Tareas Financieras — crons que automatizan mensualidad, cobranza, conciliación
El módulo de Tareas Financieras orquesta crons automáticos.
Por qué existen tareas financieras
Proveedor con 1000 clientes no puede esperar humano clicar "generar mensualidad" 1000 veces. Las tareas financieras (crontabs) corren automáticamente — generan mensualidad, verifican morosidad, procesan remesa CNAB, calculan comisión.
Principio: cualquier acción financiera repetitiva tiene (o debería tener) crontab.
Las principales tareas (crons)
| Tarea |
Frecuencia |
Qué hace |
| genera_mensualidad |
Diaria |
Crea facturas del día |
| verifica_factura_atrasada |
Diaria |
Marca facturas vencidas, dispara cobranza |
| bloquea_moroso |
Diaria |
Bloquea internet de clientes con N días |
| desbloquea_pago |
Varias veces/día |
Libera internet al confirmar pago |
| cobranza_lembrete |
Diaria |
Envía recordatorio antes del vencimiento |
| cobranza_pos_vencimiento |
Diaria |
Cobra después del vencimiento |
| remesa_cnab |
Diaria |
Genera archivo CNAB de boletas |
| procesa_retorno_cnab |
Diaria |
Importa retorno del banco |
| concilia_pix |
Cada 15min |
Verifica recepciones Pix/QR |
| calcula_comision |
Diaria / Mensual |
Calcula comisión |
| renueva_token_set |
Diaria |
Renueva credenciales fiscales |
| recalcula_morosidad |
Diaria |
Actualiza aging |
Glosario
| Término |
Significado |
| Cron / crontab |
Agendador de tareas. |
| Tarea |
Bloque de código que ejecuta una rutina. |
| Frecuencia |
Diaria, horaria, semanal, mensual. |
| Log |
Registro del que pasó en la ejecución. |
| Lock |
Impide 2 instancias rodando simultáneamente. |
| Ventana de ejecución |
Período en que la tarea puede rodar. |
| Timeout |
Tiempo máximo permitido. |
| Idempotencia |
Rodar 2× produce el mismo resultado que 1×. |
| Dry-run |
Simulación sin efecto real. |
| Reprocesamiento |
Rodar tarea para período pasado. |
Flujo del día (automatización)
TAREAS FINANCIERAS — UN DÍA TÍPICO
────────────────────────────────────
00:00 recalcula_morosidad
│
01:00 genera_mensualidad
│
02:00 verifica_factura_atrasada → BLOQUEADO
│
03:00 bloquea_moroso → corta internet
│
06:00 cobranza_lembrete (D-3)
│
07:00 remesa_cnab → archivo banco
│
08:00 procesa_retorno_cnab
│
cada 15min concilia_pix
│
12:00 cobranza_pos_vencimiento
│
18:00 calcula_comision
│
23:00 renueva_token_set
Pantalla de tareas
Financiero → Tareas Financieras / Crontab
Listagem de tareas — frecuencia, próxima ejecución.
Log de ejecución — éxitos, fallas, tiempo.
Logs y monitoreo
Cada ejecución graba:
| Campo |
Qué muestra |
| Tarea |
Nombre del cron |
| Inicio / Fin |
Timestamp |
| Estado |
OK / Falla / Timeout |
| Ítems procesados |
Cuántos registros |
| Errores |
Cuántos errores |
| Mensaje |
Detalle |
Cron que falla silenciosamente es el peor escenario. Configure alerta.
Trampas frecuentes
1. Cron desactivado por error. Alguien suspendió para test y olvidó.
2. Cron corriendo 2× simultáneamente. Configure lock.
3. Idempotencia rota.
4. Cron lento bloqueando los próximos.
5. Falla sin alerta.
6. Timezone equivocado.
7. Reprocesamiento sin dry-run.
Preguntas frecuentes
¿Puedo desactivar tarea temporariamente?
Sí. Configure alerta en Slack para recordar.
¿Cómo debugar cron que falló?
Vea log — generalmente tiene stack trace.
¿Rodar cron manualmente?
Sí — vía UI o CLI.
¿Cron de mensualidad roda para todos al mismo tiempo?
Quaza divide en lotes.
¿Mejor horario para agendar?
Madrugada (1-5h).
¿Qué pasa si servidor reinicia durante cron?
Próxima ejecución toma lo que faltó (si idempotente).
¿Tarea customizada?
Sí — admin puede cadastrar script.
¿Notificación en tiempo real?
Configure webhook.
Buenas prácticas operacionales
Esta sección reúne hábitos que proveedores experimentados adoptan para evitar problemas recurrentes en este módulo. Aplicación consistente hace diferencia grande en el largo plazo — diferencia entre operación caótica y operación previsible.
Revisión periódica
Reserve 30 minutos por semana para revisar el estado del módulo: lo que corrió, lo que falló, lo que quedó pendiente. Anomalía detectada temprano cuesta 10× menos que descubierta tarde.
Documentación de procedimientos
Cree checklists internos para operaciones recurrentes — apertura/cierre del mes, procesamiento en lote, corrección de inconsistencias. No dependa de quien "sabe de memoria" — funcionario puede salir, enfermar, tener día malo.
Backup antes de operaciones masivas
Cualquier cambio que afecte 100+ registros debe ser precedido de backup o export. Restaurar una alteración masiva equivocada es caro; prevenir es simple.
Comunicación con cliente
Cambios que impactan al cliente (precio, cobranza, regla) deben comunicarse con antelación. Cliente sorprendido reclama; cliente avisado entiende.
Indicadores acompañados
Defina 2-3 indicadores que miden la salud del módulo. Acompañe semanalmente. Cuando alguno sale del rango esperado, investigue antes de volverse problema visible.
Checklist operacional
Use este checklist como referencia rápida para garantizar que el módulo está siendo operado correctamente:
-
Configuración inicial validada — todos los campos obligatorios completados, permisos atribuidos, integraciones testadas
-
Equipo entrenado — al menos dos operadores saben operar; redundancia previene paralización
-
Procedimiento documentado — paso a paso de operaciones recurrentes disponible en lugar accesible
-
Backups al día — backup automático corriendo, último restore testado en los últimos 90 días
-
Monitoreo activo — alertas configuradas para fallas críticas, logs siendo revisados semanalmente
-
Plan de contingencia — si el módulo cae, equipo sabe cómo operar manualmente hasta volver
-
Auditoría periódica — revisión mensual de inconsistencias; trimestral de eficiencia operacional
-
Documentación de cambios — alteraciones relevantes registradas (fecha, autor, motivo, impacto)
Indicadores típicos a acompañar
Cada proveedor define sus propios KPIs, pero algunos son casi universales para este tipo de operación:
- Volumen mensual procesado (registros, transacciones, eventos)
- Tasa de error (% de operaciones que fallaron)
- Tiempo medio de respuesta/procesamiento
- Cobertura (% de la cartera atendida por el módulo)
- Satisfacción operacional (feedback del equipo que usa)
Compare valores actuales con media de los últimos 3 meses. Variación mayor que 20% en cualquier dirección merece investigación — puede ser mejora sostenible o degradación silenciosa.
Documentos relacionados