Introdução ao ZPL

O que é ZPL?

ZPL (Zebra Printer Language) é uma linguagem de impressão usada por muitas impressoras de etiquetas. É um conjunto de comandos que podem ser usados para desenhar elementos como texto, formas, códigos de barras e imagens, combinar esses elementos e finalmente imprimi-los.

Imagine que você quer imprimir uma etiqueta contendo o nome de um produto, um código de barras para um número SKU e uma caixa ao redor de tudo. Você provavelmente precisa dizer à sua impressora:

Qual é o nome do produto, onde imprimi-lo e qual fonte usar.
Que tipo de código de barras você quer usar, onde quer colocá-lo e o número SKU para codificar.
A localização da caixa, o tamanho da caixa e a espessura das linhas da caixa.

Exemplo de Etiqueta ZPL

Template de Etiqueta ZPL:

^XA
^FO50,60^A0,40^FDWorld's Best Griddle^FS
^FO60,120^BY3^BCN,60,,,,A^FD1234ABC^FS
^FO25,25^GB380,200,2^FS
^XZ

Resultado:

World's Best Griddle

1234ABC

Anatomia de uma Etiqueta

Regras Básicas:

ZPL é composto por comandos e parâmetros de comando.
Comandos começam com um acento circunflexo (^) ou til (~).
Nomes de comandos seguem o acento circunflexo ou til, têm uma ou duas letras e não diferenciam maiúsculas de minúsculas.
Comandos podem ter vários parâmetros que afetam o comportamento do comando.
Parâmetros de comando são separados por vírgulas (,).
Espaços em branco são ignorados na maioria dos casos.

Estrutura Básica:

^XA - Inicia a etiqueta
^XZ - Termina a etiqueta
Campos são separados por ^FS
Cada campo pode ter múltiplos comandos

Sistema de Coordenadas

O sistema de coordenadas ZPL usa "pontos" (dots) como unidade. A origem está no canto superior esquerdo da etiqueta.

Densidade mais comum: 203 DPI (8 pontos por milímetro)
Outras densidades: 150 DPI, 300 DPI, 600 DPI
Comando de posição: ^FO x,y - Define a origem do campo

(0,0)

(100,50)

(200,100)

Documentação ZPL

Comandos de Texto

Comandos Básicos

^XA - Início de formato
^XZ - Fim de formato
^FO x,y - Field Origin (posição)
^FS - Field Separator

Fontes e Texto

^A font,height,width - Define fonte do campo
^FD text - Field Data (texto)
^CF font,height,width - Fonte padrão
^CI28 - Codificação UTF-8

Formatação

^FR - Field Reverse (inverter cores)
^PM - Mirror (espelhar horizontalmente)
^PO - Invert (inverter verticalmente)
^FX comment - Comentário

Códigos de Barras

Códigos 1D

^BC - Code 128
^B3 - Code 39
^B8 - EAN-8
^BE - EAN-13
^BU - UPC-A
^B9 - UPC-E

Códigos 2D

^BQ - QR Code
^BX - Data Matrix
^B0 - Aztec
^B7 - PDF417

Configuração

^BY width,ratio,height - Configuração de barras
^FH hexIndicator - Indicador hexadecimal
^FD data - Dados do código

Formas e Gráficos

Formas Básicas

^GB width,height,thickness - Retângulo/Caixa
^GC diameter,thickness - Círculo
^GE width,height,thickness - Elipse
^GD width,height,thickness,orientation - Linha diagonal

Imagens

^GF format,dataBytes,totalBytes,rowBytes - Campo gráfico
^XG path,magnificationX,magnificationY - Recuperar gráfico
~DG path,totalBytes,rowBytes,data - Baixar gráfico

Cores e Efeitos

~BR x,y,width,height,r,g,b - Retângulo colorido
~BI x,y,magnification,image - Imagem de fundo
^FR - Inverter cores

Introdução ao DPL

O que é DPL?

DPL (Datamax Printer Language) é a linguagem de impressão proprietária da Datamax-O'Neil, usada em impressoras de etiquetas industriais. É uma linguagem de comandos que permite criar etiquetas complexas com texto, códigos de barras, gráficos e elementos especiais.

O DPL é conhecido por sua precisão e flexibilidade, permitindo controle detalhado sobre todos os aspectos da impressão de etiquetas, desde a posição exata dos elementos até a densidade de impressão e configurações avançadas.

Exemplo de Etiqueta DPL

Template de Etiqueta DPL:

<STX>e
<STX>j
<STX>m
<STX>M0240
<STX>L
PC
H10
D11
Q0001
3011000000000030{etiqueta.produto}
1411000000000014{etiqueta.preco}
E

Resultado:

Nome do Produto

R$ 29,90

Anatomia de uma Etiqueta DPL

Regras Básicas:

DPL usa comandos especiais com tags <STX>
Cada comando tem parâmetros específicos
O formato é sequencial e linear
Elementos são posicionados usando coordenadas em pontos
A densidade padrão é 203 DPI

Estrutura Básica:

<STX>e - Inicia o formato
E - Termina o formato
Elementos são definidos com coordenadas X,Y
Cada elemento tem seu próprio comando específico

Sistema de Coordenadas

O DPL usa um sistema de coordenadas baseado em pontos (dots), similar ao ZPL, mas com comandos específicos da Datamax.

Densidade padrão: 203 DPI
Formato de coordenadas: X,Y em pontos
Origem: Canto superior esquerdo
Precisão: Até 1 ponto

Documentação DPL

Comandos de Formato

Início e Fim

<STX>e - Início de formato
E - Fim de formato
<STX>j - Justificação
<STX>m - Margem

Configurações

<STX>M0240 - Densidade de impressão
<STX>L - Posição da etiqueta
PC - Posição do cabeçalho
H10 - Altura do cabeçalho
D11 - Densidade
Q0001 - Quantidade

Unidades

Coordenadas: X e Y em pontos (203 DPI)
Tamanho da Fonte: 8-72 pontos
Densidade: 203 DPI padrão
Unidades: cm, mm, inches

Comandos de Texto

Formatos de Texto

3011000000000030 - Texto com fonte 30
1411000000000014 - Texto com fonte 14
1811000000000018 - Texto com fonte 18
2411000000000024 - Texto com fonte 24
3611000000000036 - Texto com fonte 36

Estrutura do Comando

30: Tamanho da fonte (primeiros 2 dígitos)
11: Subcategoria
0000000000: Coordenadas X,Y
30: Tamanho da fonte (últimos 2 dígitos)

Variáveis

{etiqueta.produto} - Nome do produto
{etiqueta.preco} - Preço
{etiqueta.codigo} - Código interno
{etiqueta.data} - Data de impressão

Códigos de Barras

Tipos de Códigos

20 - Code 128
21 - Code 39
22 - EAN-13
23 - EAN-8
24 - UPC-A
25 - QR Code

Configuração

Altura: Definida em pontos
Largura: Módulo de barras
Verificação: Dígito verificador automático
Texto: Texto legível abaixo

Formas

30 - Retângulo
31 - Linha horizontal
32 - Linha vertical
33 - Círculo

Como Usar

Primeiros Passos

Selecione o Tipo de Etiqueta

No menu superior, escolha entre DPL (Datamax) ou ZPL (Zebra) dependendo da sua impressora.

Configure o Tamanho da Etiqueta

Defina a largura e altura da etiqueta no painel superior. Você pode usar cm, mm ou inches.

Arraste Elementos

Da paleta à esquerda, arraste elementos para o canvas. Você pode adicionar texto, códigos de barras, variáveis e mais.

Posicione e Edite

Clique e arraste para posicionar elementos. Use duplo clique para editar texto. Clique com botão direito para ajustar fonte.

Copie o Código

O código é gerado automaticamente. Clique em "Copiar" para usar na sua impressora.

Dicas e Truques

Navegação

Clique: Seleciona elemento
Duplo Clique: Edita texto
Botão Direito: Menu de fonte
Delete: Remove elemento

Elementos

Texto: Para títulos e descrições
Variável: Para dados dinâmicos
Código de Barras: Para produtos
QR Code: Para links e informações

Configurações

Grid: Ativa/desativa grade
Limpar: Remove todos os elementos
Tamanho: Ajusta dimensões da etiqueta
Fonte: Personaliza tamanho do texto

Elementos

Variáveis

Variável

Texto

Título

Códigos

Código de Barras

QR Code

Formas

Retângulo

Linha

Outros

Imagem

Data

Editor Visual DPL

Label Size: x

Arraste elementos da paleta para criar sua etiqueta

Código DPL Gerado

Elementos

Variáveis

Variável

Texto

Título

Códigos

Código de Barras

QR Code

Formas

Retângulo

Linha

Outros

Imagem

Data

Editor Visual ZPL

Label Size: x

Arraste elementos da paleta para criar sua etiqueta

Código ZPL Gerado

Propriedades

Selecione um elemento para editar suas propriedades