Visualizador ZPL: pré-visualize etiquetas ZPL

Veja uma etiqueta ZPL na tela antes de ela chegar a uma impressora: escolha um modelo de varejista dos Modelos UCC e preencha o formulário, ou cole seu próprio ZPL, e então pré-visualize, copie ou baixe em ZPL, PNG ou PDF.

ZPL é a linguagem de instruções que diz a uma impressora de etiquetas o que imprimir e onde. É difícil julgar o código só de olhar — um campo pode estar dois milímetros fora do lugar e você só descobre na etiqueta impressa. O Visualizador ZPL (Utilities → ZPL Viewer, /utilities/zpl-viewer) desenha a etiqueta na tela primeiro, com o tamanho de etiqueta e a resolução de impressora que você definir, para você conferir o layout antes de imprimir qualquer coisa. Ele funciona de dois jeitos: partir de um modelo de varejista salvo nos Modelos UCC e só preencher os valores, ou colar um código ZPL seu e pré-visualizar. A prévia é desenhada localmente no seu navegador.

Etapa 1: Escolha um modelo de varejista#

1. Abra Utilities → ZPL Viewer (/utilities/zpl-viewer). A página começa no modo “Modelo de varejista” — se estiver em “ZPL personalizado”, volte com o seletor no topo.
2. Abra a lista de modelos e escolha um. Você pode digitar para buscar; cada item aparece como varejista · nome do modelo.
3. Ao escolher um, a página mostra ao lado da lista o tamanho, a versão e o tipo de etiqueta do modelo, e os campos de tamanho abaixo são preenchidos automaticamente a partir do modelo.

• A lista só contém modelos de etiqueta UCC. Os modelos em si são criados e editados em WMS → Modelos UCC (/wms/templates); o visualizador apenas os usa.
• Se a lista disser “Nenhum modelo UCC encontrado”, ainda não há modelo para escolher — adicione um primeiro em WMS → Modelos UCC (/wms/templates), ou use o modo ZPL personalizado abaixo.

Etapa 2: Preencha o conteúdo da etiqueta#

1. No cartão “Preencha o conteúdo da etiqueta”, aparece um campo para cada placeholder escrito no modelo (no ZPL do modelo eles aparecem como [[ISTO]]). O nome do campo diz o que deve ir ali.
2. Digite o valor de cada campo. O ZPL do modelo é atualizado enquanto você digita, e a prévia à direita se redesenha sozinha instantes depois.
3. Bagunçou o formulário? “Redefinir”, acima do cartão, limpa todos os campos para você recomeçar os valores.

• Um campo deixado vazio permanece como seu placeholder no ZPL, e a página avisa com uma lista de “Placeholders não preenchidos” nomeando cada um — preencha todos antes de considerar a etiqueta final.
• Dois caracteres são removidos automaticamente dos valores: ^ e ~. Eles são caracteres de controle no ZPL, então um valor com eles quebraria a etiqueta — deixe-os fora de nomes e endereços aqui.

Ou: cole seu próprio ZPL (modo ZPL personalizado)#

1. Mude o seletor no topo de Utilities → ZPL Viewer (/utilities/zpl-viewer) para “ZPL personalizado”.
2. Cole seu ZPL na caixa “Código ZPL”, ou edite o que está lá — um exemplo curto (uma etiqueta simples “Hello ZPL”) vem preenchido para você ver de imediato o formato do código.
3. A prévia à direita acompanha suas edições, igual ao modo de modelo.

Etapa 3: Defina o tamanho da etiqueta e a resolução, e confira a prévia#

1. Defina a largura e a altura da etiqueta em polegadas. Um modelo traz esses valores do tamanho nele salvo (4 × 6 polegadas se o modelo não tiver tamanho); no modo personalizado, começam em 4 × 6 — ajuste para as etiquetas reais em que você imprime.
2. Escolha a resolução da sua impressora: 203 dpi (8 pontos/mm, o ajuste térmico comum) ou 300 dpi (12 pontos/mm, mais nítido). Texto e códigos de barras são desenhados com essa nitidez na prévia.
3. A prévia se redesenha sozinha pouco depois de qualquer mudança. Se alguma vez parecer desatualizada, clique em “Renderizar” para desenhá-la de novo na hora.

• Se o código da etiqueta usa um comando que este visualizador não suporta, esse comando é ignorado e listado em “Comandos não suportados (ignorados)” abaixo da prévia. O restante da etiqueta é desenhado normalmente — mas confira a lista antes de confiar na prévia.
• Se a prévia falhar por completo, um erro pede que você verifique o código ZPL — a causa comum é faltar um marcador de início ou de fim no código.

Etapa 4: Copie ou baixe a etiqueta#

1. Clique em “Copiar ZPL” para copiar o código ZPL final (com seus valores já aplicados) para a área de transferência, pronto para colar onde você trabalhar com ele.
2. Ou baixe a etiqueta no formato que precisar: o botão ZPL baixa o código como arquivo .zpl, o PNG baixa a prévia como imagem, e o PDF baixa como documento cuja página é exatamente o tamanho de etiqueta que você definiu.

Recursos do Docklify usados neste artigo#

• Visualizador ZPL — Utilities → ZPL Viewer (/utilities/zpl-viewer)
• Modelos de etiqueta de varejista com formulário de placeholders — Utilities → ZPL Viewer → modo Modelo de varejista (/utilities/zpl-viewer)
• Modelos UCC (onde os modelos de etiqueta são criados e editados) — WMS → Modelos UCC (/wms/templates)
• Prévia da etiqueta em tamanho e resolução reais (203 / 300 dpi), com cópia e download em ZPL / PNG / PDF — Utilities → ZPL Viewer → Prévia de impressão (/utilities/zpl-viewer)