Como instalar o agente de impressão na cozinha

O que esse programinha faz na bancada

O agente de impressão é um programinha leve que roda dentro do restaurante e faz a ponte entre o qmen.us, que está na nuvem, e a impressora térmica, que está na sua rede local. A nuvem não alcança a impressora atrás do roteador, então é ele que conecta pra fora, pergunta de tempos em tempos se tem comanda nova, imprime e confirma. Não precisa abrir porta nenhuma no roteador.

Tem versão pra três aparelhos: Linux (um arquivo AppImage só), Windows (um arquivo .exe só) e Android (um app do projeto, com impressora por Bluetooth ou rede). Nos três, a configuração é a mesma dupla: o endereço da Cozinha e o token que o painel te dá. O qmen.us continua rodando no navegador, sem app de loja; quem se instala é só ele, e só nesse aparelho da cozinha.

Por que vale a pena ter a comanda no papel

• A comanda sai sozinha, sem ninguém clicar. O garçom envia da Mesa, o qmen.us cria o trabalho de impressão e o programa pega na próxima batida, de 3 em 3 segundos no padrão.
• Um ticket repetido é melhor que um pedido perdido. Impressora sem papel, desligada ou internet oscilando: a falha é avisada e o trabalho volta pra fila. O servidor reoferece depois de um minuto sem confirmação e tenta até dez vezes antes de desistir.
• Cada praça imprime só o que é dela. Endereço e token são por Cozinha, então a grelha não recebe a sobremesa. Casa com duas bancadas e duas térmicas roda dois agentes, cada um com o seu config.
• O mesmo aparelho pode imprimir e mostrar o monitor. Com o monitor ligado no config, a tela da cozinha abre no navegador ao iniciar. Se você quer só a tela, nem precisa disso: é só abrir o link do monitor.

Como instalar o agente de impressão em 7 passos

São sete passos, do botão no painel até o programa subindo sozinho quando o aparelho liga.

1. Ligue a impressão da praça no painel

   No painel, abra Cozinhas. Cada praça é um cartão, e nele tem o bloco Impressão com o botão Configurar. Abre a janela Impressão da cozinha: ligue a chave Imprimir pedidos, escolha a Largura do papel (80 mm ou 58 mm), quantas Vias você quer (de 1 a 5) e toque em Salvar. O cartão passa a mostrar Ligada, com a largura e as vias do lado.

2. Copie o endereço e o token

   Na mesma janela, em Dados pro app de impressão, ficam duas linhas: o endereço da Cozinha e o token, escondido em bolinhas. O olhinho revela e o botão do lado copia. Se aparecer (gerado ao salvar), é porque você ainda não salvou. Guarde bem o token: ele vale como senha da impressão. O link Gerar novo token derruba o anterior na hora.

3. Baixe a versão do seu aparelho

   No aparelho da cozinha, baixe o arquivo do seu sistema: no Windows um arquivo .exe (Windows 7 pra cima), no Linux um AppImage que roda em qualquer distro. É um arquivo só, numa pasta. Em Raspberry Pi e outros ARM, gere o AppImage no próprio aparelho ou rode direto do código-fonte, com Python 3.9 ou mais novo.

4. Cole o endereço, o token e a impressora

   Ao lado do programa fica um config.json com base (o endereço), token, printer (a impressora) e poll (de quantos em quantos segundos ele pergunta). No Windows esse arquivo mora na mesma pasta do .exe; no Linux, em ~/.config/pedis-agent/config.json. O printer depende da ligação: network:192.168.0.50 pra impressora de rede, windows: pra fila padrão do Windows, file:/dev/usb/lp0 pra USB no Linux, serial:/dev/ttyUSB0 pra serial.

   Dica: No Windows, instale a térmica como fila Generic / Text Only: driver que desenha a página embaralha os comandos e sai papel sujo. No Linux, se o /dev/usb/lp0 der permissão negada, rode sudo usermod -aG lp $USER e faça login de novo.

5. Faça um teste antes do serviço

   Antes de confiar no almoço, rode uma passada só com a impressora dummy: o ticket aparece na tela, sem gastar papel. Depois mande um pedido de teste pela Mesa e veja o papel sair — cabeçalho com a casa, a mesa, o número do pedido, o garçom, a praça e a hora, e cada item em corpo grande, com o complemento e a observação embaixo.

6. Deixe ele subir sozinho

   Cozinha não tem tempo de lembrar de abrir programa. Com pedis-agent --install, o Windows cria uma tarefa que inicia no login e o Linux cria um serviço do usuário que reinicia sozinho se cair. Num aparelho sem ninguém logado, tipo um Raspberry Pi atrás da TV, rode também sudo loginctl enable-linger. Pra desfazer, pedis-agent --uninstall.

7. No tablet Android, é o mesmo caminho

   Se a cozinha usa tablet, o app de Android (5.0 pra cima) faz o mesmo trabalho e ainda mostra a tela da cozinha. Na tela inicial você preenche Endereço, Token e Impressora — bt: e o MAC da térmica Bluetooth já pareada, ou net: e o IP da de rede — e toca em Salvar e iniciar. Conceda a permissão de Bluetooth e tire o app da economia de bateria, senão a impressão para quando a tela apaga.

Perguntas frequentes

Glossário

Agente de impressão

O programinha que roda no aparelho da cozinha, busca as comandas no qmen.us, imprime na térmica e confirma.

Token de impressão

A senha da impressão de uma Cozinha. Sai no painel, vai pro config do agente e pode ser trocado quando você quiser.

Cozinha

O monitor onde os pedidos aparecem e andam de Em preparo até PRONTO.

ESC/POS

A linguagem que as impressoras térmicas de comanda entendem. É o que o agente gera pra cada ticket.

Recursos relacionados