Como Imprimir Etiquetas Zebra pelo Navegador

Atualizado em 11 de junho de 2026

Impressoras Zebra não precisam de driver para imprimir — precisam de bytes. Uma etiqueta é apenas um pequeno bloco de texto ZPL, e qualquer sistema capaz de entregar esse texto à impressora consegue imprimir. Isso inclui o navegador: com a API WebUSB, Chrome e Edge podem enviar ZPL bruto diretamente para uma impressora Zebra conectada por USB — sem drivers, sem spooler de impressão, sem serviço intermediário, e funciona da mesma forma no Windows, macOS, Linux e ChromeOS.

As três formas de enviar ZPL para uma impressora Zebra

  • WebUSB (navegador → USB). A página solicita permissão, você seleciona a impressora em uma caixa de diálogo do navegador uma vez, e a página grava o ZPL diretamente no endpoint USB. Ideal quando a impressora fica próxima à pessoa que imprime. Requer Chrome ou Edge e uma página HTTPS.
  • Rede (porta TCP 9100). Impressoras Zebra com Ethernet ou Wi-Fi escutam na porta 9100 por ZPL bruto. Ideal para impressoras compartilhadas em armazém; navegadores não podem abrir sockets TCP brutos, então este caminho precisa de um pequeno relay (ou o suporte HTTP POST da própria impressora em modelos Link-OS mais novos).
  • Driver do SO (Windows/CUPS). Instale o driver Zebra e imprima como qualquer outra impressora. Conveniente para imprimir documentos, mas o driver re-renderiza a página, o que pode suavizar os códigos de barras, e a instalação por máquina é exatamente o que a impressão pelo navegador evita.

Imprimindo via WebUSB, passo a passo

  1. Use Chrome ou Edge. WebUSB é compatível com navegadores baseados em Chromium; Safari e Firefox não o implementaram.
  2. Conecte a impressora por USB e ligue-a. Carregue a mídia e certifique-se de que a impressora não está pausada (luz de status verde sólido na maioria dos modelos Zebra).
  3. Abra o app e acione uma impressão. Na ZPLCraft, crie sua etiqueta no canvas e clique em Imprimir — o navegador exibe uma caixa de seleção de dispositivo listando os dispositivos USB.
  4. Selecione sua impressora e conceda acesso. Esta permissão é lembrada para o site, então impressões futuras são com um clique.
  5. Imprimir. O app reivindica a interface USB e grava os bytes ZPL; a etiqueta está sendo impressa antes que um driver terminasse de enfileirar.

Solução de problemas

A impressora não aparece na seleção de dispositivos

  • Troque o cabo USB e a porta — cabos somente de carregamento são uma causa surpreendentemente comum.
  • Windows: se o driver Zebra (ou o Zebra Setup Utilities) tiver reivindicado o dispositivo, o navegador pode não conseguir acessá-lo. Remover o driver ou mudar a impressora para um dispositivo de classe genérica "usbprint" a libera para WebUSB.
  • Linux: conceda permissão ao seu usuário para o dispositivo USB com uma regra udev para o vendor ID 0a5f (Zebra), depois reconecte a impressora.

A etiqueta imprime, mas está em branco ou apagada

  • Etiquetas em branco geralmente indicam o modo de mídia errado: papel de impressão direta com a impressora configurada para transferência térmica (ou falta de ribbon). Verifique ^MT/configurações de mídia ou execute uma calibração.
  • Impressão apagada: aumente o escurecimento (^MD ou a configuração do driver/painel frontal) ou reduza a velocidade de impressão (^PR).

O layout está deslocado ou cortado

  • Certifique-se de que o ZPL tem como alvo o DPI da sua impressora — coordenadas escritas para 203 dpi ficam no lugar errado em um cabeçote de impressão de 300 dpi. A ZPLCraft escala o código gerado para a impressora que você escolhe.
  • Execute a calibração de mídia (~JC, ou mantenha o botão de avanço pressionado conforme o manual do seu modelo) para que a impressora encontre o gap da etiqueta e comece cada etiqueta no topo.

Por que imprimir pelo navegador em vez de drivers?

Cada máquina onde você pula uma instalação de driver é uma coisa a menos para manter. A impressão pelo navegador significa que uma nova estação de armazém fica pronta assim que alguém faz login; os códigos de barras são gerados como comandos ZPL nativos em vez de imagens re-renderizadas, então permanecem nítidos e legíveis por scanner; e o mesmo app funciona em todos os sistemas operacionais. O trabalho da impressora é transformar ZPL em etiqueta — o navegador é perfeitamente capaz de entregá-lo.

A ZPLCraft foi construída em torno desse fluxo de trabalho: crie visualmente, visualize a etiqueta exata, depois envie à impressora via WebUSB ou exporte o ZPL para seus sistemas existentes. O plano gratuito inclui o editor completo e impressão por USB. Se você está escrevendo ZPL à mão, mantenha a referência de comandos por perto.