zplCloud Blog
Configuración de una Zebra en la nube: speed run de 15 minutos
Cada comando completo, en el orden en que lo tecleas, con los dos pasos en los que de verdad se pierde tiempo.
La promesa
Una impresora Link-OS nueva debería estar imprimiendo etiquetas de producción en unos quince minutos, no en una tarde. Abajo está el run con comandos reales. Dos pasos se comen sistemáticamente el presupuesto - la calibración del medio y la oscuridad - así que reciben atención aquí en lugar de una viñeta.
0 - Desembalar (2 min)
Retira los bloqueos de transporte y la protección del cabezal de impresión, carga el medio y, para transferencia térmica, carga la cinta. Enciende y deja que se calibre.
Si la impresora alimenta varias etiquetas en blanco y se detiene, está calibrando la detección de hueco/marca negra. Déjala terminar; interrumpir es como acabas persiguiendo un problema de longitud de etiqueta en el paso 5.
1 - Red (3 min)
- Ethernet: conéctala, DHCP hace el resto.
- Wi-Fi: panel frontal, o la app de Android por USB si el panel no coopera.
Anota la IP. La necesitas exactamente una vez.
2 - Conecta a zplCloud (3 min)
Elige una:
Weblink - la impresora mantiene una conexión saliente con la plataforma:
irm "https://zplcloud.com/weblink-deploy.ps1?hostname=printer01&apikey=sk_zplcloud_XXXX" | iex
curl -fsSL "https://zplcloud.com/weblink-deploy.sh?hostname=printer01&apikey=sk_zplcloud_XXXX" | bash
El script descarga los tres certificados de la impresora, los sube por TCP 9100, establece las variables de Weblink y NTP, y reinicia el dispositivo. Si el hostname no se resuelve en tu red, añade &ip=10.0.0.5 - el hostname sigue eligiendo el certificado, la IP es solo el objetivo TCP.
Agente CLI - una máquina en la LAN registra la impresora:
curl -fsSL https://zplcloud.com/install-cli.sh | sh
zplcloud proxy --agent "Warehouse Berlin" --service-install --api-key sk_zplcloud_XXXX
Ambos son solo salientes. Sin puerto de entrada, sin cambio de cortafuegos.
3 - Aplica un perfil de impresora (2 min)
Las impresoras vienen con ajustes genéricos que no coinciden con tu medio.
zplcloud profiles list
zplcloud profiles apply "Shipping 102x152" --target 10.0.0.5
El perfil empuja oscuridad (^MD), velocidad (^PR), manejo de medio y cualquier variable SGD que defina. Las variables se pueden rellenar en el momento de aplicar:
zplcloud profiles apply 42 --target 10.0.0.5 --var gtin=4006381333930 --var charge=LOT-42
Este es el paso que decide si el paso 5 funciona. Una oscuridad demasiado baja da un código de barras que escanea en la oficina y falla en el transportista; demasiado alta y las barras finas se funden. La térmica directa y la transferencia térmica necesitan valores distintos, y también cada proveedor de medio.
4 - Diseña la etiqueta (3 min)
Abre el diseñador, parte de una plantilla, añade los campos que varían y vincúlalos a tus datos. Comprueba la vista previa PNG/PDF/SVG - la renderiza el mismo motor que produce el ZPL, así que no es una aproximación de la salida.
5 - Imprime y verifica (2 min)
zplcloud send --target 10.0.0.5 --zpl "^XA^FO50,50^A0N,40,40^FDSpeed run^FS^XZ"
zplcloud send --target 10.0.0.5 --file label.zpl
La bandera es --target, y acepta una IP o un hostname. Añade --port solo para un puerto no estándar; el valor por defecto es 9100.
Después escanea el código de barras con un escáner real, no con la app de cámara del teléfono. Un teléfono es tolerante con el contraste y las zonas de silencio de formas que un escáner de almacén no lo es. Si no se lee a la primera:
- sube la oscuridad en 2 en el perfil y vuelve a aplicarlo, luego reimprime,
- comprueba la zona de silencio - un código de barras demasiado cerca del borde de la etiqueta falla independientemente de la oscuridad,
- verifica que la longitud de la etiqueta en el diseño coincide con el medio físico.
6 - Entrégalo a los que imprimen (2 min)
Crea una Print View a partir del diseño, elige los campos editables y comparte el enlace o imprime el código QR para la pared junto a la impresora. Eso es lo que hace que la configuración sobreviva al contacto con un turno que no estaba en la sala hoy.
El run
| Paso | Qué | Tiempo |
|---|---|---|
| 0 | Desembalar, medio, calibrar | 2 min |
| 1 | Red | 3 min |
| 2 | Weblink o agente | 3 min |
| 3 | Perfil de impresora | 2 min |
| 4 | Diseño | 3 min |
| 5 | Imprimir + comprobación con escáner | 2 min |
| 6 | Print View | 2 min |
Unos 15 minutos, de los cuales aproximadamente cuatro son la impresora calibrando y reiniciando mientras haces otra cosa.
Lo que no está en los 15 minutos
Lista honesta: una impresora con una versión de firmware demasiado antigua para Weblink, una red Wi-Fi con aislamiento de clientes, y stock de etiquetas que no coincide con ningún perfil que tengas. Cada uno de esos convierte un speed run en una tarde - y ninguno es un problema de configuración de la impresora.