Identificadores GS1 y Onboarding

qr3.app se basa en un modelo BYO-GTIN/BYO-GLN (Bring Your Own): tú aportas tus identificadores GS1 existentes y qr3 se encarga de la capa digital de producto (Product-Layer) sobre ellos.

¿Qué hace GS1?

GS1 asigna identificadores únicos a nivel mundial para productos y ubicaciones:

Identificador	Descripción	Ejemplo
GTIN-14	Global Trade Item Number (ID de producto)	`04012345678901`
GLN-13	Global Location Number (Ubicación/empresa)	`4012345000009`
Company Prefix	Prefijo de empresa (7-12 dígitos), del cual se derivan los GTIN	`4012345`

Para obtener GTIN, necesitas una afiliación a GS1 en tu organización nacional de GS1 (por ejemplo, GS1 Austria, GS1 Alemania).

¿Qué hace qr3.app?

qr3.app utiliza tus identificadores GS1 existentes y ofrece:

Resolver compatible con GS1 — /01/{GTIN}/21/{Serial} con negociación de contenido (Content-Negotiation)
Pasaporte Digital de Producto de la UE (DPP) — Creación de DPP, validación, vista del consumidor
Recursos QR listos para imprimir — SVG, PNG, PDF vectorial, EPS
JSON-LD, DCAT-AP — Datos de producto legibles por máquina

Flujo de onboarding

1. Registrar identificadores GS1

Antes de poder crear DPP, debes registrar tus GTIN (o tu Company Prefix):

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

Por panel de control (Dashboard):

Navega a Dashboard → GS1
Selecciona el tipo (GTIN, GLN o Company Prefix)
Introduce el valor; la validación del dígito de control (Check-Digit) se realiza automáticamente
Haz clic en Añadir identificador

2. Crear DPP

Una vez que se ha registrado un GTIN (directamente o a través de un Company Prefix), puedes crear DPP con él:

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. Verificación de propiedad

qr3.app comprueba en cada creación de DPP si el GTIN utilizado pertenece a tu organización:

Registro directo — El GTIN está registrado como identifier_type: "gtin"
Coincidencia de prefijo (Prefix-Match) — El GTIN comienza con un Company Prefix registrado (posiciones 2..N del GTIN-14)

Sin un registro coincidente, se producirá un error 422 indicando que primero se debe registrar el GTIN.

¿Cuándo necesito ambos?

Tarea	GS1	qr3.app
Obtener tus propios GTIN/GLN	✅ Requiere afiliación	—
Validar el dígito de control del GTIN	—	✅ API + Dashboard
Generar código QR para el producto	—	✅
Crear DPP según el reglamento de la UE	—	✅
Resolver GS1 Digital Link	—	✅ Resolver + `/.well-known/gs1resolver`
Registrar en el registro de la UE	Planificado (Q4 2026)	Planificado (Fase 4c)

Referencia de la API

POST /v1/gs1/identifiers — Registrar
GET /v1/gs1/identifiers — Listar
DELETE /v1/gs1/identifiers/:id — Eliminar
POST /v1/gs1/validate — Validar (sin registro, sin autenticación)

Consulta la documentación de la API para más detalles.