GS1-Identifikatoren & Onboarding

qr3.app setzt auf ein BYO-GTIN/BYO-GLN-Modell (Bring Your Own): Du bringst deine bestehenden GS1-Identifikatoren mit — qr3 übernimmt den digitalen Product-Layer darüber.

Was macht GS1?

GS1 vergibt weltweit eindeutige Identifikatoren für Produkte und Standorte:

Identifikator	Beschreibung	Beispiel
GTIN-14	Global Trade Item Number (Produkt-ID)	`04012345678901`
GLN-13	Global Location Number (Standort/Firma)	`4012345000009`
Company Prefix	Firmen-Präfix (7-12 Stellen), aus dem GTINs abgeleitet werden	`4012345`

Um GTINs zu erhalten, brauchst du eine GS1-Mitgliedschaft bei deiner nationalen GS1-Organisation (z. B. GS1 Austria, GS1 Germany).

Was macht qr3.app?

qr3.app nutzt deine vorhandenen GS1-Identifikatoren und bietet:

GS1-konformer Resolver — /01/{GTIN}/21/{Serial} mit Content-Negotiation
EU Digital Product Passport — DPP-Erstellung, Validierung, Consumer-Ansicht
Druckfertige QR-Assets — SVG, PNG, Vektor-PDF, EPS
JSON-LD, DCAT-AP — Maschinenlesbare Produktdaten

Onboarding-Flow

1. GS1-Identifikatoren registrieren

Bevor du DPPs erstellen kannst, musst du deine GTINs (oder deinen Company Prefix) registrieren:

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

Per Dashboard:

Navigiere zu Dashboard → GS1
Wähle den Typ (GTIN, GLN oder Company Prefix)
Gib den Wert ein — die Check-Digit-Validierung erfolgt automatisch
Klicke Identifikator hinzufügen

2. DPPs erstellen

Sobald eine GTIN registriert ist (direkt oder über einen Company Prefix), kannst du DPPs damit anlegen:

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. Ownership-Prüfung

qr3.app prüft bei jeder DPP-Erstellung, ob die verwendete GTIN zu deiner Organisation gehört:

Direkte Registrierung — Die GTIN ist als identifier_type: "gtin" registriert
Prefix-Match — Die GTIN beginnt mit einem registrierten Company Prefix (Position 2..N der GTIN-14)

Ohne passende Registrierung gibt es einen 422-Fehler mit dem Hinweis, die GTIN zuerst zu registrieren.

Wann brauche ich beides?

Aufgabe	GS1	qr3.app
Eigene GTINs/GLNs erhalten	✅ Mitgliedschaft nötig	—
GTIN-Check-Digit validieren	—	✅ API + Dashboard
QR-Code für Produkt erzeugen	—	✅
DPP nach EU-Verordnung erstellen	—	✅
GS1 Digital Link auflösen	—	✅ Resolver + `/.well-known/gs1resolver`
In der EU-Registry registrieren	Geplant (Q4 2026)	Geplant (Phase 4c)

API-Referenz

POST /v1/gs1/identifiers — Registrieren
GET /v1/gs1/identifiers — Auflisten
DELETE /v1/gs1/identifiers/:id — Entfernen
POST /v1/gs1/validate — Validieren (ohne Registrierung, kein Auth)

Siehe API-Dokumentation für Details.