Identifiants GS1 & Onboarding

qr3.app repose sur un modèle BYO-GTIN/BYO-GLN (Bring Your Own) : vous apportez vos identifiants GS1 existants — qr3 s’occupe de la couche produit numérique (Product-Layer) supérieure.

Que fait GS1 ?

GS1 attribue des identifiants uniques au niveau mondial pour les produits et les sites :

Identifiant	Description	Exemple
GTIN-14	Global Trade Item Number (ID produit)	`04012345678901`
GLN-13	Global Location Number (Site/Entreprise)	`4012345000009`
Company Prefix	Préfixe d’entreprise (7 à 12 chiffres), à partir duquel les GTIN sont dérivés	`4012345`

Pour obtenir des GTIN, vous devez adhérer à une organisation nationale GS1 (par ex. GS1 France, GS1 Belgique).

Que fait qr3.app ?

qr3.app utilise vos identifiants GS1 existants et propose :

Résolveur conforme GS1 — /01/{GTIN}/21/{Serial} avec négociation de contenu (Content-Negotiation)
EU Digital Product Passport — Création de DPP, validation, vue consommateur
Ressources QR prêtes à l’impression — SVG, PNG, PDF vectoriel, EPS
JSON-LD, DCAT-AP — Données de produit lisibles par machine

Flux d’onboarding

1. Enregistrer les identifiants GS1

Avant de pouvoir créer des DPP, vous devez enregistrer vos GTIN (ou votre Company Prefix) :

Via l’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 le tableau de bord :

Accédez à Tableau de bord → GS1
Sélectionnez le type (GTIN, GLN ou Company Prefix)
Saisissez la valeur — la validation du chiffre de contrôle (Check-Digit) s’effectue automatiquement
Cliquez sur Ajouter l’identifiant

2. Créer des DPP

Dès qu’un GTIN est enregistré (directement ou via un Company Prefix), vous pouvez créer des DPP avec celui-ci :

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. Vérification de propriété

qr3.app vérifie lors de chaque création de DPP si le GTIN utilisé appartient à votre organisation :

Enregistrement direct — Le GTIN est enregistré en tant que identifier_type: "gtin"
Correspondance de préfixe (Prefix-Match) — Le GTIN commence par un Company Prefix enregistré (positions 2 à N du GTIN-14)

Sans enregistrement correspondant, une erreur 422 est renvoyée avec l’indication d’enregistrer d’abord le GTIN.

Quand ai-je besoin des deux ?

Tâche	GS1	qr3.app
Obtenir ses propres GTIN/GLN	✅ Adhésion requise	—
Valider le chiffre de contrôle GTIN	—	✅ API + Tableau de bord
Générer un code QR pour le produit	—	✅
Créer un DPP selon le règlement UE	—	✅
Résoudre un GS1 Digital Link	—	✅ Résolveur + `/.well-known/gs1resolver`
S’enregistrer dans le registre de l’UE	Prévu (T4 2026)	Prévu (Phase 4c)

Référence API

POST /v1/gs1/identifiers — Enregistrer
GET /v1/gs1/identifiers — Lister
DELETE /v1/gs1/identifiers/:id — Supprimer
POST /v1/gs1/validate — Valider (sans enregistrement, pas d’authentification)

Voir la documentation de l’API pour plus de détails.