Skip to content
qr3.app Docs

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:

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

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:

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

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

Jūsu organizācijai katrs identifikators ir tikai vienreiz, vienā no tās Workspace. Ja noņemtu identifikatoru reģistrējat vēlreiz, tas atgriežas (201, tas pats id) kā pašdeklarācija un neapstiprināts, pat ja pirms noņemšanas tas bija apstiprināts; ja tas bija citā Workspace, tas pārvietojas uz šo. Ja tas joprojām ir reģistrēts, atbilde ir 409 ar reason already_registered (šajā Workspace) vai registered_in_other_workspace (citā; workspace to nosauc, ja jums ir atļauts to atvērt). Ja Workspace pa to laiku tiek arhivēts, reason ir workspace_archived; nekas netiek reģistrēts.

2. DPP izveide

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

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

Tā pati pārbaude attiecas uz POST /v1/dpp/batch un POST /v1/dpp/import, sinhroni un kā rindā ievietotu uzdevumu: viens nereģistrēts GTIN noraida visu pieprasījumu ar 422 (virsraksts GTIN Not Registered, noraidītie GTIN laukā gtins, to skaits laukā total); nekas netiek izveidots vai ievietots rindā. Esošās pases netiek skartas. Pases iesniegšanai ES produktu reģistrā (POST /v1/dpp/:id/register) papildus ir nepieciešams, lai pases organizācija turētu GTIN (skatiet 4. sadaļu); citādi atbilde ir 409 (virsraksts GTIN Held by Another Organization).

4. Apstiprināšana

Reģistrācija caur API vai paneli ir pašdeklarācija (verified_by: "self", verified_at: null). Apstiprinātam identifikatoram ir verified_at (verified_by: "gs1_registry" vai "admin"); to iestata qr3 pēc pieprasījuma ar pierādījumu pārbaudes (skatiet zemāk). Apstiprināts GTIN vai Company Prefix:

  • piesaista publisko GS1 atrisinātāju šiem GTIN jūsu organizācijai, pat ja cita organizācija pasi izveidoja agrāk;
  • bloķē jebkuru citu organizāciju: DPP izveide šādam GTIN, arī ar paketi vai importu, atgriež 409 (errors/conflict, virsraksts GTIN Verified by Another Organization, noraidītie GTIN laukā gtins). Pakete un imports tiek noraidīti pilnībā.

Bez apstiprinājuma GTIN pieder organizācijai, kurai tas ir visilgāk bez pārtraukuma (sīkāk: GS1 atrisinātājs). Ja jūsu GTIN tiek atrisināts uz citas organizācijas pasi, pieprasiet tā apstiprināšanu.

Apstiprināšanas pieprasīšana

Panelī sadaļā GS1, daļā Pieprasīt apstiprinājumu: ievadiet tipu (GTIN vai Company Prefix) un vērtību, augšupielādējiet pierādījumu un iesniedziet pieprasījumu. Pierādījums parāda, ka jūsu organizācijai ir GS1 piešķirts GTIN vai Company Prefix, piemēram, jūsu GS1 organizācijas licences apstiprinājums (PDF, PNG, JPEG vai WebP). Tas tiek glabāts privāti; to redz tikai jūsu organizācija un qr3 komanda. Automātiska vaicājuma GS1 nav.

qr3 komanda pārbauda pierādījumu un pieprasījumu apstiprina vai noraida ar pamatojumu. Pēc apstiprināšanas identifikators ir apstiprināts (verified_by: "admin") un darbojas, kā aprakstīts iepriekš. Par katru lēmumu jūs saņemat e-pastu uz jūsu organizācijas paziņojumu adresi, bet, ja tādas nav, uz īpašnieka adresi.

  • Kas: tikai organizācijas administratori (org_admin vai īpašnieks). Citas lomas un tiešās API atslēgas saņem 403. Arī qr3 atbalsts nevar iesniegt pieprasījumu jūsu vārdā.
  • Statuss: pending (pārbaudē), approved, rejected, withdrawn (jūsu atsaukts) vai revoked (apstiprinājums vēlāk anulēts). Pārbaudē esošu pieprasījumu varat atsaukt.
  • 409: reason ir request_pending (jūsu organizācijai šim identifikatoram jau ir pieprasījums), already_verified vai verified_elsewhere (to ir apstiprinājusi cita organizācija; tā netiek nosaukta). Ja jūsu organizācijai ir tā GS1 licence, rakstiet uz [email protected]: qr3 pārbauda abas puses un var anulēt apstiprinājumu. Ja pierādījums mainās, kamēr pieprasījums tiek iesniegts, reason ir proof_changed; iesniedziet pieprasījumu vēlreiz.
  • Cits Workspace: pie request_pending workspace (id, name) un request_id nosauc atvērto pieprasījumu, ja jums ir atļauts atvērt tā Workspace; atsauciet to tur. Pretējā gadījumā abi ir null. Ja Workspace tiek arhivēts, kamēr iesniedzat pieprasījumu, reason ir workspace_archived; nekas netiek iesniegts.
  • Arhivēšana: kad Workspace tiek arhivēts, tā pārbaudē esošie pieprasījumi tiek atsaukti (withdrawn, audita žurnālā ar iemeslu workspace archived). Pierādījums pēc tam atkal ir brīvs, un identifikatoru varat pieprasīt vēlreiz no cita Workspace.
  • Pierādījums: kamēr pieprasījums ir pārbaudē vai apstiprināts, failu nevar ne aizstāt, ne izdzēst (409, reason: "gs1_verification_proof"). Pēc noraidīšanas, atsaukšanas vai anulēšanas tas atkal ir brīvs.
  • Noņemšana: apstiprinātu identifikatoru nevar noņemt (409, reason: "verified"). Apstiprinājumu atceļ tikai qr3, to anulējot.

Kad man ir nepieciešams abi?

UzdevumsGS1qr3.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)
  • POST /v1/gs1/verifications — Pieprasīt apstiprinājumu (organizācijas administratori)
  • GET /v1/gs1/verifications — Pieprasījumu saraksts
  • GET /v1/gs1/verifications/:id — Iegūt pieprasījumu
  • POST /v1/gs1/verifications/:id/withdraw — Atsaukt pieprasījumu

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