GS1 identifikatori un onboarding

GS1 identifikatori un onboarding

qr3.app izmanto BYO-GTIN/BYO-GLN modeli (Bring Your Own): jūs izmantojat savus esošos GS1 identifikatorus — qr3 nodrošina digitālo produkta slāni (Product-Layer) virs tiem.

Ko dara GS1?

GS1 piešķir globāli unikālus identifikatorus produktiem un atrašanās vietām:

Identifikators	Apraksts	Piemērs
GTIN-14	Global Trade Item Number (produkta ID)	04012345678901
GLN-13	Global Location Number (atrašanās vieta/uzņēmums)	4012345000009
Company Prefix	Uzņēmuma prefikss (7-12 zīmes), no kura tiek atvasināti GTIN	4012345

Lai iegūtu GTIN, jums ir nepieciešams GS1 dalības statuss jūsu nacionālajā GS1 organizācijā (piem., GS1 Austria, GS1 Germany).

Ko dara qr3.app?

qr3.app izmanto jūsu esošos GS1 identifikatorus un nodrošina:

• GS1 saderīgs atrisinātājs (Resolver) — /01/{GTIN}/21/{Serial} ar Content-Negotiation
• EU Digital Product Passport — DPP izveide, validācija, patērētāja skats
• Drukāšanai gatavi QR resursi — SVG, PNG, vektoru PDF, EPS
• JSON-LD, DCAT-AP — mašīnlasāmi produkta dati

Onboarding process

1. GS1 identifikatoru reģistrēšana

Pirms varat izveidot DPP, jums ir jāreģistrē savi GTIN (vai uzņēmuma Company Prefix):

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

Izmantojot vadības paneli (Dashboard):

1. Dodieties uz Dashboard → GS1
2. Izvēlieties tipu (GTIN, GLN vai Company Prefix)
3. Ievadiet vērtību — kontrolcipara (Check-Digit) validācija notiek automātiski
4. Noklikšķiniet uz Pievienot identifikatoru

2. DPP izveide

Tiklīdz GTIN ir reģistrēts (tieši vai izmantojot Company Prefix), varat izveidot DPP ar to:

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. Īpašumtiesību pārbaude

qr3.app katras DPP izveides laikā pārbauda, vai izmantotais GTIN pieder jūsu organizācijai:

1. Tieša reģistrācija — GTIN ir reģistrēts kā identifier_type: "gtin"
2. Prefiksa atbilstība — GTIN sākas ar reģistrētu Company Prefix (GTIN-14 pozīcijas no 2 līdz N)

Bez atbilstošas reģistrācijas tiks atgriezta 422 kļūda ar norādi vispirms reģistrēt GTIN.

Kad man ir nepieciešams abi?

Uzdevums	GS1	qr3.app
Savu GTIN/GLN iegūšana	✅ Nepieciešama dalība	—
GTIN kontrolcipara validācija	—	✅ API + Dashboard
QR koda ģenerēšana produktam	—	✅
DPP izveide saskaņā ar ES regulu	—	✅
GS1 Digital Link atrisināšana	—	✅ Resolver + /.well-known/gs1resolver
Reģistrēšana ES reģistrā	Plānots (2026. gada 4. ceturksnī)	Plānots (4c fāze)

API atsauce

• POST /v1/gs1/identifiers — Reģistrēt
• GET /v1/gs1/identifiers — Uzskaitīt
• DELETE /v1/gs1/identifiers/:id — Noņemt
• POST /v1/gs1/validate — Validēt (bez reģistrācijas, bez autentifikācijas)

Sīkāku informāciju skatiet API dokumentācijā.