Códigos QR en ZPL con ^BQ

Para imprimir un código QR en ZPL, use ^BQN,2,{magnification} seguido de ^FDQA, y sus datos, por ejemplo ^FO50,50^BQN,2,6^FDQA,https://openzpl.com^FS. La magnificación (1 a 10) establece el tamaño de cada módulo en puntos, y las dos letras antes de la coma eligen el nivel de corrección de errores y el modo de entrada.

Actualizado 2026-10-20 · Renderizados hechos con el motor de OpenZPL

Generador

Datos

Ancho del módulo (puntos)

Altura (puntos)

ZPL

Copiar ZPL Abrir en el visor Descargar PNG

Generando…

Etiqueta de 4 × 2 pulgadas a 203 dpi. Una vista previa muestra cómo la impresora dibuja el código; confirme con un escáner antes de imprimir una serie.

El comando ^BQ

^BQ toma la orientación, el modelo de QR y la ampliación. Los datos van en ^FD y comienzan con dos caracteres y una coma: el nivel de corrección de errores y el modo de entrada. QA, significa corrección de errores Q y modo automático, que es correcto para casi cualquier URL o texto.

Ampliación y tamaño en puntos

Un código QR es un cuadrado de módulos, y cada módulo tiene el mismo ancho en puntos que la magnificación. https://openzpl.com con corrección de errores Q cabe en un código de módulo de 25 × 25 (versión 2). Renderizado por el motor de OpenZPL a 203 dpi mide:

Datos más largos o un nivel de corrección de errores más alto requieren más módulos: la misma URL con HA, crece a 29 × 29 módulos, 174 puntos a una ampliación de 6. A 300 dpi cada punto es más pequeño, así que la misma ampliación imprime un código más pequeño; vea 203 vs 300 dpi.

^XA
^FO50,50^BQN,2,6
^FDQA,https://openzpl.com^FS
^FO250,90^A0N,30,30^FDScan to open^FS
^FO250,130^A0N,30,30^FDopenzpl.com^FS
^XZ

Datos válidos e inválidos

El error más común es omitir el prefijo QA,. La impresora luego lee los primeros caracteres de sus datos como configuraciones, y el código escanea sin ellos. Ambos códigos a continuación escanean, pero el de la izquierda da ps://openzpl.com:

^FDhttps://… (prefijo faltante)

^XA
^FO50,50^BQN,2,6
^FDhttps://openzpl.com^FS
^XZ

^FDQA,https://… (correcto)

^XA
^FO50,50^BQN,2,6
^FDQA,https://openzpl.com^FS
^FO250,90^A0N,30,30^FDScan to open^FS
^FO250,130^A0N,30,30^FDopenzpl.com^FS
^XZ

• URL o texto: ^FDQA, luego los datos. Una página cubre ambos: una URL es solo texto que el teléfono ofrece abrir.
• Modo manual con datos alfanuméricos: ^FDMM,A luego los datos, por ejemplo ^FDMM,AOZ-2026.
• Caracteres fuera de ASCII (acentos, otros guiones): añada ^CI28 cerca de ^XA para que los datos se envíen como UTF-8; consulte caracteres acentuados.
• ^ y ~ inician un comando ZPL, por lo que no pueden aparecer en los datos tal como están; use ^FH y escapes hexadecimales, consulte caracteres especiales en los datos.

Posición: donde comienza el código

En el motor de OpenZPL, la parte superior del código QR cae por debajo de la posición ^FO debido a la altura de barra actual ^BY (10 puntos por defecto, así que ^FO50,50 dibuja el código desde y = 60). Después de un código de barras lineal con ^BY3,2,120, el siguiente código QR se movió 120 puntos hacia abajo en nuestra prueba. Si un código QR aparece más bajo de lo esperado, vuelve a poner ^BY a una altura de 10 antes de ^BQ y verifica el resultado en tu impresora.

Verifique un código de barras antes de imprimir una tanda

Una vista previa muestra cómo la impresora dibujará el código: anchos de barras, zona muerta y la línea legible por humanos. No prueba que cada escáner lo lea en su medio. Imprima una etiqueta a la densidad real y escáneela con el escáner que utiliza su cliente o transportista; para códigos de venta al por menor y logística, un verificador de códigos de barras califica la calidad de impresión.