Agente Vitrine Print (Windows)
Instalar o agente de impressão silenciosa, parear com a Central e evitar bloqueio de antivírus.
O que e
O Vitrine Print e um programa para Windows que fica na bandeja do PC da estação (caixa ou cozinha). Ele busca cupons e tickets na fila do ERP e imprime na impressora termica sem abrir janela do navegador.
O navegador continua disponivel para 2ª via ou se o agente estiver offline.
Como usar
- No Windows, instale o driver da impressora termica e imprima uma pagina de teste.
- No ERP, abra Central de Impressoras.
- Clique em Baixar instalador Windows e execute o
VitrinePrintSetup.exe(atalho no Menu Iniciar; opcional iniciar com o Windows). - Clique em Gerar codigo de pareamento e digite o codigo (e a URL do ERP) na janela do agente. Escolha o perfil Caixa ou Cozinha antes de parear.
- Em cada setor, escolha a impressora Windows na lista e salve (Vincular).
- Opcional: no agente, marque Modo so-cozinha no PC da cozinha (ou use o perfil Cozinha).
- Deixe o agente rodando. Quando houver versão nova, o painel local mostra Atualizar agora. No painel também aparece o relatório do dia (ok/falha/pendente).
Na Central, o card Diagnóstico mostra se o agente está online, versão antiga, fila travada, setor sem impressora e o perfil (Caixa/Cozinha).
Em Fila / falhas: use Reenviar para tentar de novo, Ignorar em um item, ou Limpar falhas para tirar todos os erros da lista (o cupom não é apagado do histórico da venda).
Antivírus / Windows Defender
O instalador pode ir sem assinatura Authenticode até a plataforma assinar o .exe. O Windows ou o antivirus pode alertar na primeira execucao.
O que fazer:
- Clique em Mais informacoes → Executar mesmo assim (SmartScreen).
- Se o Defender quarentenar o arquivo, restaure e adicione uma exclusao na pasta
%LocalAppData%\Programs\VitrinePrint. - Em ambiente corporativo, peca ao TI para liberar o hash do instalador.
Perguntas frequentes
O celular do garçom imprime? Nao. O ticket de cozinha sai no PC onde o agente esta rodando (e online). O garçom vê um aviso se a fila recebeu os tickets ou se o agente está offline.
E se o agente estiver pausado ou offline? Os jobs ficam na fila. O PDV pode abrir o cupom no navegador (fallback).
Como atualizar? No painel do agente (http://127.0.0.1:17888), use Atualizar agora, ou baixe de novo o Setup na Central. Versao atual: 0.2.2.
A impressão falhou e depois saiu sozinha? Sim — o sistema tenta de novo até 3 vezes (com espera). Se continuar falhando, a Central e o badge Print falha no PDV mostram o motivo (papel, offline, etc.).
O ticket não corta o papel? Atualize o agente para 0.2.2+ (corte Epson padronizado). Confira se o modelo da térmica aceita ESC/POS GS V.
Posso usar QZ Tray?
Sim, no futuro. A fila e os setores sao os mesmos (PRINT_AGENT_DRIVER=qz + certificado). Enquanto isso, use o Vitrine Print.