O que é ZPL? Linguagem de Programação Zebra Explicada

Atualizado em 23 de junho de 2026

ZPL (linguagem de programação Zebra) é a linguagem de comandos usada por impressoras térmicas Zebra e compatíveis para descrever etiquetas. Em vez de receber uma imagem pronta como uma impressora de escritório, uma impressora ZPL recebe um pequeno bloco de texto simples — comandos que dizem "coloque este texto aqui, desenhe este código de barras ali, imprima uma cópia" — e renderiza a etiqueta ela mesma, com a resolução total da impressora, em milissegundos.

É esse design que faz o ZPL dominar a rotulagem em logística, armazéns, varejo e saúde desde os anos 1980: os dados enviados à impressora são mínimos, podem ser gerados por qualquer sistema capaz de produzir texto (um ERP, um script, um navegador), e o hardware da impressora faz o trabalho pesado. Praticamente toda impressora Zebra fabricada desde o início dos anos 1990 fala ZPL II, a revisão em uso hoje, assim como muitas impressoras de outras marcas que anunciam emulação "ZPL-compatible".

Como é uma etiqueta ZPL

Um documento ZPL é uma sequência de comandos, cada um começando com um acento circunflexo (^). Toda etiqueta fica entre ^XA (início do formato) e ^XZ (fim do formato). Aqui está uma etiqueta completa e funcional:

^XA
^CF0,40
^FO50,50^FDHELLO WORLD^FS
^FO50,110^GB700,4,4^FS
^BY3,2,100
^FO150,150^BCN,100,Y,N,N^FD12345678^FS
^XZ

Lendo linha a linha:

  • ^XA … ^XZ — abrem e fecham o formato da etiqueta. Tudo entre eles descreve uma etiqueta.
  • ^CF0,40 — define a fonte padrão para a fonte escalável 0 com 40 pontos de altura.
  • ^FO50,50 — Origem do Campo: posiciona o próximo campo a 50 pontos da esquerda e 50 pontos do topo.
  • ^FDHELLO WORLD^FS — Dados do Campo seguido de Separador de Campo: o conteúdo real do campo.
  • ^GB700,4,4 — desenha uma Caixa Gráfica com 700 pontos de largura e 4 pontos de altura — aqui usada como régua horizontal.
  • ^BY3,2,100 e depois ^BCN,100,Y,N,N — define os padrões do código de barras (largura do módulo, proporção, altura), depois renderiza um código de barras Code 128 com os dados 12345678 e uma linha legível por humanos abaixo.

Pontos, não pixels: entendendo o DPI

Cada coordenada e tamanho em ZPL é medido em pontos da impressora, e o tamanho físico de um ponto depende da resolução do cabeçote de impressão. As resoluções comuns são 203 dpi (8 pontos/mm), 300 dpi (12 pontos/mm) e 600 dpi (24 pontos/mm). Em uma impressora de 203 dpi, uma etiqueta de envio de 4 × 6 polegadas tem 812 × 1218 pontos; em uma de 300 dpi, a mesma etiqueta tem 1200 × 1800 pontos. Um ZPL escrito para uma resolução imprime menor ou maior em outra — esta é a causa mais comum de "minha etiqueta ficou errada na nova impressora" — os tamanhos precisam ser escalados para o DPI de destino.

ZPL vs. EPL vs. impressão por driver

Você também pode encontrar EPL (Eltron Programming Language), uma linguagem mais antiga e simples usada por algumas impressoras desktop legadas; impressoras Zebra modernas aceitam as duas, mas novos projetos devem usar ZPL. A alternativa a ambas é a impressão por driver, em que um driver Windows ou CUPS converte uma página renderizada em comandos de impressora para você. Drivers são convenientes para imprimir de Word ou de um visualizador de PDF, mas o ZPL bruto oferece posicionamento preciso, códigos de barras mais nítidos, payloads muito menores e a capacidade de imprimir em sistemas onde instalar drivers é impraticável — por isso softwares de etiquetas falam ZPL.

Como escrever — ou gerar — ZPL

Para uma etiqueta pontual, escrever ZPL à mão com uma referência de comandos aberta é perfeitamente viável: a linguagem é pequena e um punhado de comandos (^FO, ^FD, ^A, ^BC, ^GB) cobre a maioria das etiquetas reais. O problema começa quando você precisa iterar num layout — cada ajuste significa editar coordenadas em pontos, reenviar o arquivo e desperdiçar papel de etiqueta.

É esse problema que os editores visuais resolvem. A ZPLCraft oferece um canvas fiel ao tamanho real onde você arrasta textos, códigos de barras, linhas e caixas para o lugar certo e o ZPL correspondente é gerado para você — corretamente escalado para o DPI da sua impressora, com códigos de barras que leem. Você pode exportar o código para qualquer sistema que já envie ZPL, ou imprimir direto pelo navegador via USB sem instalar nada.

Perguntas básicas frequentes

ZPL é gratuito?

Sim. ZPL é um padrão aberto de fato: a Zebra publica o guia completo de programação ZPL II e não há nada a licenciar. Qualquer editor de texto consegue produzi-lo.

Qual extensão de arquivo o ZPL usa?

Não há extensão obrigatória — ZPL é texto simples. Você encontrará .zpl, .txt e .prn na prática; as impressoras não se importam, elas apenas consomem o fluxo de bytes.

Posso visualizar ZPL sem uma impressora?

Sim — serviços de renderização como Labelary convertem ZPL em imagem, e o editor da ZPLCraft mostra uma prévia ao vivo da etiqueta enquanto você cria, então você só gasta papel de etiqueta quando o layout estiver pronto.