DPP API

Your product data already lives in your ERP, PIM or battery management system. Use the API to create and update passports without manual entry, and send serial numbers and battery status automatically.

Base URL: https://www.qrnot.com/api/dpp/v1

1. Key

Create a key in the panel under Company → API keys (company owner only). The key is shown once; send it in the header of every request. Keys can be read-only or read + write, and can be revoked at any time.

Authorization: Bearer qrn_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Rules

• Everything you write is saved to the draft first. The public passport changes only when you call /publish; every publish is stored as a new version.
• Battery status (state of health, cycles, charge) is the exception: no publish needed, it shows on the passport immediately.
• Every write is recorded in your company audit log as “api:<key name>”.
• Limits: 1200 requests per hour per key, at most 2000 serial numbers per request. Your plan’s product limit applies to the API too.
• Send your ERP product code as externalId and repeating the same request never creates a duplicate.
• Errors are always { "error": { "code", "message", "details" } }; choose the message language with the x-dpp-lang header (tr, en, de, fr, es, nl, ar, ru).

2. Endpoints

3. Examples

Create or update by ERP code

curl -X PUT https://www.qrnot.com/api/dpp/v1/products/external/VB-48-15AH \
  -H "Authorization: Bearer qrn_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "defaultLang": "en",
    "texts": { "en": { "name": "E-bike battery 48V 15Ah" } },
    "data": {
      "brand": "Volta", "model": "VB-48", "category": "battery",
      "gtin": "08691234567892", "countryOfOrigin": "TR",
      "sector": { "batteryCategory": "lmt", "chemistry": "Li-ion LFP" }
    }
  }'

Publish

curl -X POST https://www.qrnot.com/api/dpp/v1/products/{id}/publish \
  -H "Authorization: Bearer qrn_live_…"

Add serial numbers (one passport each)

curl -X POST https://www.qrnot.com/api/dpp/v1/products/{id}/items \
  -H "Authorization: Bearer qrn_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "serials": [
        { "serial": "VB-000101", "batch": "L2026-10", "productionDate": "2026-10-20" },
        { "serial": "VB-000102", "batch": "L2026-10", "productionDate": "2026-10-20" }
      ] }'

Update one battery’s status

curl -X PATCH https://www.qrnot.com/api/dpp/v1/products/{id}/items/VB-000101 \
  -H "Authorization: Bearer qrn_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "stateOfHealthPct": 97, "cycles": 120, "stateOfChargePct": 80 }'

4. Sector fields

Fields go into data.sector; the module is chosen by product category. If a “required” field is missing, publish returns 400 and lists what is missing in error.details.

Note: the API does not submit to the EU central DPP registry; the technical details of that registry have not been published yet.