Código QR

Cómo generar códigos QR con ^BQ: URLs, texto y configuración de tamaño.

Probar en EditorZPL
QRcódigo 2DBQ

Código QR

El código QR es el código 2D más popular. Puede almacenar URLs, texto, datos de contacto y mucho más.

El comando ^BQ

^BQ{orientación},{modelo},{magnificación},{corrección},{máscara}
ParámetroDescripciónValores
orientaciónRotación (solo N)N
modeloVersión QR1, 2
magnificaciónTamaño del módulo1-10
correcciónNivel de errorH, Q, M, L
máscaraPatrón de máscara0-7

Usa siempre modelo 2 - es el estándar actual y más compatible.

Niveles de corrección de errores

NivelRecuperaciónUso
L7%Máxima capacidad
M15%Equilibrado (recomendado)
Q25%Alta fiabilidad
H30%Máxima resistencia a daños

El prefijo de datos

El ^FD para QR requiere un prefijo que indica el tipo de datos:

PrefijoTipoEjemplo
LAAutomático^FDLA,https://zpl.es^FS
LMManual^FDLM,B,datos^FS
LHHexadecimal^FDLH,48656C6C6F^FS

El prefijo LA (automático) es el más común y funciona para URLs, texto y la mayoría de datos.

Ejemplos básicos

QR con URL

^XA
^FO50,50
^BQN,2,5
^FDLA,https://zpl.es^FS
^XZ

QR con texto

^XA
^FO50,50
^BQN,2,6
^FDLA,Hola mundo desde ZPL^FS
^XZ

QR más grande

^XA
^FO50,50
^BQN,2,10
^FDLA,https://ejemplo.com^FS
^XZ
Ejemplo ZPL
^XA
^FO50,30^A0N,25,25^FDQR con URL:^FS
^FO50,60^BQN,2,5^FDLA,https://zpl.es^FS
^FO250,30^A0N,25,25^FDQR con texto:^FS
^FO250,60^BQN,2,5^FDLA,Hola ZPL^FS
^XZ

Diferentes tamaños

El parámetro de magnificación controla el tamaño:

^XA
^FO50,50^BQN,2,3^FDLA,Pequeño^FS
^FO150,50^BQN,2,5^FDLA,Mediano^FS
^FO300,50^BQN,2,8^FDLA,Grande^FS
^XZ

QR con alta corrección de errores

Para etiquetas que pueden dañarse:

^XA
^FO50,50
^BQN,2,5,Q,7
^FDLA,https://ejemplo.com/producto^FS
^XZ

Datos estructurados

vCard (contacto)

^XA
^FO50,50
^BQN,2,4
^FDLA,BEGIN:VCARD\0D\0AVERSION:3.0\0D\0AFN:Juan Garcia\0D\0ATEL:+34600123456\0D\0AEND:VCARD^FS
^XZ

WiFi

^XA
^FO50,50
^BQN,2,5
^FDLA,WIFI:T:WPA;S:MiRed;P:password123;;^FS
^XZ

Para datos con caracteres especiales, usa los códigos hexadecimales: \0D\0A = salto de línea.

Calcular el tamaño

El tamaño final del QR depende de:

  • Cantidad de datos
  • Nivel de corrección de errores
  • Magnificación

Fórmula aproximada:

Tamaño = (21 + 4×versión) × magnificación puntos

Para un QR versión 2 con magnificación 5:

Tamaño = (21 + 4×2) × 5 = 145 puntos ≈ 18mm
Ejemplo ZPL
^XA
^FO30,30^A0N,20,20^FDMagn. 3^FS
^FO30,55^BQN,2,3^FDLA,Test^FS
^FO130,30^A0N,20,20^FDMagn. 5^FS
^FO130,55^BQN,2,5^FDLA,Test^FS
^FO280,30^A0N,20,20^FDMagn. 7^FS
^FO280,55^BQN,2,7^FDLA,Test^FS
^XZ