Aitheantóirí GS1 & Onboarding

Braitheann qr3.app ar mhúnla BYO-GTIN/BYO-GLN (Tabhair Leat Do Chuid Féin): Tugann tú do chuid aitheantóirí reatha GS1 leat — glacann qr3 cúram den chiseal digiteach táirge os a gcionn.

Cad a dhéanann GS1?

GS1 sannann aitheantóirí uathúla ar fud an domhain do tháirgí agus do shuímh:

Aitheantóir	Cur Síos	Sampla
GTIN-14	Global Trade Item Number (ID Táirge)	`04012345678901`
GLN-13	Global Location Number (Suíomh/Cuideachta)	`4012345000009`
Company Prefix	Réimír Cuideachta (7-12 dhigit), as a ndíorthaítear GTINanna	`4012345`

Chun GTINanna a fháil, teastaíonn ballraíocht GS1 uait ó d’eagraíocht náisiúnta GS1 (e.g. GS1 Austria, GS1 Germany).

Cad a dhéanann qr3.app?

Úsáideann qr3.app do chuid aitheantóirí reatha GS1 agus cuireann sé seo ar fáil:

Réititheoir comhlíontach le GS1 — /01/{GTIN}/21/{Serial} le Content-Negotiation
EU Digital Product Passport — Cruthú DPP, bailíochtú, amharc tomhaltóra
Sócmhainní QR réidh le priontáil — SVG, PNG, PDF veicteoireach, EPS
JSON-LD, DCAT-AP — Sonraí táirge inléite ag meaisín

Sreabhadh Onboarding

1. Aitheantóirí GS1 a chlárú

Sula mbeidh tú in ann DPPanna a chruthú, caithfidh tú do chuid GTINanna (nó do Company Prefix) a chlárú:

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

Tríd an Deais:

Téigh go dtí Deais → GS1
Roghnaigh an cineál (GTIN, GLN nó Company Prefix)
Cuir isteach an luach — déantar an bailíochtú seiceála digití go huathoibríoch
Cliceáil ar Cuir Aitheantóir leis

2. DPPanna a chruthú

Chomh luath agus a bhíonn GTIN cláraithe (go díreach nó trí Company Prefix), is féidir leat DPPanna a chruthú leis:

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. Seiceáil Úinéireachta

Seiceálann qr3.app le linn gach cruthú DPP an mbaineann an GTIN a úsáidtear le d’eagraíocht:

Clárú Díreach — Tá an GTIN cláraithe mar identifier_type: "gtin"
Meaitseáil Réimíre — Tosaíonn an GTIN le Company Prefix cláraithe (Suíomh 2..N den GTIN-14)

Gan clárú meaitseála, faightear earráid 422 le leid chun an GTIN a chlárú ar dtús.

Cathain a bhíonn an dá rud de dhíth orm?

Tasc	GS1	qr3.app
GTINanna/GLNanna do chuid féin a fháil	✅ Ballraíocht de dhíth	—
Seiceáil dhigit GTIN a bhailíochtú	—	✅ API + Deais
Cód QR a ghiniúint do tháirge	—	✅
DPP a chruthú de réir Rialachán an AE	—	✅
GS1 Digital Link a réiteach	—	✅ Réititheoir + `/.well-known/gs1resolver`
Clárú i gClárlann an AE	Beartaithe (Q4 2026)	Beartaithe (Céim 4c)

Tagairt API

POST /v1/gs1/identifiers — Clárú
GET /v1/gs1/identifiers — Liostú
DELETE /v1/gs1/identifiers/:id — Deireadh a chur le
POST /v1/gs1/validate — Bailíochtú (gan clárú, gan Auth)

Féach ar an Doiciméadúchán API le haghaidh sonraí.