Fundamentos

¿Qué es ZPL? – Estructura, unidades y la etiqueta básica

ZPL Zebra Programming Language es el lenguaje de impresión de Zebra y de muchos otros impresores térmicos de etiquetas emulación ZPL-II: CAB, Novexx, … . …

ZPL (Zebra Programming Language) es el lenguaje de impresión de Zebra y de muchos otros impresores térmicos de etiquetas (emulación ZPL-II: CAB, Novexx, …). Una etiqueta es un documento de texto compuesto por comandos (comandos ^ y comandos ~).

Estructura de una etiqueta

Toda etiqueta comienza con ^XA (inicio de formato) y termina con ^XZ (fin de formato):

^XA
^FO50,50^FDHello World^FS
^XZ
  • ^FO50,50 – posición del campo (origen) en x=50 dots, y=50 dots
  • ^FDHello World – datos del campo (el texto a imprimir)
  • ^FS – fin de campo

Unidades: dots, mm y DPI

Todas las posiciones y tamaños en ZPL se indican en dots. El tamaño físico depende de la resolución de la impresora (DPI = dots por pulgada):

DPIDots por mm
2038,0
30011,8
60023,6
dots = mm × DPI / 25,4

Ejemplo: etiqueta de 75 mm a 203 dpi → 75 × 203 / 25,4 = 600 dots de ancho.

Ejemplo de trabajo mínimo

^XA
^PW600          ; ancho de impresión en dots (75 mm @ 203 dpi)
^LL400          ; longitud de etiqueta en dots (50 mm @ 203 dpi)
^FO50,50^A0N,30,30^FDHello ZplCloud^FS
^XZ

Consejos

  • Los comandos no distinguen mayúsculas (^xa funciona igual que ^XA).
  • La mayoría de las impresoras ignoran silenciosamente los comandos desconocidos: comprueba antes de imprimir con el linter ZPL.
  • Termina cada texto con ^FS; un ^FS olvidado «se traga» el siguiente comando.