Configurar a impressora Epson com talões e logótipo

O que precisa

• Uma impressora de talões Epson com Server Direct Print e ligação de rede (LAN ou Wi-Fi), por exemplo TM-m30III, TM-m30II-H/-NT/-S/-SL, TM-m50/TM-m50II, TM-T88VII, TM-T88VI, TM-L100, TM-H6000V, TM-T70II-DT2, TM-T88VI-DT2.
• Acesso à Internet para a impressora – basta um router normal, sem reencaminhamento de portas.
• Papel térmico de 80 ou 58 mm, adequado à impressora. As impressoras de talões e os ecrãs de pedidos só se configuram aqui, não na área admin da WebApp ou da app.
• Um acesso como titular ou administrador do clube na Administração em /admin.

Adicionar a impressora em /admin

1. Abra /admin, escolha a lista à esquerda e vá a «Operação» → «Impressoras de talões».
2. Clique em «Adicionar impressora de talões» e introduza um nome, por exemplo «Balcão».
3. Em «Lista» escolha a lista (ou deixe vazio para todas) e em «Largura do papel» 80 mm ou 58 mm.
4. Em «O que imprime esta impressora?» assinale o que sai automaticamente: «Talões de caixa», «Talão Z» e «Talões de pedido» – mais na secção «Rotas de impressão» abaixo. Sem nada assinalado a impressora só imprime testes e talões escolhidos expressamente.
5. Clique em «Guardar». A janela fica aberta e mostra o endereço de recolha, o «ID (utilizador)» e a palavra-passe – a palavra-passe só agora: copie-a com «Copiar palavra-passe». «Novo endereço» e «Nova palavra-passe» invalidam os anteriores.

Configurar a impressora

1. Descubra o endereço IP da impressora: com a impressora desligada, mantenha premido o botão de avanço (FEED) e ligue-a – a folha de estado mostra o endereço IP.
2. Abra http://endereço-IP no browser de um computador da mesma rede – é a interface web da impressora (Web Config; em aparelhos mais antigos, EpsonNet Config). Vá a «Advanced Settings» → «Administrator Login» e inicie sessão: nos modelos mais recentes a palavra-passe é o número de série da impressora (utilizador, se pedido, «epson»). Os modelos TM-i e TM-DT seguem o mesmo caminho.
3. Antes, atualize os certificados raiz da impressora: o nosso servidor usa um certificado Let's Encrypt (cadeia YR1 → ISRG Root YR → ISRG Root X1). As listas de certificados antigas da impressora não o conhecem – então https:// falha sem aviso e não nos chega nenhum pedido. Abra «Advanced Settings» → «Network Security» → «Root Certificate Update» e clique em «Update»; a impressora descarrega a lista atual da Epson. Em alternativa, importe em «Network Security» → «CA Certificate» os ficheiros PEM «ISRG Root X1» e «ISRG Root YR» de letsencrypt.org/certificates.
4. Abra «TMI Settings» → «Server Direct Print» e coloque «Server Direct Print» (no manual da Epson «Use Server Direct Print») em «Enable».
5. Introduza em «URL» o endereço copiado, em «Interval» 5 segundos e nos campos «ID» e «Password» o utilizador e a palavra-passe de /admin. A impressora autentica-se com eles por HTTP Digest, como descreve o manual da Epson; o nosso servidor aceita Digest e Basic. Sem credenciais corretas responde «401» e a impressora não recebe nada. Menos de 5 segundos não traz nada: o nosso servidor aceita no máximo um pedido a cada 400 ms por impressora.
6. Clique em «Apply» e depois, em «TM-i Settings» (endereço /webconfig-i), em «Apply & Restart» – só então a impressora aplica o Server Direct Print e reinicia. Depois termine a sessão com «Administrator Logout»: enquanto alguém tiver sessão iniciada como administrador, a impressora está em modo de configuração e não imprime nada.
7. Em /admin clique em «Impressão de teste» na linha da impressora. O talão de teste chega na próxima consulta – ou seja, em cerca de 5 segundos no máximo – e na coluna «Estado» aparece «último contacto» com a hora.

Em alternativa: impressoras Star com CloudPRNT

1. Em vez da Epson também serve uma impressora Star com CloudPRNT, p. ex. TSP143IV, TSP100IV, mC-Print3 ou mC-Print2. Ao adicionar, escolha «Star CloudPRNT (a impressora recolhe os talões)».
2. Abra a interface web da impressora Star (endereço IP do autoteste) e inicie sessão como administrador.
3. Ative o CloudPRNT, introduza em «Server URL» o endereço do /admin, 5 a 10 segundos como intervalo de consulta e na autenticação (Basic) o utilizador e a palavra-passe do /admin.
4. Guarde, reinicie a impressora e clique em «Impressão de teste» no /admin. No primeiro contacto o servidor guarda o endereço MAC da impressora; outro dispositivo com o mesmo endereço é recusado.

Impressoras de talões económicas através do proxy de impressão (USB ou rede)

1. Em vez de uma impressora Epson ou Star com função cloud, também serve uma impressora de talões ESC/POS económica – por USB ou em rede, por exemplo Epson TM-T20, Xprinter, Munbyn ou Rongta. É preciso uma guilhotina automática: cada talão termina com um corte. Impressoras sem guilhotina (barra de corte, muitas impressoras portáteis de 58 mm) não são suportadas.
2. Para isso, na rede do clube corre um pequeno proxy de impressão como contentor Docker – num Raspberry Pi (também modelos mais antigos a partir do Pi 2; o Pi 1 e o primeiro Pi Zero não servem), num NAS ou num PC. Liga-se sozinho ao nosso servidor, sem reencaminhamento de portas.
3. Em /admin abra «Operação» → «Impressoras de talões» → «Proxies de impressão», introduza um nome e clique em «Associar proxy». O token do dispositivo só aparece agora. Se a impressora estiver ligada ao proxy por USB, marque «Impressora por USB no proxy (/dev/usb/lp0)». Copie o comando de arranque já pronto (docker run …) com «Copiar comando». Em alternativa, «docker compose» mostra a mesma configuração como docker-compose.yml: copie-a com «Copiar YAML», guarde-a numa pasta e execute aí «docker compose up -d».
4. Execute o comando no Raspberry Pi ou no computador. No primeiro arranque, o Docker descarrega sozinho a imagem drinklist/print-proxy do Docker Hub (https://hub.docker.com/r/drinklist/print-proxy, para amd64, arm64 e arm/v7). O contentor reinicia sozinho após um reinício ou falha de energia; pouco depois o proxy aparece como «ligado» em /admin. Dica: com o acrescento --test-print e o endereço IP da impressora (ou /dev/usb/lp0) a imagem imprime uma página de teste sem servidor – para verificar cabo, endereço e guilhotina.
5. Depois adicione a impressora: ligação «Proxy de impressão: impressora ESC/POS económica por USB ou rede (Docker, Raspberry Pi)», escolha o proxy e em «Ligação no proxy» rede (endereço IP da impressora na rede do clube, porta 9100) ou USB (/dev/usb/lp0). Marque «A impressora tem guilhotina automática», guarde e clique em «Impressão de teste». Rotas de impressão, reimpressão e trabalhos funcionam como em qualquer outra impressora.
6. Se o proxy não estiver ligado (energia, internet), os talões aguardam e saem assim que volte a estar online – os com mais de duas horas já não são impressos, mas podem ser reimpressos. A coluna «Estado» mostra falta de papel ou tampa aberta, se a impressora o comunicar; muitas impressoras económicas não o fazem. «Novo token» invalida o anterior, «Remover» desliga o proxy definitivamente.

Rotas de impressão: comida para a cozinha, bebidas para o balcão

1. Em «O que imprime esta impressora?» cada impressora define o que imprime automaticamente: «Talões de caixa» após cada venda a dinheiro, o «Talão Z» ao fechar a caixa e «Talões de pedido» para novos pedidos por QR. Várias impressoras podem imprimir o mesmo, p. ex. talões no balcão e no escritório.
2. Cozinha: adicione a impressora «Cozinha», assinale «Talões de pedido» e em «Só estes grupos de produtos (categorias)» escolha a categoria dos pratos, p. ex. «Comida» – tal como está nos produtos.
3. Balcão: na impressora «Balcão» assinale «Talões de caixa» e «Talões de pedido» e ainda «Todos os outros produtos (categoria sem impressora própria)». Sem categoria e sem esta opção uma impressora imprime cada pedido completo.
4. Um pedido com 2 imperiais e 1 bitoque dá agora dois talões: o bitoque na cozinha, as imperiais no balcão – cada um com número do pedido, mesa ou posto, hora, cliente e notas. Linhas sem impressora adequada não são impressas. Opcionalmente há «Preços no talão de pedido» e «Imprimir pedidos anulados como talão de anulação».
5. O botão «Rotas de impressão» mostra a visão geral: que documento, de que lista e grupo de produtos, sai em que impressora. Se a impressora não tiver lista escolhida, «Para a lista» na janela da impressora limita as suas rotas a uma lista.

Ecrã de pedidos em vez de talões: para cozinha e balcão

1. Abra «Operação» → «Ecrãs de pedidos» e clique em «Adicionar ecrã de pedidos». Nome, p. ex. «Cozinha», e como na impressora «Só estes grupos de produtos (categorias)» ou «Todos os outros produtos (categoria sem impressora própria)» – ecrãs e impressoras seguem as mesmas regras.
2. Abra a ligação ou o código QR no tablet ou na TV e escolha «Adicionar ao ecrã principal». O ecrã arranca como app própria sem início de sessão, em ecrã inteiro, e mantém o ecrã ligado. Um toque liga o som de novos pedidos.
3. Cada pedido em aberto aparece como um grande mosaico com número, mesa ou posto, cliente, notas e só as linhas deste ecrã. O tempo corre e o mosaico fica âmbar após «Âmbar após minutos» e vermelho após «Vermelho após minutos».
4. Toque em «Em preparação» para assumir o pedido (o balcão vê-o como assumido) e em «Pronto» para o retirar deste ecrã – com «Anular» durante 10 segundos. Entregar e cobrar fica no balcão. «Nova ligação» invalida a anterior, p. ex. se um tablet se perder.

Logótipo para talões, PDF e ecrã de TV

1. Em /admin abra «Organização» → «Dados base» e desça até à secção «Logótipo».
2. Clique em «Carregar logótipo» e escolha uma imagem JPG ou PNG até 2 MB. É rodada e reduzida automaticamente.
3. Escolha onde o logótipo aparece: «Nos talões (impressora), em cima ao centro», «No ecrã TV/projetor, em cima à direita» e «Nos PDF do clube, em cima à direita (recibos, extratos, relatórios)».
4. Dica: a impressora só imprime a preto e branco, por isso o logótipo é convertido em pontos. Um logótipo simples, com contornos nítidos e forte contraste sobre fundo claro, fica melhor no talão.

Imprimir talões

• Um talão tem o logótipo, as linhas com letra de IVA, descontos e regras de preço, o total, a forma de pagamento e o IVA por taxa.
• «Diários e contas» → «Diário de pagamentos»: «Imprimir talão» na linha de um pagamento envia o talão para a impressora escolhida – sem escolha, para a primeira impressora com «Talões de caixa». O recibo em PDF continua disponível como sempre.
• «Operação» → «Caixa e relatório Z»: «Imprimir fecho Z» na linha de uma sessão de caixa fechada imprime o fecho Z em papel.
• «Operação» → «Impressoras de talões» → «Trabalhos»: todos os trabalhos com estado e erro. «Reimprimir» imprime um talão outra vez.

Se algo não funcionar

• Na coluna «Estado» continua «nunca consultada»: o endereço falta ou está errado, o Server Direct Print não está ativo ou a impressora não chega à Internet. Verifique também a data e a hora da impressora – se estiverem erradas, a ligação HTTPS falha. Se não conseguir entrar na interface web (o início de sessão falha), reponha as definições de fábrica da impressora com o botão FEED, como descreve o manual da Epson.
• Os trabalhos ficam «a aguardar» ou «enviado»: a impressora está ligada, com papel e a tampa fechada? A impressora vai buscar os trabalhos na consulta seguinte; sem resposta são reenviados e, após várias tentativas, marcados como falhados. Se /admin mostrar para a impressora «Gere uma nova palavra-passe (necessária para a Epson)», a palavra-passe é anterior à autenticação Digest: gere uma nova e introduza-a na impressora.
• Erro com uma mensagem da impressora: normalmente falta de papel ou tampa aberta. Resolva e o trabalho é reenviado automaticamente.
• Texto cortado ou demasiado estreito: a largura do papel em /admin tem de corresponder ao papel colocado (80 ou 58 mm).
• Acentos ou caracteres especiais errados: verifique se o firmware da impressora está atualizado – versões antigas não tratam todos os conjuntos de caracteres.

Epson: resolução de problemas da prática

• Não chega nenhum pedido ao servidor, embora tudo esteja introduzido: normalmente a impressora não conhece o certificado Let's Encrypt do nosso servidor (visto com uma TM-m30III, firmware TM-i 01.39 e certificados raiz 02.03). Execute «Advanced Settings» → «Network Security» → «Root Certificate Update» → «Update» ou importe «ISRG Root X1» e «ISRG Root YR» (letsencrypt.org/certificates) em «Network Security» → «CA Certificate». Depois, «Apply & Restart» em «TM-i Settings».
• As definições alteradas não têm efeito: o Server Direct Print só aplica alterações após «Apply & Restart» em «TM-i Settings» (/webconfig-i).
• A impressora imprime um talão «WebConfig Start» e mais nada: alguém tem sessão iniciada na interface web como administrador e a impressora está em modo de configuração. Termine sempre a sessão com «Administrator Logout».
• O autoteste imprime, mas da rede não sai nada – até o ePOS ou a porta 9100 aceitam dados sem imprimir: a ligação interna entre a parte de rede e o mecanismo de impressão bloqueou. Desligue a alimentação durante cerca de 30 segundos.
• Introduza o endereço com https://, não com http://: os pedidos por http:// são redirecionados e a Epson não segue redirecionamentos.
• Em /admin, em «Operação» → «Impressoras de talões», «Letzter Kontakt» (último contacto) na janela da impressora mostra os últimos pedidos com o resultado; este diagnóstico aparece em alemão. «Anmeldung angefordert (401 – bei Digest normal)» (início de sessão pedido) é normal no primeiro pedido. Com «Digest-Anmeldung falsch (ID/Passwort prüfen)» (início de sessão Digest errado) gere uma nova palavra-passe e introduza-a na impressora. Se aparecer «seit dem letzten Serverstart kein Abruf angekommen» (nenhum pedido desde o último arranque do servidor), a impressora não chega ao nosso servidor – verifique https://, certificados raiz e rede.