ZPL imprime una etiqueta en blanco

Una etiqueta ZPL imprime en blanco cuando cada campo cae fuera de la etiqueta, cuando el formato nunca se cierra con ^XZ, o cuando ningún campo tiene datos. Verifique que los campos se ajusten a la etiqueta en puntos, que cada etiqueta tenga ^XA y ^XZ, y que cada campo tenga ^FD y ^FS.

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

Lo que ve

La impresora alimenta una etiqueta sin nada en ella, o la vista previa está vacía.

Campos en y = 500 en una etiqueta de 406 puntos

^XA
^FO40,500^A0N,50,50^FDALEX MORGAN^FS
^FO40,580^A0N,40,40^FDAUSTIN, TX 78701^FS
^XZ

Campos dentro de la etiqueta

^XA
^FO40,60^A0N,50,50^FDALEX MORGAN^FS
^FO40,140^A0N,40,40^FDAUSTIN, TX 78701^FS
^XZ

Causas en el ZPL

1. Campos fuera de la etiqueta. La etiqueta anterior fue diseñada para 4 × 6 pulgadas y enviada a una impresora de 4 × 2: y = 500 está más allá del borde inferior (406 puntos a 203 dpi), por lo que no se dibuja nada. Lo mismo ocurre con las coordenadas para 300 dpi en una impresora de 203 dpi, o un gran ^LH que mueve el origen fuera de la etiqueta.
2. No ^XZ. Without the end of format the printer keeps waiting for the rest of the label and prints nothing; the next ^XA may merge two labels. The OpenZPL API answers 404 with No labels found in the ZPL and X-Total-Count: 0 in this case, as Labelary does.
3. Campos sin datos. Un campo con ^FO y ^A pero sin ^FD, o un ^FD vacío porque una variable de plantilla estaba vacía, no dibuja nada. Una etiqueta hecha solo de tales campos está en blanco; la API de OpenZPL responde igual con 404.
4. Texto del mismo color que el fondo. Un campo ^FR sobre nada, o texto blanco sobre una caja blanca, se renderiza pero no se puede ver.

Una etiqueta con ^XA^XZ y nada entre ellos es un ZPL válido para una impresora, que alimenta una etiqueta en blanco. La API de OpenZPL lo trata como un error en lugar de devolver una imagen vacía, por lo que un error de plantilla aparece en sus registros.

Causas en la impresora

Si la vista previa muestra la etiqueta y la impresora la alimenta en blanco, el ZPL no es el problema:

• Tipo de medio incorrecto. Las etiquetas térmicas directas no necesitan cinta; las etiquetas de transferencia térmica no imprimen nada sin una. Verifique la configuración del tipo de medio de la impresora con respecto a sus etiquetas.
• Cinta cargada de forma incorrecta, o el lado de la tinta lejos de la etiqueta.
• Etiquetas al revés: el papel térmico directo está recubierto solo de un lado. Rasguñelo con una uña: el lado que se oscurece está frente al cabezal de impresión.
• Oscuridad en el mínimo, o un cabezal de impresión que necesita limpieza.

Cómo encontrarlo

1. Pegue el ZPL en el visor de ZPL con el tamaño y densidad de la etiqueta de la impresora. Si la vista previa está vacía o la API informa que no hay etiquetas, es el ZPL.
2. Mire los valores más grandes de ^FO en comparación con el tamaño de la etiqueta en puntos (tamaños de etiquetas).
3. Envía una etiqueta conocida como válida, por ejemplo ^XA^FO50,50^A0N,50,50^FDTEST^FS^XZ. Si eso también imprime en blanco, es la impresora o los medios.