Por que seu código de barras ZPL não escaneia
Um código de barras ZPL pode parecer correto na tela e ainda falhar no leitor. Normalmente o problema não está só em ^BC ou ^BY, mas na combinação de largura do módulo, qualidade de impressão, zonas silenciosas, DPI e formato dos dados.
Causas mais comuns
A largura do módulo é pequena demais
Se a barra mais fina tem apenas 1 dot em uma impressora de 203 DPI, o calor e o papel podem borrar as barras. Comece com ^BY2 ou ^BY3 e teste com o leitor real.
Falta zona silenciosa
Os leitores precisam de espaço em branco antes e depois do código. Se texto, caixas ou a borda da etiqueta ficam muito perto, a leitura falha.
A altura do código é baixa
Códigos muito baixos são mais difíceis de ler, especialmente com leitores manuais ou embalagens curvas. Aumente a altura em ^BC, ^B3, ^BE ou no comando usado.
Simbologia errada ou dados inválidos
EAN e UPC exigem números com comprimento e dígito verificador válidos. Code 39 aceita um conjunto limitado de caracteres. Se os dados não combinam com o tipo, o scan pode falhar.
Escuridão, velocidade ou DPI não combinam com a mídia
Escuridão demais engrossa as barras; pouca escuridão as quebra. Velocidade alta reduz a nitidez. Ajuste DPI, mídia e escuridão antes de imprimir em produção.
Checklist rápido
- Use uma largura de módulo segura: teste ^BY3 em impressoras de 203 DPI e reduza só se o leitor escanear de forma consistente.
- Deixe zonas silenciosas claras nos dois lados. Não encoste caixas, textos ou imagens na primeira ou última barra.
- Aumente a altura e mantenha o texto legível durante os testes para comparar o valor codificado.
- Valide o formato dos dados: Code 128 para dados alfanuméricos flexíveis; EAN-13/UPC só para valores numéricos de varejo.
- Imprima uma etiqueta real e escaneie com o dispositivo usado em produção; uma pré-visualização não garante leitura.
Etiqueta de teste Code 128 segura
Este exemplo usa Code 128 com ^BY3 e 120 dots de altura, um bom ponto de partida para muitas Zebra de 203 DPI.
^XA
^PW812
^LL406
^FO40,40^A0N,32,32^FDCode 128 scan test^FS
^FO40,100^BY3,2,120
^BCN,120,Y,N,N
^FD123456789012^FS
^XZPerguntas frequentes
Qual comando ZPL controla a largura do código?
^BY define a largura do módulo, a proporção largo/estreito e a altura padrão de muitos códigos lineares. O primeiro valor é o mais importante para a leitura.
Uma pré-visualização prova que vai escanear?
Não. Ela ajuda a revisar layout e dados, mas a leitura depende da impressão física, mídia, escuridão, DPI e leitor.
Que tipo de código de barras devo usar em ZPL?
Use Code 128 para a maioria das etiquetas internas de logística e inventário. Use EAN-13 ou UPC só se o sistema de varejo exigir esses padrões.