Pode pensar-se em ZPL como um dialeto que as impressoras entendem. Envie a uma impressora Zebra um bloco de código ZPL e ela sabe onde colocar o texto, onde desenhar o código de barras e com que tamanho e espessura o fazer. Parece simples. Na realidade, muitos armazéns funcionam com um modelo ZPL que uma só pessoa escreveu à mão há três anos, e ninguém se atreve a mexer-lhe, porque mudar um caráter pode obrigar todo o armazém a reimprimir.
Comecemos por como funciona. O ZPL tem três ingredientes: posição, conteúdo e formato. A posição vem do comando ^FO, que diz à impressora onde começa um campo; o conteúdo é o próprio campo — número de encomenda, SKU, quantidade —; o formato abrange o tipo de letra, o tamanho, o tipo de código de barras e a rotação. A impressora executa o código por ordem, desenhando a etiqueta linha a linha. Pode entender-se assim: o ZPL não imprime um documento, dá à impressora as instruções para desenhar uma imagem.
Em março de 2024, como responsável técnico de um integrador num armazém 3PL no leste da China, assisti a um fracasso clássico. O cliente pediu uma linha «Frágil» na etiqueta de expedição. O engenheiro de TI do armazém acrescentou um campo diretamente ao modelo, calculou mal a posição, e o novo campo empurrou o código de barras abaixo dele para fora do limite da etiqueta, onde já não pode ser lido. Mais de 400 expedições de um turno inteiro tiveram de ser reimpressas. Os preparadores, os embaladores e os verificadores pararam todos e esperaram pelas etiquetas, e o desempenho de saída desse turno caiu 3 horas. Uma linha acrescentada custou meio dia de capacidade — o preço de um modelo ZPL sem controlo de versões.
Num modelo ZPL, separe primeiro as variáveis do texto fixo
Os campos de um modelo são de dois tipos: fixos e variáveis. O texto fixo é idêntico em todas as etiquetas: nome da empresa, morada do armazém, notas de manuseamento. O texto variável muda com cada expedição: número de encomenda, destinatário, SKU, quantidade, conteúdo do código de barras. Se não se distinguem os dois, o modelo acabará por falhar mais cedo ou mais tarde.
As variáveis devem ser escritas com números de campo ^FN e marcadores ^FD, preenchidos pelo sistema no momento da impressão, nunca escritos diretamente no modelo. O pior modelo que já vi tinha 200 nomes de SKU escritos no ficheiro, com lógica condicional para escolher entre eles; era tão grande que a memória da impressora quase se esgotou, e cada etiqueta demorava 4 segundos a imprimir. Quatro segundos parecem triviais, mas com 5,000 expedições por dia somam mais de 5 horas à espera da impressora. É um falso requisito de manual: um trabalho que pertence ao sistema foi imposto à impressora.
O limite de escolha é claro. Com menos de 500 expedições por dia, desenhe os modelos num programa de etiquetas comercial e nunca escreva ZPL à mão — não vale a pena. Entre 500 e 3,000 por dia, os modelos ZPL com variáveis preenchidas pelo sistema são a combinação de melhor valor: flexíveis, baratos e fáceis de rastrear quando algo falha. Acima de 3,000 por dia, ou com vários armazéns a partilhar modelos, precisa de um sistema de gestão de modelos: armazenamento central, números de versão, aprovação de alterações e lançamento faseado. Muitos armazéns ficam presos no meio: o volume cresceu, mas continuam a gerir os modelos como um armazém pequeno, e cada alteração deixa todo o centro a suster a respiração.
Eis um exemplo resolvido, com valores assumidos. Suponha que um armazém expede 2,000 encomendas por dia, e uma falha de modelo obriga à reimpressão de 1,000 etiquetas em meio turno. A 1.2 yuan por reimpressão, entre papel, fita e mão de obra, o custo direto é de 1,200 yuan. Mas o custo real é a linha parada: 1,000 encomendas saem com 3 horas de atraso, e com uma margem média de 8 yuan por encomenda, com 10% a sofrer penalizações por atraso, a perda oculta pode passar os 800 yuan. Seis incidentes destes por ano custam mais de 12,000 yuan juntos, enquanto até um controlo de versões básico de modelos não custa mais do que um ou dois dias de trabalho. Vale a pena o dinheiro? Olhe para um só número: quantos incidentes de modelo tem o seu armazém por ano?
Térmica direta ou transferência térmica: o modelo ZPL tem de acompanhar o consumível
Um modelo ZPL não está terminado quando é escrito. Tem de corresponder ao consumível. A impressão térmica direta escurece o papel da etiqueta com calor, não precisa de fita e custa menos, mas desvanece com o calor e a luz do sol, e o texto pode ficar ilegível ao fim de três meses. A transferência térmica imprime através de uma fita, resiste ao calor e à luz do sol e dura muito mais tempo, mas custa mais e acrescenta mais um consumível a gerir.
Escolher mal tem consequências concretas. Em junho de 2025, um armazém de comércio eletrónico transfronteiriço enviou tudo para o seu armazém no estrangeiro com etiquetas térmicas diretas; a mercadoria passou mais de 40 dias num contentor, e à chegada o texto tinha desvanecido tanto que as etiquetas já não podiam ser lidas. O armazém no estrangeiro conferiu os números de encomenda à mão, expedição a expedição, a receção demorou mais dois dias, e seguiu-se uma taxa adicional de tratamento de exceções. O erro inverso também desperdiça dinheiro: a transferência térmica para as etiquetas de paletes dentro do armazém não faz sentido, pois são deitadas fora depois de usadas e a térmica direta é perfeitamente adequada.
Pense nisso como nos sapatos: ténis para correr, botas de chuva para a chuva. Nenhum par serve para tudo. Ao desenhar um modelo, registe o tipo de consumível nos seus metadados: térmica direta ou transferência térmica, que papel e que modelo de fita. Verifique o modelo antes de mudar de consumível, em vez de descobrir texto desvanecido e códigos de barras ilegíveis depois de imprimir.
Os tipos de letra e o posicionamento têm as suas próprias armadilhas. Os tipos de letra integrados do ZPL são monoespaçados, e os tipos de letra chineses têm de ser descarregados para a impressora ou impressos como gráficos. Mude o tamanho de um tipo de letra e a posição de toda a linha tem de ser recalculada. Os códigos de barras são ainda mais rigorosos: a largura da barra estreita, a altura e a zona de silêncio têm todos mínimos. Barras demasiado finas não podem ser lidas, e uma zona de silêncio demasiado pequena faz o leitor ler através das linhas. A minha regra prática: altura do código de barras de pelo menos 15 milímetros, zonas de silêncio de pelo menos 3 milímetros de cada lado, densidade de impressão um nível acima do meio, e depois imprima 10 etiquetas de teste e leia cada uma. Se a taxa de acerto não for de 100%, não entre em produção.
Controlo de versões de modelos: mude uma coisa sem reimprimir o armazém
No fim, as falhas de modelos voltam sempre ao controlo de versões. Um armazém sem ele muda os modelos à sorte: edita diretamente o ficheiro do modelo de produção e reza para que nada se parta. Quando se parte, não há versão antiga para onde voltar, porque foi substituída, e a única opção é reescrever de memória.
A abordagem correta tem quatro passos. Primeiro, guarde os modelos de forma centralizada, um número por modelo, como ZPL-OUT-001, com versões V1.0, V1.1, V2.0, e um registo de alterações que anote o que mudou, quem mudou e porquê. Segundo, teste cada alteração primeiro numa impressora de testes: imprima 20 etiquetas com dados reais, leia-as, cole-as nas caixas e execute todo o fluxo de verificação antes do lançamento. Terceiro, lance por fases: uma equipa ou um cliente recebe primeiro o novo modelo, e só depois de um turno completo sem problemas é que todo o armazém o adota. Quarto, conserve as versões antigas durante pelo menos 3 meses, para que um problema possa ser revertido em 5 minutos em vez de se transformar num novo desenvolvimento.
Eis a parte contraintuitiva: quanto mais «flexível» é um modelo, mais perigoso ele se torna. Alguns armazéns deixam uma dúzia de campos opcionais num modelo para o operador assinalar à mão no momento da impressão. Um visto errado e todo um lote de etiquetas sai errado. A flexibilidade pertence ao sistema, onde os dados da encomenda decidem automaticamente o que imprimir e o que omitir, e não em frente à impressora, onde uma pessoa escolhe. Cada escolha manual na impressora é mais uma oportunidade de errar.
Os downloads de tipos de letra são outra armadilha. As etiquetas em chinês precisam de um tipo de letra chinês descarregado para a memória da impressora, e quando o ficheiro do tipo de letra muda, o número do tipo de letra referenciado no modelo pode deixar de corresponder, imprimindo apenas blocos ilegíveis. Antes de mudar um tipo de letra, verifique numa impressora de testes se o número do tipo de letra e a referência do modelo coincidem, e depois passe para produção. Não salte este passo. Já vi um armazém onde uma mudança de fornecedor de tipos de letra deixou metade das etiquetas do centro a imprimir como quadrados, e a linha parou durante duas horas antes de recuperar.
Para o dizer claramente: os modelos ZPL não são tecnicamente difíceis. O difícil é tratá-los como ativos reais. Um modelo é uma ferramenta de produção que o armazém usa todos os dias, tão digna de uma gestão séria como as estantes e os empilhadores. Mudar uma coisa sem reimprimir todo o armazém não depende da sorte. Depende de quatro coisas: versões, testes, lançamento faseado e reversão. Vale a pena o dinheiro? Olhe para um só número: quantos incidentes de modelo teve o seu armazém este ano? Um basta para justificar a criação do processo.
Por Da Liu, Engenheiro de Automação Traduzido do inglês. Em caso de divergência, prevalece a versão em inglês.







