Códigos QR para el DPP: tamaño, corrección de errores y GS1 (guía para desarrolladores)

El código QR de un Pasaporte Digital de Producto no es un QR cualquiera: lleva un GS1 Digital Link, tiene que sobrevivir a la impresión sobre un producto y debe resolverse hacia el pasaporte. Los detalles de ingeniería que la mayoría de las guías omiten, con código de generación listo para imprimir.

por QR3 Redaktion

Códigos QR para el DPP: tamaño, corrección de errores y GS1 (guía para desarrolladores)

El código QR de un Pasaporte Digital de Producto parece un cuadrado en blanco y negro como cualquier otro. No lo es. Tiene que llevar un GS1 Digital Link, sobrevivir a la impresión en pequeño sobre un producto curvo y susceptible de rayarse, y resolverse de forma fiable hacia el pasaporte durante toda la vida del producto. Esto es lo que realmente importa cuando generas uno: las partes que la mayoría de los artículos sobre "códigos QR para el DPP" omiten.

Un QR de DPP codifica una URL estructurada de GS1, no example.com/product/123:

https://id.gs1.org/01/04019999999902/21/DEMO-BAT-01

01 es el GTIN, 21 el número de serie. Cualquier cámara lo abre; un resolver devuelve la representación correcta según quien lo solicite (consulta The GS1 Digital Link Resolver, Explained). Apunta el QR a tu resolver y el GTIN/número de serie se mantienen estables para siempre.

Nivel de corrección de errores: elige Q o H para productos

Los códigos QR tienen cuatro niveles de corrección de errores: cuanto más alto, mayor es la parte del símbolo que puede dañarse y seguir escaneándose:

Nivel Recuperación ¿Usar en un DPP?
L ~7 % No — demasiado frágil en productos físicos
M ~15 % Solo web/pantalla
Q ~25 % — etiquetas, embalaje
H ~30 % — productos pequeños, curvos o de desgaste intenso

Una etiqueta de pasaporte puede rayarse, doblarse alrededor de una celda de batería o desgastarse parcialmente. Usa Q o H para que siga escaneándose tras un año de uso en campo. Una corrección más alta implica un símbolo más denso, así que equilíbralo con el tamaño de impresión.

Zona de silencio y tamaño mínimo de impresión

  • Zona de silencio: mantén un margen libre de al menos 4 módulos alrededor del símbolo. Sin logotipos ni texto dentro.
  • Tamaño mínimo: como regla general, el tamaño del módulo debería ser ≥ 0,33 mm para escaneos de teléfono a corta distancia; mayor si se escanea desde lejos. En una impresora de etiquetas típica de 300 DPI eso equivale aproximadamente a un símbolo de 2 × 2 cm para un Digital Link con número de serie; verifícalo con tu escáner e iluminación en el peor de los casos.

Dinámico, no estático — o no cumple

Un QR estático incrusta los datos en el símbolo. Los datos de un DPP cambian a lo largo de la vida del producto (huella de carbono recalculada, objetivo de contenido reciclado alcanzado, información de reparación actualizada). Si los datos están incrustados, no puedes actualizarlos sin reimprimir cada etiqueta, y un pasaporte desactualizado no cumple la normativa.

Por eso un QR de DPP debe ser dinámico: lleva una URL de resolver estable (GTIN/número de serie inmutables) y los datos que hay detrás se actualizan vía API. Imprime una vez, actualiza para siempre.

Genera un QR de DPP listo para imprimir (código)

Crear un pasaporte devuelve el QR en cuatro formatos, sin un paso de QR aparte:

import { QR3 } from "@qr3/sdk";

const client = new QR3({ apiKey: process.env.QR3_API_KEY! });

const passport = await client.dpp.create({
  gtin: "04019999999902",
  serial: "SN-00012345",
  product_name: "PowerCell 5 kWh LFP",
  manufacturer: "ExampleTech GmbH",
  origin_country: "DE",
  category: "battery",
  battery_data: { capacity_kwh: 5, carbon_footprint_kg: 62, recycled_content_pct: 12, recyclability_pct: 95, manufacturer_warranty_years: 8 },
});

console.log(passport.qr.svg); // vector — escala a cualquier tamaño de etiqueta, sin pixelado
console.log(passport.qr.pdf); // PDF CMYK para impresión
// qr.png para la web, qr.eps para impresoras de etiquetas profesionales

Usa SVG o EPS para etiquetas (el vector sobrevive a cualquier escalado); PNG para la web. El QR ya codifica el GS1 Digital Link hacia el pasaporte.

Productos diminutos: GS1 Data Matrix

Cuando no hay espacio para un QR (electrónica pequeña, joyería), un GS1 Data Matrix lleva el mismo Digital Link en menos espacio y está respaldado por los mismos estándares. Misma URL, símbolo más pequeño.

Preguntas frecuentes

¿Puedo añadir mi logotipo en el centro? Sí, dentro del presupuesto de corrección de errores: en el nivel Q/H un pequeño logotipo centrado es recuperable. Mantén libre la zona de silencio y haz una prueba de escaneo.

¿El QR contiene los datos del producto en sí? No: contiene el GS1 Digital Link. Los datos viven detrás del resolver y se mantienen actualizables. Eso es lo que hace que el pasaporte sea duradero.

¿SVG o PNG para etiquetas? SVG/EPS (vector) para cualquier cosa impresa: escala con nitidez a cualquier tamaño. PNG solo para uso web de tamaño fijo.

Fuentes

Empieza gratis y genera un QR de DPP listo para imprimir: app.qr3.app/sign-up