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 agente de impressão a imprimir e o acompanhamento dos trabalhos enviados a cada impressora (vias, status e tentativas). O agente é 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 é o que faz o cupom do pedido de retirada sair direto na impressora do box, sem depender do navegador nem de um computador sempre aberto. O operador dispara a impressão no app ou no web; o sistema enfileira o trabalho; o agente 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.

A tela Impressão separa isso em duas abas:

Configuração — as impressoras cadastradas (com o estado de saúde sondado pelo agente) e o agente 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 (se o pedido de retirada sai no app ou no web, e em qual impressora) não é configurado aqui — é configurado por empresa, no cadastro da empresa (seção Pedido de retirada). A tela Impressão cadastra as impressoras disponíveis; o cadastro da empresa diz qual delas cada destino usa.

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 Agente de impressão começa recolhida e abre sozinha apenas quando há risco — agente 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 agente: Responde (a impressora atendeu à sonda), Sem resposta (o agente não conseguiu falar com ela), Sem papel (a impressora reportou falta de papel) ou Não verificada (o agente ainda não sondou). A saúde é atualizada pelo agente 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.
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 agente coleta e manda para a impressora; o diálogo acompanha o resultado em tempo real:

Teste enfileirado. Aguardando o agente… — o trabalho foi criado, esperando o agente coletar.
Entregue ao agente. Imprimindo… — o agente recebeu e mandou para a impressora.
Teste impresso com sucesso. — a impressora imprimiu a folha de teste.
Falha na impressão do teste. — o agente mandou, mas a impressora recusou (sem papel, offline, codepage errado).
Nenhum agente coletou o teste dentro do tempo. — o agente está offline ou sem chave configurada. Confirme a chave de integração na seção Agente 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; trabalhos já enfileirados não são afetados (eles seguem na fila até o agente coletá-los). 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.

Agente de impressão

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

Estado do agente

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

Agente conectado — o box está online e se comunicando com o sistema. Aparece também a versão do agente instalada, a máquina (hostname do box) e a última conexão.
Agente desconectado — o box parou de se comunicar (desligado, sem internet ou o agente 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 agente.

O estado é atualizado ao vivo (sem recarregar a página) à medida que o agente 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 agente 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 Agente 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 agente, registra-o como serviço e pede a chave de integração copiada no passo anterior.
Concluído o instalador, o agente se conecta e o badge nesta tela passa para Agente 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 agente perde 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: Pendente, Entregue, Concluído, Falhou, Expirado, Morto ou Obsoleto.
Impressora — a impressora de destino.
Tentativas — quantas vezes o agente 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 agente 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 o agente coletar.
Entregue — o agente coletou e mandou para a impressora.
Concluído — a impressora imprimiu a via com sucesso.
Falhou — o agente mandou, mas a impressora recusou (sem papel, offline, codepage incompatível).
Expirado — nenhum agente coletou o trabalho dentro do 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 o agente coletar).

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, e o destino definido no cadastro da empresa (seção Pedido de retirada). Se faltar qualquer uma, o trabalho fica Pendente/Expirado na aba Trabalhos. Comece pela seção Agente de impressão: o badge deve estar Agente conectado.

Por que o status aparece Expirado?

Expirado significa que nenhum agente coletou o trabalho dentro do tempo. O box está desligado, sem internet ou sem a chave de integração configurada. Verifique na seção Agente de impressão se o badge está Agente conectado; se estiver Desconectado ou Nunca conectou, ligue o box, confirme a internet e gere/role a chave e reinstale-a no agente.

Qual a diferença entre Reimprimir e Reabrir?

Reimprimir gera uma via nova do documento (Via 2, Via 3…) e enfileira do zero — use quando a via anterior ficou irrecuperável. Reabrir volta um trabalho Morto para a fila na mesma via, para o agente tentar de novo — use 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 agente tentou sondar a impressora e ela não atendeu — o IP ou a porta estão errados, a impressora está offline ou há um firewall bloqueando a porta (padrão 9100). Confira o Endereço e a Porta no cadastro da impressora e verifique que a impressora está ligada e no mesmo segmento de rede do box.

Onde defino qual impressora o app e o web usam?

Não aqui. O destino de impressão (qual impressora o app usa e qual o web usa) é configurado por empresa, no cadastro da empresa — seção Pedido de retirada, subgrupo Impressão. A tela Impressão apenas cadastra as impressoras disponíveis; a escolha de qual usar vive no cadastro da empresa.

Posso revogar a chave sem desinstalar o agente?

Sim. Revogar chave apaga a credencial e o agente perde acesso imediatamente, parando de imprimir — 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 que dispara a impressão térmica, com o fluxo de vias e o comportamento no app.
Perfis de acesso — a permissão gerenciar_chave_integracao (e a de reimpressão) vive no perfil.