O que é ZPL, e por que a etiqueta veio como um arquivo de texto

ZPL é a sigla de Zebra Programming Language, a linguagem que as impressoras térmicas da Zebra entendem. Um arquivo ZPL não é uma foto da etiqueta: é a receita dela, escrita em texto.

Isso explica o que provavelmente trouxe você até aqui. O arquivo abre no Bloco de Notas e mostra um monte de acentos circunflexos; não abre no visualizador de imagens; e clicar duas vezes nele não faz nada. Não está corrompido. Ele só não é o tipo de arquivo que você esperava.

Esta é uma etiqueta inteira, completa:

^XA
^CI28
^FO50,50^A0N,40,40^FDMaria Silva^FS
^FO50,110^A0N,30,30^FDRua das Flores, 210^FS
^FO50,160^BY2^BCN,100,Y,N,N^FD123456789012^FS
^XZ

Cada linha manda a impressora fazer uma coisa. ^XA abre a etiqueta e ^XZ fecha. No meio, ^FO diz onde posicionar, ^A0N escolhe a fonte e o tamanho, ^FD traz o texto em si, e ^BC desenha o código de barras.

Se isso parece programação, é porque é. E é exatamente por isso que o arquivo pesa alguns kilobytes enquanto a imagem equivalente pesaria centenas.

Impressora térmica não tem tinta. Ela tem uma barra de pontos que esquenta, e o papel escurece onde encostou. Para imprimir, ela precisa saber quais pontos aquecer, e quem decide isso é a própria impressora, a partir das instruções que recebeu.

Mandar uma imagem pronta obrigaria o sistema que emite a etiqueta a desenhar tudo antes, na resolução exata daquele modelo de impressora, e a transmitir um arquivo dezenas de vezes maior. Mandar a receita resolve os dois problemas de uma vez: o arquivo é minúsculo, e a mesma etiqueta sai certa numa impressora de 203 ou de 300 pontos por polegada.

A consequência aparece do seu lado: sem uma impressora que fale ZPL, o arquivo sozinho não vira nada. Ele é uma receita sem cozinha.

Quase sempre porque alguém no meio do caminho tem uma impressora Zebra, e o sistema que gerou a etiqueta assumiu que você também tem.

Em todos os casos o arquivo está correto. O que falta é o equipamento que ele espera encontrar.

Converter. É possível interpretar o ZPL fora da impressora, desenhar a etiqueta e devolver um PDF ou um PNG, e aí qualquer impressora comum dá conta, inclusive a de folha A4 do escritório. É o que este site faz, e não pede cadastro para lotes pequenos.

Duas coisas valem saber antes. A primeira é a densidade: escolher 203 em vez de 300 desloca tudo na etiqueta, e o guia sobre densidade explica como descobrir a certa. A segunda é a escala na hora de imprimir, que vem errada por padrão em quase todo visualizador e encolhe a etiqueta sem avisar: imprimir em A4 no tamanho real tem guia próprio.

Existe uma linguagem parecida e mais antiga, a EPL, da Eltron, que a Zebra comprou. Muita impressora entende as duas e troca sozinha, e é por isso que um arquivo "sempre funcionou" na impressora e mesmo assim não converte.

A diferença se vê na primeira linha: ZPL começa com ^XA, EPL começa com uma letra solta como N ou q. Há um guia para identificar o formato em dez segundos, porque a extensão do arquivo não ajuda: .txt, .prn e .zpl são usadas para qualquer um dos dois.

O manual da Zebra tem mais de duzentos. Uma etiqueta de transportadora usa menos de vinte, e as mesmas quase sempre: abrir, posicionar, escrever, código de barras, fechar.

Se a curiosidade passou de "o que é isso" para "o que cada linha faz", a lista dos comandos que você vai encontrar de verdade é o passo seguinte, com o que cada um faz e o erro que cada um costuma causar.