Problemas de conexão da impressora: o que fazer quando as etiquetas não saem

Soluções para os erros que você realmente encontra: No route to host, PRINTER_OFFLINE, um IP de impressora que mudou, a mesma impressora listada três vezes, “Out of ink” no Mac, uma atualização travada em “Downloading update…”, etiquetas em branco ou ilegíveis — começando pela verificação que divide todo problema em dois: o Test Print do Device Hub.

Quando as etiquetas não saem, a falha está em um de três lugares: o caminho do computador até a impressora, a própria impressora, ou o sistema enviando o trabalho para a entrada errada. Uma verificação separa tudo: abra o Device Hub na estação, encontre a impressora em Connected Devices e clique em Test Print na linha dela. Se a etiqueta de teste sair, o caminho e a impressora estão bem — o problema é qual impressora o app está usando (última seção). Se o Test Print falhar, o texto do erro diz qual seção ler. Guarde o texto exato do erro: as palavras-chave (por exemplo “No route to host”) são como você — e o suporte — acham a solução rápido.

1. “No route to host”: o computador não alcança a impressora#

O que você vê: o Test Print no Device Hub falha com uma mensagem vermelha como “Test Print failed: [PRINTER_OFFLINE] connect 10.10.200.138:9100 failed: No route to host”. “No route to host” significa exatamente isso: seu computador não tem caminho de rede até o endereço da impressora. A impressora está bem — ela tem o próprio endereço (uma impressora de rede o mostra na tela, por exemplo “ETH 10.10.200.138”) — mas o computador e a impressora estão em redes diferentes. Causas comuns: o cabo de rede da impressora está em outro roteador ou switch que não o do seu computador, ou o computador está numa rede Wi-Fi de convidados, que normalmente bloqueia o acesso a dispositivos locais.

1. Veja o IP da impressora na tela dela (a tela Ready o mostra). Depois veja o IP do seu computador: Mac — Ajustes do Sistema → Wi-Fi → detalhes da rede conectada; Windows — Configurações → Rede e Internet → Propriedades.
2. Compare os três primeiros grupos de números. Computador 192.168.1.20 e impressora 10.10.200.138 são redes diferentes — esse é o problema inteiro. Os mesmos três primeiros grupos (por exemplo, ambos 10.10.200.x) significam a mesma rede, e a causa está em outro lugar.
3. Ligue o cabo de rede da impressora no mesmo roteador ou switch que seu computador usa, e conecte o computador ao Wi-Fi principal, não ao de convidados. A tela da impressora mostrará um novo endereço na faixa da rede do seu computador.
4. Se o endereço mudou, o Device Hub ainda guarda o antigo: exclua aquela entrada de impressora de rede no Device Hub e adicione de novo com o novo endereço (o Setup Wizard orienta você), depois rode o Test Print novamente.

2. O IP da impressora mudou: ontem imprimia, hoje não#

A maioria das redes distribui endereços automaticamente (isso é o DHCP). Depois de uma reinicialização ou queda de energia, a impressora pode voltar com outro endereço, enquanto o Device Hub continua procurando o antigo — o mesmo sintoma da seção 1, sem você ter mexido em nada. Compare o endereço na tela da impressora com o salvo no Device Hub: se forem diferentes, é isso. Para não acontecer de novo, reserve o endereço para a impressora no seu roteador (reserva de endereço, vinculada à impressora) ou defina um endereço fixo (estático) nas configurações de rede da própria impressora — depois atualize a entrada no Device Hub uma vez, e ela fica estável.

3. PRINTER_OFFLINE: verifique primeiro a própria impressora#

Quando um trabalho falha com PRINTER_OFFLINE, não comece mudando configurações do computador — vá até a impressora e leia a tela dela. A maioria dos “offline” é a impressora pedindo algo:

• Sem etiquetas ou sem ribbon — coloque um rolo novo (e rode uma Calibration pelo menu da tela depois de trocar o rolo, para ela aprender o novo espaçamento das etiquetas).
• Tampa mal fechada — pressione a tampa superior até travar dos dois lados.
• Pausada — muitas impressoras pausam após um erro ou um toque num botão; volte-a para Ready pela tela ou pelos botões.
• Numa impressora de rede, verifique também o cabo: firme nas duas pontas e a luz da porta do switch acesa. Depois volte ao Device Hub e clique em Test Print para confirmar que ela voltou.

4. A mesma impressora aparece várias vezes — e virou a padrão#

O que você vê: a lista de impressoras do Mac ou do Windows mostra a mesma impressora duas ou três vezes (nomes terminando em “ 2”, “ 3”), e uma delas está como padrão do sistema — então um documento comum sai na impressora de etiquetas como uma etiquetinha. Isso acontece quando a impressora foi adicionada mais de uma vez, de jeitos diferentes (pelo endereço, pela descoberta automática, depois de reinstalar o driver). As duplicatas não são inofensivas: os apps escolhem entradas que você não queria e os trabalhos parecem sumir.

1. Exclua as duplicatas nas configurações de impressoras do sistema (Mac: Ajustes do Sistema → Impressoras e Scanners; Windows: Configurações → Bluetooth e dispositivos → Impressoras e scanners). Apagar as entradas do sistema não afeta o Device Hub: a impressora de rede dele (mostrada como “Network printer 10.10.200.138 · 9100”) fala direto com a impressora e não passa pela lista do sistema.
2. Volte a definir uma impressora de escritório comum como padrão do sistema, para os documentos do dia a dia pararem de cair na impressora de etiquetas.
3. No Device Hub, confira a classe da impressora: as de etiquetas ficam em Label Printer, as de escritório em Regular Printer. Cada linha tem um botão para trocar de classe (por exemplo “Change to Label Printer”) — etiquetas só saem em uma Label Printer, nunca numa comum.

5. “Out of ink” no Mac: um alarme falso#

Impressoras de etiquetas térmicas e de transferência térmica não têm cartucho de tinta — elas imprimem aquecendo uma cabeça de impressão. O macOS não sabe ler direito o status desse tipo de impressora, então pode mostrar “Out of ink” (sem tinta) e marcá-la com um ponto vermelho quando está tudo bem. Ignore: a tela da própria impressora é a fonte da verdade. Se ela realmente ficar sem etiquetas ou ribbon, ela mesma diz isso na tela, em palavras claras.

6. As etiquetas saem em branco, ilegíveis ou do tamanho errado#

O trabalho chega à impressora, mas o que sai está errado. Verifique estas quatro coisas, nesta ordem:

1. A entrada certa: imprima pela entrada de rede do Device Hub (a que mostra o endereço IP e a porta 9100) — ela envia os dados da etiqueta como estão. Uma entrada que passa pelo driver do sistema operacional pode redimensionar ou recodificar o trabalho no caminho, e é assim que as etiquetas saem encolhidas, deslocadas ou nem saem.
2. A linguagem da impressora: as etiquetas de envio do Docklify são código de impressora ZPL. A impressora precisa estar trabalhando em modo ZPL (muitas industriais também falam a própria linguagem, como TSPL, e oferecem emulação ZPL — se a sua estiver só na linguagem nativa, o ZPL sai como páginas em branco ou linhas de texto cru). Troque a emulação nas configurações da impressora se precisar; antes de imprimir, você pode pré-visualizar como o ZPL deveria parecer em Utilities → Visualizador ZPL (/utilities/zpl-viewer) para separar um problema de dados de um problema de impressora.
3. O tamanho: o tamanho de etiqueta do modelo precisa coincidir com o papel carregado na impressora — um modelo de envio 4×6 em papel 4×3 sai cortado ou encolhido. Mude o tamanho onde a etiqueta é criada (o modelo), não na impressora.
4. Calibração depois de trocar o rolo: se depois de colocar um rolo novo a impressão desviar, pular etiquetas ou parar entre elas, rode Calibration pelo menu da tela da impressora — ela mede de novo o espaçamento entre as etiquetas.

7. O Device Hub está “não pronto”, ou o log enche de falhas ao buscar trabalhos#

O que você vê: as etiquetas param de chegar mesmo com a impressora boa, e a parte inferior da janela do Device Hub — o Runtime Log — mostra erros repetidos ao buscar trabalhos, ou a sincronização com a nuvem nunca fica “pronta”. Há duas coisas diferentes por trás disso. A comum: a estação perdeu a internet por um momento, o Hub registrou uma rajada de erros e depois se recuperou sozinho — as linhas antigas ficam no log, então parece quebrado muito depois de curado. A real: o Hub realmente não alcança a nuvem agora, ou perdeu o pareamento, e os trabalhos do app web nunca chegam a este computador. O log distingue as duas: cada linha tem um horário.

1. Leia primeiro as linhas mais novas. Se os erros forem antigos (de uma hora atrás, de ontem à noite) e as linhas mais recentes mostrarem a sincronização concluindo — registro de dispositivos sincronizado, sincronização pronta — já se recuperou; não há nada para corrigir.
2. Verifique o estado de pareamento na janela do Hub. Se estiver não pareado, pareie de novo: pegue o código de 6 dígitos do Hub e digite no lado web — na caixa que aparece ao imprimir, ou em SaaS → Admin → Print Devices, onde o pareamento do Hub é gerenciado.
3. Reinicie o Hub: feche o Device Hub por completo e abra de novo. Na inicialização ele se registra novamente, ressincroniza o registro de dispositivos e reconecta a sincronização — depois confirme no log que as linhas novas mostram a sincronização concluída e rode um Test Print.
4. Ainda falhando? Verifique primeiro a internet deste computador (abra qualquer página). Se a web funcionar mas o log continuar ganhando erros novos, clique em Copy Log na janela do Hub e envie o log ao suporte, dizendo mais ou menos desde quando — os horários fazem o resto.

8. Uma atualização fica em “Downloading update…” e a barra não se move#

O que você vê: o Device Hub oferece uma versão nova, uma barra de progresso começa em “Downloading update…” e depois nada se move por muito tempo; a janela pode dizer ainda que há um trabalho de impressão em andamento e que a atualização foi adiada. Na verdade, nada está travado. O Hub se recusa a instalar uma atualização enquanto há impressão ativa — um único Test Print já conta como impressão. Se ele detectar atividade de impressão quando a instalação vai começar, cancela aquela tentativa silenciosamente e adia a atualização (lembra de novo mais tarde, normalmente em uma hora), e em versões antigas a janela podia continuar mostrando o download como se estivesse em curso, parecendo travada.

1. Feche o Device Hub por completo e abra de novo — sair do app de verdade (no Mac, Encerrar pelo menu dele; no Windows, Sair pelo ícone da bandeja), não só fechar a janela. Isso limpa o estado residual de “baixando / impressão em andamento”.
2. Ao reabrir, clique em Update now e deixe terminar de uma vez: ele baixa, instala e reinicia sozinho. A mudança do número da versão é a prova de que pegou.
3. Nesses minutos, não clique em Test Print nem imprima etiquetas pela estação de embalagem — qualquer atividade de impressão faz o instalador adiar de novo.

9. O Test Print funciona, mas a estação de embalagem não imprime nada#

Um Test Print bem-sucedido prova que o caminho do computador até a impressora e a própria impressora estão bons. Então, quando a Packing Station (SaaS → WMS → Packing Station) parece imprimir mas nenhuma etiqueta sai, o trabalho foi para outro lugar. No Docklify, qual impressora recebe um trabalho de etiqueta é decidido em dois níveis. Primeiro vale o padrão próprio do Device Hub desta estação: a impressora marcada como impressora de etiquetas padrão em Device Hub → Connected Devices neste computador — ela vence. Só se este Hub não tiver um padrão próprio é que vale o padrão do armazém: a impressora marcada para este armazém em SaaS → Admin → Print Devices. Se essa impressora padrão do armazém pertencer ao Hub de outra estação, o trabalho é enviado a ela pela retransmissão na nuvem, e o Device Hub daquele computador precisa estar rodando; se não estiver, o trabalho nem consegue ser entregue. E se nenhum dos dois níveis tiver um padrão definido, a impressão não escolhe uma impressora por você: um seletor aparece para você escolher, e ao escolher você pode salvar aquela impressora como o padrão do Hub desta estação.

1. Primeiro verifique o padrão do Hub desta estação: abra o Device Hub → Connected Devices no computador da estação de embalagem e veja qual linha de impressora tem a marca de impressora de etiquetas padrão. Se a errada estiver marcada — ou a certa não tiver marca nenhuma — use “Set as default label printer” na linha da impressora certa. Esse padrão do Hub é verificado primeiro, então corrija aqui antes de mexer em qualquer outra coisa.
2. Depois verifique o padrão do armazém: abra SaaS → Admin → Print Devices e veja qual impressora tem a marca de impressora de etiquetas padrão deste armazém e se ela aparece online. Se a marca estiver na impressora errada, passe-a para a certa. Lembre que esse padrão do armazém só vale quando o Hub local não tem um padrão próprio — e se a impressora marcada pertencer ao Hub de outra estação, os trabalhos chegam a ela pela retransmissão na nuvem, então o Device Hub daquele computador precisa estar rodando.
3. Se a impressora certa aparecer offline, vá ao computador dela e abra o Device Hub lá — sem o Hub rodando naquela máquina, nenhum trabalho chega à impressora.
4. Confirme também a classe da impressora no Device Hub daquele computador: ela precisa estar em Label Printer, não em Regular Printer (troque com o botão “Change to Label Printer” da linha dela).
5. Imprima de novo pela Packing Station e observe aquela impressora. Se as etiquetas saírem por ela agora, a configuração está certa — os trabalhos anteriores foram simplesmente entregues para onde o padrão apontava na época.

10. Etiquetas da transportadora, avisos de pareamento e recusas da transportadora na estação de embalagem#

Quando um pedido indica uma transportadora como UPS ou FedEx, a estação de embalagem compra a etiqueta dela e ela imprime direto na sua impressora de etiquetas, como qualquer outra. Se a transportadora devolver a etiqueta como imagem, ela abre em uma nova guia do navegador e a caixa de diálogo de impressão aparece sozinha — imprima por ela. A mensagem da estação diz qual das duas coisas aconteceu: só diz “impressa” quando a etiqueta foi de fato para uma impressora, e diz que abriu em uma nova guia quando você ainda precisa imprimir por lá. Reimprimir sempre reimprime a mesma etiqueta; nunca compra uma segunda.

Se o Device Hub deste computador está rodando, mas este navegador ainda não foi pareado com ele, as etiquetas não param mais no aviso de pareamento: quando o armazém tem uma impressora na nuvem disponível, a etiqueta é enviada para lá automaticamente e imprime do mesmo jeito. Você só precisa digitar o código de pareamento de 6 dígitos quando não há impressora na nuvem disponível. Se fechar a caixa de pareamento sem parear, a estação avisa que a etiqueta ainda não foi impressa — conclua o pareamento ou use Reimprimir no pacote quando estiver pronto.

E quando uma transportadora se recusa a criar uma etiqueta, a estação agora explica em palavras claras o que deu errado e o que fazer — por exemplo, verificar o endereço do pedido, a conta da transportadora ou o serviço escolhido — em vez de um genérico “algo deu errado”. A tentativa recusada também fica em Exceções como etiqueta bloqueada: corrija a causa e compre a etiqueta de novo por lá. A estação nunca imprime silenciosamente uma etiqueta local no lugar de uma que a transportadora recusou.

11. No telefone, Minhas impressoras não mostra as impressoras — ou marca uma como offline enquanto no escritório aparece online#

O que você vê: no telefone (Mobile → WMS → Mais → Minhas impressoras) a lista é bem mais curta do que as impressoras que o armazém realmente usa — ou uma impressora aparece como Offline enquanto um colega olhando SaaS → Admin → Print Devices a vê como Online. As duas coisas são regras de exibição, não defeitos da impressora. Minhas impressoras mostra as impressoras do armazém selecionado no telefone, mais as impressoras da organização que um administrador ainda não atribuiu a nenhum armazém — essas aparecem em um grupo próprio, marcadas como “ainda sem armazém atribuído”. Se o telefone estiver com outro armazém selecionado, a lista segue o armazém do telefone: confira primeiro o armazém selecionado. E “offline” significa a mesma coisa nas duas telas: o sistema não recebe notícias do Device Hub daquela impressora há mais de dois minutos — o app do Hub naquele computador está fechado, o computador dormiu ou saiu da rede.

1. Confira primeiro o armazém selecionado no telefone. Minhas impressoras segue o armazém atual do telefone: troque para o armazém onde você está e reabra a página.
2. Antes de concluir que uma impressora sumiu, procure no grupo “Impressoras ainda sem armazém atribuído”. As impressoras desse grupo funcionam normalmente — a impressão já as alcança (uma delas pode ser até o padrão da organização). Você também pode escolher uma ali como seu padrão pessoal.
3. Se uma impressora deve pertencer de forma permanente a um armazém, um administrador a atribui uma vez em SaaS → Admin → Print Devices (a página tem um filtro e um aviso com a contagem das não atribuídas). Depois disso ela entra no grupo daquele armazém em todos os lugares.
4. Se uma impressora aparecer offline, vá ao computador ao qual ela está conectada e abra o Device Hub lá; depois reabra Minhas impressoras — quando o Hub voltar a se reportar, a marca some em poucos minutos. É a mesma verificação que um administrador vê em Print Devices, então as duas telas concordam.

Funções do Docklify usadas neste artigo#

• Test Print de qualquer impressora conectada — Device Hub → Connected Devices
• Adicionar uma impressora de rede e o assistente de configuração inicial — Device Hub → Setup Wizard
• Alternar uma impressora entre Label Printer e Regular Printer — Device Hub → Connected Devices → Change to Label / Regular Printer
• Impressora de etiquetas padrão do armazém, estado online e pareamento do Hub — SaaS → Admin → Print Devices; o padrão próprio do Hub, que cada estação usa primeiro, é definido na linha da impressora em Device Hub → Connected Devices
• Runtime Log e Copy Log para o suporte — Device Hub → Runtime Log
• Pré-visualizar como uma etiqueta ZPL deve parecer antes de imprimir — SaaS → Utilities → Visualizador ZPL (/utilities/zpl-viewer)
• Impressão de etiquetas no posto de embalagem — SaaS → WMS → Packing Station