Identificatori GS1 & Onboarding

qr3.app se bazează pe un model BYO-GTIN/BYO-GLN (Bring Your Own): aduceți propriii identificatori GS1 existenți — qr3 se ocupă de stratul digital de produs (Product-Layer) de deasupra acestora.

Ce face GS1?

GS1 emite identificatori unici la nivel global pentru produse și locații:

Identificator	Descriere	Exemplu
GTIN-14	Global Trade Item Number (ID produs)	`04012345678901`
GLN-13	Global Location Number (Locație/Companie)	`4012345000009`
Company Prefix	Prefix de companie (7-12 cifre), din care sunt derivate codurile GTIN	`4012345`

Pentru a obține coduri GTIN, aveți nevoie de calitatea de membru GS1 în cadrul organizației dumneavoastră naționale GS1 (de ex. GS1 Austria, GS1 Germany).

Ce face qr3.app?

qr3.app utilizează identificatorii dumneavoastră GS1 existenți și oferă:

Resolver conform cu GS1 — /01/{GTIN}/21/{Serial} cu Content-Negotiation
EU Digital Product Passport — creare DPP, validare, vizualizare pentru consumatori
Asset-uri QR gata de tipărit — SVG, PNG, PDF vectorial, EPS
JSON-LD, DCAT-AP — date de produs lizibile de către echipamente (machine-readable)

Fluxul de onboarding

1. Înregistrarea identificatorilor GS1

Înainte de a putea crea DPP-uri, trebuie să vă înregistrați codurile GTIN (sau prefixul de companie - Company Prefix):

Prin API:

curl -X POST https://qr3.app/v1/gs1/identifiers \
  -H "Authorization: Bearer qr3_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"identifier_type": "company_prefix", "value": "4012345", "label": "GreenPower GmbH"}'

Prin Dashboard:

Navigați la Dashboard → GS1
Selectați tipul (GTIN, GLN sau Company Prefix)
Introduceți valoarea — validarea cifrei de control (Check-Digit) se realizează automat
Faceți clic pe Adăugare identificator

2. Crearea DPP-urilor

De îndată ce un cod GTIN este înregistrat (direct sau prin intermediul unui Company Prefix), puteți crea DPP-uri cu acesta:

curl -X POST https://qr3.app/v1/dpp \
  -H "Authorization: Bearer qr3_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"gtin": "04012345678901", "product_name": "EcoMax Battery", ...}'

3. Verificarea proprietății (Ownership)

qr3.app verifică la fiecare creare de DPP dacă codul GTIN utilizat aparține organizației dumneavoastră:

Înregistrare directă — Codul GTIN este înregistrat ca identifier_type: "gtin"
Potrivire prefix (Prefix-Match) — Codul GTIN începe cu un Company Prefix înregistrat (pozițiile 2..N din GTIN-14)

Fără o înregistrare corespunzătoare, se va returna o eroare 422 cu indicația de a înregistra mai întâi codul GTIN.

Când am nevoie de ambele?

Sarcină	GS1	qr3.app
Obținerea propriilor coduri GTIN/GLN	✅ Calitate de membru necesară	—
Validarea cifrei de control GTIN	—	✅ API + Dashboard
Generarea codului QR pentru produs	—	✅
Crearea DPP conform Regulamentului UE	—	✅
Rezoluția GS1 Digital Link	—	✅ Resolver + `/.well-known/gs1resolver`
Înregistrarea în Registrul UE	Planificat (Q4 2026)	Planificat (Faza 4c)

Referință API

POST /v1/gs1/identifiers — Înregistrare
GET /v1/gs1/identifiers — Listare
DELETE /v1/gs1/identifiers/:id — Ștergere
POST /v1/gs1/validate — Validare (fără înregistrare, fără autentificare)

Consultați Documentația API pentru detalii.