GS1 identifikátory & onboarding

GS1 identifikátory & onboarding

qr3.app stavia na modeli BYO-GTIN/BYO-GLN (Bring Your Own): prinesiete si svoje existujúce GS1 identifikátory — qr3 prevezme digitálnu produktovú vrstvu nad nimi.

Čo robí GS1?

GS1 prideľuje celosvetovo jedinečné identifikátory pre produkty a lokality:

Identifikátor	Popis	Príklad
GTIN-14	Global Trade Item Number (ID produktu)	04012345678901
GLN-13	Global Location Number (lokalita/firma)	4012345000009
Company Prefix	Firemný prefix (7-12 miest), z ktorého sa odvodzujú GTIN	4012345

Na získanie GTIN potrebujete členstvo v GS1 u vašej národnej organizácie GS1 (napr. GS1 Austria, GS1 Germany).

Čo robí qr3.app?

qr3.app využíva vaše existujúce GS1 identifikátory a ponúka:

• Resolver kompatibilný s GS1 — /01/{GTIN}/21/{Serial} s Content-Negotiation
• Digitálny pas produktu EÚ — tvorba DPP, validácia, zobrazenie pre spotrebiteľa
• QR podklady pripravené na tlač — SVG, PNG, vektorové PDF, EPS
• JSON-LD, DCAT-AP — strojovo čitateľné údaje o produkte

Onboarding proces

1. Registrácia GS1 identifikátorov

Predtým, ako budete môcť vytvárať DPP, musíte zaregistrovať svoje GTIN (alebo váš Company Prefix):

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

Cez dashboard:

1. Prejdite na Dashboard → GS1
2. Vyberte typ (GTIN, GLN alebo Company Prefix)
3. Zadajte hodnotu — overenie kontrolnej číslice (Check-Digit) prebehne automaticky
4. Kliknite na Pridať identifikátor

2. Vytvorenie DPP

Akonáhle je GTIN zaregistrovaná (priamo alebo prostredníctvom Company Prefix), môžete pomocou nej vytvárať 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. Overenie vlastníctva

qr3.app pri každom vytvorení DPP kontroluje, či použitá GTIN patrí vašej organizácii:

1. Priama registrácia — GTIN je zaregistrovaná ako identifier_type: "gtin"
2. Zhoda prefixu — GTIN začína registrovaným Company Prefix (pozícia 2..N v GTIN-14)

Bez zodpovedajúcej registrácie dôjde k chybe 422 s upozornením, že GTIN je potrebné najprv zaregistrovať.

Kedy potrebujem oboje?

Úloha	GS1	qr3.app
Získanie vlastných GTIN/GLN	✅ Vyžaduje sa členstvo	—
Validácia kontrolnej číslice GTIN	—	✅ API + Dashboard
Generovanie QR kódu pre produkt	—	✅
Vytvorenie DPP podľa nariadenia EÚ	—	✅
Rozlíšenie GS1 Digital Link	—	✅ Resolver + /.well-known/gs1resolver
Registrácia v registri EÚ	Plánované (Q4 2026)	Plánované (Fáza 4c)

API referencia

• POST /v1/gs1/identifiers — Registrácia
• GET /v1/gs1/identifiers — Zoznam
• DELETE /v1/gs1/identifiers/:id — Odstránenie
• POST /v1/gs1/validate — Validácia (bez registrácie, bez autentifikácie)

Podrobnosti nájdete v API dokumentácii.