Converter ZPL para TSPL: equivalências de comandos e guia de migração (Zebra → TSC)

Como os comandos ZPL correspondem ao TSPL, o que muda em unidades, fontes e códigos de barras, uma etiqueta real antes/depois e como migrar uma biblioteca Zebra para impressoras TSC sem redesenhar.

Passar de Zebra para TSC é a migração de impressoras mais comum em logística e varejo: as TSC custam menos e a mecânica é compatível com as mesmas etiquetas e ribbons. O obstáculo é a linguagem. ZPL e TSPL descrevem a mesma coisa — um texto em uma posição, um código de barras, uma caixa — com sintaxe completamente diferente, então todo modelo ZPL existente precisa ser reescrito, a menos que algo o traduza para você.

Equivalências de comandos

Operação	ZPL (Zebra)	TSPL (TSC)
Início / fim da etiqueta	^XA … ^XZ	CLS … PRINT 1
Tamanho da etiqueta	^PW800 ^LL600 (pontos)	SIZE 100 mm,75 mm GAP 3 mm,0
Posição de um campo	^FO50,40 (x,y em pontos)	Dois primeiros parâmetros de TEXT/BARCODE (x,y em pontos)
Texto	^A0N,40,40 ^FDOlá^FS	TEXT 50,40,"0",0,12,12,"Olá"
Code 128	^BY2 ^BCN,80,Y,N,N ^FD12345^FS	BARCODE 50,150,"128",80,1,0,2,4,"12345"
Código QR	^BQN,2,6 ^FDQA,dados^FS	QRCODE 400,150,M,6,A,0,"dados"
Data Matrix	^BXN,6,200 ^FDdados^FS	DMATRIX 400,150,120,120,"dados"
Caixa / linha	^GB300,2,2^FS	BOX x,y,xend,yend,2 / BAR x,y,w,h
Cópias	^PQ10	PRINT 10,1
Escurecimento / velocidade	^MD15 ^PR4	DENSITY 10 SPEED 4

O que realmente muda

Unidades: o ZPL trabalha só em pontos; o TSPL aceita milímetros ou polegadas em SIZE e GAP, mas posições em pontos. Um modelo ZPL de 203 dpi levado a uma TSC de 300 dpi precisa de cada coordenada escalada por 1,48.
Fontes: o ^A0 do ZPL é uma fonte escalável dimensionada em pontos; as fontes internas 1–8 do TSPL são bitmaps fixos com multiplicadores inteiros, e a fonte "0" é escalável, mas dimensionada em pontos por caractere. As larguras de texto não coincidirão exatamente — confira etiquetas com nomes de produto longos.
Parâmetros de código de barras: o ZPL define a largura de módulo uma vez com ^BY e a reutiliza; o TSPL declara a largura da barra estreita e larga em cada comando BARCODE. O texto legível é uma flag em ambos, mas sua fonte e posição diferem.
Origem e orientação: ambos usam o canto superior esquerdo, mas DIRECTION e REFERENCE do TSPL mudam onde fica o (0,0); declare-os explicitamente em cada trabalho.
Gráficos: os bitmaps hexadecimais ^GF do ZPL e o BITMAP do TSPL têm ordem de bytes e polaridade diferentes; logotipos precisam ser recodificados, não copiados.
RFID: os comandos ^RF não têm equivalente em modelos TSC sem RFID; nas TSC com RFID o conjunto de comandos é diferente e a codificação precisa ser redefinida.

Antes e depois: a mesma etiqueta

^XA
^PW812 ^LL609
^FO40,30 ^A0N,36,36 ^FDSafety Harness^FS
^FO40,80 ^A0N,24,24 ^FDLOT: MX-24-0917^FS
^FO40,130 ^BY2 ^BCN,90,Y,N,N ^FD7501234567893^FS
^PQ1
^XZ

SIZE 101.6 mm,76.2 mm
GAP 3 mm,0
DIRECTION 1
CLS
TEXT 40,30,"0",0,11,11,"Safety Harness"
TEXT 40,80,"0",0,7,7,"LOT: MX-24-0917"
BARCODE 40,130,"128",90,1,0,2,4,"7501234567893"
PRINT 1,1

Note como o tamanho da etiqueta passa a unidades físicas, cada campo carrega suas próprias coordenadas e o código de barras declara suas larguras de barra inline. Os dados — produto, lote, GTIN — ficam intactos; só o invólucro mudou.

Lista de verificação de migração

Confirmar a resolução da impressora (203 vs 300 dpi) antes de escalar coordenadas.
Imprimir cada modelo uma vez na TSC e avaliar os códigos (ISO 15416); ajustar a barra estreita se as notas caírem.
Verificar que textos variáveis longos não transbordam — as fontes TSPL são mais largas no mesmo tamanho nominal.
Recodificar logotipos como bitmaps TSPL ou, melhor, mantê-los como objetos vetoriais na ferramenta de design.
Manter a versão ZPL na biblioteca: frotas mistas são a norma durante uma transição.

Como o EtikStudio faz

Cole ou importe o arquivo ZPL; o interpretador o renderiza como design editável em milímetros. Escolha um perfil de impressora TSC e exporte: o EtikStudio regenera o TSPL com coordenadas escaladas para a resolução de destino, fontes substituídas com métricas equivalentes, códigos reconstruídos por módulo e logotipos recodificados. O mesmo design continua imprimindo nas Zebra até a última ser aposentada.

Os exemplos de comandos são simplificados para clareza; a sintaxe exata varia por modelo e firmware. Sempre teste na impressora de destino.