Agente de estación

Para qué sirve

El agente de estación es un programa que se instala en una PC de la estación y hace de puente entre los equipos de la playa y MDSYS Grifos:

• el controlador de surtidores (la consola que gobierna los dispensadores electrónicos), y
• la consola de telemetría de tanques (sondas que miden el nivel automáticamente).

Con el agente, el sistema recibe solo:

• Transacciones del surtidor: cada despacho terminado (manguera, galones, soles, precio), para asociarlo a la venta del POS y que ningún despacho quede sin cobrar.
• Totalizadores (contómetros electrónicos) de todas las mangueras, para las lecturas de cierre y de corte de precio del turno sin digitarlas.
• Mediciones de tanques (telemetría), que pueden generar el corte diario automáticamente.

Y el sistema le envía al controlador los precios nuevos cuando cambias un precio.

:::warning Estado actual El programa del agente ya funciona con su simulador, pero los adaptadores para controladores reales (DOMS, Fusion, etc.) y consolas de telemetría están pendientes de homologar el hardware. Consulta con soporte antes de planificar su uso en producción. :::

Dónde está

Menú:Configuración›Agente de estación/agentes

Se gestiona en la estación activa (se muestra debajo del título). Requiere el módulo de agente de estación en tu plan.

Quién puede

• Ver el agente y las transacciones del surtidor: Permisoagente_estacion.ver
• Registrar, rotar la clave y desactivar el agente: Permisoagente_estacion.gestionar
• Ignorar una transacción del surtidor: Permisoagente_estacion.ignorar_transaccion

Conceptos

• Un agente por estación: cada estación tiene como máximo un agente activo.
• API key: la clave con la que el agente se identifica. Empieza por mdsa_. Se muestra una sola vez (al registrar o al rotar); el sistema no la guarda en texto legible.
• Latido: cada 15 segundos el agente avisa que está vivo, envía el estado de sus adaptadores y los totalizadores de todas las mangueras, y recibe los comandos pendientes.
• Estado de conexión: En línea (latido en el último minuto), Sin señal, Nunca conectó o Desactivado.
• Desfase de reloj: diferencia entre la hora de la PC y la del servidor. El sistema corrige las horas del agente con este desfase y alerta si supera el umbral (120 s por defecto).
• Comandos que el servidor envía en el latido:
  • Enviar precio: cuando se activa un precio nuevo en la estación, se envía al controlador hasta que este confirme. Si tras 10 intentos no confirma, se registra un evento crítico.
  • Leer totalizadores – final: cuando un turno pasa a cierre, para registrar las lecturas finales de las mangueras del controlador.
  • Leer totalizadores – corte: cuando hay cortes pendientes por cambio de precio en el turno abierto.

Paso a paso

Registrar el agente

1. Pulsa «Registrar agente»
   Se abre Registrar agente de estación.
2. Escribe un nombre
   Entre 3 y 60 caracteres, por ejemplo PC de oficina — controlador.
3. Pulsa «Registrar»
   Se abre API key del agente — Cópiala ahora: no se volverá a mostrar.
4. Copia la clave
   Pulsa Copiar (verás Copiada.) y guárdala para configurar la PC.
5. Pulsa «Ya la guardé»
   La clave desaparece de la pantalla para siempre.
6. Configura la PC
   El técnico instala el programa del agente en la PC de la estación y le carga la clave. Cuando arranque, el estado pasa a En línea.

La pantalla resume estos pasos: 1. Registra el agente, 2. Copia la clave, 3. Configura la PC (El agente envía despachos y lecturas cada 15 s.).

Rotar la API key

Hazlo si sospechas que la clave se filtró o periódicamente por seguridad.

1. Pulsa «Rotar API key»
   Se generará una clave nueva para "PC de oficina — controlador". La actual seguirá válida 24 h. ¿Continuar? → Rotar.
2. Copia la clave nueva
   En Nueva API key del agente: La clave anterior seguirá funcionando 24 h para que actualices el agente.
3. Actualiza la PC
   Carga la clave nueva en el agente antes de 24 horas. Mientras tanto la fila muestra Clave anterior en gracia (24 h).

Desactivar el agente

Pulsa Desactivar: El agente "…" dejará de enviar despachos y lecturas de inmediato. ¿Desactivarlo? Para volver a usarlo, registra el agente de nuevo (se reactiva el mismo con una clave nueva).

Revisar las transacciones del surtidor

1. Abre la pestaña «Transacciones del surtidor»
   Por defecto se filtran las Pendientes.
2. Revisa cada despacho
   Columnas Manguera, Despacho (galones · S/ y el precio), Fin y Estado.
3. Ignora solo lo que no se venderá
   Si un despacho no corresponde a una venta (por ejemplo, una calibración o una prueba del técnico), pulsa Ignorar, escribe el Motivo (10 a 200 caracteres) y confirma con Ignorar. Verás Transacción ignorada.

Estados de una transacción:

Estado	Significado
Pendiente	El surtidor despachó, pero aún no se asoció a una venta.
Asociada a venta	El playero la vendió en el POS.
Ignorada	Se descartó con motivo.

:::danger No se puede cerrar el turno con pendientes Un despacho medido por el controlador dentro del turno que nadie vendió ni ignoró es un despacho sin cobrar: el cierre del turno se bloquea hasta resolverlo (venderlo en el POS o ignorarlo aquí con motivo). :::

Ajustes relacionados

Ajuste	Por defecto	Para qué
Exigir transacción del surtidor en ventas de combustible	No	Con agente activo, todo ítem de combustible del POS debe venir de una transacción del surtidor.
Registrar el corte diario desde la telemetría	No	La primera medición de la consola dentro de la ventana de corte crea el varillaje del día.
Desfase de reloj del agente que dispara alerta (s)	120	Alerta si el reloj de la PC se desvía.

Se cambian en Ajustes avanzados (Configuración).

Seguridad

• Si el agente se conecta desde una IP distinta a la del latido anterior, o su reloj se desfasa demasiado, se registra un evento crítico en la auditoría (posible clave robada o reloj mal configurado).
• El agente solo ve su estación: mangueras, tanques y precios de otra estación no existen para él.
• Los reenvíos del agente no duplican transacciones ni lecturas.

Mensajes de error frecuentes y qué hacer

Mensaje	Por qué pasa	Qué hacer
"La estación ya tiene un agente activo."	Ya hay un agente registrado.	Rota su clave en lugar de registrar otro.
Estado Sin señal	La PC está apagada, sin internet o el servicio del agente se detuvo.	Revisa la PC y su conexión. Los datos se guardan en la PC y se envían al volver.
Estado Nunca conectó	La clave aún no se configuró en la PC.	Configura la clave en el agente.
"No se pudo rotar la clave."	Error de conexión.	Reintenta.

Relación con otros módulos

• Playa y Surtidores y mangueras: las mangueras que reporta el controlador.
• Precios: el agente envía cada precio nuevo al controlador.
• Tabla de aforo: necesaria para el corte desde telemetría.
• Lecturas de turno y cierre: Turnos. Venta asociada a la transacción: Vender en el POS de isla.