TSPL vs ZPL: diferencias, compatibilidad y conversión
Una plantilla funciona en una impresora, pero no en la que la sustituye. Antes de cambiar cables o rehacer el diseño, comprueba el lenguaje de comandos. TSPL y ZPL pueden describir etiquetas similares, pero sus instrucciones no son intercambiables. Algunas impresoras ofrecen emulación; otras necesitan una plantilla convertida o una salida diferente del programa. Esta guía explica cómo distinguir esas situaciones y preparar una migración que puedas comprobar paso a paso.
¿Qué son TSPL, TSPL2 y ZPL?
TSPL y TSPL2 son lenguajes de programación documentados por TSC para impresoras de etiquetas. Utilizan comandos legibles como SIZE, CLS, TEXT, BARCODE y PRINT. TSPL2 no es otro nombre de ZPL: TSC documenta diferencias entre TSPL y TSPL2, incluido el comportamiento de las fuentes. Un comando o una fuente disponible en un equipo puede comportarse de otra manera en otro. Consulta el manual del modelo y firmware concretos.
ZPL significa Zebra Programming Language. Los formatos ZPL II suelen comenzar con ^XA y terminar con ^XZ, con ^FO para posicionar campos y ^FD para introducir datos. Ambos lenguajes describen el contenido; su nombre no determina papel, conexión ni resolución. USB y Ethernet pueden transportar el mismo lenguaje. Cambiar el cable no traduce los comandos ni adapta el diseño a una impresora distinta.
Diferencias que afectan al resultado
La primera diferencia es la sintaxis. TSPL utiliza nombres de comandos y parámetros, normalmente separados por comas. ZPL emplea prefijos compactos y delimitadores de campo. También cambia la interpretación de fuentes, coordenadas y ajustes de impresora. Que un texto corto se vea parecido no demuestra que las métricas coincidan. Compara nombres de producto largos y comprueba si se mantienen sus saltos de línea.
No hay un lenguaje mejor para cualquier situación. Una aplicación TSPL que funciona puede ser la opción adecuada para una instalación existente. ZPL encaja cuando el sistema ya genera esas plantillas. Valora qué comandos admite el dispositivo, qué exporta el software y quién mantendrá los diseños. Incluye logotipos, caracteres especiales, simbologías de códigos y recursos almacenados, además de los campos de texto visibles.
¿Una impresora TSPL puede imprimir ZPL?
Algunas impresoras TSC ofrecen emulación ZPL mediante su firmware; el fabricante documenta familias como TSPL-EZ y TSPL-EZD. Emular significa interpretar otro lenguaje. No convierte el código TSPL en código ZPL ni garantiza que todos los comandos se comporten exactamente como en el equipo original. Comprueba los lenguajes admitidos por la configuración concreta y prueba etiquetas representativas.
Separa tres preguntas: qué lenguaje contiene el archivo, cuál acepta la impresora y qué envía el controlador. Consulta el informe de configuración, la utilidad del fabricante y el manual. Una ficha comercial que diga “impresora térmica” no basta. Antes de convertir, comprueba si la aplicación de origen ya exporta el lenguaje de destino: puede reducir mantenimiento manual y conservar mejor la gestión de datos variables.
El mismo mensaje en TSPL y ZPL
Los ejemplos imprimen HELLO en una etiqueta de aproximadamente 50 × 30 mm a 203 DPI. TSPL declara milímetros; ZPL utiliza 400 × 240 puntos. El redondeo hace que las medidas sean aproximadas. Representan la misma intención, no una tipografía idéntica: la fuente 3 de TSPL y la fuente 0 de ZPL tienen métricas distintas. Mantén la prueba separada de los datos reales de envíos.
En TSPL, SIZE define el formato, GAP la separación del soporte, CLS limpia el búfer, TEXT coloca texto y PRINT solicita la impresión. Ajusta los 2 mm de separación del ejemplo al rollo real antes de imprimir. El ejemplo ZPL no configura el sensor de separación. Prepara soporte y calibración en la impresora de destino por separado: un ejemplo de lenguaje no es un procedimiento completo de configuración del equipo.
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
^XZLos DPI también deben coincidir
A 203 DPI, 400 puntos equivalen aproximadamente a 50 mm. A 300 DPI, esos mismos puntos representan unos 34 mm. Esto afecta a posiciones, fuentes y módulos de códigos de barras. Traducir el nombre de los comandos sin considerar la resolución puede producir una etiqueta visible pero con dimensiones físicas incorrectas. Anota la resolución de origen y destino antes de modificar parámetros.
Para mantener el tamaño físico, escala las medidas expresadas en puntos por DPI de destino dividido entre DPI de origen y revisa redondeos y requisitos del código. No escales datos codificados ni identificadores numéricos de producto. Milímetros y coordenadas en puntos requieren un tratamiento diferente. El conversor TSPL actual de EditorZPL interpreta las medidas físicas de SIZE a 203 DPI; cambiar los DPI de previsualización no recalcula todas las coordenadas.
Cómo convertir TSPL a ZPL en EditorZPL
Conserva el archivo TSPL y una impresión correcta de referencia. Abre el conversor, pega o importa una etiqueta completa y revisa el ZPL generado. Lee las advertencias y compara la vista previa con las dimensiones previstas. Comprueba todos los campos: un número de lote o una dirección recortada puede invalidar una etiqueta aunque el resto del diseño parezca correcto.
El conversor procesa comandos habituales de diseño, no un programa completo de impresora. Aproxima fuentes, omite gráficos BITMAP y no conserva todas las instrucciones de configuración. Actualmente ignora DIRECTION, REFERENCE, CODEPAGE y PRINT, por lo que hay que revisar orientación, caracteres y número de copias. REVERSE se aproxima mediante un rectángulo relleno. Son límites del conversor; no significan que ZPL sea incapaz de representar esas funciones.
Abrir el conversor TSPL a ZPLComprobaciones antes de pasar a producción
Prueba los textos más largos, acentos, campos vacíos, elementos girados y datos reales de códigos. Si aparece una advertencia por una simbología desconocida, revisa la correspondencia: el conversor puede sustituirla por Code 128. Que un código se pueda escanear no demuestra que su tipo o contenido sean los requeridos. Contrasta la lectura con el original y con las exigencias del sistema receptor.
Imprime una muestra en el dispositivo final con el soporte real. Comprueba medidas, orientación, contraste, recortes y márgenes libres. Algunos logotipos deberán reconstruirse o instalarse aparte. Prueba una etiqueta antes de un lote y verifica cantidades: no presupongas que PRINT se ha conservado. Guarda la plantilla anterior y registra modelo, firmware, resolución y cambios realizados para facilitar futuras revisiones.
Cuándo conservar TSPL, emular o migrar
Conserva TSPL si aplicación e impresora lo gestionan correctamente y no existe un requisito que justifique cambiar. Valora la emulación documentada al sustituir equipos manteniendo plantillas. Convierte cuando el flujo receptor necesite ZPL y no haya exportación nativa. Compara las alternativas con una etiqueta representativa, sin decidir únicamente por antigüedad del lenguaje o marca del dispositivo.
Si una prueba sencilla funciona y la plantilla de producción no, añade sus elementos de uno en uno. Distingue comunicación y diseño: una impresora que no recibe ningún trabajo exige una investigación distinta de otra que dibuja un código incompleto. Busca un proceso repetible con resultados comprobados, no simplemente un archivo que atraviese el conversor sin advertencias.
Preguntas frecuentes
¿TSPL y ZPL son el mismo lenguaje?
No. Cambian la sintaxis y la interpretación. Etiquetas similares requieren instrucciones diferentes salvo que la impresora disponga de una emulación adecuada.
¿Todas las impresoras TSC aceptan ZPL?
No lo des por hecho. Comprueba modelo, firmware y emulación habilitada, y valida la plantilla real.
¿Puedo visualizar TSPL online?
La herramienta TSPL a ZPL convierte instrucciones admitidas y muestra el ZPL resultante. No emula todo el firmware TSPL: omisiones y aproximaciones pueden afectar a la vista previa.
¿Esta herramienta convierte ZPL a TSPL?
La dirección disponible es TSPL a ZPL. La inversa requiere otra implementación o una exportación desde tu software. Cambiar la extensión no convierte el contenido.
Guías relacionadas
Referencias oficiales
- TSC: TSPL/TSPL2 Programming Manual
- TSC: Customizable Printer Language Firmware
- TSC: FAQs — TSPL-EZ / TSPL-EZC
- Zebra: ^XA — Start Format
Referencias y comportamiento del conversor revisados el 4 de octubre de 2026. Ilustración de impresoras genéricas generada con IA.
Sobre el autor
Eduard Diaz
Eduard Diaz es técnico IT (desarrollo) en S-IE, partner oficial de Zebra con más de 20 años ofreciendo servicios de identificación y etiquetado. Desarrolla y mantiene EditorZPL para facilitar el trabajo con ZPL e impresoras de etiquetas Zebra.
s-ie.cat