Referencia de Comandos ZPL y Cheat Sheet
ZPLCraftActualizado el 17 de agosto de 2026
Esta es una referencia práctica de comandos ZPL II de uso común para estructura de formato, texto, fuentes, códigos de barras, gráficos y control de impresora. Todas las posiciones y tamaños están en puntos de impresora (203 dpi = 8 puntos/mm — consulta ¿Qué es ZPL? para los conceptos básicos). Los parámetros que aparecen en la columna de sintaxis son: x,y = posición desde la esquina superior izquierda, h,w = alto y ancho, o = orientación (N normal, R 90°, I 180°, B 270°).
Formato de etiqueta
| Comando | Sintaxis | Qué hace |
|---|---|---|
^XA | ^XA | Inicio del formato de etiqueta. Cada etiqueta comienza con este comando. |
^XZ | ^XZ | Fin del formato de etiqueta. La impresora renderiza e imprime la etiqueta al recibirlo. |
^FX | ^FXcomment | Comentario — ignorado por la impresora. Termínalo con ^FS como cualquier campo. |
^PW | ^PWwidth | Ancho de impresión en puntos. Configúralo al ancho de tu etiqueta para que los campos no queden recortados. |
^LL | ^LLlength | Longitud de la etiqueta en puntos. Necesaria principalmente para medios continuos (sin separación). |
^LH | ^LHx,y | Inicio de etiqueta — desplaza el origen para todas las posiciones ^FO subsiguientes. |
^PQ | ^PQqty | Cantidad de impresión — cuántas copias de esta etiqueta imprimir. |
^PR | ^PRspeed | Velocidad de impresión en pulgadas por segundo. Más lento suele imprimir más oscuro y nítido. |
^MD | ^MDdarkness | Ajuste de oscuridad del medio, de -30 a 30. Auméntalo si la impresión está tenue. |
Campos y texto
| Comando | Sintaxis | Qué hace |
|---|---|---|
^FO | ^FOx,y | Origen de campo — posiciona el siguiente campo en x,y puntos desde el inicio de la etiqueta. |
^FD | ^FDdata | Datos de campo — el contenido (texto o datos de código de barras) del campo actual. |
^FS | ^FS | Separador de campo — cierra el campo actual. Obligatorio después de cada campo. |
^FB | ^FBwidth,lines,space,align | Bloque de campo — envuelve el texto ^FD en un bloque: ancho máximo, máximo de líneas, interlineado, alineación (L/C/R/J). |
^FR | ^FR | Campo invertido — imprime el campo en blanco sobre negro donde se superpone a un área negra. |
^FH | ^FH | Campo hexadecimal — permite escapes _xx en ^FD, p. ej. _C3_A9 para é. |
^CI | ^CIencoding | Conjunto de caracteres; ^CI28 selecciona UTF-8 y es recomendable para cualquier texto no ASCII. |
Fuentes
| Comando | Sintaxis | Qué hace |
|---|---|---|
^A | ^Afo,h,w | Fuente para el siguiente campo: letra de fuente f (0–9, A–Z), orientación, altura y ancho en puntos. ^A0N,40,40 es la fuente escalable predeterminada a 40 puntos. |
^CF | ^CFf,h,w | Cambia la fuente predeterminada para todos los campos siguientes que no tengan su propio ^A. |
^A@ | ^A@o,h,w,name | Usa un archivo de fuente almacenado en la impresora (p. ej. TrueType descargado). |
La fuente 0 es la fuente vectorial escalable y la opción habitual; las fuentes A–H son fuentes bitmap de tamaño fijo que solo se ven bien en sus tamaños nativos o múltiplos enteros.
Códigos de barras
| Comando | Sintaxis | Qué hace |
|---|---|---|
^BY | ^BYw,r,h | Valores predeterminados de campo de código de barras: ancho de módulo (barra estrecha) en puntos, proporción ancho-estrecho, altura predeterminada. Configúralo antes del comando de código de barras. |
^BC | ^BCo,h,f,g,e,m | Code 128 — el código de barras 1D de referencia para envíos y logística. f=Y imprime la línea legible por humanos, g=Y la imprime encima del código. |
^B3 | ^B3o,e,h,f,g | Code 39 — simbología 1D más antigua, aún requerida por algunas especificaciones industriales y de defensa. |
^BE | ^BEo,h,f,g | Código de barras EAN-13 para retail (usa ^BU para UPC-A). |
^BQ | ^BQa,model,mag,ec | Código QR. La magnificación 1–10 establece el tamaño del módulo; ec establece la corrección de errores (H/Q/M/L). Antepone el modo de codificación a los datos, p. ej. ^FDQA,https://… |
^BX | ^BXo,h,s,c,r,f | Data Matrix — código 2D compacto común en etiquetas de electrónica y sanidad. |
^B7 | ^B7o,h,m,c,r,t | PDF417 — código 2D apilado usado en identificaciones y algunos documentos logísticos. |
El tamaño del código de barras depende de la simbología. Utiliza ^BY para definir el ancho del módulo, la proporción y la altura; después sigue la especificación aplicable de la simbología, el transportista o el sector para las dimensiones mínimas y las zonas de silencio. Una vista previa no sustituye la verificación de la impresión física con el escáner y el soporte de producción.
Gráficos
| Comando | Sintaxis | Qué hace |
|---|---|---|
^GB | ^GBw,h,t,c,r | Recuadro gráfico: ancho, alto, grosor del borde, color (B/W), redondeo de esquinas 0–8. Un ^GB fino es la forma de dibujar líneas. |
^GC | ^GCd,t,c | Círculo gráfico con diámetro d y grosor de borde t. |
^GD | ^GDw,h,t,c,o | Línea diagonal gráfica dentro de un recuadro de w×h; o establece la dirección (L o R). |
^GF | ^GFa,b,c,d,data | Campo gráfico — incrusta un bitmap (p. ej. un logotipo) directamente en la etiqueta como datos hex o binarios. |
~DG | ~DGd:name,t,w,data | Descarga gráfica — almacena una imagen en la impresora y luego la posiciona con ^XG. |
^XG | ^XGd:name,mx,my | Recupera un gráfico almacenado en el origen del campo actual, con magnificación x/y. |
Control y estado de la impresora
| Comando | Sintaxis | Qué hace |
|---|---|---|
~HS | ~HS | Estado del host — la impresora responde con información sobre falta de papel, pausa, búfer y odómetro. |
~HI | ~HI | Identificación del host — modelo, versión de firmware, DPI y memoria. |
^MM | ^MMmode | Modo de impresión: T arrancar, P despegar, R rebobinar, C cortador. |
^MN | ^MNtype | Seguimiento de medios: Y detección de separación/tela, M marca negra, N continuo. |
~JC | ~JC | Ejecutar calibración de medios (la impresora avanza algunas etiquetas para encontrar la separación). |
~JA | ~JA | Cancelar todos los formatos de etiqueta en el búfer de la impresora. |
^JUS | ^JUS | Guardar la configuración actual en flash para que sobreviva a un ciclo de energía. |
Poniéndolo todo junto
Una etiqueta de envío típica de 4×6 usando la mayoría de los grupos anteriores:
^XA
^PW812
^CI28
^CF0,32
^FO40,40^FDSHIP TO:^FS
^FO40,80^A0N,44,44^FDAcme Industries^FS
^FO40,130^FD500 Warehouse Way^FS
^FO40,170^FDSpringfield, IL 62701^FS
^FO40,230^GB732,3,3^FS
^FO40,260^FDOrder #A-10592 / 3 of 4^FS
^BY3,2,120
^FO140,320^BCN,120,Y,N,N^FD4210159200083^FS
^XZEditar coordenadas de puntos a mano cansa rápido — cada ajuste de diseño implica cambiar números y reimprimir. Si prefieres arrastrar los campos a su lugar y dejar que el ZPL se escriba solo, el editor de ZPLCraft que se muestra a continuación compila un lienzo visual a exactamente este tipo de ZPL limpio, y puede enviarlo por una vía USB compatible del navegador a la impresora cuando el navegador, el sistema operativo y la impresora ofrezcan una interfaz disponible.