GS1 identifikatoriai ir integracija

qr3.app naudoja BYO-GTIN / BYO-GLN modelį (angl. Bring Your Own): jūs pateikiate savo esamus GS1 identifikatorius, o qr3 pasirūpina skaitmeniniu produkto sluoksniu virš jų.

Ką daro GS1?

GS1 suteikia unikalius identifikatorius produktams ir vietoms visame pasaulyje:

Identifikatorius	Aprašymas	Pavyzdys
GTIN-14	Global Trade Item Number (produkto ID)	`04012345678901`
GLN-13	Global Location Number (vietos / įmonės ID)	`4012345000009`
Company Prefix	Įmonės prefiksas (7–12 skaitmenų), iš kurio generuojami GTIN	`4012345`

Norėdami gauti GTIN, turite turėti GS1 narystę savo šalies GS1 organizacijoje (pvz., „GS1 Austria“, „GS1 Germany“).

Ką daro qr3.app?

qr3.app naudoja jūsų turimus GS1 identifikatorius ir siūlo:

GS1 standartus atitinkantis nukreipimo įrankis (Resolver) — /01/{GTIN}/21/{Serial} su turinio derybomis (Content-Negotiation)
ES skaitmeninis produkto pasas (DPP) — DPP kūrimas, patvirtinimas, vartotojo peržiūra
Spaudai paruošti QR failai — SVG, PNG, vektorinis PDF, EPS
JSON-LD, DCAT-AP — mašininio skaitymo produktų duomenys

Integracijos eiga (Onboarding)

1. GS1 identifikatorių registravimas

Prieš kurdami DPP, turite užregistruoti savo GTIN (arba įmonės prefiksą):

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

Naudojant valdymo skydelį (Dashboard):

Eikite į Dashboard → GS1
Pasirinkite tipą (GTIN, GLN arba Company Prefix)
Įveskite reikšmę — kontrolinio skaitmens patikra (Check-Digit) atliekama automatiškai
Spustelėkite Pridėti identifikatorių

2. DPP kūrimas

Kai tik GTIN yra užregistruotas (tiesiogiai arba per įmonės prefiksą), galite kurti DPP:

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. Nuosavybės patikra

qr3.app kiekvieno DPP kūrimo metu tikrina, ar naudojamas GTIN priklauso jūsų organizacijai:

Tiesioginė registracija — GTIN yra užregistruotas kaip identifier_type: "gtin"
Prefikso atitikimas — GTIN prasideda registruotu įmonės prefiksu (GTIN-14 2..N pozicijos)

Jei atitinkamos registracijos nėra, grąžinama 422 klaida su pranešimu, kad pirmiausia reikia užregistruoti GTIN.

Kada man reikia abiejų?

Užduotis	GS1	qr3.app
Gauti savo GTIN / GLN	✅ Reikalinga narystė	—
Patvirtinti GTIN kontrolinį skaitmenį	—	✅ API + Dashboard
Sugeneruoti produkto QR kodą	—	✅
Sukurti DPP pagal ES reglamentą	—	✅
Iššifruoti (nukreipti) GS1 Digital Link	—	✅ Resolver + `/.well-known/gs1resolver`
Registruoti ES registre	Planuojama (2026 m. IV ketv.)	Planuojama (4c etapas)

API nuorodos

POST /v1/gs1/identifiers — Registruoti
GET /v1/gs1/identifiers — Sąrašas
DELETE /v1/gs1/identifiers/:id — Pašalinti
POST /v1/gs1/validate — Patvirtinti (be registracijos, nereikia autorizacijos)

Išsamesnės informacijos ieškokite API dokumentacijoje.