TL;DR
- Una URI de GS1 Digital Link es una dirección web con una gramática fija: un dominio, una clave principal como
/01/con un GTIN de 14 dígitos, calificadores de clave opcionales en la ruta y atributos de datos en la cadena de consulta. - Sus números son identificadores de aplicación (IA) de GS1, los mismos que se usan en los códigos de barras GS1-128, así que una URI se convierte en una cadena de elementos tradicional, y viceversa, sin perder datos GS1.
- Las reglas en las que más se tropieza: GTIN completados hasta 14 dígitos con un dígito de control válido, calificadores en un orden fijo (
22,10,21), atributos solo después de?y símbolos de los valores con codificación porcentual.
Una URI de GS1 Digital Link es una dirección HTTPS que lleva identificadores GS1 en una estructura estándar, de modo que un móvil puede abrirla y un escáner puede extraer de ella los identificadores. La ruta contiene la identidad; la cadena de consulta contiene datos adicionales e instrucciones para el resolver. Para el vocabulario, consulta los conceptos básicos de GS1 Digital Link; para lo que ocurre después de un escaneo, la guía del resolver.
La sintaxis de la URI de GS1 Digital Link de un vistazo
| Patrón | https://{domain}/{key AI}/{value}/{qualifier AI}/{value}?{attribute AI}={value} |
| Identidad | En la ruta: exactamente una clave principal y, después, calificadores de clave opcionales en un orden fijo |
| Datos adicionales | En la cadena de consulta: atributos de datos como la fecha de caducidad 17 o el peso neto 310n |
| Formato del GTIN | Siempre 14 dígitos, completados con ceros a la izquierda, terminados en un dígito de control válido |
| Caracteres especiales | Con codificación porcentual: una / dentro de un número de lote se convierte en %2F |
| Instrucciones para el resolver | linkType en la cadena de consulta, como linkType=gs1:pip o linkType=linkset |
¿Cuáles son las partes de una URI de GS1 Digital Link?
Un ejemplo completo:
https://id.example.com/01/09506000134352/22/2A/10/LOT42/21/1234?17=271231&3103=000750
| Parte | En el ejemplo | Regla |
|---|---|---|
| Dominio | id.example.com | Cualquier dominio, después de https://. Decide qué resolver responde a un móvil, pero no forma parte de la identidad del producto |
| Clave principal | /01/09506000134352 | Exactamente una por URI: un IA seguido de su valor |
| Calificadores de clave | /22/2A/10/LOT42/21/1234 | Opcionales, en la ruta, en el orden fijado para esa clave |
| Atributos de datos | ?17=271231&3103=000750 | Opcionales, como pares AI=value unidos por &, en cualquier orden |
Leído de izquierda a derecha: GTIN 09506000134352, variante de producto de consumo 2A, lote LOT42, número de serie 1234, fecha de caducidad 31 de diciembre de 2027, peso neto 0,750 kg.
¿Qué claves principales puede usar un GS1 Digital Link?
El GTIN es la clave de los productos de consumo, pero la sintaxis también cubre las demás claves GS1:
| Clave GS1 | IA | Identifica | Calificadores de clave |
|---|---|---|---|
| GTIN, Global Trade Item Number | 01 | Un artículo comercial, en cualquier nivel de embalaje | 22, 10, 21 |
| SSCC, Serial Shipping Container Code | 00 | Una unidad logística, como un palé (18 dígitos) | Ninguno |
| GLN, Global Location Number | 414 | Una ubicación física (13 dígitos) | 254, componente de extensión del GLN |
Las claves de activos, como el GRAI (8003) y el GIAI (8004), siguen el mismo patrón.
¿Cómo funcionan los calificadores de clave de un GTIN?
Los calificadores de clave acotan un GTIN de un producto a una variante, un lote o una sola unidad. Van en la ruta, en este orden:
| Orden | IA | Calificador | Formato | Identifica |
|---|---|---|---|---|
| 1 | 22 | Variante de producto de consumo (CPV) | Hasta 20 caracteres | Una variante dentro de un mismo GTIN |
| 2 | 10 | Lote | Hasta 20 caracteres | Una tirada de producción |
| 3 | 21 | Número de serie | Hasta 20 caracteres | Una unidad |
Cualquiera de ellos puede omitirse, pero los que uses mantienen ese orden:
| Ruta | ¿Válida? |
|---|---|
/01/09506000134352/10/LOT42/21/1234 | Sí |
/01/09506000134352/21/1234 | Sí: un número de serie sin lote |
/01/09506000134352/21/1234/10/LOT42 | No: el número de serie va antes del lote |
/01/09506000134352/17/271231 | No: la fecha de caducidad va en la cadena de consulta |
Un resolver usa los calificadores para encontrar su entrada más específica y, si no la hay, recurre al nivel de producto.
¿Qué atributos de datos van en la cadena de consulta?
Los atributos de datos describen el artículo sin cambiar su identidad:
| IA | Atributo | Formato | Ejemplo |
|---|---|---|---|
17 | Fecha de caducidad | AAMMDD | 17=271231: 31 de diciembre de 2027 |
15 | Fecha de consumo preferente | AAMMDD | 15=270630: 30 de junio de 2027 |
310n | Peso neto en kg, n = número de decimales | 6 dígitos | 3103=000750: 0,750 kg |
422 | País de origen | Código numérico ISO 3166 de 3 dígitos | 422=380: Italia |
Cada atributo aparece una sola vez, en cualquier orden. Un resolver transmite la cadena de consulta sin cambios cuando redirige, para que la página de destino pueda leerla.
¿Cómo se escribe un GTIN en un GS1 Digital Link?
Siempre con 14 dígitos. A los GTIN más cortos se les añaden ceros a la izquierda, que no cambian ni el número ni su dígito de control:
| GTIN bajo el código de barras | En la URI |
|---|---|
GTIN-12 (UPC-A): 614141123452 | /01/00614141123452 |
GTIN-13 (EAN-13): 9506000134352 | /01/09506000134352 |
El último dígito es un dígito de control. Para 9506000134352, multiplica los doce dígitos anteriores, empezando por la derecha, por 3, 1, 3, 1 y así sucesivamente, y súmalos: 78. El dígito de control lleva esa suma hasta el siguiente múltiplo de diez: 80 − 78 = 2.
¿Qué caracteres necesitan codificación porcentual?
Las letras, los dígitos, -, . y _ se escriben tal cual. Los demás símbolos de los valores de lote, número de serie o CPV se codifican con codificación porcentual, para que no puedan confundirse con la estructura de la dirección:
| Carácter | Se codifica como | Valor | En la URI |
|---|---|---|---|
/ | %2F | AB/12 | /10/AB%2F12 |
% | %25 | 50%OFF | /10/50%25OFF |
& | %26 | A&B | /21/A%26B |
Los valores distinguen entre mayúsculas y minúsculas, así que LOT42 y lot42 son lotes distintos, y no se admiten espacios.
¿Qué es la forma comprimida?
El estándar también define una forma comprimida para los códigos muy pequeños: todo lo que va después del dominio se condensa en una cadena corta de letras, dígitos, - y _, ilegible a simple vista, que el resolver descomprime antes de validarla. Usa la forma sin comprimir salvo que el tamaño del símbolo no te deje otra opción: es más fácil de comprobar antes de imprimir, y un código comprimido solo funciona donde todos los escáneres y las apps de tu cadena pueden descomprimirlo.
¿Cómo encajan linkType y los linksets en la URI?
linkType no es un identificador, sino una instrucción para el resolver, escrita en la cadena de consulta:
| URI | Qué devuelve el resolver |
|---|---|
https://id.example.com/01/09506000134352 | Una redirección al enlace por defecto, normalmente la página del producto |
https://id.example.com/01/09506000134352?linkType=gs1:recallStatus | Una redirección al enlace del estado de retirada, si lo hay |
https://id.example.com/01/09506000134352?linkType=linkset | La lista completa de enlaces de ese GTIN, en un formato legible por máquinas |
Los tipos de enlace proceden del GS1 Web Vocabulary, como gs1:pip (página de información del producto), gs1:instructions y gs1:allergenInfo. El idioma no se fija en la URI: el resolver lo lee de la solicitud del móvil.
¿Qué relación hay entre un GS1 Digital Link y una cadena de elementos?
Llevan los mismos datos GS1 en dos sintaxis:
| Formato | Ejemplo | Se usa en |
|---|---|---|
| Cadena de elementos | (01)09506000134352(10)LOT42(17)271231 | Los códigos de barras GS1-128 y el texto bajo los símbolos GS1 |
| URI de GS1 Digital Link | https://id.example.com/01/09506000134352/10/LOT42?17=271231 | Los códigos QR y los símbolos Data Matrix que pueden abrir los móviles |
En una cadena de elementos, los paréntesis solo aparecen en el texto impreso, y un valor de longitud variable, como un lote, termina con un carácter separador cuando le sigue otro IA; en la URI, esa función la cumplen las barras, ? y &. Al convertir una URI en una cadena de elementos se conservan todos los IA y sus valores, y se eliminan el dominio y las instrucciones para el resolver, que es lo que hace una caja preparada para 2D, sin conexión a internet. Para elegir el símbolo, consulta código QR frente a Data Matrix.
Cómo construir una URI de GS1 Digital Link válida: siete pasos
- Elige el dominio. Empieza por
https://y un dominio que controles, comoid.tumarca.com, para que los códigos sigan siendo tuyos sea cual sea el proveedor que gestione el resolver. - Elige la clave principal. Para un producto, el IA
01y su GTIN:/01/. - Escribe el GTIN con 14 dígitos. Complétalo con ceros a la izquierda y comprueba el último dígito:
9506000134352se convierte en09506000134352. - Añade, en orden, los calificadores de clave que necesites. CPV
/22/, lote/10/, número de serie/21/. - Aplica la codificación porcentual a los valores. Mantén las letras, los dígitos,
-,.y_, y codifica el resto:AB/12se convierte enAB%2F12. - Añade los atributos de datos después de
?. Escribe cada uno comoAI=value, unidos por&:?17=271231&3103=000750. - Valida antes de imprimir. Convierte la URI en una cadena de elementos y comprueba cada valor, ábrela en un navegador y después escanea el código impreso con varios móviles y un escáner 2D. La guía de solución de problemas recoge los fallos habituales.
El resultado para un lote con fecha de caducidad: https://id.tumarca.com/01/09506000134352/10/AB%2F12?17=271231.
Dónde encaja la plataforma Digital Link
Digital Link, la plataforma que está detrás de este sitio, escribe estas URI por ti. Valida cada GTIN al crear un enlace y añade el lote, el número de serie, la fecha de caducidad, el peso neto, el país de origen, la fecha de envasado o la variante de producto de consumo como variantes de un enlace, cada una con su propio conjunto de enlaces. Los códigos pueden crearse de forma masiva a partir de un archivo CSV, en tu propio subdominio o en el dominio dlink.is incluido.
Crea tu primer código QR GS1 Digital Link
Preguntas frecuentes
¿Un GS1 Digital Link necesita un GTIN de 14 dígitos?
Sí. Un GTIN-8, GTIN-12 o GTIN-13 se completa con ceros a la izquierda hasta los 14 dígitos, así que 9506000134352 se escribe /01/09506000134352. El dígito de control no cambia y debe ser válido.
¿En qué orden van los calificadores de clave?
Para un GTIN: la variante de producto de consumo 22, después el lote 10 y después el número de serie 21. Cualquiera puede omitirse, pero los que uses mantienen ese orden.
¿El dominio cambia la identidad del producto?
No. El dominio decide qué resolver responde a un móvil, pero la identidad es la clave principal y sus calificadores. El mismo GTIN bajo dos dominios es el mismo producto.
¿Qué diferencia hay entre una URI de GS1 Digital Link y una cadena de elementos?
Son los mismos datos en dos formatos. Una cadena de elementos, como (01)09506000134352(10)LOT42, es el formato de los códigos de barras GS1-128. Una URI de GS1 Digital Link los escribe como una dirección web que pueden abrir los móviles.
¿Debo usar la forma comprimida?
Solo si el símbolo es demasiado pequeño para la dirección completa. Un código comprimido solo funciona donde todos los escáneres y las apps pueden descomprimirlo.
