DPP API

Ürün verisi zaten ERP’nizde, PIM’inizde ya da batarya yönetim sisteminizde. API ile pasaportları elle girmeden oluşturun, güncelleyin, seri numaralarını ve pil durumunu otomatik gönderin.

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

1. Anahtar

Panelde Firma → API anahtarları bölümünden bir anahtar oluşturun (sadece firma yöneticisi). Anahtar bir kez gösterilir; her istekte başlıkta gönderin. Anahtarlar okuma ya da okuma + yazma yetkili olabilir, istediğiniz an iptal edilebilir.

Authorization: Bearer qrn_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Kurallar

• Yazdığınız her şey önce taslağa kaydedilir. Herkese açık pasaport sadece /publish çağrısıyla değişir; her yayın yeni bir sürüm olarak saklanır.
• Batarya durumu (sağlık %, döngü, şarj) istisnadır: yayın gerekmez, hemen pasaporta yansır.
• Her yazma işlemi firmanızın işlem kaydına “api:<anahtar adı>” olarak yazılır.
• Sınır: anahtar başına saatte 1200 istek, istek başına en fazla 2000 seri numarası. Paketinizin ürün sınırı API için de geçerlidir.
• externalId (ERP ürün kodunuz) ile gönderirseniz aynı istek tekrar gelse de çift kayıt oluşmaz.
• Hatalar her zaman { "error": { "code", "message", "details" } } biçimindedir; mesaj dili x-dpp-lang başlığıyla seçilir (tr, en, de, fr, es, nl, ar, ru).

2. Uç noktalar

3. Örnekler

ERP kodu ile ürün oluştur ya da güncelle

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" }
    }
  }'

Yayınla

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

Seri numaralarını ekle (her biri ayrı pasaport)

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" }
      ] }'

Tek bir pilin durumunu güncelle

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. Sektör alanları

Alanlar data.sector içinde gönderilir; ürün kategorisine göre modül seçilir. “Zorunlu” alanlar eksikse yayınlama 400 döner ve eksikler error.details içinde listelenir.

Not: API, AB merkezi DPP kayıt sistemine gönderim yapmaz; bu kayıt sisteminin teknik ayrıntıları henüz yayımlanmadı.