Convertir ZPL a TSPL: equivalencias de comandos y guía de migración (Zebra → TSC)

Cómo se corresponden los comandos ZPL con TSPL, qué cambia en unidades, fuentes y códigos, una etiqueta real antes/después, y cómo migrar una librería Zebra a impresoras TSC sin rediseñar.

Pasar de Zebra a TSC es la migración de impresoras más común en logística y retail: las TSC cuestan menos y su mecánica es compatible con las mismas etiquetas y cintas. El obstáculo es el lenguaje. ZPL y TSPL describen lo mismo — un texto en una posición, un código de barras, un recuadro — con sintaxis completamente distinta, así que cada plantilla ZPL existente tiene que reescribirse, salvo que algo la traduzca por ti.

Equivalencias de comandos

Operación	ZPL (Zebra)	TSPL (TSC)
Inicio / fin de etiqueta	^XA … ^XZ	CLS … PRINT 1
Tamaño de etiqueta	^PW800 ^LL600 (puntos)	SIZE 100 mm,75 mm GAP 3 mm,0
Posición de un campo	^FO50,40 (x,y en puntos)	Primeros dos parámetros de TEXT/BARCODE (x,y en puntos)
Texto	^A0N,40,40 ^FDHola^FS	TEXT 50,40,"0",0,12,12,"Hola"
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,datos^FS	QRCODE 400,150,M,6,A,0,"datos"
Data Matrix	^BXN,6,200 ^FDdatos^FS	DMATRIX 400,150,120,120,"datos"
Recuadro / línea	^GB300,2,2^FS	BOX x,y,xend,yend,2 / BAR x,y,w,h
Copias	^PQ10	PRINT 10,1
Oscuridad / velocidad	^MD15 ^PR4	DENSITY 10 SPEED 4

Qué cambia realmente

Unidades: ZPL trabaja solo en puntos; TSPL acepta milímetros o pulgadas en SIZE y GAP pero posiciones en puntos. Una plantilla ZPL de 203 dpi llevada a una TSC de 300 dpi necesita cada coordenada escalada por 1.48.
Fuentes: la ^A0 de ZPL es una fuente escalable dimensionada en puntos; las fuentes internas 1–8 de TSPL son mapas de bits fijos con multiplicadores enteros, y la fuente "0" es escalable pero se dimensiona en puntos por carácter. Los anchos de texto no coincidirán exactamente — revisa etiquetas con nombres de producto largos.
Parámetros de código: ZPL fija el ancho de módulo una vez con ^BY y lo reutiliza; TSPL declara ancho de barra estrecha y ancha en cada comando BARCODE. El texto legible es una bandera en ambos, pero su fuente y posición difieren.
Origen y orientación: ambos usan la esquina superior izquierda, pero DIRECTION y REFERENCE de TSPL cambian dónde queda (0,0); decláralos explícitamente en cada trabajo.
Gráficos: los mapas de bits ^GF de ZPL y BITMAP de TSPL tienen orden de bytes y polaridad distintos; los logotipos deben recodificarse, no copiarse.
RFID: los comandos ^RF no tienen equivalente en modelos TSC sin RFID; en los TSC con RFID el juego de comandos es distinto y la codificación debe redefinirse.

Antes y después: la misma 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

Observa cómo el tamaño de etiqueta pasa a unidades físicas, cada campo lleva sus propias coordenadas y el código declara sus anchos de barra en línea. Los datos — producto, lote, GTIN — no se tocan; solo cambió el envoltorio.

Lista de verificación para migrar

Confirma la resolución (203 vs 300 dpi) antes de escalar coordenadas.
Imprime cada plantilla una vez en la TSC y califica los códigos (ISO 15416); ajusta el ancho de barra estrecha si baja el grado.
Verifica que los textos variables largos no se desborden — las fuentes TSPL son más anchas a igual tamaño nominal.
Recodifica los logotipos como mapas de bits TSPL o, mejor, mantenlos como objetos vectoriales en la herramienta de diseño.
Conserva la versión ZPL en tu librería: las flotas mixtas son la norma durante una transición.

Cómo lo hace EtikStudio

Pega o importa el archivo ZPL; el intérprete lo renderiza como diseño editable en milímetros. Elige un perfil de impresora TSC y exporta: EtikStudio regenera el TSPL con coordenadas escaladas a la resolución destino, fuentes sustituidas con métricas equivalentes, códigos reconstruidos por módulo y logotipos recodificados. El mismo diseño sigue imprimiendo en las Zebra hasta que se retire la última.

Los ejemplos de comandos están simplificados por claridad; la sintaxis exacta varía según modelo y firmware. Prueba siempre en la impresora destino.