GS1-identifikatorji in uvajanje

GS1-identifikatorji in uvajanje

qr3.app temelji na modelu BYO-GTIN/BYO-GLN (Bring Your Own): s seboj prinesete svoje obstoječe GS1 identifikatorje — qr3 pa poskrbi za digitalni produktni sloj nad njimi.

Kaj počne GS1?

GS1 dodeljuje globalno edinstvene identifikatorje za izdelke in lokacije:

Identifikator	Opis	Primer
GTIN-14	Global Trade Item Number (ID izdelka)	04012345678901
GLN-13	Global Location Number (lokacija/podjetje)	4012345000009
Company Prefix	Predpona podjetja (7-12 mest), iz katere se izpeljejo GTIN-i	4012345

Za pridobitev GTIN-ov potrebujete članstvo v GS1 pri svoji nacionalni organizaciji GS1 (npr. GS1 Austria, GS1 Germany).

Kaj počne qr3.app?

qr3.app uporablja vaše obstoječe GS1 identifikatorje in ponuja:

• Združljiv GS1 razreševalnik — /01/{GTIN}/21/{Serial} s pogajanjem o vsebini (Content-Negotiation)
• EU Digital Product Passport — ustvarjanje DPP, validacija, potrošniški pogled
• Za tisk pripravljena QR sredstva — SVG, PNG, vektorski PDF, EPS
• JSON-LD, DCAT-AP — strojno berljivi podatki o izdelkih

Postopek uvajanja

1. Registracija GS1 identifikatorjev

Preden lahko ustvarite DPP-je, morate registrirati svoje GTIN-e (ali predpono podjetja):

Preko API-ja:

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

Preko nadzorne plošče:

1. Pojdite na Nadzorna plošča → GS1
2. Izberite vrsto (GTIN, GLN ali Company Prefix)
3. Vnesite vrednost — preverjanje kontrolne številke se izvede samodejno
4. Kliknite Dodaj identifikator

2. Ustvarjanje DPP-jev

Takoj ko je GTIN registriran (neposredno ali prek predpone podjetja), lahko z njim ustvarite DPP-je:

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. Preverjanje lastništva

qr3.app ob vsakem ustvarjanju DPP-ja preveri, ali uporabljeni GTIN pripada vaši organizaciji:

1. Neposredna registracija — GTIN je registriran kot identifier_type: "gtin"
2. Ujemanje predpone — GTIN se začne z registrirano predpono podjetja (pozicije 2..N v GTIN-14)

Brez ustrezne registracije se vrne napaka 422 z opozorilom, da morate GTIN najprej registrirati.

Kdaj potrebujem oboje?

Naloga	GS1	qr3.app
Pridobitev lastnih GTIN-ov/GLN-ov	✅ Potrebno članstvo	—
Validacija kontrolne številke GTIN	—	✅ API + nadzorna plošča
Ustvarjanje QR-kode za izdelek	—	✅
Ustvarjanje DPP v skladu z uredbo EU	—	✅
Razreševanje GS1 Digital Link	—	✅ Razreševalnik + /.well-known/gs1resolver
Registracija v registru EU	Načrtovano (Q4 2026)	Načrtovano (faza 4c)

API referenca

• POST /v1/gs1/identifiers — Registracija
• GET /v1/gs1/identifiers — Seznam
• DELETE /v1/gs1/identifiers/:id — Odstranitev
• POST /v1/gs1/validate — Validacija (brez registracije, brez avtentikacije)

Za podrobnosti si oglejte API dokumentacijo.