GS1 azonosítók & Onboarding

GS1 azonosítók & Onboarding

A qr3.app a BYO-GTIN/BYO-GLN (Bring Your Own) modellre épül: Ön hozza a meglévő GS1 azonosítóit — a qr3 pedig biztosítja a felettük lévő digitális termékréteget (Product-Layer).

Mit csinál a GS1?

A GS1 világszerte egyedi azonosítókat bocsát ki termékekhez és helyszínekhez:

Azonosító	Leírás	Példa
GTIN-14	Global Trade Item Number (termékazonosító)	04012345678901
GLN-13	Global Location Number (helyszín/cég)	4012345000009
Company Prefix	Vállalati előtag (7-12 számjegy), amelyből a GTIN-ek származnak	4012345

A GTIN-ek beszerzéséhez GS1-tagságra van szüksége a helyi nemzeti GS1-szervezetnél (pl. GS1 Austria, GS1 Germany).

Mit csinál a qr3.app?

A qr3.app a meglévő GS1 azonosítóit használja, és az alábbiakat kínálja:

• GS1-konform Resolver — /01/{GTIN}/21/{Serial} Content-Negotiation támogatással
• EU Digitális Termékútlevél — DPP létrehozása, validálása és fogyasztói nézet
• Nyomtatásra kész QR-eszközök — SVG, PNG, vektoros PDF, EPS
• JSON-LD, DCAT-AP — Gépileg olvasható termékadatok

Onboarding folyamat

1. GS1 azonosítók regisztrálása

Mielőtt DPP-ket hozhatna létre, regisztrálnia kell a GTIN-jeit (vagy a Company Prefix előtagját):

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

Irányítópulton (Dashboard) keresztül:

1. Navigáljon a Dashboard → GS1 menüponthoz
2. Válassza ki a típust (GTIN, GLN vagy Company Prefix)
3. Adja meg az értéket — az ellenőrző számjegy (Check-Digit) ellenőrzése automatikusan megtörténik
4. Kattintson az Azonosító hozzáadása gombra

2. DPP-k létrehozása

Amint egy GTIN regisztrálva van (közvetlenül vagy egy Company Prefix-en keresztül), létrehozhat hozzá DPP-ket:

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. Tulajdonjog-ellenőrzés

A qr3.app minden DPP létrehozásakor ellenőrzi, hogy a használt GTIN az Ön szervezetéhez tartozik-e:

1. Közvetlen regisztráció — A GTIN identifier_type: "gtin" típusként van regisztrálva
2. Előtag-egyezés (Prefix-Match) — A GTIN egy regisztrált Company Prefix előtaggal kezdődik (a GTIN-14 2..N pozíciója)

Megfelelő regisztráció nélkül egy 422-es hibaüzenetet kap, amely arra figyelmeztet, hogy először regisztrálja a GTIN-t.

Mikor van szükségem mindkettőre?

Feladat	GS1	qr3.app
Saját GTIN/GLN azonosítók beszerzése	✅ Tagság szükséges	—
GTIN ellenőrző számjegy validálása	—	✅ API + Dashboard
QR-kód generálása termékhez	—	✅
DPP létrehozása az EU-rendeletnek megfelelően	—	✅
GS1 Digital Link feloldása	—	✅ Resolver + /.well-known/gs1resolver
Regisztráció az EU-Registry-ben	Tervezve (2026 Q4)	Tervezve (4c fázis)

API-referencia

• POST /v1/gs1/identifiers — Regisztráció
• GET /v1/gs1/identifiers — Listázás
• DELETE /v1/gs1/identifiers/:id — Eltávolítás
• POST /v1/gs1/validate — Validálás (regisztráció és hitelesítés nélkül)

A részletekért lásd az API-dokumentációt.