O que é ZPL? Linguagem Zebra Explicada

ZPLCraft · Atualizado em 17 de agosto de 2026

ZPL (linguagem de programação Zebra) é uma linguagem de comandos usada por impressoras térmicas compatíveis para descrever etiquetas. Em vez de receber uma imagem de página pronta, uma impressora ZPL recebe comandos em texto simples, como “coloque este texto aqui, desenhe este código de barras ali, imprima uma cópia”, interpreta-os e renderiza a etiqueta usando a resolução configurada da cabeça de impressão.

O ZPL usa comandos de texto compactos que aplicativos como sistemas ERP, scripts e ferramentas de navegador podem gerar. O suporte da impressora depende do modelo e da configuração: a Zebra documenta o suporte a ZPL II nas especificações de cada modelo, e algumas impressoras de outros fabricantes oferecem um modo de emulação compatível com ZPL devidamente documentado.

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; por isso, uma divergência de DPI é uma causa 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), usada por algumas impressoras antigas ou explicitamente compatíveis. O suporte a ZPL e EPL varia conforme o modelo e o firmware; portanto, consulte a documentação do fabricante antes de escolher uma linguagem. A alternativa à saída bruta em uma linguagem de impressora é a impressão por driver, em que um driver do Windows ou do CUPS prepara uma página renderizada para a impressora configurada. O ZPL bruto pode oferecer controle direto de coordenadas e payloads de texto compactos, enquanto a impressão por driver pode ser mais adequada quando o dispositivo ou o sistema operacional não oferece um caminho compatível para ZPL bruto.

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 o problema que os editores visuais resolvem. A ZPLCraft oferece um canvas fiel ao tamanho real para posicionar textos, códigos de barras, linhas e caixas e gerar ZPL dimensionado para o DPI selecionado da impressora. Os dados, as dimensões e as zonas de silêncio dos códigos de barras ainda precisam atender aos requisitos da simbologia escolhida, e o resultado impresso deve ser verificado com a impressora e o scanner de destino. Você pode exportar o código para um sistema que já envie ZPL ou usar a impressão WebUSB pelo navegador quando o navegador, o sistema operacional e a impressora disponibilizarem uma interface compatível que possa ser reivindicada.

Perguntas básicas frequentes

ZPL é gratuito?

A Zebra publica o Guia de Programação ZPL II para consulta pública, e você pode escrever comandos ZPL em um editor de texto. O software da impressora, as fontes, o firmware e as marcas registradas podem ter termos de licença próprios.

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.

Quais impressoras são compatíveis com ZPL?

A compatibilidade depende do modelo e da configuração. Consulte as especificações do fabricante para confirmar o suporte a ZPL ou ZPL II ou um modo de emulação documentado, confirme o DPI de destino e os recursos necessários e teste o caminho de saída exato. A conectividade USB ou pela porta TCP 9100, por si só, não comprova que a impressora aceita ZPL. Compatibilidade e recomendação