Skip to content
qr3.app Docs

Aitheantóirí GS1 & Onboarding

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óirCur SíosSampla
GTIN-14Global Trade Item Number (ID Táirge)04012345678901
GLN-13Global Location Number (Suíomh/Cuideachta)4012345000009
Company PrefixRéimír Cuideachta (7-12 dhigit), as a ndíorthaítear GTINanna4012345

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:

Terminal window
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:

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

Níl gach aitheantóir ag d’eagraíocht ach uair amháin, i gceann dá Workspace. Má chláraíonn tú aitheantóir a baineadh arís, tagann sé ar ais (201, an id céanna) mar fhéindearbhú agus gan fíorú, fiú má bhí sé fíoraithe sular baineadh é; má bhí sé i Workspace eile, bogtar go dtí an ceann seo é. Má tá sé cláraithe fós, is é an freagra 409 le reason already_registered (sa Workspace seo) nó registered_in_other_workspace (i gceann eile; ainmníonn workspace é má tá cead agat é a oscailt). Má chartlannaítear an Workspace idir an dá linn, is é reason ná workspace_archived; ní chláraítear aon rud.

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:

Terminal window
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:

  1. Clárú Díreach — Tá an GTIN cláraithe mar identifier_type: "gtin"
  2. 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.

Baineann an tseiceáil chéanna le POST /v1/dpp/batch agus POST /v1/dpp/import, go sioncronach agus mar jab i scuaine: diúltaíonn GTIN amháin gan clárú don iarratas ar fad le 422 (teideal GTIN Not Registered, na GTINanna diúltaithe in gtins, a líon in total); ní chruthaítear ná ní chuirtear aon rud i scuaine. Ní théann sé i bhfeidhm ar phasanna atá ann cheana. Chun pas a chur isteach i gClár Táirgí an AE (POST /v1/dpp/:id/register) ní mór freisin gurb í eagraíocht an phas sealbhóir an GTIN (féach roinn 4); murach sin is é 409 an freagra (teideal GTIN Held by Another Organization).

4. Fíorú

Is féindearbhú é clárú tríd an API nó an deais (verified_by: "self", verified_at: null). Bíonn verified_at ag aitheantóir fíoraithe (verified_by: "gs1_registry" nó "admin"); is é qr3 a shocraíonn é, tar éis dó iarratas le cruthúnas a sheiceáil (féach thíos). GTIN nó Company Prefix fíoraithe:

  • ceanglaíonn sé an réititheoir GS1 poiblí do na GTINanna sin le d’eagraíocht, fiú má chruthaigh eagraíocht eile pas níos luaithe;
  • cuireann sé bac ar gach eagraíocht eile: má chruthaítear DPP do GTIN den sórt sin, trí bhaisc nó iompórtáil freisin, tugtar 409 ar ais (errors/conflict, teideal GTIN Verified by Another Organization, na GTINanna diúltaithe in gtins). Diúltaítear don bhaisc agus don iompórtáil ina n-iomláine.

Gan fíorú, is leis an eagraíocht a bhfuil sé aici is faide gan bhriseadh an GTIN (sonraí: Réititheoir GS1). Má réitíonn do GTIN chuig pas eagraíochta eile, iarr go bhfíorófar é.

Fíorú a iarraidh

Sa deais faoi GS1, sa chuid Iarr fíorú: cuir isteach an cineál (GTIN nó Company Prefix) agus an luach, uaslódáil cruthúnas agus seol an t-iarratas. Léiríonn an cruthúnas go bhfuil an GTIN nó an Company Prefix ag d’eagraíocht ó GS1, mar shampla deimhniú ceadúnais ó d’eagraíocht GS1 (PDF, PNG, JPEG nó WebP). Stóráiltear go príobháideach é; ní fheiceann ach d’eagraíocht agus foireann qr3 é. Níl aon fhiosrú uathoibríoch ag GS1.

Seiceálann foireann qr3 an cruthúnas agus ceadaíonn sí an t-iarratas nó diúltaíonn sí dó le cúis. Nuair a cheadaítear é, tá an t-aitheantóir fíoraithe (verified_by: "admin") agus bíonn an éifeacht a thuairiscítear thuas aige. Faigheann tú ríomhphost faoi gach cinneadh chuig seoladh fógraí d’eagraíochta, nó mura bhfuil ceann ann, chuig seoladh an úinéara.

  • Cé: riarthóirí na heagraíochta amháin (org_admin nó an t-úinéir). Faigheann róil eile agus eochracha API díreacha 403. Ní féidir le tacaíocht qr3 iarratas a sheoladh i d’ainm ach an oiread.
  • Stádas: pending (á scrúdú), approved, rejected, withdrawn (tarraingthe siar agatsa) nó revoked (fíorú cúlghairthe níos déanaí). Is féidir leat iarratas atá á scrúdú a tharraingt siar.
  • 409: is é reason ná request_pending (tá iarratas ag d’eagraíocht cheana féin don aitheantóir seo), already_verified nó verified_elsewhere (tá sé fíoraithe ag eagraíocht eile; ní ainmnítear í). Má tá an ceadúnas GS1 dó ag d’eagraíocht, scríobh chuig [email protected]: seiceálann qr3 an dá thaobh agus is féidir leis fíorú a chúlghairm. Má athraíonn an cruthúnas agus an t-iarratas á sheoladh, is é reason ná proof_changed; seol an t-iarratas arís.
  • Workspace eile: le request_pending, ainmníonn workspace (id, name) agus request_id an t-iarratas oscailte má tá cead agat a Workspace a oscailt; tarraing siar ansin é. Seachas sin is null an dá cheann. Má chartlannaítear an Workspace agus an t-iarratas á sheoladh agat, is é reason ná workspace_archived; ní sheoltar aon rud.
  • Cartlannú: nuair a chartlannaítear Workspace, tarraingítear siar a chuid iarratas atá á scrúdú (withdrawn, sa loga iniúchta leis an gcúis workspace archived). Bíonn an cruthúnas saor arís ansin, agus is féidir leat an t-aitheantóir a iarraidh arís ó Workspace eile.
  • Cruthúnas: fad atá an t-iarratas á scrúdú nó ceadaithe, ní féidir an comhad a athsholáthar ná a scriosadh (409, reason: "gs1_verification_proof"). Tar éis diúltú, tarraingt siar nó cúlghairm, tá sé saor arís.
  • Baint: ní féidir aitheantóir fíoraithe a bhaint (409, reason: "verified"). Ní chuireann ach qr3 deireadh leis an bhfíorú, trína chúlghairm.

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

TascGS1qr3.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 AEBeartaithe (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)
  • POST /v1/gs1/verifications — Iarr fíorú (riarthóirí na heagraíochta)
  • GET /v1/gs1/verifications — Liostaigh iarratais
  • GET /v1/gs1/verifications/:id — Faigh iarratas
  • POST /v1/gs1/verifications/:id/withdraw — Tarraing iarratas siar

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