GS1-identificatoren & onboarding

GS1-identificatoren & onboarding

qr3.app maakt gebruik van een BYO-GTIN/BYO-GLN-model (Bring Your Own): je brengt je bestaande GS1-identificatoren mee — qr3 verzorgt de digitale productlaag daarbovenop.

Wat doet GS1?

GS1 kent wereldwijd unieke identificatoren toe voor producten en locaties:

Identificator	Beschrijving	Voorbeeld
GTIN-14	Global Trade Item Number (product-ID)	04012345678901
GLN-13	Global Location Number (locatie/bedrijf)	4012345000009
Company Prefix	Bedrijfsprefix (7-12 cijfers), waarvan GTIN’s worden afgeleid	4012345

Om GTIN’s te verkrijgen, heb je een GS1-lidmaatschap nodig bij je nationale GS1-organisatie (bijv. GS1 Austria, GS1 Germany).

Wat doet qr3.app?

qr3.app gebruikt je bestaande GS1-identificatoren en biedt:

• GS1-conforme resolver — /01/{GTIN}/21/{Serial} met content-negotiation
• EU Digital Product Passport — DPP-creatie, validatie, consumentenweergave
• Drukklare QR-assets — SVG, PNG, vector-PDF, EPS
• JSON-LD, DCAT-AP — Machineleesbare productgegevens

Onboarding-flow

1. GS1-identificatoren registreren

Voordat je DPP’s kunt maken, moet je je GTIN’s (of je Company Prefix) registreren:

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 het dashboard:

1. Navigeer naar Dashboard → GS1
2. Kies het type (GTIN, GLN of Company Prefix)
3. Voer de waarde in — de controlecijfervalidatie (check-digit) gebeurt automatisch
4. Klik op Identificator toevoegen

2. DPP’s maken

Zodra een GTIN is geregistreerd (direct of via een Company Prefix), kun je hiermee DPP’s aanmaken:

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

qr3.app controleert bij elke DPP-creatie of de gebruikte GTIN bij jouw organisatie hoort:

1. Directe registratie — De GTIN is geregistreerd als identifier_type: "gtin"
2. Prefix-match — De GTIN begint met een geregistreerde Company Prefix (positie 2..N van de GTIN-14)

Zonder geldige registratie treedt er een 422-fout op met de melding om de GTIN eerst te registreren.

Wanneer heb ik beide nodig?

Taak	GS1	qr3.app
Eigen GTIN’s/GLN’s verkrijgen	✅ Lidmaatschap vereist	—
GTIN-controlecijfer valideren	—	✅ API + dashboard
QR-code voor product genereren	—	✅
DPP conform EU-verordening maken	—	✅
GS1 Digital Link resolven	—	✅ Resolver + /.well-known/gs1resolver
Registreren in de EU-registry	Gepland (Q4 2026)	Gepland (Fase 4c)

API-referentie

• POST /v1/gs1/identifiers — Registreren
• GET /v1/gs1/identifiers — Weergeven
• DELETE /v1/gs1/identifiers/:id — Verwijderen
• POST /v1/gs1/validate — Valideren (zonder registratie, geen auth)

Zie de API-documentatie voor details.