GS1 identifikatori i onboarding

qr3.app se oslanja na BYO-GTIN/BYO-GLN model (Bring Your Own): donosite svoje postojeće GS1 identifikatore — qr3 preuzima digitalni sloj proizvoda (Product-Layer) iznad njih.

Što radi GS1?

GS1 dodjeljuje globalno jedinstvene identifikatore za proizvode i lokacije:

Identifikator	Opis	Primjer
GTIN-14	Global Trade Item Number (ID proizvoda)	`04012345678901`
GLN-13	Global Location Number (lokacija/tvrtka)	`4012345000009`
Company Prefix	Prefiks tvrtke (7-12 znamenki) iz kojeg se izvode GTIN-ovi	`4012345`

Kako biste dobili GTIN-ove, potrebno vam je članstvo u GS1 kod vaše nacionalne GS1 organizacije (npr. GS1 Croatia, GS1 Germany).

Što radi qr3.app?

qr3.app koristi vaše postojeće GS1 identifikatore i nudi:

GS1 kompatibilan resolver — /01/{GTIN}/21/{Serial} s Content-Negotiation
EU Digital Product Passport — izrada DPP-a, validacija, korisnički prikaz (Consumer-Ansicht)
QR materijali spremni za tisak — SVG, PNG, vektorski PDF, EPS
JSON-LD, DCAT-AP — strojno čitljivi podaci o proizvodu

Onboarding proces

1. Registracija GS1 identifikatora

Prije nego što možete izraditi DPP-ove, morate registrirati svoje GTIN-ove (ili svoj Company Prefix):

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

Putem nadzorne ploče (Dashboard):

Idite na Dashboard → GS1
Odaberite vrstu (GTIN, GLN ili Company Prefix)
Unesite vrijednost — provjera kontrolne znamenke (Check-Digit) vrši se automatski
Kliknite Dodaj identifikator

2. Izrada DPP-ova

Nakon što je GTIN registriran (izravno ili putem Company Prefixa), možete kreirati DPP-ove s njim:

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. Provjera vlasništva (Ownership)

qr3.app prilikom svake izrade DPP-a provjerava pripada li korišteni GTIN vašoj organizaciji:

Izravna registracija — GTIN je registriran kao identifier_type: "gtin"
Podudaranje prefiksa (Prefix-Match) — GTIN počinje s registriranim Company Prefixom (pozicija 2..N u GTIN-14)

Bez odgovarajuće registracije pojavit će se pogreška 422 s napomenom da najprije morate registrirati GTIN.

Kada mi treba oboje?

Zadatak	GS1	qr3.app
Dobivanje vlastitih GTIN-ova/GLN-ova	✅ Potrebno članstvo	—
Validacija GTIN kontrolne znamenke	—	✅ API + Dashboard
Generiranje QR koda za proizvod	—	✅
Izrada DPP-a prema EU uredbi	—	✅
Razlučivanje GS1 Digital Linka	—	✅ Resolver + `/.well-known/gs1resolver`
Registracija u EU registru	Planirano (Q4 2026)	Planirano (Faza 4c)

API referenca

POST /v1/gs1/identifiers — Registracija
GET /v1/gs1/identifiers — Popisivanje
DELETE /v1/gs1/identifiers/:id — Uklanjanje
POST /v1/gs1/validate — Validacija (bez registracije, bez autorizacije)

Pogledajte API dokumentaciju za detalje.