Ñ e acentos saem errados na impressão ZPL: como corrigir

1. Identifique o sintoma

Se aparece España, procure uma conversão incorreta do texto: esses caracteres são uma pista, não uma prova de onde ocorreu o erro. Um quadradinho, ponto de interrogação ou espaço pode indicar um caractere ausente na fonte ou perdido antes da impressão. Se a etiqueta mostra literalmente ^XA ou ^FD, consulte o guia de texto ilegível no final da página.

2. Envie UTF-8 e declare ^CI28

Abra o arquivo como UTF-8 e confira se contém España, não España. No aplicativo que envia a impressão, codifique o texto em UTF-8 uma única vez e verifique se o driver ou serviço de impressão não faz outra conversão depois. Coloque ^CI28 no início de cada formato e confira se nenhum ^CI posterior muda a codificação antes do campo afetado. Resolva entidades HTML e escapes JSON antes de montar o ZPL.

3. Imprima uma etiqueta mínima

Este exemplo usa a fonte 0 e uma área de aproximadamente 60 × 40 mm a 203 DPI. Imprima pelo mesmo canal que apresenta o erro e compare o resultado com o texto esperado. A prévia ajuda a conferir conteúdo e disposição, mas não comprova quais bytes chegam à Zebra nem quais caracteres sua fonte contém.

Exemplo com texto UTF-8

^XA
^CI28
^PW480
^LL320
^LH0,0
^FO24,30^A0N,28,28^FDEspaña - Café^FS
^FO24,85^A0N,28,28^FDá é í ó ú ñ ü^FS
^XZ

4. Isole o envio com ^FH

O segundo teste representa os bytes UTF-8 em hexadecimal e contém apenas caracteres ASCII. ^FH ativa os escapes para o próximo campo; o indicador padrão é o sublinhado. Repita ^FH em cada campo que precisar dele. Se esta versão funciona e a primeira não, investigue a codificação do arquivo e o envio. Se ambas falham, confira também a fonte, o suporte do firmware e os comandos acrescentados pelo aplicativo.

A mesma primeira linha com bytes hexadecimais

^XA
^CI28
^PW480
^LL320
^LH0,0
^FO24,30^A0N,28,28^FH^FDEspa_C3_B1a - Caf_C3_A9^FS
^XZ

Em UTF-8, ñ ocupa dois bytes: C3 B1. _F1 não é um ñ válido em UTF-8. Copie o teste hexadecimal para o canal de envio à impressora sem converter os escapes novamente.

5. Confira a fonte se faltarem caracteres

Mantenha ^CI28 e teste uma fonte que contenha os glifos necessários. Uma fonte Unicode baixada pode ser selecionada com ^A@ ou associada por ^CW, seguindo a documentação do equipamento. Em impressoras antigas, confirme se o firmware suporta ^CI28. Depois teste nomes e endereços reais: corrigir ñ e é não garante que a mesma fonte cubra todos os sistemas de escrita.