Configuração da impressora de recibos: como conectar e imprimir pedidos

O RestaurantManage Print Agent é um serviço leve do Windows que recebe comandos de impressão da nuvem e os envia para sua impressora térmica de recibos — permitindo a impressão automática de recibos quando os pedidos são pagos ou quando os tickets de cozinha precisam ser impressos. O agente suporta impressoras de rede (porta TCP 9100), impressoras USB e conexões Windows Spooler. Este guia abrange instalação, configuração, conexão de impressora e solução de problemas.

Como funciona a impressão de recibos?

O fluxo de trabalho de impressão é totalmente automatizado. Quando um caixa confirma o pagamento ou um ticket de cozinha é acionado, o backend do RestaurantManage gera o recibo completo como comandos de bytes ESC/POS — incluindo nome do restaurante, número da mesa, pedido detalhado, preços, detalhamento de impostos, total e método de pagamento. Esses bytes são enviados por uma conexão WebSocket segura (PrintHub) ao Print Agent rodando em um PC Windows no seu restaurante. O agente decodifica os dados e os encaminha diretamente para a impressora térmica conectada. Todo o processo leva menos de dois segundos da confirmação do pagamento ao recibo impresso.

Como instalar o Print Agent?

1. Download: Obtenha o instalador mais recente do Print Agent no seu painel administrativo ou entre em contato com o suporte.
2. Instalar: Execute o instalador em um PC Windows que permanecerá ligado durante o horário de serviço.
3. Configurar: Abra o config.json e insira a URL base da API, o ID do seu restaurante e a chave secreta do agente (fornecida pelo seu administrador).
4. Conectar a impressora: Conecte sua impressora térmica via USB ou conecte-a à mesma rede do PC.
5. Iniciar o serviço: Execute o Print Agent — ele se conecta ao PrintHub automaticamente e exibe um indicador de status verde.
6. Imprimir teste: Processe um pagamento de teste no painel de caixa e verifique se o recibo é impresso corretamente.

Quais tipos de conexão de impressora são suportados?

O Print Agent suporta três métodos de conexão, com fallback automático entre eles. Impressoras de rede conectam via TCP na porta 9100 — insira o endereço IP da impressora na configuração. Este é o método recomendado para restaurantes com múltiplas impressoras. Impressoras USB conectam diretamente ao PC e são acessadas pelo Windows Spooler ou endereçamento direto de porta USB. O Windows Spooler usa o driver de impressão padrão do Windows, que funciona com qualquer impressora reconhecida pelo Windows. O agente tenta o Spooler primeiro, depois recorre ao USB direto e finalmente tenta compartilhamentos de rede UNC.

Como configurar o Print Agent?

O Print Agent usa um arquivo config.json com três configurações obrigatórias: ApiBaseUrl (a URL do servidor RestaurantManage), RestaurantId (o ID único do seu restaurante no painel administrativo) e AgentSecretKey (uma chave secreta gerada no painel administrativo que autentica o agente de impressão sem precisar de uma conta de usuário). O agente se autentica com o PrintHub usando essa chave secreta via WebSocket. Para impressoras de rede, adicione o IP e a porta da impressora à configuração. O agente registra toda a atividade na pasta logs/ para solução de problemas.

Como funciona a atualização automática?

O Print Agent verifica atualizações aproximadamente a cada 2,5 horas chamando o endpoint de atualização no servidor RestaurantManage. Se uma nova versão estiver disponível, ele baixa o pacote de atualização como arquivo ZIP para uma pasta de atualizações pendentes, executa o script de instalação e reinicia o serviço automaticamente. Isso significa que seu restaurante sempre executa a versão mais recente sem intervenção manual. As verificações de atualização incluem um jitter de temporização por restaurante para evitar que todos os agentes atualizem simultaneamente. Você pode ver a versão atual do agente no painel administrativo.

Solução de problemas comuns

• O agente não conecta: Verifique se ApiBaseUrl e AgentSecretKey no config.json estão corretos. Verifique o acesso à internet no PC.
• O recibo não imprime: Confirme que a impressora está ligada e conectada. Verifique a pasta logs/ para detalhes do erro.
• Texto ilegível no recibo: Certifique-se de que sua impressora suporta comandos ESC/POS. A maioria das impressoras térmicas de 80 mm é compatível.
• A conexão cai frequentemente: O agente reconecta automaticamente, mas verifique a estabilidade da sua rede. Uma conexão Ethernet com fio é mais confiável que Wi-Fi.
• O agente não inicia como serviço: Execute install-service.bat como Administrador para registrar o serviço Windows corretamente.

Guias relacionados

• Painel de caixa: Como processar pagamentos que acionam a impressão de recibos
• Tela da cozinha: Como a impressão de tickets de cozinha se integra ao fluxo de pedidos
• Primeiros passos: Guia completo de configuração do registro ao primeiro pedido