Identifikaturi GS1 & Onboarding

Identifikaturi GS1 & Onboarding

qr3.app tibbaża fuq mudell BYO-GTIN/BYO-GLN (Bring Your Own): Inti ġġib l-identifikaturi GS1 eżistenti tiegħek — qr3 tieħu ħsieb is-saff tal-prodott diġitali (digital product layer) fuqhom.

X’tagħmel GS1?

GS1 toħroġ identifikaturi uniċi madwar id-dinja għal prodotti u postijiet:

Identifikatur	Deskrizzjoni	Eżempju
GTIN-14	Global Trade Item Number (ID tal-Prodott)	04012345678901
GLN-13	Global Location Number (Post/Kumpanija)	4012345000009
Company Prefix	Prefiss tal-Kumpanija (7-12-il ċifra), li minnu jiġu derivati l-GTINs	4012345

Biex tikseb GTINs, għandek bżonn sħubija f’GS1 mal-organizzazzjoni nazzjonali tiegħek ta’ GS1 (eż. GS1 Austria, GS1 Germany).

X’tagħmel qr3.app?

qr3.app tuża l-identifikaturi GS1 eżistenti tiegħek u toffri:

• Resolver konformi ma’ GS1 — /01/{GTIN}/21/{Serial} b’Content-Negotiation
• Passaport Diġitali tal-Prodott tal-UE — Ħolqien ta’ DPP, validazzjoni, u dehra għall-konsumatur
• Assessi tal-QR lesti għall-istampar — SVG, PNG, PDF vettorjali, EPS
• JSON-LD, DCAT-AP — Data tal-prodott li tista’ tinqara mill-magni

Fluss tal-Onboarding

1. Irreġistra l-Identifikaturi GS1

Qabel ma tkun tista’ toħloq DPPs, trid tirreġistra l-GTINs tiegħek (jew il-Company Prefix tiegħek):

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

Permezz tad-Dashboard:

1. Innaviga lejn Dashboard → GS1
2. Agħżel it-tip (GTIN, GLN jew Company Prefix)
3. Daħħal il-valur — il-validazzjoni taċ-ċifra tal-kontroll (check-digit) issir awtomatikament
4. Ikklikkja Żid l-Identifikatur

2. Oħloq DPPs

Ladarba GTIN tkun irreġistrata (direttament jew permezz ta’ Company Prefix), tista’ toħloq DPPs biha:

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. Verifika tas-Sjieda (Ownership)

qr3.app tivverifika ma’ kull ħolqien ta’ DPP jekk il-GTIN użata tappartjenix għall-organizzazzjoni tiegħek:

1. Reġistrazzjoni diretta — Il-GTIN hija rreġistrata bħala identifier_type: "gtin"
2. Tqabbil tal-Prefiss (Prefix-Match) — Il-GTIN tibda b’Company Prefix irreġistrat (pożizzjoni 2..N tal-GTIN-14)

Mingħajr reġistrazzjoni xierqa, ikollok żball 422 b’avviż biex tirreġistra l-GTIN l-ewwel.

Meta għandi bżonn it-tnejn?

Kompitu	GS1	qr3.app
Ikseb il-GTINs/GLNs tiegħek stess	✅ Sħubija meħtieġa	—
Validazzjoni taċ-ċifra tal-kontroll tal-GTIN	—	✅ API + Dashboard
Iġġenera kodiċi QR għall-prodott	—	✅
Oħloq DPP skont ir-Regolament tal-UE	—	✅
Riżoluzzjoni ta’ GS1 Digital Link	—	✅ Resolver + /.well-known/gs1resolver
Irreġistra fir-Reġistru tal-UE	Ippjanat (Q4 2026)	Ippjanat (Fażi 4c)

Referenza tal-API

• POST /v1/gs1/identifiers — Irreġistra
• GET /v1/gs1/identifiers — Elenka
• DELETE /v1/gs1/identifiers/:id — Neħħi
• POST /v1/gs1/validate — Validazzjoni (mingħajr reġistrazzjoni, l-ebda awtentikazzjoni)

Ara d-Dokumentazzjoni tal-API għal dettalji.