Materialización de devengos
Convierte los devengos previstos en eventos reales de las cuentas de tiempo y abona los saldos de ausencias de los empleados.
Cómo funciona
La tarea de materialización de devengos se ejecuta a diario y hace lo siguiente:
- Busca los devengos vencidos: previsiones cuya próxima fecha de devengo es igual o anterior a la fecha de ejecución
- Crea eventos: convierte cada entrada de previsión vencida en un evento real de la cuenta de tiempo
- Actualiza el seguimiento: registra la última fecha materializada para evitar procesarla dos veces
Esta es la tarea que realmente abona los saldos de ausencias. Hasta que se materializan, los devengos solo existen como proyecciones en la previsión.
Procesamiento diario frente a relleno
La tarea gestiona dos situaciones:
Procesamiento diario
Para los empleados que ya tienen historial de materialización, la tarea:
- Busca los devengos con
next_accrual_date <= run_date - Crea eventos solo para los devengos vencidos
- Actualiza el
last_materialized_datede la previsión
Procesamiento de relleno
Para los empleados sin historial de materialización (configuraciones nuevas o migraciones), la tarea:
- Materializa todos los devengos desde el inicio de la previsión hasta la fecha de ejecución
- Esto permite ponerse al día con los devengos históricos en una sola ejecución
Comportamiento de la fecha de ejecución
La fecha de ejecución es fundamental en esta tarea:
| Situación | Fecha de ejecución | Efecto |
|---|---|---|
| Ejecución diaria normal | Hoy | Materializa los devengos vencidos hasta hoy |
| Ejecución de recuperación | Fecha pasada | Materializa solo hasta esa fecha (útil para un despliegue controlado) |
| Fecha futura | Fecha futura | Materializa devengos en el futuro (úsala con precaución) |
Rellenar devengos históricos
Para materializar devengos de periodos pasados:
- Asegúrate de que se ha ejecutado la Previsión de devengos para el periodo histórico
- Lanza esta tarea manualmente con la fecha de ejecución fijada en la fecha histórica de destino
- Vuelve a ejecutarla con fechas progresivamente posteriores si quieres una materialización controlada e incremental
Resultados de la tarea
| Métrica | Descripción |
|---|---|
forecasts_processed | Número de previsiones de empleados evaluadas |
accruals_materialized | Número de eventos de devengo creados (procesamiento diario) |
accruals_backfilled | Número de eventos de devengo creados (procesamiento de relleno) |
expirations_created | Número de movimientos de caducidad creados para saldos que superaron su fecha de caducidad |
expiration_only_swept | Empleados que ya no devengan (por ejemplo, porque su contrato terminó) pero seguían teniendo un saldo después de su fecha de caducidad, y que solo se revisaron por caducidad |
errors | Número de fallos durante la materialización |
Momento del devengo
Los devengos se asignan el día 1 del mes siguiente. Por ejemplo:
- Trabajo de enero → devengo con fecha 1 de febrero
- Trabajo de diciembre → devengo con fecha 1 de enero (del año siguiente)
Esto significa que la tarea de materialización que se ejecuta el 1 de febrero creará el evento de devengo de las ausencias generadas en enero.
Solución de problemas
| Problema | Solución |
|---|---|
| No aparecen los devengos | Comprueba que antes se ha ejecutado la tarea Previsión de devengos |
| Faltan devengos históricos | Comprueba que last_materialized_date es nulo para que se lance el relleno, o vuelve a ejecutar la previsión con una fecha de ejecución histórica |
| Devengos duplicados | No debería ocurrir: volver a ejecutar la tarea nunca crea el mismo devengo dos veces. Busca eventos creados manualmente |
| El saldo parece incorrecto | Revisa la configuración del plugin de devengo y los ajustes de prorrateo |