Referência de Comandos ZPL

Abre um formato de etiqueta. Toda etiqueta ZPL começa com ^XA, e a impressora ignora comandos de campo que chegarem antes dele.

Fecha o formato e manda a impressora imprimir e avançar a etiqueta. Sem ele, nada é impresso.

Define a largura imprimível em pontos. O que passar disso é cortado — a causa mais comum de etiqueta cortada de um lado.

Define o comprimento da etiqueta em pontos. Em mídia contínua, é o que separa uma etiqueta da próxima.

Desloca a origem da etiqueta. Todo ^FO e ^FT seguinte passa a ser medido a partir desse ponto, e não do canto superior esquerdo.

Ativa ou desativa o modo de dados variáveis da impressora, usado com ^FV para atualizar um campo sem reenviar o formato inteiro.

Armazena um template ZPL nomeado na impressora para que etiquetas futuras recuperem o layout e enviem apenas dados variáveis.

Recupera um formato armazenado nomeado e preenche seus campos numerados com dados do trabalho atual.

Desloca horizontalmente as origens dos campos seguintes, oferecendo um ajuste global para esquerda/direita em pontos.

Desloca verticalmente as origens dos campos seguintes, oferecendo um ajuste global para cima/baixo em pontos.

Seleciona a orientação normal ou invertida para a imagem inteira da etiqueta.

Posiciona o canto superior esquerdo do próximo campo. É o comando que você mais vai usar.

Posiciona o campo pela linha de base em vez do canto superior esquerdo, para que textos de tamanhos diferentes fiquem alinhados.

Fornece o conteúdo do campo — o texto, o dado do código de barras ou o conteúdo do QR.

Marca um campo por número para que um formato armazenado receba seus dados quando a impressora o recupera.

Encerra o campo atual. Todo campo precisa de um, e um ^FS faltando faz o resto da etiqueta ser lido como parte dele.

Permite que o ^FD carregue bytes escritos como _XX — o único jeito de imprimir um ^ ou um ~ literal nos dados.

Inverte o próximo campo em relação ao fundo: o preto vira branco, permitindo texto vazado dentro de um box preenchido.

Gira um quarto, meia ou três quartos de volta todos os campos seguintes, permitindo rotacionar o template sem mexer em cada comando.

Adiciona um comentário que não é impresso. Prático para dividir o template em seções, com uma armadilha em relação ao circunflexo.

Fornece um campo de dados variáveis para um formato de impressora que usa ^MC, evitando baixar o formato inteiro a cada etiqueta.

Posiciona um valor serial que a impressora pode incrementar entre etiquetas de uma tiragem.

Seleciona fonte, tamanho e rotação do próximo campo. ^A0 é a fonte escalável usada pela maioria dos templates modernos.

Define a fonte e o tamanho usados por todos os campos seguintes que não especificarem os seus, para você parar de repetir ^A.

Quebra dados de campo em um bloco de texto com largura fixa, limite de linhas, justificação e recuo pendente opcional.

Seleciona o conjunto de caracteres ou a codificação que a impressora usa para interpretar os dados de campo seguintes.

Define largura de módulo, proporção e altura herdadas pelos códigos de barras seguintes. A largura de módulo é o que mais afeta a leitura.

Desenha um código de barras Code 128 — a simbologia que praticamente toda etiqueta de transporte usa para o código de rastreio.

Desenha um QR Code. O campo de dados exige um prefixo de modo, fácil de errar e origem frequente de símbolos ilegíveis.

O cavalo de batalha da etiqueta industrial: letras maiúsculas, dígitos e alguns símbolos, lido por qualquer leitor já fabricado.

Parente mais denso e contínuo do Code 39, capaz de carregar o ASCII inteiro — desde que o leitor esteja configurado para ele.

O código de varejo usado no Brasil e em quase todo o mundo. Você manda doze dígitos e a impressora calcula o décimo terceiro.

O EAN curto, para embalagens pequenas demais para um EAN-13: sete dígitos mais o verificador.

O código de varejo norte-americano: onze dígitos mais um verificador, num símbolo fixo de 95 módulos.

A simbologia numérica mais densa da família clássica — e a mais sujeita a leitura errada quando usada sem dígito verificador.

Simbologia numérica antiga, mantida viva por bibliotecas, bancos de sangue e sistemas de courier, com as letras A–D marcando onde o dado começa e termina.

Simbologia 2D empilhada que guarda um parágrafo, não um número — é o código das carteiras de habilitação e dos manifestos de carga.

O 2D quadrado e compacto: muito dado em poucos milímetros, legível mesmo com parte do símbolo danificada.

Desenha um box ou uma linha. Com espessura igual à altura vira uma tarja sólida — a base de todo cabeçalho invertido.

Desenha um círculo com diâmetro, espessura de borda e cor na origem atual do campo.

Desenha uma linha diagonal dentro de um campo retangular, subindo ou descendo para a direita.

Desenha uma elipse dentro de uma largura e altura, com espessura de borda e cor configuráveis.

Embute um bitmap direto na etiqueta — o comando que toda conversão de PDF ou imagem para ZPL produz.

Desenha um bitmap que foi baixado uma vez para a impressora, em vez de reenviá-lo a cada etiqueta.

Guarda um bitmap em hexadecimal ASCII na memória da impressora para que etiquetas posteriores o recuperem com ^XG sem carregar a imagem inteira.