Identifikátory GS1 a onboarding

qr3.app sází na model BYO-GTIN/BYO-GLN (Bring Your Own): Přinesete si své stávající identifikátory GS1 — qr3 se postará o digitální produktovou vrstvu nad nimi.

Co dělá GS1?

GS1 přiděluje celosvětově unikátní identifikátory pro produkty a lokality:

Identifikátor	Popis	Příklad
GTIN-14	Global Trade Item Number (ID produktu)	`04012345678901`
GLN-13	Global Location Number (lokalita/firma)	`4012345000009`
Company Prefix	Firemní předpona (7–12 číslic), ze které se odvozují GTIN	`4012345`

Chcete-li získat GTIN, potřebujete členství v GS1 u vaší národní organizace GS1 (např. GS1 Austria, GS1 Germany).

Co dělá qr3.app?

qr3.app využívá vaše stávající identifikátory GS1 a nabízí:

Resolver kompatibilní s GS1 — /01/{GTIN}/21/{Serial} s Content-Negotiation
Digitální pas produktu EU — tvorba DPP, validace, zobrazení pro spotřebitele
QR podklady připravené k tisku — SVG, PNG, vektorové PDF, EPS
JSON-LD, DCAT-AP — strojově čitelná produktová data

Postup onboardingu

1. Registrace identifikátorů GS1

Předtím než budete moci vytvářet DPP, musíte zaregistrovat své GTIN (nebo svůj Company Prefix):

Přes 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"}'

Přes dashboard:

Přejděte do Dashboard → GS1
Vyberte typ (GTIN, GLN nebo Company Prefix)
Zadejte hodnotu — validace kontrolní číslice (Check-Digit) proběhne automaticky
Klikněte na Přidat identifikátor

2. Vytvoření DPP

Jakmile je GTIN zaregistrována (přímo nebo prostřednictvím Company Prefix), můžete s ní vytvářet DPP:

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. Ověření vlastnictví (Ownership)

qr3.app při každém vytváření DPP kontroluje, zda použitá GTIN patří vaší organizaci:

Přímá registrace — GTIN je zaregistrována jako identifier_type: "gtin"
Shoda předpony (Prefix-Match) — GTIN začíná registrovaným Company Prefix (pozice 2..N v GTIN-14)

Bez odpovídající registrace dojde k chybě 422 s upozorněním, že je nejprve nutné GTIN zaregistrovat.

Kdy potřebuji obojí?

Úkol	GS1	qr3.app
Získání vlastních GTIN/GLN	✅ Nutné členství	—
Validace kontrolní číslice GTIN	—	✅ API + Dashboard
Generování QR kódu pro produkt	—	✅
Vytvoření DPP podle nařízení EU	—	✅
Překlad GS1 Digital Link	—	✅ Resolver + `/.well-known/gs1resolver`
Registrace v registru EU	Plánováno (Q4 2026)	Plánováno (Fáze 4c)

API reference

POST /v1/gs1/identifiers — Registrace
GET /v1/gs1/identifiers — Výpis
DELETE /v1/gs1/identifiers/:id — Odstranění
POST /v1/gs1/validate — Validace (bez registrace, bez autentizace)

Podrobnosti naleznete v dokumentaci k API.