Skip to content
qr3.app Docs

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:

IdentifikatorOpisPrimer
GTIN-14Global Trade Item Number (ID izdelka)04012345678901
GLN-13Global Location Number (lokacija/podjetje)4012345000009
Company PrefixPredpona podjetja (7-12 mest), iz katere se izpeljejo GTIN-i4012345

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:

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

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

Vaša organizacija ima vsak identifikator samo enkrat, v enem od svojih delovnih prostorov. Če odstranjeni identifikator znova registrirate, se vrne (201, isti id) kot lastna izjava in nepotrjen, tudi če je bil pred odstranitvijo potrjen; če je bil v drugem delovnem prostoru, se premakne v tega. Če je še registriran, je odgovor 409 z reason already_registered (v tem delovnem prostoru) ali registered_in_other_workspace (v drugem; workspace ga navede, če ga smete odpreti). Če se delovni prostor medtem arhivira, je reason workspace_archived; nič se ne registrira.

2. Ustvarjanje DPP-jev

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

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. 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.

Enako preverjanje velja za POST /v1/dpp/batch in POST /v1/dpp/import, sinhrono in kot opravilo v vrsti: en GTIN brez registracije zavrne celotno zahtevo z 422 (naslov GTIN Not Registered, zavrnjeni GTIN v gtins, njihovo število v total); nič se ne ustvari ali uvrsti. Obstoječi potni listi niso prizadeti. Prijava potnega lista v register izdelkov EU (POST /v1/dpp/:id/register) dodatno zahteva, da organizacija potnega lista GTIN ima (glejte razdelek 4); sicer je odgovor 409 (naslov GTIN Held by Another Organization).

4. Potrditev

Registracija prek API-ja ali nadzorne plošče je lastna izjava (verified_by: "self", verified_at: null). Potrjen identifikator ima verified_at (verified_by: "gs1_registry" ali "admin"); nastavi ga qr3, ko preveri zahtevo z dokazilom (glejte spodaj). Potrjen GTIN ali predpona podjetja:

  • veže javni razreševalnik GS1 za te GTIN na vašo organizacijo, tudi če je druga organizacija prej ustvarila potni list;
  • blokira vsako drugo organizacijo: ustvarjanje DPP-ja za tak GTIN, tudi s paketom ali uvozom, vrne 409 (errors/conflict, naslov GTIN Verified by Another Organization, zavrnjeni GTIN v gtins). Paket in uvoz sta zavrnjena v celoti.

Brez potrditve GTIN pripada organizaciji, ki ga ima najdlje brez prekinitve (podrobnosti: Razreševalnik GS1). Če se vaš GTIN razreši v potni list druge organizacije, zaprosite za njegovo potrditev.

Zaprositi za potrditev

Na nadzorni plošči pod GS1, razdelek Zaprosi za potrditev: vnesite vrsto (GTIN ali predpona podjetja) in vrednost, naložite dokazilo in oddajte zahtevo. Dokazilo kaže, da ima vaša organizacija GTIN ali predpono podjetja od GS1, na primer potrdilo o licenci vaše organizacije GS1 (PDF, PNG, JPEG ali WebP). Shrani se zasebno; vidita ga samo vaša organizacija in ekipa qr3. Samodejne poizvedbe pri GS1 ni.

Ekipa qr3 preveri dokazilo in zahtevo odobri ali jo z utemeljitvijo zavrne. Po odobritvi je identifikator potrjen (verified_by: "admin") in deluje, kot je opisano zgoraj. O vsaki odločitvi prejmete e-poštno sporočilo na naslov za obvestila vaše organizacije, sicer na naslov lastnika.

  • Kdo: samo skrbniki organizacije (org_admin ali lastnik). Druge vloge in neposredni ključi API prejmejo 403. Tudi podpora qr3 ne more oddati zahteve v vašem imenu.
  • Status: pending (v pregledu), approved, rejected, withdrawn (umaknili ste jo) ali revoked (potrditev pozneje preklicana). Zahtevo v pregledu lahko umaknete.
  • 409: reason je request_pending (vaša organizacija že ima zahtevo za ta identifikator), already_verified ali verified_elsewhere (potrdila ga je druga organizacija; ni navedena). Če ima vaša organizacija zanj licenco GS1, pišite na [email protected]: qr3 preveri obe strani in lahko prekliče potrditev. Če se dokazilo spremeni med oddajo zahteve, je reason proof_changed; oddajte zahtevo znova.
  • Drug delovni prostor: pri request_pending workspace (id, name) in request_id navedeta odprto zahtevo, če smete odpreti njen delovni prostor; tam jo umaknite. Sicer sta oba null. Če se delovni prostor arhivira med oddajo zahteve, je reason workspace_archived; nič se ne odda.
  • Arhiviranje: ko se delovni prostor arhivira, se njegove zahteve v pregledu umaknejo (withdrawn, v revizijskem dnevniku z razlogom workspace archived). Dokazilo je nato spet prosto in za identifikator lahko znova zaprosite iz drugega delovnega prostora.
  • Dokazilo: dokler je zahteva v pregledu ali odobrena, datoteke ni mogoče zamenjati ali izbrisati (409, reason: "gs1_verification_proof"). Po zavrnitvi, umiku ali preklicu je spet prosta.
  • Odstranitev: potrjenega identifikatorja ni mogoče odstraniti (409, reason: "verified"). Potrditev odpravi samo qr3 s preklicem.

Kdaj potrebujem oboje?

NalogaGS1qr3.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 EUNač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)
  • POST /v1/gs1/verifications — Zaprositi za potrditev (skrbniki organizacije)
  • GET /v1/gs1/verifications — Seznam zahtev
  • GET /v1/gs1/verifications/:id — Pridobitev zahteve
  • POST /v1/gs1/verifications/:id/withdraw — Umik zahteve

Za podrobnosti si oglejte API dokumentacijo.