El Agente Fire incluye dos páginas web integradas que se sirven desde el propio agente (no requieren conexión a internet). Sirven para verificar el estado, diagnosticar y hacer pruebas de impresión sin necesidad de la aplicación de punto de venta.
Ambas solo son accesibles desde el mismo equipo donde corre el agente, porque escucha únicamente en 127.0.0.1 (localhost).
| Página | Dirección | Para qué sirve |
|---|
| Página de pruebas | http://localhost:9100/ | Conectarse, listar impresoras e imprimir tickets de prueba |
| Panel informativo | http://localhost:9100/panel | Ver estado, versión, actualizaciones, impresoras y URLs (solo lectura) |
Si cambiaste el puerto con FIRE_AGENT_PORT, usa ese número en lugar de 9100.
Requisitos previos
- El Agente Fire debe estar instalado y en ejecución (icono visible en la bandeja del sistema). Si no lo está, consulta Instalación en Windows.
- Un navegador moderno (Chrome, Edge, Brave, Firefox o Safari).
- Conocer el token del agente (
FIRE_AGENT_TOKEN). En instalaciones nuevas el valor por defecto es fire-agent-dev-token; en producción es el que se configuró durante la instalación.
Haz clic en el icono de Fire Agent en la bandeja del sistema para abrir directamente el panel informativo en el navegador.
Página de pruebas
La página de pruebas permite conectarse al agente e imprimir tickets de ejemplo. Es la herramienta principal para comprobar que una impresora funciona.
La interfaz tiene una barra lateral izquierda con cuatro secciones (Connection, Printers, Print, Log) y un botón Connect / Disconnect arriba a la derecha.
Abrir la página
Abre http://localhost:9100/ en el navegador. Se mostrará la interfaz Fire Agent.
Connection (Conexión)
Es la sección que se muestra al abrir la página.
- En el campo FIRE_AGENT_TOKEN, escribe el token del agente. Usa el icono de ojo para mostrarlo u ocultarlo.
- Haz clic en Connect (arriba a la derecha).
- El indicador de estado cambiará:
- Connecting… (amarillo): estableciendo conexión.
- Connected (verde): conexión correcta.
- Error (rojo): no se pudo conectar (revisa que el agente esté en ejecución).
- Al conectarse, el agente lista automáticamente las impresoras y el botón cambia a Disconnect.
Printers (Impresoras)
- Haz clic en Printers en la barra lateral.
- Verás la lista de impresoras detectadas en Windows. La predeterminada aparece como (default).
- Selecciona una impresora en el desplegable Select printer. La selección queda guardada para la próxima vez.
- Si conectaste una impresora nueva, haz clic en Refresh para volver a consultarlas.
Si no aparece ninguna impresora, instala primero su controlador desde la Configuración de Windows y luego pulsa Refresh.
Print (Imprimir)
Esta sección envía trabajos de impresión de prueba a la impresora seleccionada.
- Asegúrate de haber seleccionado una impresora en la sección anterior.
- Edita el contenido del ticket en el cuadro ESC/POS content (trae un ejemplo precargado).
- Usa uno de los cuatro botones:
| Botón | Acción |
|---|
| Print test | Imprime el contenido del cuadro de texto (sin cortar el papel) |
| Print + cut | Imprime el contenido y corta el papel al final |
| Open drawer | Envía el pulso para abrir el cajón de dinero conectado a la impresora |
| Cut only | Avanza papel y corta, sin imprimir texto |
Log (Registro)
Muestra, con marca de tiempo, todos los mensajes intercambiados con el agente:
- En amarillo: mensajes enviados (→) al agente.
- En verde: respuestas correctas (←
print_ok, printers, pong).
- En rojo: errores (← ERROR: …).
Usa el botón Clear para vaciar el registro. Es la primera sección a revisar cuando algo no funciona.
Dentro del cuadro de texto puedes aplicar énfasis con marcadores:
| Escribe | Resultado en el ticket |
|---|
**texto** | Negrita |
***texto*** | Negrita + doble ancho (título destacado) |
Guardado automático
La página recuerda su configuración en el navegador (localStorage):
| Dato | Se guarda cuando | Se restaura al abrir |
|---|
| Token | Cada vez que pulsas Connect | Se rellena el campo del token |
| Impresora | Al seleccionarla o imprimir | Se selecciona en el desplegable |
| Contenido del ticket | Cada vez que imprimes | Se rellena el cuadro de texto |
http://localhost:9100/panel (o haz clic en el icono de Fire Agent en la bandeja del sistema). La barra lateral tiene cuatro secciones:
| Sección | Información que muestra |
|---|
| Status | Versión del agente, tiempo activo (uptime), plataforma e indicador de actividad |
| Updates | Si la actualización automática está activa, versión remota, estado y última comprobación |
| Printers | Impresoras detectadas con su estado |
| Connection | URLs de conexión: ws://localhost:9100, wss://localhost:9101 y la de /health |
El indicador de estado pasa a Offline (rojo) si el agente deja de responder.
Tema claro / oscuro
Ambas páginas tienen un botón de tema (icono de sol/luna) en la esquina superior derecha. Al hacer clic se alterna entre modo oscuro y claro, y la preferencia se guarda en el navegador.
Solución de problemas
| Síntoma | Causa probable | Solución |
|---|
La página no carga (localhost rechazó la conexión) | El agente no está en ejecución | Inicia Fire Agent (bandeja del sistema) o reinicia el equipo; verifica con http://localhost:9100/health |
| Estado Error al pulsar Connect | El agente no responde o el puerto cambió | Confirma que el agente esté activo y que usas el puerto correcto (FIRE_AGENT_PORT) |
El registro muestra ERROR: ... 1001 o Unauthorized | Token incorrecto | Escribe el token correcto en la sección Connection y vuelve a conectarte |
| No aparece ninguna impresora | El controlador no está instalado en Windows | Instala el driver desde la Configuración de Windows y pulsa Refresh |
| El ticket se imprime pero no corta | La impresora no soporta el comando de corte | Usa Print test (sin corte) o consulta el manual de tu impresora |
| El cajón no abre | Cableado o voltaje del cajón distinto | Verifica que el cajón esté conectado al puerto RJ de la ticketera y encendido |
La página HTTPS de la POS no conecta a wss://localhost:9101 | El navegador no confía en el certificado autofirmado | Abre una vez https://localhost:9101/health y acepta la advertencia, o importa el certificado (ver Instalación en Windows) |
