GS1-identifikatorer & onboarding

GS1-identifikatorer & onboarding

qr3.app er baseret på en BYO-GTIN/BYO-GLN-model (Bring Your Own): Du medbringer dine eksisterende GS1-identifikatorer — qr3 overtager det digitale produktlag ovenpå.

Hvad gør GS1?

GS1 udsteder globalt unikke identifikatorer til produkter og lokationer:

Identifikator	Beskrivelse	Eksempel
GTIN-14	Global Trade Item Number (Produkt-ID)	04012345678901
GLN-13	Global Location Number (Lokation/Virksomhed)	4012345000009
Company Prefix	Virksomhedspræfiks (7-12 cifre), som GTIN’er afledes fra	4012345

For at få GTIN’er skal du have et GS1-medlemskab hos din nationale GS1-organisation (f.eks. GS1 Denmark, GS1 Germany).

Hvad gør qr3.app?

qr3.app bruger dine eksisterende GS1-identifikatorer og tilbyder:

• GS1-kompatibel resolver — /01/{GTIN}/21/{Serial} med Content-Negotiation
• EU Digital Product Passport — DPP-oprettelse, validering, forbrugervisning
• Trykklare QR-aktiver — SVG, PNG, vektor-PDF, EPS
• JSON-LD, DCAT-AP — Maskinlæsbare produktdata

Onboarding-flow

1. Registrer GS1-identifikatorer

Før du kan oprette DPP’er, skal du registrere dine GTIN’er (eller dit 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"}'

Via dashboard:

1. Gå til Dashboard → GS1
2. Vælg type (GTIN, GLN eller Company Prefix)
3. Indtast værdien — kontrolciffer-valideringen sker automatisk
4. Klik på Tilføj identifikator

2. Opret DPP’er

Så snart et GTIN er registreret (direkte eller via et Company Prefix), kan du oprette DPP’er med det:

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

qr3.app kontrollerer ved hver DPP-oprettelse, om det anvendte GTIN tilhører din organisation:

1. Direkte registrering — GTIN’et er registreret som identifier_type: "gtin"
2. Præfiks-match — GTIN’et begynder med et registreret Company Prefix (position 2..N i GTIN-14)

Uden en matchende registrering returneres en 422-fejl med besked om at registrere GTIN’et først.

Hvornår har jeg brug for hvad?

Opgave	GS1	qr3.app
Få egne GTIN’er/GLN’er	✅ Medlemskab påkrævet	—
Validere GTIN-kontrolciffer	—	✅ API + Dashboard
Generere QR-kode til produkt	—	✅
Oprette DPP i henhold til EU-forordning	—	✅
Opløse GS1 Digital Link	—	✅ Resolver + /.well-known/gs1resolver
Registrere i EU-registret	Planlagt (Q4 2026)	Planlagt (Fase 4c)

API-reference

• POST /v1/gs1/identifiers — Registrer
• GET /v1/gs1/identifiers — Vis liste
• DELETE /v1/gs1/identifiers/:id — Fjern
• POST /v1/gs1/validate — Valider (uden registrering, ingen godkendelse)

Se API-dokumentation for detaljer.