Pular para o conteúdo principal

ONZ Print Server

Antes de começar​

Confira os itens abaixo antes da instalação:

  • Windows 7 ou superior (64 bits)
  • Impressora térmica conectada via USB
  • Impressora ligada durante a instalação
  • Arquivo ONZ-Printer-Setup.exe — baixar aqui
  • Permissão para executar o instalador como Administrador

Importante: o instalador já inclui os componentes necessários para executar o serviço. Não é necessário instalar dependências adicionais na máquina do cliente.

Etapa 1 — Instalar o ONZ Print Server​

  1. Conecte a impressora na porta USB e ligue-a.
  2. Execute o arquivo ONZ-Printer-Setup.exe como Administrador.
  3. Siga o assistente de instalação.
  4. Na tela de opções, marque preferencialmente:
  • Iniciar automaticamente com o Windows
  • Liberar a porta 4000 no Firewall do Windows
  • Abrir o Zadig para configurar o driver da impressora
  1. Conclua a instalação.
  2. Ao final, o ONZ Print Server será iniciado automaticamente.

Resultado esperado​

Ao concluir a instalação, a máquina passa a ter:

  • Arquivos instalados em C:\Program Files\ONZ Printer\
  • Inicialização automática com o Windows, se a opção tiver sido marcada
  • Porta 4000 liberada no firewall, se a opção tiver sido marcada
  • Zadig disponível para configuração do driver USB

Etapa 2 — Configurar o driver da impressora com o Zadig​

Na primeira instalação da máquina, é necessário configurar o driver USB da impressora para permitir a comunicação direta via ESC/POS.

  1. Se a opção correspondente tiver sido marcada no instalador, o Zadig será aberto automaticamente ao final.
  2. Caso ele não abra, execute manualmente:
  • C:\Program Files\ONZ Printer\zadig-2.9.exe
  1. No menu superior, clique em Options > List All Devices.
  2. No campo de seleção de dispositivo, escolha a impressora.
  3. Ela pode aparecer como:
  • USB Printing Support
  • Diebold IM453HU
  1. No campo Driver, selecione WinUSB.
  2. Clique em Replace Driver ou Install Driver.
  3. Aguarde a conclusão da instalação.

Atenção: após trocar o driver para WinUSB, a impressora deixa de funcionar pelo spooler padrão do Windows. Isso é esperado, pois a comunicação passa a ser direta via ESC/POS.

Dica: esse procedimento normalmente precisa ser feito apenas uma vez por máquina.

Etapa 3 — Configurar o sistema de frente de caixa​

Depois que o serviço estiver instalado e a impressora configurada, ajuste o endereço do servidor no sistema de frente de caixa.

  1. Abra o sistema de frente de caixa no navegador.
  2. Acesse o menu (...) > Configurações.
  3. Na seção Impressão, informe o endereço do servidor:
  • Mesma máquina: http://localhost:4000
  • Outra máquina na rede: http://<IP_DA_MÁQUINA>:4000
  1. Clique em Teste de impressão.
  2. Verifique se o comprovante foi impresso corretamente.

Resultado esperado​

Se a comunicação estiver correta:

  • O teste de impressão será enviado com sucesso
  • A impressora emitirá o comprovante
  • O sistema de frente de caixa poderá usar o serviço normalmente