GS1-identifikaatorid ja liitumine

qr3.app põhineb BYO-GTIN/BYO-GLN mudelil (Bring Your Own): Sina tood oma olemasolevad GS1-identifikaatorid — qr3 pakub nende kohale digitaalset tootekihitust (Product-Layer).

Mida teeb GS1?

GS1 väljastab globaalselt kordumatuid identifikaatoreid toodetele ja asukohtadele:

Identifikaator	Kirjeldus	Näide
GTIN-14	Global Trade Item Number (toote ID)	`04012345678901`
GLN-13	Global Location Number (asukoht/ettevõte)	`4012345000009`
Company Prefix	Ettevõtte eesliide (7–12 kohta), millest tuletatakse GTIN-id	`4012345`

GTIN-ide saamiseks on sul vaja GS1 liikmelisust oma riiklikus GS1 organisatsioonis (nt GS1 Austria, GS1 Germany).

Mida teeb qr3.app?

qr3.app kasutab sinu olemasolevaid GS1-identifikaatoreid ja pakub:

GS1-ühilduv lahendaja (Resolver) — /01/{GTIN}/21/{Serial} koos sisuläbirääkimisega (Content-Negotiation)
ELi digitaalne tootepass (DPP) — DPP loomine, valideerimine, tarbijavaade
Trükivalmis QR-failid — SVG, PNG, vektor-PDF, EPS
JSON-LD, DCAT-AP — masinloetavad tooteandmed

Liitumisprotsess (Onboarding-Flow)

1. Registreeri GS1-identifikaatorid

Enne kui saad DPP-sid luua, pead registreerima oma GTIN-id (või oma ettevõtte eesliite / Company Prefix):

API kaudu:

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

Töölaua (Dashboard) kaudu:

Navigeeri valikusse Dashboard → GS1
Vali tüüp (GTIN, GLN või Company Prefix)
Sisesta väärtus — kontrollarvu (Check-Digit) valideerimine toimub automaatselt
Klõpsa Lisa identifikaator

2. Loo DPP-d

Niipea kui GTIN on registreeritud (otse või ettevõtte eesliite kaudu), saad sellega luua DPP-sid:

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. Omanikuõiguse kontroll

qr3.app kontrollib iga DPP loomise ajal, kas kasutatud GTIN kuulub sinu organisatsioonile:

Otsene registreerimine — GTIN on registreeritud väärtusega identifier_type: "gtin"
Eesliite kattuvus (Prefix-Match) — GTIN algab registreeritud ettevõtte eesliitega (GTIN-14 positsioonid 2..N)

Ilma sobiva registreeringuta tagastatakse viga 422 koos juhisega GTIN esmalt registreerida.

Millal on mul vaja mõlemat?

Ülesanne	GS1	qr3.app
Oma GTIN-ide/GLN-ide hankimine	✅ Liikmelisus vajalik	—
GTIN-i kontrollarvu (Check-Digit) valideerimine	—	✅ API + töölaud
Tootele QR-koodi genereerimine	—	✅
DPP loomine vastavalt EL-i määrusele	—	✅
GS1 Digital Linki lahendamine	—	✅ Resolver + `/.well-known/gs1resolver`
EL-i registris (EU-Registry) registreerimine	Planeeritud (Q4 2026)	Planeeritud (faas 4c)

API viited

POST /v1/gs1/identifiers — Registreerimine
GET /v1/gs1/identifiers — Nimekirja kuvamine
DELETE /v1/gs1/identifiers/:id — Eemaldamine
POST /v1/gs1/validate — Valideerimine (ilma registreerimiseta, autentimist pole vaja)

Üksikasju vaata API dokumentatsioonist.