Módulo de Suspensión Automática y Gestión de Logs

Esta guía explica cómo funciona el sistema de corte de servicio automatizado ("Corte Automático"), cómo interpretar los resultados en el panel de logs y cómo solucionar los errores comunes reportados por el router MikroTik.

Funcionamiento: El sistema verifica automáticamente fechas y deudas. No requiere intervención manual si está correctamente configurado.
Nota sobre Errores: Es común ver mensajes de fallo si el cliente ya estaba cortado previamente en el router.

1. ¿Cómo funciona el proceso internamente?

El módulo de CorteAutomatico opera bajo una lógica secuencial estricta para garantizar que solo se suspenda el servicio a los clientes correctos en el momento adecuado. El flujo de trabajo interno es el siguiente:

Fases del proceso

  1. Verificación de Configuración: El sistema lee un archivo de propiedades local. Primero valida si el módulo está activo, luego comprueba si la fecha actual coincide con los días de corte programados (ej. días 15 o 30) y si la hora actual coincide con la hora configurada (con un margen de tolerancia de 2 minutos).
  2. Consulta de Deudores: Se conecta a la base de datos y busca clientes cuyo próximo pago sea anterior a la fecha actual o que tengan meses de adeudo acumulados.
  3. Conexión al Router: Por cada cliente moroso, el sistema intenta iniciar sesión en el MikroTik asociado usando las credenciales guardadas.
  4. Ejecución del Bloqueo:
    • Intenta agregar la IP del cliente a una Address List llamada "corte".
    • Si no tiene IP, intenta bloquear por MAC Address en el filtro del firewall.
  5. Registro (Log): Finalmente, guarda el resultado (Éxito o Fallo) en la base de datos para su auditoría.

2. Interpretación del Panel de Logs

El sistema genera un reporte detallado de cada intento de corte. A continuación, explicamos qué significa cada columna basada en su interfaz.

Pantalla de Logs de Suspensión

Captura de pantalla: Panel de reportes de ejecución de comandos en MikroTik.

Columna Descripción
Accion Indica el tipo de operación intentada. Generalmente será "SUSPENSIÓN".
Resultado OK: El corte se aplicó correctamente.
FALLÓ: El router devolvió un error o no se pudo conectar.
Mensaje Detalle técnico de lo ocurrido. Aquí es donde diagnosticamos problemas.

3. Errores Comunes y Soluciones

Al analizar los logs, es posible que encuentre mensajes de error repetitivos. Analicemos el caso más frecuente mostrado en sus capturas.

Error: "failure: already have such entry"

Error MikroTik

Causa: Este error ocurre cuando el sistema intenta agregar una IP a la lista de "corte" en el MikroTik, pero esa IP ya existe en la lista.

¿Por qué pasa?

  • El cliente ya fue cortado manualmente antes del proceso automático.
  • El proceso automático corrió dos veces seguidas por error.
  • La regla en el firewall no se limpió después de un pago anterior.

Solución: Generalmente no requiere acción, ya que el objetivo (que el cliente esté cortado) ya se cumple. Sin embargo, para limpiar el log, puede eliminar manualmente la entrada en el MikroTik.

4. Comandos ejecutados en el Router

Para transparencia técnica, estos son los comandos que el sistema envía internamente al router MikroTik según el método de identificación del cliente. 

// Caso 1: Si el cliente tiene IP asignada
/ip/firewall/address-list/add list=corte address=[IP_CLIENTE] comment="Corte automático: [NOMBRE]"

// Caso 2: Si el cliente solo tiene MAC Address
/ip/firewall/filter/add chain=forward action=drop src-mac-address=[MAC_CLIENTE] comment="Corte automático: [NOMBRE]"

El sistema prioriza siempre el bloqueo por IP. Si la IP está vacía, recurre a la MAC.

5. Conclusión

El módulo de Corte Automático está diseñado para facilitar la gestión de cobranza. Recuerde revisar periódicamente la pestaña de "Reportes" para asegurarse de que la comunicación con los routers MikroTik sea fluida y atender los casos marcados como "FALLÓ" que no sean por duplicidad de entrada.