La mayoría de las explicaciones sobre los códigos QR del Pasaporte Digital de Producto se quedan en "escanea el código, abre una web". Eso pasa por alto lo interesante. El código QR de un producto conforme codifica un GS1 Digital Link, y el componente que lo hace útil es el resolver: el servicio que convierte un único identificador de producto en muchas respuestas distintas y adaptadas al contexto.
Este artículo muestra lo que realmente hace el resolver, con un pasaporte en vivo al que puedes llamar ahora mismo (sin registro, sin clave).
Qué es realmente un GS1 Digital Link
Un GS1 Digital Link es una URL HTTPS normal que incrusta identificadores GS1 como segmentos de ruta, cada uno etiquetado con un Application Identifier (AI):
https://id.gs1.org/01/04019999999902/21/DEMO-BAT-01
└─01─┘ └──GTIN───┘ └21┘ └─serial─┘
01→ GTIN (Global Trade Item Number) — qué producto21→ número de serie — qué unidad individual10→ lote/partida (alternativa al número de serie)
Como es una URL normal, cualquier cámara de teléfono la abre. Como está estructurada, las máquinas pueden analizarla. Esa doble naturaleza es precisamente lo importante.
El resolver: una URI, muchas respuestas
Un código QR tonto devuelve una única página fija. Un resolver inspecciona la petición y devuelve la representación que mejor encaja con quien la solicita:
- un consumidor con el navegador del teléfono obtiene una página HTML legible para humanos;
- el sistema de un reciclador pide JSON-LD y obtiene datos estructurados legibles por máquina;
- una autoridad puede solicitar el linkset completo: cada enlace tipado que expone el producto.
La misma URL, respuestas distintas, decididas por la cabecera Accept (o una anulación con ?format=).
Un resolver en vivo al que puedes llamar ahora mismo
qr3.app aloja un pasaporte de batería de demostración público. Ábrelo en un navegador:
Verás la página de consumidor de EcoMax 5000 (Demo) de GreenPower GmbH. Ahora pide a la misma URL el JSON-LD legible por máquina:
curl "https://qr3.app/dpp/04019999999902/DEMO-BAT-01?format=jsonld"
{
"@context": ["https://schema.org", "https://gs1.org/voc/"],
"@type": "Product",
"gtin": "04019999999902",
"name": "EcoMax 5000 (Demo)"
}
Eso es el resolver haciendo su trabajo: un identificador, una página para humanos y un documento JSON-LD construido sobre schema.org + el vocabulario web de GS1. Otras representaciones están disponibles del mismo modo — ?format=json (pasaporte en bruto), ?format=linkset (todos los enlaces tipados), ?format=dcat-ap — o mediante la negociación estándar con Accept (Accept: application/ld+json).
Valida los identificadores antes de acuñar enlaces
Un resolver es solo tan fiable como los identificadores que hay detrás. Valida un GTIN antes de construir un Digital Link para él:
import { QR3 } from "@qr3/sdk";
const client = new QR3({ apiKey: process.env.QR3_API_KEY! });
const result = await client.gs1.validateGs1({
identifier_type: "gtin",
value: "04019999999902",
});
console.log(result.valid); // true
console.log(result.detail); // "Valid GTIN-14"
Registra tus GTIN
Mantén bajo control los identificadores que usas para que cada Digital Link se remonte a un producto conocido:
const gtin = await client.gs1.createGs1Identifier({
identifier_type: "gtin", // or "gln" | "company_prefix"
value: "04019999999902",
label: "EcoMax 5000",
});
Usar qr3 como tu resolver
No tienes que construir ni operar un resolver tú mismo. Apunta el código QR de tu producto al Digital Link, aloja el pasaporte en qr3.app y el resolver sirve la representación correcta en cada petición. El GTIN/número de serie de la URL permanecen estables para siempre (de modo que las etiquetas impresas nunca dejan de funcionar), mientras que los datos que hay detrás siguen siendo actualizables.
Preguntas frecuentes
¿El propio código QR es diferente de uno normal? No: es un QR (o Data Matrix) estándar que contiene una URL de GS1 Digital Link. Cualquier cámara lo abre; la inteligencia está en el resolver, no en el símbolo.
¿De verdad consumidores y recicladores obtienen contenidos distintos?
Sí: eso es la negociación de contenido. El navegador obtiene HTML; un sistema que solicita application/ld+json (o ?format=jsonld) obtiene datos estructurados desde la misma URL.
¿Puedo mantener mi propia página de producto y seguir siendo conforme?
Sí. El Digital Link puede exponer múltiples enlaces tipados (un linkset): tu página de marketing, el pasaporte oficial, una ficha técnica de reciclaje, cada uno etiquetado con un tipo de enlace.
Fuentes
Prueba el pasaporte en vivo de arriba y luego empieza gratis y resuelve el tuyo.
