Impressão

A tela Impressão, em Configurações, organiza a impressão térmica da empresa: o cadastro das impressoras ligadas na rede local, a chave de integração que autoriza o programa de impressão a imprimir e o acompanhamento dos trabalhos enviados a cada impressora (vias, status e tentativas). O programa de impressão é um programinha instalado num computador da empresa (o box) que recebe os trabalhos pela internet e manda para a impressora na rede. Por isso a impressora precisa ter um endereço de rede fixo e a chave precisa estar configurada no box.

Para que serve

A impressão térmica faz o cupom sair direto na impressora do box, sem depender do navegador nem de um computador sempre aberto. Ela vale para o pedido de retirada, o pedido de venda, o orçamento e o recibo de caixa. O operador dispara a impressão no app ou no web, e o sistema enfileira o trabalho. O programa de impressão instalado na empresa coleta o trabalho e manda para a impressora certa, na largura de coluna certa, acompanhando o resultado em tempo real. Antes de imprimir, a tela mostra um preview fiel do cupom, com a largura e o layout que a impressora vai receber.

A tela Impressão separa isso em duas abas:

Configuração: as impressoras cadastradas (com o estado de saúde sondado pelo programa) e o programa de impressão (estado de conexão e chave de integração). É o degrau que antecede qualquer impressão: sem impressora cadastrada e sem chave configurada no box, nada imprime.
Trabalhos: a auditoria de tudo que foi enviado, por documento, via, status e tentativas. É onde você descobre por que uma via ficou pendente ou falhou, e de onde reimprime ou reabre um trabalho.

Importante: o destino de cada impressão não é escolhido aqui nem por documento. A empresa define a Impressora do aplicativo (app), no cadastro da empresa, na seção Pedido de retirada: sem ela, o botão Imprimir do app fica indisponível. No navegador, o botão Imprimir oferece a térmica assim que houver uma impressora ativa cadastrada aqui. A Impressora padrão (web) da empresa só define qual delas o painel já traz selecionada. A tela Impressão cadastra as impressoras disponíveis. Ao imprimir, se a empresa tem mais de uma impressora ativa, o campo Impressora do painel permite trocá-la naquela impressão.

Como acessar

Abra Configurações › Impressão no menu lateral. O item aparece para quem tem acesso ao subject impressao. Se ele não aparecer, peça a um administrador para conceder a permissão no perfil de acesso.

A aba Configuração abre primeiro. A seção Impressoras é fixa (sempre visível). A seção Programa de impressão começa recolhida e abre sozinha apenas quando há risco: programa desconectado, sem chave de integração ou que nunca conectou. Quando está tudo saudável, ela fica fechada. Abra-a se quiser gerenciar a chave.

Impressoras

A seção Impressoras lista as impressoras térmicas cadastradas para a empresa. Cada linha mostra:

Nome: o nome que você deu à impressora (ex.: Balcão, Cozinha), usado para escolhê-la no cadastro da empresa e nos diálogos de impressão.
Endereço: o IP e a porta da impressora na rede local (ex.: 192.168.0.50:9100).
Largura: a largura em colunas (48 ou 80), que define o tamanho do cupom.
Situação: Ativa ou Inativa. Uma impressora inativa não recebe trabalhos.
Saúde: o estado sondado pelo programa, que pode ser Responde (a impressora atendeu à sonda), Sem resposta (o programa não conseguiu falar com ela), Sem papel (a impressora reportou falta de papel) ou Não verificada (o programa ainda não sondou). A saúde é atualizada pelo programa e reflete a última verificação.

O menu de ações (três pontos verticais, na primeira coluna) tem Testar, Editar e Remover. O Testar fica disponível só para impressoras ativas: uma inativa não recebe trabalhos, então não há o que testar.

Cadastrar uma impressora

Abra o menu de ações de uma impressora e escolha Editar, ou use Nova impressora (no topo da lista quando já há impressoras, ou no cartão de lista vazia). O formulário pede:

Em Nome, dê um nome que identifique a impressora na empresa (ex.: Balcão). É esse nome que aparece na hora de escolher a impressora de destino.
Em Endereço IP, informe o IP da impressora na rede local. O campo tem máscara de IPv4 e rejeita valores inválidos. Confira o IP na configuração da própria impressora ou no roteador. Impressora só-USB ligada por ponte no próprio box usa 127.0.0.1.
Em Porta, mantenha 9100 (a porta padrão da impressão térmica, raw ESC/POS) a menos que a impressora use outra. Porta é obrigatória e aceita de 1 a 65535.
Em Largura (colunas), escolha 48 ou 80. A largura define quantos caracteres cabem numa linha do cupom. 48 é o padrão (Font A da térmica 80mm, o layout do cupom), e 80 serve para impressoras mais largas.
Em Ativa, deixe Sim para a impressora receber trabalhos. Se quiser pausá-la sem excluí-la, deixe Não.
Se a impressora usa um codepage específico, preencha em Codepage (ex.: PC860). Caso contrário, deixe em branco: o sistema trata a ausência.
Escolha Salvar. A impressora entra na lista e já pode ser usada como destino no cadastro da empresa.

Testar uma impressora

No menu de ações da impressora, escolha Testar. O sistema enfileira uma folha de teste e o programa manda para a impressora. O diálogo acompanha o resultado em tempo real:

Teste enviado. Aguardando a impressora… O trabalho foi criado e ainda não saiu.
Imprimindo… A folha de teste está a caminho da impressora.
Teste impresso com sucesso. A impressora imprimiu a folha de teste.
Falha na impressão do teste. A impressora recusou (sem papel, offline, codepage errado).
O teste não chegou à impressora a tempo. O programa está desligado ou sem chave. Confirme a chave na seção Programa de impressão e que o box está ligado.

Remover uma impressora

No menu de ações, escolha Remover. A impressora deixa de receber trabalhos, mas os trabalhos já enfileirados não são afetados (eles seguem na fila até o programa enviá-los à impressora). Se a impressora removida era o destino de alguma empresa, o destino daquela empresa volta sozinho para Nenhuma / Padrão do sistema operacional. Confira o cadastro da empresa para redefinir o destino.

Programa de impressão

A seção Programa de impressão mostra o estado do programa e gerencia a chave de integração, a credencial que autoriza o box da empresa a coletar e imprimir os trabalhos.

Estado da conexão

O badge no topo da seção mostra a vitalidade da conexão:

Conectado: o box está online e se comunicando com o sistema. Aparece também a versão instalada, a máquina (hostname do box) e a última conexão.
Desconectado: o box parou de se comunicar (desligado, sem internet ou o programa travou). Imprime o que estava na fila assim que voltar.
Nunca conectou: ainda não há um box configurado com a chave desta empresa. Você precisa gerar a chave e instalar o programa.

O estado é atualizado ao vivo (sem recarregar a página) à medida que o programa se conecta e desconecta.

Chave de integração

A chave de integração é a credencial que liga o box da empresa a esta empresa no sistema. Sem ela, o programa não consegue coletar trabalhos. A gestão da chave exige a permissão gerenciar_chave_integracao no subject impressao. Sem ela, a seção mostra que você não tem permissão para gerenciar a chave.

Quando não há chave configurada, a seção mostra Nenhuma chave de integração configurada e o botão Gerar chave. Quando há, aparece um indicador de atribuição (a chave em claro nunca é exibida novamente depois de gerada) e a data em que foi configurada, com os botões Rolar chave e Revogar chave.

Nesta seção, em Programa de impressão, clique em Gerar chave (ou Rolar chave, se já houver uma e você quiser renovar). A chave aparece num diálogo. Copie-a.
No computador que será o box (Linux ou Raspberry Pi) ligado à impressora na rede, rode o instalador em um terminal e passe a chave quando ele pedir:
```
curl -fsSL https://tromso.com.br/agente | sudo bash
```
O instalador baixa o programa, registra-o como serviço e pede a chave de integração copiada no passo anterior.
Concluído o instalador, o programa se conecta e o badge nesta tela passa para Conectado em poucos instantes.

Rolar e revogar a chave

Rolar chave: gera uma chave nova, substituindo a atual. A chave antiga para de funcionar imediatamente: você precisa copiar a nova e reconfigurar no box. Útil quando há suspeita de vazamento ou para trocar a credencial periodicamente.
Revogar chave: apaga a chave de integração. O programa perde o acesso imediatamente e para de imprimir até uma nova chave ser gerada e configurada nele. O sistema pede confirmação antes de revogar.

Trabalhos

A aba Trabalhos é a auditoria de tudo que foi enviado às impressoras. Cada linha é uma via de um documento, com:

Documento: o tipo do documento (ex.: Pedido de retirada ou Teste).
Via: o número da via (1 para a primeira impressão, 2 para a reimpressão, e assim por diante). Cada Reimprimir gera uma via nova. O documento de teste não gera vias novas.
Status: o estado do trabalho, que pode ser Pendente, Entregue, Concluído, Falhou, Expirado, Morto ou Obsoleto.
Impressora: a impressora de destino.
Tentativas: quantas vezes o programa tentou imprimir esta via.
Solicitado em / Finalizado em: quando o trabalho foi criado e quando terminou (impresso ou falhou).
Pendente desde / Entregue em / Erro: colunas extras, exibíveis pelo seletor de colunas, que ajudam a diagnosticar trabalhos parados.

Filtrar e ordenar

Use os filtros para afunilar a auditoria:

Status: seleção múltipla (ex.: ver só Falhou e Morto para entender o que não imprimiu).
Documento: Pedido de retirada ou Teste.
Via: um número de via específico.
Solicitado em: por data.

A ordenação por coluna é suportada em Solicitado em, Via, Status, Pendente desde e Finalizado em. As demais colunas não são ordenáveis (o cabeçalho clicável prometeria uma ordenação que o sistema ignoraria).

Reimprimir e reabrir

No menu de ações de cada trabalho:

Reimprimir: gera uma via nova do documento e a enfileira novamente. Disponível quando há permissão de reimpressão. Não se aplica ao documento de teste.
Reabrir: volta um trabalho Morto para a fila, na mesma via, para o programa tentar de novo. Útil quando o trabalho morreu por um problema transitório (impressora desligada na hora) e você quer tentar a mesma via sem gerar uma nova.

Entender os status

Pendente: enfileirado, esperando sair na impressora.
Entregue: a impressão está a caminho da impressora.
Concluído: a impressora imprimiu a via com sucesso.
Falhou: a impressora recusou (sem papel, offline, codepage incompatível).
Expirado: a impressão não chegou à impressora a tempo. Significa box desligado ou sem chave configurada.
Morto: o trabalho não pôde ser impresso e parou de ser tentado. Pode ser reaberto manualmente.
Obsoleto: o trabalho foi cancelado (ex.: a impressora foi removida ou o destino mudou antes de sair na impressora).

Dúvidas frequentes

Cadastrei a impressora, mas nada imprime. O que falta?

A impressão térmica depende de três peças, em ordem: a impressora cadastrada aqui (com Situação Ativa e Saúde Responde), a chave de integração configurada e o box ligado com a chave instalada. Sem impressora ativa, nenhum trabalho é criado: nos pedidos de retirada, o botão abre o PDF A4 no navegador, e nos documentos térmicos a tela avisa que não há impressora configurada. No aplicativo, sem a Impressora do aplicativo definida no cadastro da empresa (seção Pedido de retirada), o botão Imprimir fica indisponível. Com a impressora ativa, um trabalho que fica Pendente ou Expirado na aba Trabalhos aponta para o box, para a chave ou para a impressora que não responde (Saúde Sem resposta). Comece pela seção Programa de impressão: o badge deve estar Conectado.

Por que o status aparece Expirado?

Expirado significa que a impressão não chegou à impressora a tempo. O box está desligado, sem internet ou sem a chave de integração configurada. Verifique na seção Programa de impressão se o badge está Conectado. Se estiver Desconectado ou Nunca conectou, ligue o box, confirme a internet e gere/role a chave e reinstale-a no programa.

Qual a diferença entre Reimprimir e Reabrir?

Reimprimir gera uma via nova do documento (Via 2, Via 3…) e enfileira do zero. Use essa opção quando a via anterior ficou irrecuperável. Reabrir volta um trabalho Morto para a fila na mesma via, para o programa tentar de novo. Use essa opção quando o problema foi transitório (impressora desligada na hora) e você não quer gerar uma via nova.

A saúde da impressora mostra Sem resposta. O que significa?

Sem resposta significa que o programa não conseguiu abrir a conexão com a impressora na porta informada. Na impressora de rede, a causa costuma ser IP ou porta errados, a impressora desligada ou um firewall bloqueando a porta (padrão 9100). Confira o Endereço e a Porta no cadastro e verifique que a impressora está ligada e no mesmo segmento de rede do box. Na impressora só-USB ligada por ponte, o endereço é 127.0.0.1: Sem resposta aí quer dizer que a ponte não está escutando a porta 9100, e a equipe técnica verifica o serviço no box.

Como conectar uma impressora só-USB?

Uma impressora só-USB não tem endereço na rede, então o programa não a alcança direto. A saída sem hardware extra é uma ponte de software no próprio box: ela escuta a porta 9100 do computador e entrega o cupom à impressora pelo USB. No cadastro, a impressora fica com o endereço 127.0.0.1 e a porta 9100.

A ponte é instalada pela equipe técnica, no computador do caixa. O operador só precisa cadastrar a impressora como descrito acima e conferir a Saúde. Com a ponte do Windows, a saúde mostra Responde mesmo com a impressora sem papel ou com a tampa aberta, porque o spooler não devolve o status da impressora. Nessa configuração a tela não mostra Sem papel. Se o cupom demorar alguns segundos para sair nessa ponte, peça à equipe técnica para conferir a configuração do programa no box.

Para a equipe técnica:

Windows: um serviço que recebe RAW na porta 9100 de 127.0.0.1 e o repassa ao spooler da impressora instalada (ex.: Windows-PrtEasyServer). O tipo de dado da impressora tem de ser RAW. Driver Generic/Text Only converte quebra de linha e o cupom sai com espaçamento duplo. Como essa ponte não responde ao status, coloque "probeAntesDeImprimir": false no agente.json do programa do box, que na instalação do Windows fica em C:\ProgramData\Tromso\ImpressaoAgente. Sem isso, cada cupom espera o tempo limite da sondagem antes de sair.
Linux: p910nd com -b (bidirecional) sobre /dev/usb/lp0. Com -b, o programa recebe o status da impressora, e a saúde mostra Sem papel quando ela informa falta de papel. Nessa ponte, a sondagem de status continua ligada e não espera o tempo limite antes de cada cupom.

Onde defino qual impressora o app e o web usam?

Não aqui. O destino de impressão fica no cadastro da empresa, na seção Pedido de retirada. No app, o destino é a Impressora do aplicativo. No navegador, o destino é a impressora ativa que o painel traz selecionada, que começa na Impressora padrão (web) quando ela está definida. A tela Impressão apenas cadastra as impressoras disponíveis. Na hora de imprimir, se a empresa tem mais de uma impressora ativa, o campo Impressora do painel permite escolher outra.

Posso revogar a chave sem desinstalar o programa?

Sim. Revogar chave apaga a credencial e o programa perde o acesso imediatamente, parando de imprimir, e não é preciso desinstalá-lo. Para voltar a imprimir, gere uma nova chave e configure-a no box (ou rola a chave e reconfigura). Útil quando há suspeita de vazamento da credencial.

Veja também

Empresas: onde se define o destino de impressão por empresa (impressora do app e do web), na seção Pedido de retirada.
Pedidos de retirada: o documento de retirada, com o fluxo de vias e a impressão no app.
Perfis de acesso: a permissão gerenciar_chave_integracao (e a de reimpressão) vive no perfil.