Guia de Comandos ZPL

Referencia completa dos principais comandos da linguagem ZPL (Zebra Programming Language) com exemplos praticos. Use este guia para criar etiquetas profissionais e converter seu codigo ZPL em PDF para visualizacao.

Exemplo Completo de Etiqueta ZPL

Esta etiqueta demonstra os comandos mais comuns: posicionamento, texto, codigo de barras e graficos.

^XA

; --- Configuracao ---
^PW812           ; Largura: 4 polegadas (203dpi)
^LL1218          ; Altura: 6 polegadas

; --- Borda da etiqueta ---
^FO20,20
^GB772,1178,2,B^FS

; --- Logo/Titulo ---
^FO50,50
^A0N,45,45
^FDEmpresa Logistica LTDA^FS

; --- Linha separadora ---
^FO50,110
^GB712,0,2,B^FS

; --- Destinatario ---
^FO50,130
^A0N,28,28
^FDDestinatario:^FS
^FO50,170
^A0N,35,35
^FDJoao Silva^FS
^FO50,215
^A0N,25,25
^FDRua das Flores, 123 - Sao Paulo/SP^FS
^FO50,250
^A0N,25,25
^FDCEP: 01234-567^FS

; --- Codigo de barras ---
^FO50,310
^BY2,3
^BCN,120,Y,N,N
^FDBR123456789^FS

; --- QR Code ---
^FO550,310
^BQN,2,6
^FDQA,https://rastreio.exemplo.com/BR123456789^FS

; --- Peso ---
^FO50,480
^A0N,30,30
^FDPeso: 2.5 kg^FS

^XZ

Copie este codigo e converta em PDF para ver o resultado.

Comandos de Estrutura

Controlam inicio, fim e configuracao geral da etiqueta

^XA

Start Format

Inicia o formato de uma etiqueta. Obrigatorio como primeiro comando.

^XA

^XZ

End Format

Finaliza o formato da etiqueta e envia para impressao.

^XZ

^PQ

Print Quantity

Define quantidade de copias, pausas entre grupos e replicas.

^PQ3,0,1,Y  ; 3 copias

^PW

Print Width

Define largura da area de impressao em dots.

^PW812  ; 812 dots = ~4 polegadas a 203dpi

^LL

Label Length

Define comprimento da etiqueta em dots.

^LL1218  ; ~6 polegadas a 203dpi

^LH

Label Home

Define posicao de origem (0,0) da etiqueta.

^LH0,0  ; Origem no canto superior esquerdo

Comandos de Texto

Controlam fontes, tamanhos e conteudo de texto

^FO

Field Origin

Define posicao X,Y do campo a partir do canto superior esquerdo.

^FO100,50  ; 100 dots da esquerda, 50 do topo

^FD

Field Data

Define o conteudo de texto ou dados do campo.

^FDTexto da etiqueta^FS

^FS

Field Separator

Finaliza a definicao do campo atual.

^FS

^A0

Scalable/Bitmapped Font

Define fonte, orientacao e tamanho (altura x largura).

^A0N,30,30  ; Normal, 30x30 dots

^CF

Change Font

Muda fonte padrao para todos os campos seguintes.

^CF0,30  ; Fonte 0, altura 30

^FW

Field Orientation

Rotacao padrao: N(normal), R(90), I(180), B(270).

^FWR  ; Rotacionar 90 graus

Comandos de Codigo de Barras

Geram codigos de barras lineares e bidimensionais

^BC

Code 128

Codigo de barras Code 128 — padrao para logistica.

^BCN,80,Y,N,N
^FD123456789^FS

^BE

EAN-13

Codigo de barras europeu para produtos de varejo.

^BEN,80,Y,N
^FD7891234567890^FS

^BU

UPC-A

Codigo universal de produto norte-americano.

^BUN,80,Y,N,Y
^FD01234567890^FS

^B3

Code 39

Codigo alfanumerico usado em industria e defesa.

^B3N,N,80,Y,N
^FDABC123^FS

^BQ

QR Code

Codigo bidimensional para URLs e dados complexos.

^BQN,2,5
^FDQA,https://zplparapdf.com.br^FS

^BX

DataMatrix

Codigo 2D para rastreamento farmaceutico e industrial.

^BXN,5,200
^FDDados rastreamento^FS

^BY

Bar Code Defaults

Define largura do modulo, ratio e altura padrao das barras.

^BY2,3,80  ; modulo 2, ratio 3:1, altura 80

Comandos Graficos

Desenham formas geometricas e imagens

^GB

Graphic Box

Desenha retangulo ou linha. Parametros: largura, altura, espessura, cor, arredondamento.

^GB300,200,3,B,0^FS  ; Retangulo 300x200, borda 3px

^GC

Graphic Circle

Desenha circulo com diametro e espessura definidos.

^GC100,3,B^FS  ; Circulo diametro 100, borda 3

^GD

Graphic Diagonal Line

Desenha linha diagonal entre dois pontos.

^GD200,100,3,B,L^FS  ; Diagonal esquerda

^GE

Graphic Ellipse

Desenha elipse com largura, altura e espessura.

^GE200,100,3,B^FS  ; Elipse 200x100

^GF

Graphic Field

Insere imagem bitmap em formato hexadecimal ou comprimido.

^GFA,1024,1024,16,...dados^FS

Dicas para Escrever Codigo ZPL

Sempre comece com ^XA e termine com ^XZ

Esses delimitadores sao obrigatorios. Sem eles, a impressora ignora o codigo ou gera erros.

Use ^FO para posicionar cada elemento

Cada texto, codigo de barras ou grafico precisa de seu proprio ^FO definindo posicao X,Y em dots.

Calcule dots a partir do DPI

Impressoras 203dpi: 1 polegada = 203 dots. Impressoras 300dpi: 1 polegada = 300 dots. Faca a conversao antes de posicionar.

Teste antes de imprimir

Use o conversor ZPL para PDF para visualizar a etiqueta antes de enviar para a impressora. Economiza tempo e etiquetas.

Finalize campos com ^FS

Cada campo de dados (^FD) deve ser encerrado com ^FS. Esquece-lo causa comportamento imprevisivel.

Organize com comentarios

Use ; (ponto e virgula) para adicionar comentarios ao codigo. Impressoras ignoram texto apos ;

Perguntas Frequentes sobre Comandos ZPL

Quantos comandos ZPL existem?

A linguagem ZPL possui mais de 170 comandos documentados pela Zebra Technologies no ZPL II Programming Guide. Os comandos cobrem desde funcoes basicas como posicionamento de campos (^FO) e definicao de texto (^FD) ate funcoes avancadas como impressao de imagens GRF (^GF), rotacao de campos (^FW), e configuracao de rede (^NC). Na pratica, a maioria das etiquetas utiliza entre 10 e 20 comandos diferentes. Os mais comuns sao ^XA/^XZ (delimitadores), ^FO (posicao), ^A0 (fonte), ^FD/^FS (dados), ^BC (Code 128), ^BQ (QR Code) e ^GB (graficos).

Como testar comandos ZPL sem impressora?

Existem varias formas de testar codigo ZPL sem acesso a uma impressora Zebra fisica. A mais pratica e usar um conversor ZPL para PDF online como o zplparapdf.com.br, que renderiza o codigo ZPL e gera um documento PDF mostrando exatamente como a etiqueta sera impressa. Outra opcao e usar o emulador de impressora virtual incluido no Zebra Designer, software gratuito da propria Zebra Technologies. Conversores online tem a vantagem de funcionar em qualquer dispositivo com navegador, sem necessidade de instalacao de software.

Qual a diferenca entre ^FO e ^FT?

Ambos os comandos definem posicao de campos na etiqueta, mas com referencia diferente. ^FO (Field Origin) posiciona o campo usando o canto superior esquerdo como ponto de referencia, que e o mais intuitivo para a maioria dos usuarios. ^FT (Field Typeset) posiciona usando a linha de base do texto como referencia, similar ao conceito tipografico de baseline. Na pratica, ^FO e mais utilizado por ser mais previsivel, especialmente quando se trabalha com elementos mistos como textos e codigos de barras na mesma etiqueta.

Paginas Relacionadas

O que e ZPL?

Introducao a linguagem Zebra

Converter ZPL em PDF

Conversor online gratuito

FAQ

Perguntas frequentes

Teste seu Codigo ZPL Agora

Cole qualquer codigo ZPL no conversor e veja o resultado em PDF instantaneamente.

Abrir Conversor ZPL