Código QR ZPL — Guía completa del comando ^BQ

¿Qué es un código QR en ZPL?

Un código QR en ZPL es un código de barras bidimensional generado por el comando ^BQ — una de las simbologías más potentes que soportan las impresoras Zebra. Un solo QR puede almacenar hasta 4,296 caracteres alfanuméricos o 7,089 dígitos numéricos, soporta corrección Reed–Solomon (sigue siendo legible aunque esté dañado o sucio parcialmente) y se lee con cualquier cámara de smartphone o escáner industrial. Por eso es la elección universal para URLs de tracking, tarjetas vCard, identificadores GS1, credenciales WiFi, tickets de transporte y cualquier payload que supere los 20 caracteres óptimos para 1D.

En ZPL, el QR vive dentro de un formato ^XA..^XZ como cualquier otro campo. Lo posicionas con ^FO o ^FT, lo declaras con ^BQ y en ^FD antepones dos caracteres antes de la coma y los datos: el primero es el nivel de corrección de errores (H, Q, M o L) y el segundo es el modo de entrada (A = selección de codificación automática, M = segmentos manuales). Para la mayoría de los casos de producción escribes ^FDHA,datos^FS — alta recuperación, codificación automática. No hay paso ^BY separado porque el tamaño del módulo se controla directamente con el parámetro de magnificación — valores típicos son 4 a 8 en una etiqueta 4×6 pulgadas a 203 dpi. El parámetro de modelo siempre debe ser 2 (modelo 1 es legado y no se recomienda para diseños nuevos).

Sintaxis del comando ^BQ

La declaración mínima de QR toma 3 parámetros después de ^BQ — orientación, modelo y magnificación. El nivel de corrección de errores y el modo de entrada van dentro de ^FD como un prefijo de 2 caracteres seguido de coma (ver Formato del Field Data abajo). Estructura canónica:

^XA
^CI28                                ; UTF-8 para datos internacionales
^FO50,50                             ; Posición X=50, Y=50
^BQ orientación,modelo,magnificación  ; orientación N/R/I/B, modelo 2, magnif. 1-10
^FD <ECC><modo>,<payload>^FS         ; ECC = H/Q/M/L, modo = A (auto) o M (manual)
^XZ

; Línea típica de producción: alta recuperación + codificación automática
; ^FDHA,https://zplpdf.com^FS

Parámetros de ^BQ

Niveles de corrección de errores (H / Q / M / L)

La corrección Reed–Solomon permite que el QR siga siendo legible aunque parte del símbolo esté ausente o dañada. El compromiso es la capacidad: niveles más altos añaden más redundancia y dejan menos espacio para datos. El nivel se selecciona con el primer carácter del prefijo en ^FD — HA para H + auto, MA para M + auto, etc. No hay default implícito — siempre declaras el nivel explícitamente. Para envíos y exterior, HA es el punto de partida recomendado; para etiquetas interiores limpias MA ahorra espacio.

Tamaño y magnificación

El tamaño del QR en ZPL se controla con el parámetro de magnificación (1–10) — no hay paso ^BY para QR. Cada unidad multiplica el módulo (el cuadradito más pequeño del QR) por 4 dots a 203 dpi y 6 dots a 300 dpi. El tamaño total del símbolo depende de la magnificación y de la longitud del payload (más datos → más módulos → código más grande).

• Impresora 203 dpi + magnificación 5 ≈ 200×200 dots ≈ 25×25 mm con una URL de 50 chars.
• Impresora 203 dpi + magnificación 8 ≈ 320×320 dots ≈ 40×40 mm — recomendado para escaneo exterior a >50 cm.
• Impresora 300 dpi + magnificación 5 ≈ 300×300 dots ≈ 25×25 mm con una URL de 50 chars.
• Los smartphones leen magnificación 3 fiable si la URL es corta (≤25 chars) y la etiqueta está a <20 cm de la cámara.
• Prueba siempre con el escáner más lento esperado; subir la magnificación en 1 es más barato que escaneos fallidos en campo.
• Módulos menores a 0.4 mm dejan de ser legibles en escáneres de gama baja — mantén la magnificación ≥4 en impresoras de 203 dpi.

Errores comunes con QR y cómo corregirlos