Recursos ZPL: Comandos, Calibración y Drivers Zebra
ZPL es el lenguaje nativo de toda impresora Zebra. Aquí encontrará la estructura de una etiqueta, los comandos más usados con ejemplos, cómo imprimir una etiqueta de prueba, cómo calibrar su impresora Zebra ZD o ZT, y dónde descargar los drivers oficiales.
¿Qué es ZPL y por qué le conviene aprenderlo?
ZPL (Zebra Programming Language) es el lenguaje con el que las impresoras Zebra describen una etiqueta: texto, códigos de barras, líneas y cajas. Es texto plano — cada instrucción comienza con ^ o ~ — y la impresora lo interpreta directamente, sin depender de un driver gráfico. La versión actual, ZPL II, lleva décadas como el estándar de facto del etiquetado industrial.
Un solo formato, toda la flota
El mismo archivo ZPL imprime en una ZD421 de escritorio, una ZT231 industrial o una móvil de la serie ZQ600 Plus. Solo cuide la resolución: a 203 dpi el equipo trabaja a 8 puntos por mm, y las coordenadas cambian al migrar a 300 dpi.
Integración sin fricción
Cualquier sistema que genere texto puede imprimir etiquetas: un ERP, un WMS o una aplicación web. Basta enviar la cadena ZPL por USB o, en red, al puerto TCP 9100. Por eso nuestro WMS P4 Warehouse genera ZPL nativo: la etiqueta sale idéntica en cualquier bodega.
Control total del resultado
A diferencia de imprimir desde Word o un PDF, con ZPL usted decide la posición exacta de cada campo, la simbología del código y la cantidad de copias. El resultado es repetible: la etiqueta que valida hoy es la que saldrá en las tres mil del turno de mañana.
Anatomía de una Etiqueta ZPL: de ^XA a ^XZ
Todo formato ZPL vive entre dos comandos: ^XA abre la etiqueta y ^XZ la cierra e imprime. En medio, cada campo se posiciona con ^FO, se llena con ^FD y se cierra con ^FS. Las medidas van en puntos: a 203 dpi, una etiqueta de 4×6 pulgadas equivale a 812 × 1218 puntos.
^XA
^CI28
^PW812
^LL1218
^FO40,40^GB732,120,3^FS
^FO60,75^A0N,55,55^FDBARRDEGA S.A.^FS
^FO60,210^A0N,35,35^FDDestino: Ciudad de Panamá^FS
^FO60,265^A0N,35,35^FDPedido: 00012345^FS
^FO60,360^BCN,120,Y,N,N^FD00012345^FS
^FO540,360^BQN,2,6^FDQA,https://barrdega.com^FS
^PQ1
^XZ- ^CI28 activa UTF-8: sin esta línea, las tildes y la eñe pueden salir como símbolos extraños.
- ^PW812 y ^LL1218 declaran el ancho y el largo de la etiqueta en puntos (4×6 pulgadas a 203 dpi).
- ^GB732,120,3 dibuja una caja de 732 × 120 puntos con borde de 3 puntos.
- ^BCN,120,Y,N,N genera un Code 128 de 120 puntos de alto con el texto legible debajo.
- ^BQN,2,6 imprime un QR modelo 2 con ampliación 6; el prefijo QA, del ^FD define corrección de errores Q y entrada automática.
- ^PQ1 indica una sola copia; cámbielo a ^PQ50 y la impresora repetirá el formato cincuenta veces.
Los Comandos ZPL que Resuelven el 90% de las Etiquetas
ZPL tiene cientos de comandos, pero una docena cubre casi cualquier etiqueta logística. Guarde esta tabla: es la chuleta que usamos a diario al configurar formatos para clientes.
| Comando | Qué hace | Ejemplo |
|---|---|---|
| ^XA / ^XZ | Abre y cierra el formato de etiqueta; todo lo demás va en medio | ^XA ... ^XZ |
| ^FO | Posiciona el campo: coordenadas x,y en puntos desde la esquina superior izquierda | ^FO50,100 |
| ^FD / ^FS | Contenido del campo (texto o datos del código) y cierre del campo | ^FDLote A-123^FS |
| ^A | Fuente, orientación y tamaño en puntos (alto, ancho); la fuente 0 es escalable | ^A0N,40,40 |
| ^BC | Código de barras Code 128, el estándar logístico: orientación, alto, texto legible | ^BCN,100,Y,N,N |
| ^BQ | Código QR: modelo y factor de ampliación; los datos van en el ^FD con prefijo QA, | ^BQN,2,6 |
| ^GB | Caja o línea: ancho, alto y grosor del borde en puntos; con alto 2 dibuja una línea | ^GB600,2,2^FS |
| ^PW | Ancho de impresión en puntos; a 203 dpi, 812 puntos equivalen a 4 pulgadas | ^PW812 |
| ^LL | Largo de la etiqueta en puntos; útil sobre todo en material continuo | ^LL1218 |
| ^PQ | Cantidad de copias del formato | ^PQ3 |
| ^CI28 | Codificación UTF-8: imprescindible para tildes y eñes en español | ^CI28 |
| ~SD | Oscuridad de impresión, escala 0 a 30; se guarda en la impresora | ~SD20 |
| ^PR | Velocidad de impresión en pulgadas por segundo; menos velocidad, mejor calidad | ^PR4 |
La referencia completa es la ZPL II Programming Guide de Zebra, gratuita en zebra.com. Pero antes de leer setecientas páginas, pruebe la tabla: con estos trece comandos se construye desde una etiqueta de rack hasta una de envío con QR de rastreo.
Cómo Imprimir su Primera Etiqueta de Prueba
Copie este formato mínimo en un archivo de texto y guárdelo como prueba.zpl. Hay tres maneras de enviarlo a la impresora.
^XA
^CI28
^FO50,50^A0N,50,50^FDPrueba ZPL - Barrdega^FS
^FO50,130^BCN,100,Y,N,N^FD123456^FS
^XZ1. Con Zebra Setup Utilities
La vía más cómoda en Windows: abra la herramienta de comunicación directa, pegue el código ZPL y envíelo. La etiqueta sale al instante y puede iterar el diseño línea por línea.
2. Por red, al puerto 9100
Toda impresora Zebra en red escucha datos crudos en el puerto TCP 9100. Cualquier sistema — un script, su ERP o su WMS — puede abrir una conexión a la dirección IP de la impresora, transmitir el archivo y cerrarla. Sin driver, sin cola de impresión.
3. Desde el driver o el panel
El driver ZDesigner imprime una página de prueba desde las propiedades de la impresora, y los ZT con pantalla incluyen una etiqueta de configuración en el menú. Útil para confirmar que equipo y material responden antes de depurar su formato.
Calibrar una Impresora Zebra: Medios, Oscuridad y Velocidad
La mayoría de los problemas de impresión que atendemos no son fallas del equipo: son impresoras sin calibrar tras un cambio de material, o con oscuridad y velocidad mal combinadas para el papel y el ribbon en uso.
Calibración de medios
Al cambiar el tamaño o tipo de etiqueta, la impresora debe volver a aprender dónde termina una y empieza la siguiente. En los modelos de escritorio ZD se ejecuta con la secuencia del botón de avance (FEED) que indica el manual, o con un clic desde Zebra Setup Utilities; en los industriales ZT, desde el menú de sensores del panel frontal. Si la impresora «se come» etiquetas en blanco o corta a mitad del formato, esta es la primera medicina.
Oscuridad (darkness)
La escala va de 0 a 30 y se ajusta con ~SD, desde el driver o el panel. Empiece en un punto medio y suba de dos en dos hasta que el código de barras quede negro y nítido. Pasarse de oscuridad engrosa las barras, deforma el QR y acorta la vida del cabezal; quedarse corto produce impresión pálida que el escáner rechaza.
Velocidad de impresión
A menor velocidad, más tiempo de contacto del cabezal y mejor definición — especialmente sobre materiales sintéticos y con ribbon de resina. Si una etiqueta crítica no escanea a la primera, baje la velocidad con ^PR o desde el driver antes de tocar nada más. La regla de oro: la mínima oscuridad y la máxima velocidad que produzcan un código que escanee siempre.
El material importa tanto como el ajuste
Ninguna calibración compensa una combinación incorrecta de etiqueta y ribbon. Si sus etiquetas se borran, se manchan o despegan, revise primero el consumible: nuestra guía de materiales de etiquetas explica cómo elegirlo, y ofrecemos suministros genuinos Zebra certificados para cada cabezal.
Síntomas Comunes y su Solución
Antes de abrir un ticket de soporte, recorra esta tabla: resuelve la mayoría de los casos en minutos.
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| Impresión pálida o gris | Oscuridad baja o velocidad excesiva para el material | Suba la oscuridad (~SD) de dos en dos y reduzca la velocidad (^PR) |
| Salen etiquetas en blanco o el corte queda desfasado | Sensores sin calibrar tras un cambio de material | Ejecute la calibración de medios desde el panel, el driver o Zebra Setup Utilities |
| Texto o código cortado en el borde | ^PW o ^LL no coinciden con la etiqueta física | Recalcule el ancho y el largo en puntos según los dpi reales del equipo |
| Tildes y eñes salen como símbolos | Codificación de caracteres incorrecta | Agregue ^CI28 al inicio del formato y guarde el archivo en UTF-8 |
| El código de barras no escanea | Altura insuficiente, sin zona de silencio o impresión deficiente | Aumente el alto del ^BC, deje márgenes libres a los lados y baje la velocidad |
| Líneas blancas verticales en toda la etiqueta | Cabezal sucio o con elementos quemados | Limpie el cabezal con alcohol isopropílico; si la línea persiste, toca reemplazarlo |
Drivers y Herramientas: Dónde Descargarlos
Todo el software oficial es gratuito en la página de soporte y descargas de Zebra. Estas son las cuatro piezas que recomendamos instalar.
Zebra Setup Utilities
La navaja suiza: detecta la impresora por USB o red, configura conectividad, lanza la calibración y — lo más valioso para quien programa ZPL — permite enviar comandos directamente al equipo y ver su respuesta. Es lo primero que instalamos en cada implementación.
Driver ZDesigner para Windows
Necesario cuando se imprime desde aplicaciones de oficina o sistemas que no generan ZPL propio. Expone oscuridad, velocidad y tamaño de etiqueta como preferencias de impresión, para que el operador ajuste sin tocar código.
ZebraDesigner
Editor visual de etiquetas: arrastra campos, códigos de barras y logos, e imprime a través del driver sin escribir una línea de ZPL. La edición Essentials es gratuita y cubre formatos sencillos; para datos variables conviene pasar a código o a etiquetado profesional.
NiceLabel / Loftware
Cuando el etiquetado es corporativo — plantillas centralizadas, aprobaciones, decenas de impresoras en varias sedes — el siguiente nivel es NiceLabel de Loftware, que diseñamos e implementamos como partner autorizado.
ZPL en Producción: Conectado a su WMS o ERP
Una etiqueta de prueba es el comienzo; el valor real aparece cuando el sistema imprime solo. El patrón habitual es una plantilla ZPL con marcadores de posición que el software rellena con los datos de cada transacción — SKU, lote, pedido, destino — y envía a la impresora correcta por el puerto 9100. Sin intervención del operador.
Así trabaja P4 Warehouse, el WMS desarrollado por nuestra empresa hermana P4 Software: genera ZPL nativo para etiquetas de ubicación, paleta, producto y despacho, directo a cualquier impresora Zebra. Como además somos ISV de Zebra, el formato, la impresora y el sistema llegan probados como un solo paquete.
¿Aún elige el equipo? Nuestra guía de impresoras Zebra compara los modelos de escritorio e industriales, y el catálogo completo reúne todas las líneas con envío a toda Latinoamérica.