Referência
Referência de Comandos ZPL
19 comandos com sintaxe, tabela de parâmetros, valores padrão e um exemplo renderizado na própria página. Cada exemplo abre no visualizador com um clique.
Formato da etiqueta
- ^XAInício do FormatoPreview: parcial
Abre um formato de etiqueta. Toda etiqueta ZPL começa com ^XA, e a impressora ignora comandos de campo que chegarem antes dele.
- ^XZFim do FormatoPreview: parcial
Fecha o formato e manda a impressora imprimir e avançar a etiqueta. Sem ele, nada é impresso.
- ^PWLargura de ImpressãoPreview: exato
Define a largura imprimível em pontos. O que passar disso é cortado — a causa mais comum de etiqueta cortada de um lado.
- ^LLComprimento da EtiquetaPreview: exato
Define o comprimento da etiqueta em pontos. Em mídia contínua, é o que separa uma etiqueta da próxima.
- ^LHOrigem da EtiquetaPreview: exato
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.
Campos
- ^FOOrigem do CampoPreview: parcial
Posiciona o canto superior esquerdo do próximo campo. É o comando que você mais vai usar.
- ^FTComposição do CampoPreview: parcial
Posiciona o campo pela linha de base em vez do canto superior esquerdo, para que textos de tamanhos diferentes fiquem alinhados.
- ^FDDados do CampoPreview: exato
Fornece o conteúdo do campo — o texto, o dado do código de barras ou o conteúdo do QR.
- ^FSSeparador de CampoPreview: exato
Encerra o campo atual. Todo campo precisa de um, e um ^FS faltando faz o resto da etiqueta ser lido como parte dele.
- ^FHIndicador Hexadecimal de CampoPreview: exato
Permite que o ^FD carregue bytes escritos como _XX — o único jeito de imprimir um ^ ou um ~ literal nos dados.
- ^FRImpressão Invertida do CampoPreview: exato
Inverte o próximo campo em relação ao fundo: o preto vira branco, permitindo texto vazado dentro de um box preenchido.
- ^FXComentárioPreview: exato
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.
Texto e fontes
- ^AFonte Escalável / BitmapPreview: parcial
Seleciona fonte, tamanho e rotação do próximo campo. ^A0 é a fonte escalável usada pela maioria dos templates modernos.
- ^CFFonte Padrão AlfanuméricaPreview: parcial
Define a fonte e o tamanho usados por todos os campos seguintes que não especificarem os seus, para você parar de repetir ^A.
Códigos de barras
- ^BYPadrão do Código de BarrasPreview: parcial
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.
- ^BCCódigo de Barras Code 128Preview: parcial
Desenha um código de barras Code 128 — a simbologia que praticamente toda etiqueta de transporte usa para o código de rastreio.
- ^BQCódigo QRPreview: parcial
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.