TSPL vs ZPL: diferenças, compatibilidade e conversão
Uma etiqueta funciona em uma impressora, mas não no equipamento que a substituiu. Antes de trocar cabos ou refazer o layout, confira a linguagem de comandos. TSPL e ZPL podem descrever etiquetas semelhantes, porém suas instruções não são intercambiáveis. Algumas impressoras oferecem emulação; outras precisam de um modelo convertido ou de uma saída diferente do software. Este guia explica como distinguir essas situações e preparar uma migração verificável.
O que são TSPL, TSPL2 e ZPL?
TSPL e TSPL2 são linguagens documentadas pela TSC para impressoras de etiquetas. Usam comandos legíveis como SIZE, CLS, TEXT, BARCODE e PRINT. TSPL2 não é outro nome para ZPL: a TSC documenta diferenças entre TSPL e TSPL2, inclusive no comportamento das fontes. Um comando ou fonte disponível em um equipamento pode funcionar de forma diferente em outro. Consulte o manual do modelo e firmware exatos.
ZPL significa Zebra Programming Language. Os formatos ZPL II normalmente começam com ^XA e terminam com ^XZ, usando ^FO para posição e ^FD para dados. As duas famílias descrevem conteúdo; seus nomes não determinam papel, conexão ou resolução. USB e Ethernet podem transportar a mesma linguagem. Trocar o cabo não traduz comandos nem adapta o desenho à impressora.
Diferenças práticas que alteram a etiqueta
A primeira diferença é a sintaxe. TSPL usa nomes de comandos seguidos de parâmetros, geralmente separados por vírgulas. ZPL utiliza prefixos compactos e delimitadores de campos. Também muda a interpretação de fontes, coordenadas e configurações. Um texto curto parecido não comprova métricas iguais. Compare nomes longos de produtos e confira se as quebras de linha permanecem adequadas.
Não existe uma linguagem melhor em qualquer cenário. Uma aplicação TSPL estável pode continuar sendo a melhor opção para a instalação existente. ZPL faz sentido quando o sistema já gera esses modelos. Avalie comandos suportados, saídas do software e manutenção das etiquetas. Inclua logotipos, caracteres especiais, tipos de códigos de barras e recursos armazenados, além dos campos de texto mais visíveis.
Uma impressora TSPL pode imprimir ZPL?
Algumas impressoras TSC oferecem emulação ZPL no firmware; a documentação inclui famílias como TSPL-EZ e TSPL-EZD. Emulação significa interpretar outra linguagem. Não transforma o código TSPL em ZPL nem garante que cada comando se comporte exatamente como no dispositivo original. Confira os idiomas suportados pela configuração específica e teste etiquetas representativas.
Separe três perguntas: qual linguagem está no arquivo, qual a impressora aceita e o que o driver envia. Consulte relatório de configuração, utilitário do fabricante e manual. A descrição comercial “impressora térmica” não é suficiente. Antes de converter, veja se a aplicação de origem já exporta na linguagem desejada: isso pode reduzir manutenção manual e preservar melhor os dados variáveis.
A mesma mensagem em TSPL e ZPL
Os exemplos imprimem HELLO em uma etiqueta de aproximadamente 50 × 30 mm a 203 DPI. TSPL declara milímetros; ZPL usa 400 × 240 pontos. Os arredondamentos tornam as medidas aproximadas. Os exemplos expressam a mesma intenção, mas não a mesma tipografia: a fonte 3 de TSPL e a fonte 0 de ZPL têm métricas diferentes. Mantenha o teste separado de dados reais de envio.
Em TSPL, SIZE define o formato, GAP o intervalo do material, CLS limpa o buffer, TEXT posiciona texto e PRINT solicita impressão. Ajuste o intervalo de 2 mm ao rolo real antes do teste físico. O exemplo ZPL não configura a detecção de intervalo. Prepare material e calibração separadamente no equipamento final: um exemplo de linguagem não é um roteiro completo de configuração da impressora.
TSPL
SIZE 50 mm,30 mm
GAP 2 mm,0 mm
CLS
TEXT 30,30,"3",0,1,1,"HELLO"
PRINT 1,1ZPL
^XA
^PW400
^LL240
^FO30,30^A0N,24,16^FDHELLO^FS
^XZOs DPI também precisam ser considerados
A 203 DPI, 400 pontos medem aproximadamente 50 mm. A 300 DPI, os mesmos pontos medem cerca de 34 mm. Isso afeta posições, fontes e módulos dos códigos de barras. Traduzir comandos sem considerar resolução pode gerar uma etiqueta visível, mas fisicamente incorreta. Registre o DPI de origem e de destino antes de alterar parâmetros.
Para manter o tamanho físico, multiplique medidas em pontos por DPI de destino dividido pelo DPI de origem; depois confira arredondamento e requisitos dos códigos. Não escale dados codificados nem identificadores numéricos de produtos. Milímetros e coordenadas em pontos exigem tratamentos distintos. O conversor TSPL atual do EditorZPL transforma medidas físicas de SIZE usando 203 DPI; selecionar outro DPI na prévia não recalcula todas as coordenadas.
Como converter TSPL para ZPL no EditorZPL
Guarde o arquivo TSPL e uma impressão correta de referência. Abra o conversor, cole ou importe uma etiqueta completa e examine o ZPL gerado. Leia os avisos e compare a prévia nas dimensões previstas. Confira todos os campos: um lote incorreto ou um endereço cortado pode invalidar uma etiqueta mesmo quando o restante do layout parece bom.
O conversor trata comandos comuns de desenho, não um programa completo de impressora. Aproxima fontes, omite gráficos BITMAP e não preserva toda a configuração. DIRECTION, REFERENCE, CODEPAGE e PRINT são atualmente ignorados, exigindo revisão de orientação, caracteres e cópias. REVERSE é aproximado por um retângulo preenchido. São limites do conversor, não uma indicação de que ZPL seja incapaz de representar esses recursos.
Abrir o conversor TSPL para ZPLChecklist antes de usar em produção
Teste textos longos, acentos, campos vazios, elementos girados e dados reais de códigos. Se houver aviso de simbologia desconhecida, revise o mapeamento: o conversor pode substituir por Code 128. Um código que o scanner lê não é necessariamente do tipo solicitado nem contém os dados esperados. Compare a leitura com a origem e os requisitos do sistema que recebe a etiqueta.
Imprima uma amostra no dispositivo final com o material real. Confira dimensões, orientação, contraste, cortes e margens livres. Logotipos ausentes podem precisar ser recriados ou instalados separadamente. Teste uma etiqueta antes de um lote e confirme as quantidades, sem presumir que PRINT foi preservado. Guarde o modelo anterior e registre equipamento, firmware, DPI e alterações para facilitar a manutenção.
Quando manter TSPL, emular ou migrar
Mantenha TSPL se aplicação e impressora o utilizam corretamente e não houver requisito para mudar. Considere emulação documentada ao substituir o equipamento mantendo modelos existentes. Converta quando o fluxo receptor exigir ZPL e a exportação nativa não estiver disponível. Compare as opções com uma etiqueta representativa, em vez de decidir apenas pela idade da linguagem ou marca da impressora.
Se uma etiqueta simples funciona e a de produção falha, acrescente seus elementos um por vez. Separe comunicação de layout: um dispositivo que não recebe trabalho precisa de investigação diferente de outro que imprime um código incompleto. O objetivo é um processo repetível e validado, não apenas um arquivo que passe pelo conversor sem avisos.
Perguntas frequentes
TSPL e ZPL são a mesma linguagem?
Não. Sintaxe e interpretação diferem. Etiquetas semelhantes precisam de instruções distintas, a menos que a impressora ofereça emulação adequada.
Toda impressora TSC aceita ZPL?
Não presuma isso. Verifique modelo, firmware e emulação habilitada e valide seu modelo real de etiqueta.
Posso visualizar TSPL online?
A ferramenta TSPL para ZPL converte instruções compatíveis e mostra o ZPL resultante. Não é uma emulação completa do firmware TSPL; omissões e aproximações afetam a prévia.
Esta ferramenta converte ZPL para TSPL?
A direção disponível é TSPL para ZPL. O caminho inverso exige outra implementação ou exportação pelo seu software. Alterar a extensão não converte o conteúdo.
Guias relacionados
Referências oficiais
- TSC: TSPL/TSPL2 Programming Manual
- TSC: Customizable Printer Language Firmware
- TSC: FAQs — TSPL-EZ / TSPL-EZC
- Zebra: ^XA — Start Format
Referências e comportamento do conversor verificados em 4 de outubro de 2026. Ilustração de impressoras genéricas gerada por IA.
Sobre o autor
Eduard Diaz
Eduard Diaz é técnico de TI (desenvolvimento) na S-IE, parceira oficial da Zebra com mais de 20 anos oferecendo serviços de identificação e etiquetagem. Ele desenvolve e mantém o EditorZPL para facilitar o trabalho com ZPL e impressoras de etiquetas Zebra.
s-ie.cat