ZPLToolkit

Solução de problemas

A impressora imprime o código ZPL em vez da etiqueta

Páginas de ^XA^FO50,50 em vez de uma etiqueta querem dizer que algo entre você e a impressora está tratando o ZPL como documento a diagramar, e não como comandos a obedecer.

O que está acontecendo de fato

ZPL é uma linguagem de comandos, não um formato de documento. Quando uma impressora o recebe e o imprime como texto, ela nunca o viu como ZPL — algo no caminho transformou aqueles caracteres numa imagem e mandou a imagem para impressão.

Esse algo é quase sempre um driver. A função de um driver gráfico é transformar o que um aplicativo desenha em pontos; entregue a ele um arquivo de texto cheio de circunflexos e é exatamente isso que ele faz, fielmente e inutilmente.

O driver é a resposta habitual

Mandar ZPL por um driver do Windows que renderiza gráficos te dá uma figura do seu código. Mandar por um driver que passa os bytes adiante sem tocá-los te dá uma etiqueta.

  1. 1Use um driver de passagem. No Windows, o Generic / Text Only não faz nada com os bytes, que é exatamente o que se quer aqui.
  2. 2Ou contorne o driver de vez. A maioria das impressoras Zebra aceita ZPL bruto na porta TCP 9100, e mandar o arquivo para esse socket remove toda camada que poderia reinterpretá-lo.
  3. 3Ou use as ferramentas do fabricante. Os utilitários da própria Zebra mandam arquivos brutos para a impressora sem um spooler no caminho.

O mesmo arquivo impresso de dois jeitos é o diagnóstico mais rápido disponível. Se imprime como etiqueta pela porta 9100 e como texto pelo driver, o arquivo está correto e o driver é o problema — não há mais ZPL a depurar.

Quando não é o driver

Duas outras causas produzem o mesmo sintoma. A primeira é uma impressora na linguagem errada: alguns modelos suportam mais de uma linguagem de descrição de página, e uma configurada em EPL ou em modo de impressão de linha não reconhece comandos ZPL como comandos.

A segunda é um arquivo que nunca abre um formato. Comandos antes do primeiro ^XA não têm a que se ligar, e um arquivo que perdeu a primeira linha pode parecer ZPL e se comportar como texto.

O ^SZ escolhe entre o ZPL original e o ZPL II, que é uma questão aparentada mas diferente: uma impressora no modo ZPL errado produz etiquetas sutilmente erradas, não páginas de código-fonte.

Abrir o visualizador ZPL

Cole o arquivo e veja se é uma etiqueta válida antes de culpar a impressora. Se renderiza aqui, o ZPL está bom e o que precisa de conserto é o caminho até a impressora.

Abrir o visualizador ZPL

Perguntas frequentes

Qual driver do Windows devo usar para ZPL?
Generic / Text Only, que passa os bytes adiante sem renderizá-los. Um driver gráfico transforma seus comandos numa figura dos seus comandos.
O que é a porta 9100?
A porta padrão de impressão bruta. Abrir um socket na impressora em 9100 e escrever o ZPL o envia sem nada no meio para reinterpretá-lo, o que é ao mesmo tempo a forma mais confiável de imprimir e a mais rápida de descartar o driver.
Meu arquivo imprime como texto numa impressora e como etiqueta em outra. Por quê?
As duas são alcançadas por caminhos diferentes — uma por um driver que renderiza e outra bruta — ou uma delas está em outro modo de linguagem. O arquivo é o mesmo, então não é o arquivo.

Comandos deste guia

Guias relacionados