zplCloud Blog
Configuração Zebra no cloud: speed run de 15 minutos
Todos os comandos por completo, na ordem em que você os digita, com as duas etapas em que as pessoas realmente perdem tempo.
A promessa
Uma impressora Link-OS nova deve imprimir etiquetas de produção em cerca de quinze minutos, não em uma tarde. Abaixo está o run com comandos reais. Duas etapas comem consistentemente o orçamento - calibração da mídia e escuridão - então recebem atenção aqui em vez de uma mera bala.
0 - Desembalar (2 min)
Remova os travas de transporte e a proteção da cabeça de impressão, carregue a mídia e, para transferência térmica, carregue o ribbon. Ligue e deixe calibrar.
Se a impressora alimentar várias etiquetas em branco e parar, ela está calibrando a detecção de espaço/marca preta. Deixe terminar; interromper é como você acaba perseguindo um problema de comprimento de etiqueta na etapa 5.
1 - Rede (3 min)
- Ethernet: conecte, o DHCP faz o resto.
- Wi-Fi: painel frontal, ou o app Android via USB se o painel não cooperar.
Anote o IP. Você precisa dele exatamente uma vez.
2 - Conecte ao zplCloud (3 min)
Escolha um:
Weblink - a impressora mantém uma conexão de saída com a 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
O script puxa os três certificados da impressora, os carrega via TCP 9100, define as variáveis Weblink e NTP e reinicia o dispositivo. Se o hostname não resolver na sua rede, adicione &ip=10.0.0.5 - o hostname ainda escolhe o certificado, o IP é só o alvo TCP.
Agente CLI - uma máquina na LAN registra a impressora:
curl -fsSL https://zplcloud.com/install-cli.sh | sh
zplcloud proxy --agent "Warehouse Berlin" --service-install --api-key sk_zplcloud_XXXX
Ambos são apenas de saída. Sem porta de entrada, sem mudança de firewall.
3 - Aplique um perfil de impressora (2 min)
Impressoras saem com configurações genéricas que não correspondem à sua mídia.
zplcloud profiles list
zplcloud profiles apply "Shipping 102x152" --target 10.0.0.5
O perfil empurra escuridão (^MD), velocidade (^PR), manuseio de mídia e quaisquer variáveis SGD que define. Variáveis podem ser preenchidas no momento da aplicação:
zplcloud profiles apply 42 --target 10.0.0.5 --var gtin=4006381333930 --var charge=LOT-42
Esta é a etapa que decide se a etapa 5 funciona. Escuridão muito baixa dá um código de barras que escaneia no escritório e falha na transportadora; alta demais e barras finas se fundem. Térmica direta e transferência térmica precisam de valores diferentes, e também cada fornecedor de mídia.
4 - Crie a etiqueta (3 min)
Abra o designer, comece de um modelo, adicione os campos que variam e vincule-os aos seus dados. Verifique a visualização PNG/PDF/SVG - ela é renderizada pelo mesmo mecanismo que produz o ZPL, então não é uma aproximação da saída.
5 - Imprima e verifique (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
O flag é --target, e aceita um IP ou hostname. Adicione --port apenas para uma porta não padrão; o padrão é 9100.
Depois escaneie o código de barras com um scanner real, não com o app de câmera do celular. Um celular é tolerante com contraste e zonas de silêncio de maneiras que um scanner de armazém não é. Se não ler de primeira:
- aumente a escuridão em 2 no perfil e reaplique, depois reimprima,
- verifique a zona de silêncio - um código de barras perto demais da borda da etiqueta falha independentemente da escuridão,
- confira se o comprimento da etiqueta no design corresponde à mídia física.
6 - Entregue a quem imprime (2 min)
Crie uma Print View a partir do design, escolha os campos editáveis e compartilhe o link ou imprima o QR code para a parede perto da impressora. Isso é o que faz a configuração sobreviver ao contato com um turno que não estava na sala hoje.
O run
| Etapa | O quê | Tempo |
|---|---|---|
| 0 | Desembalar, mídia, calibrar | 2 min |
| 1 | Rede | 3 min |
| 2 | Weblink ou agente | 3 min |
| 3 | Perfil de impressora | 2 min |
| 4 | Design | 3 min |
| 5 | Imprimir + verificação com scanner | 2 min |
| 6 | Print View | 2 min |
Cerca de 15 minutos, dos quais mais ou menos quatro são a impressora calibrando e reiniciando enquanto você faz outra coisa.
O que não está nos 15 minutos
Lista honesta: uma impressora com versão de firmware antiga demais para Weblink, uma rede Wi-Fi com isolamento de cliente, e estoque de etiquetas que não corresponde a nenhum perfil que você tem. Cada um desses transforma um speed run em uma tarde - e nenhum é problema de configuração de impressora.