GS1-identifierare & onboarding

qr3.app bygger på en BYO-GTIN/BYO-GLN-modell (Bring Your Own): Du tar med dina befintliga GS1-identifierare — qr3 hanterar det digitala produktlagret ovanpå.

Vad gör GS1?

GS1 tilldelar globalt unika identifierare för produkter och platser:

Identifierare	Beskrivning	Exempel
GTIN-14	Global Trade Item Number (produkt-ID)	`04012345678901`
GLN-13	Global Location Number (plats/företag)	`4012345000009`
Company Prefix	Företagsprefix (7–12 tecken), från vilket GTINs härleds	`4012345`

För att få GTINs behöver du ett GS1-medlemskap hos din nationella GS1-organisation (t.ex. GS1 Austria, GS1 Germany).

Vad gör qr3.app?

qr3.app använder dina befintliga GS1-identifierare och erbjuder:

GS1-kompatibel resolver — /01/{GTIN}/21/{Serial} med content negotiation
EU Digital Product Passport — DPP-skapande, validering, konsumentvy
Tryckfärdiga QR-resurser — SVG, PNG, vektor-PDF, EPS
JSON-LD, DCAT-AP — Maskinläsbara produktdata

Onboarding-flöde

1. Registrera GS1-identifierare

Innan du kan skapa DPPs måste du registrera dina GTINs (eller ditt Company Prefix):

Via 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 dashboarden:

Navigera till Dashboard → GS1
Välj typ (GTIN, GLN eller Company Prefix)
Ange värdet — kontrollsiffervalideringen sker automatiskt
Klicka på Lägg till identifierare

2. Skapa DPPs

Så snart ett GTIN är registrerat (direkt eller via ett Company Prefix) kan du skapa DPPs 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. Ägarskapskontroll

qr3.app kontrollerar vid varje DPP-skapande om det använda GTIN-numret tillhör din organisation:

Direkt registrering — GTIN-numret är registrerat som identifier_type: "gtin"
Prefix-matchning — GTIN-numret börjar med ett registrerat Company Prefix (position 2..N i GTIN-14)

Utan en matchande registrering returneras ett 422-fel med ett meddelande om att registrera GTIN-numret först.

När behöver jag båda?

Uppgift	GS1	qr3.app
Erhålla egna GTINs/GLNs	✅ Medlemskap krävs	—
Validera GTIN-kontrollsiffra	—	✅ API + Dashboard
Generera QR-kod för produkt	—	✅
Skapa DPP enligt EU-förordning	—	✅
Resolva GS1 Digital Link	—	✅ Resolver + `/.well-known/gs1resolver`
Registrera i EU-registret	Planerat (Q4 2026)	Planerat (Fas 4c)

API-referens

POST /v1/gs1/identifiers — Registrera
GET /v1/gs1/identifiers — Lista
DELETE /v1/gs1/identifiers/:id — Ta bort
POST /v1/gs1/validate — Validera (utan registrering, ingen autentisering)

Se API-dokumentationen för mer information.