O Agente Fire inclui duas páginas web integradas, servidas pelo próprio agente (não exigem conexão com a internet). Servem para verificar o status, diagnosticar e fazer testes de impressão sem o aplicativo de ponto de venda.
As duas só são acessíveis do mesmo equipamento onde o agente roda, porque ele escuta apenas em 127.0.0.1 (localhost).
| Página | Endereço | Para que serve |
|---|
| Página de testes | http://localhost:9100/ | Conectar, listar impressoras e imprimir comprovantes de teste |
| Painel informativo | http://localhost:9100/panel | Ver status, versão, atualizações, impressoras e URLs (somente leitura) |
Se você mudou a porta com FIRE_AGENT_PORT, use esse número no lugar de 9100.
Pré-requisitos
- O Agente Fire deve estar instalado e em execução (ícone visível na bandeja do sistema). Se não estiver, consulte Instalação no Windows.
- Um navegador moderno (Chrome, Edge, Brave, Firefox ou Safari).
- O token do agente (
FIRE_AGENT_TOKEN). Em instalações novas o valor padrão é fire-agent-dev-token; em produção é o que foi configurado durante a instalação.
Clique no ícone do Fire Agent na bandeja do sistema para abrir o painel informativo diretamente no navegador.
Página de testes
A página de testes permite conectar ao agente e imprimir comprovantes de exemplo. É a ferramenta principal para confirmar que uma impressora funciona.
A interface tem uma barra lateral esquerda com quatro seções (Connection, Printers, Print, Log) e um botão Connect / Disconnect no canto superior direito.
Abrir a página
Abra http://localhost:9100/ no navegador. A interface Fire Agent será exibida.
Connection (Conexão)
É a seção mostrada ao abrir a página.
- No campo FIRE_AGENT_TOKEN, digite o token do agente. Use o ícone de olho para mostrá-lo ou ocultá-lo.
- Clique em Connect (canto superior direito).
- O indicador de status muda:
- Connecting… (amarelo): estabelecendo a conexão.
- Connected (verde): conexão bem-sucedida.
- Error (vermelho): não foi possível conectar (verifique se o agente está rodando).
- Ao conectar, o agente lista as impressoras automaticamente e o botão muda para Disconnect.
Printers (Impressoras)
- Clique em Printers na barra lateral.
- Você verá as impressoras detectadas no Windows. A padrão aparece como (default).
- Selecione uma impressora no menu Select printer. A seleção fica salva para a próxima vez.
- Se conectou uma impressora nova, clique em Refresh para consultá-las novamente.
Se nenhuma impressora aparecer, instale o driver dela pelas configurações do Windows e depois clique em Refresh.
Print (Imprimir)
Esta seção envia trabalhos de impressão de teste para a impressora selecionada.
- Confirme que selecionou uma impressora na seção anterior.
- Edite o conteúdo do comprovante na caixa ESC/POS content (vem com um exemplo pré-carregado).
- Use um dos quatro botões:
| Botão | Ação |
|---|
| Print test | Imprime o conteúdo da caixa de texto (sem cortar o papel) |
| Print + cut | Imprime o conteúdo e corta o papel no final |
| Open drawer | Envia o pulso para abrir a gaveta de dinheiro conectada à impressora |
| Cut only | Avança o papel e corta, sem imprimir texto |
Log (Registro)
Mostra, com marca de tempo, todas as mensagens trocadas com o agente:
- Em amarelo: mensagens enviadas (→) ao agente.
- Em verde: respostas corretas (←
print_ok, printers, pong).
- Em vermelho: erros (← ERROR: …).
Use o botão Clear para limpar o registro. É a primeira seção a revisar quando algo não funciona.
Dentro da caixa de texto você pode aplicar ênfase com marcadores:
| Digite | Resultado no comprovante |
|---|
**texto** | Negrito |
***texto*** | Negrito + largura dupla (título destacado) |
Salvamento automático
A página lembra a configuração no navegador (localStorage):
| Dado | Salvo quando | Restaurado ao abrir |
|---|
| Token | Cada vez que você clica em Connect | O campo do token é preenchido |
| Impressora | Ao selecionar ou imprimir | Selecionada no menu |
| Conteúdo do comprovante | Cada vez que você imprime | A caixa de texto é preenchida |
http://localhost:9100/panel (ou clique no ícone do Fire Agent na bandeja do sistema). A barra lateral tem quatro seções:
| Seção | Informação exibida |
|---|
| Status | Versão do agente, tempo ativo (uptime), plataforma e indicador de atividade |
| Updates | Se a atualização automática está ativa, versão remota, status e última verificação |
| Printers | Impressoras detectadas com o status |
| Connection | URLs de conexão: ws://localhost:9100, wss://localhost:9101 e a de /health |
O indicador de status passa para Offline (vermelho) se o agente parar de responder.
Tema claro / escuro
As duas páginas têm um botão de tema (ícone de sol/lua) no canto superior direito. Ao clicar, alterna entre modo escuro e claro, e a preferência é salva no navegador.
Solução de problemas
| Sintoma | Causa provável | Solução |
|---|
A página não carrega (localhost recusou a conexão) | O agente não está rodando | Inicie o Fire Agent (bandeja do sistema) ou reinicie o equipamento; verifique com http://localhost:9100/health |
| Status Error ao clicar em Connect | O agente não responde ou a porta mudou | Confirme que o agente está ativo e que você usa a porta correta (FIRE_AGENT_PORT) |
O registro mostra ERROR: ... 1001 ou Unauthorized | Token incorreto | Digite o token correto na seção Connection e conecte novamente |
| Nenhuma impressora aparece | O driver não está instalado no Windows | Instale o driver pelas configurações do Windows e clique em Refresh |
| O comprovante imprime mas não corta | A impressora não suporta o comando de corte | Use Print test (sem corte) ou consulte o manual da impressora |
| A gaveta não abre | Cabeamento ou voltagem da gaveta diferente | Verifique que a gaveta está conectada à porta RJ da impressora e ligada |
A página HTTPS do POS não conecta a wss://localhost:9101 | O navegador não confia no certificado autoassinado | Abra https://localhost:9101/health uma vez e aceite o aviso, ou importe o certificado (ver Instalação no Windows) |
