O que é ZPL? – Estrutura, unidades e a etiqueta básica

ZPL (Zebra Programming Language) é o idioma de impressão da Zebra e de muitas outras impressoras térmicas de etiquetas (emulação ZPL-II: CAB, Novexx, …). Uma etiqueta é um documento de texto composto por comandos (comandos ^ e comandos ~).

Estrutura de uma etiqueta

Cada etiqueta começa com ^XA (início do formato) e termina com ^XZ (fim do formato):

^XA
^FO50,50^FDHello World^FS
^XZ

• ^FO50,50 – posição do campo (origem) em x=50 pontos, y=50 pontos
• ^FDHello World – dados do campo (o texto a ser impresso)
• ^FS – fim do campo

Unidades: pontos, mm e DPI

Todas as posições e tamanhos em ZPL são indicados em pontos. O tamanho físico depende da resolução da impressora (DPI = pontos por polegada):

DPI	Pontos por mm
203	8,0
300	11,8
600	23,6

pontos = mm × DPI / 25,4

Exemplo: etiqueta de 75 mm a 203 dpi → 75 × 203 / 25,4 = 600 pontos de largura.

Exemplo de trabalho mínimo

^XA
^PW600          ; largura de impressão em pontos (75 mm @ 203 dpi)
^LL400          ; comprimento da etiqueta em pontos (50 mm @ 203 dpi)
^FO50,50^A0N,30,30^FDHello ZplCloud^FS
^XZ

Dicas

• Os comandos não diferenciam maiúsculas de minúsculas (^xa funciona como ^XA).
• A maioria das impressoras ignora silenciosamente comandos desconhecidos: verifique antes de imprimir com o linter ZPL.
• Termine cada texto com ^FS; um ^FS esquecido «engole» o próximo comando.