O que é ZPL? Guia da linguagem Zebra para iniciantes
Você baixa uma etiqueta de envio e vê ^XA e ^FO em vez de uma imagem. Isso é ZPL: instruções que uma impressora compatível transforma em texto, códigos de barras e gráficos. Você pode ler e visualizar essas instruções antes de enviar qualquer coisa à impressora.
O que é ZPL?
ZPL significa Zebra Programming Language, uma linguagem de comandos desenvolvida pela Zebra para impressoras de etiquetas. Hoje, ZPL geralmente se refere a ZPL II, a versão posterior documentada nos manuais atuais. Ela descreve onde posicionar texto, qual código de barras desenhar e como adicionar imagens, em etiquetas de envio, produtos e estoque.
Com os prefixos padrão, comandos de formato começam com ^ e comandos de controle com ~. Um formato de etiqueta começa com ^XA e termina com ^XZ. São instruções, não um PDF ou uma fotografia: um renderizador ou impressora compatível as interpreta para criar a etiqueta.
Como é o código ZPL?
Este exemplo mínimo coloca a palavra Hello em uma etiqueta. Copie apenas o bloco de código para o visualizador; as explicações ficam separadas para que o código esteja pronto para uso.
^XA
^FO50,50
^A0N,40,40
^FDHello^FS
^XZ| Comando | O que faz |
|---|---|
^XA | Inicia um novo formato de etiqueta. |
^FO50,50 | Define a origem do campo em x = 50, y = 50 pontos de impressão em relação à origem da etiqueta. |
^A0N,40,40 | Seleciona a fonte 0, orientação normal (N), com altura e largura solicitadas de 40 pontos de impressão, não 40 pontos tipográficos. |
^FDHello^FS | ^FD fornece o texto Hello; ^FS encerra esse campo. |
^XZ | Encerra o formato. Neste trabalho simples, a impressora pode então produzir a etiqueta. |
Posições e dimensões de fonte estão em pontos de impressão, não milímetros. A 203 DPI, 50 pontos equivalem a cerca de 6,3 mm; a 300 DPI, cerca de 4,2 mm. O exemplo pressupõe origem e orientação habituais e não configura tamanho, sensor de mídia ou calibração. Selecione tamanho e DPI reais no visualizador e configure a impressora separadamente.
O que é um arquivo .zpl?
Um arquivo .zpl típico é texto simples contendo esses comandos, às vezes com vários formatos de etiqueta. A extensão indica o uso previsto, mas não transforma o arquivo em imagem. Abra no Bloco de Notas, VS Code ou outro editor de texto para ler as instruções.
Para ver a etiqueta em vez do código, abra o arquivo em um visualizador ZPL. Salve as alterações como texto simples, não como documento do Word. Renomear um PDF para .zpl não faz conversão. Alguns fluxos ZPL contêm dados binários de gráficos ou fontes; nem todo trabalho é inteiramente legível como texto.
O que você pode fazer com ZPL?
Comece com o exemplo e escolha a ferramenta para a próxima etapa. A prévia permite conferir o layout; a impressão física também exige uma impressora compatível, a mídia correta e uma conexão funcionando.
Visualizar uma etiqueta
Abra um arquivo .zpl ou cole código para ver o layout sem impressora física.
Abrir visualizador ZPLExportar para PDF
Crie um PDF para compartilhar ou imprimir em um fluxo baseado em documentos.
Converter ZPL para PDFAdicionar um logo
Transforme uma imagem em dados gráficos ZPL e insira na etiqueta.
Converter imagem para ZPLPara logos, ^GFA é o comando de campo gráfico ^GF com A selecionando dados ASCII hexadecimais. Depois vêm contagens de bytes, bytes por linha e dados de imagem codificados, não o nome de um PNG. O conversor prepara um gráfico monocromático. ^BC gera códigos de barras Code 128; ^BQ gera códigos QR.
Imprimir a etiqueta
Envie ZPL como instruções diretas por software ou utilitário compatível, como Zebra Setup Utilities para modelos suportados. Imprimir pelo editor de texto pode imprimir o próprio código. Confira linguagem, tamanho e DPI e teste uma etiqueta antes de um lote. A prévia no navegador não estabelece conexão com a impressora.
ZPL e outras linguagens de impressora
EPL e TSPL são outras linguagens de etiquetas com sintaxes diferentes. Um equipamento pode aceitar várias por firmware ou emulação, mas renomear o arquivo não traduz comandos. Compare ZPL e EPL antes de reutilizar um modelo em outra impressora.
Perguntas frequentes
ZPL é gratuito ou de código aberto?
Você pode escrever ZPL em um editor de texto e consultar a documentação pública da Zebra. Isso não torna ZPL um projeto de software de código aberto. Editores, conversores, fontes e programas têm licenças próprias e podem ser gratuitos ou pagos.
Preciso de uma impressora Zebra?
Não precisa de impressora para ler, editar ou visualizar ZPL. Para impressão direta, use uma Zebra ou outro equipamento que suporte explicitamente os comandos necessários. A emulação depende do modelo e firmware. Um PDF exportado também pode ser impresso por um fluxo de PDF.
Como abro um arquivo .zpl?
Use um editor de texto para ler os comandos ou abra o arquivo no visualizador ZPL para renderizar a etiqueta. Selecione o tamanho e os DPI previstos para uma prévia útil.
Qual é a diferença entre ZPL e ZPL II?
ZPL II é a versão posterior da linguagem ZPL original da Zebra. É comum abreviar ZPL II como ZPL. Para novos modelos, siga a documentação ZPL II compatível com seu equipamento; não suponha que todos os comandos antigos ou modos se comportem de forma idêntica.
Referências oficiais
Sobre o autor
Eduard Diaz
Eduard Diaz é técnico de TI (desenvolvimento) na S-IE, parceira oficial da Zebra com mais de 20 anos oferecendo serviços de identificação e etiquetagem. Ele desenvolve e mantém o EditorZPL para facilitar o trabalho com ZPL e impressoras de etiquetas Zebra.
s-ie.cat