🤖 Explicar con IA

Gestión de Días Festivos¶

Gestiona los días festivos de tu fuerza laboral con sincronización automática, cálculos de pago específicos por país y rastros de auditoría completos.

Descripción General¶

Gestión de Días Festivos te permite:

• Calendario de Festivos — Calendario visual con filtros por país y año
• Sincronización Automática — Importa días festivos desde fuentes externas para más de 100 países
• Cálculos de Pago — Pago de festivos automático basado en la clasificación, la categoría de turno y las horas extra
• Rastro de Auditoría — Desglose paso a paso del cálculo para el cumplimiento
• Reporte de Pago de Festivos — Panel con KPIs, seguimiento de estados y exportación CSV

Calendario de Festivos¶

Visualizando los Festivos¶

1. Navega a la pestaña Festivos en Nómina
2. Selecciona un País y un Año
3. Usa el Filtro de Clasificación para mostrar tipos de festivos específicos
4. Alterna entre los nombres Locales y en Inglés

Vista de Calendario¶

El calendario muestra los festivos superpuestos sobre una cuadrícula mensual:

• Pagado Obligatorio — Fondo verde
• Pagado No Obligatorio — Fondo amarillo
• Sincronizado — Insignia azul
• Manual — Insignia gris

Agregando un Festivo Manualmente¶

1. Haz clic en Agregar Festivo
2. Completa los detalles:

1. Haz clic en Guardar

Sincronizando Festivos¶

Países Soportados¶

La función de sincronización soporta más de 100 países en todo el mundo, incluyendo los 12 países latinoamericanos del sistema de nómina.

Sincronización desde una Fuente Externa¶

1. Selecciona un país en el calendario
2. Haz clic en Sincronizar Festivos
3. El sistema obtiene los días festivos desde la fuente externa
4. Los festivos se importan con el mapeo de clasificación:
5. Festivos Públicos → Pagado Obligatorio
6. Otros tipos (Bancarios, Escolares, de Autoridades) → Pagado No Obligatorio

Resincronización¶

Para actualizar los festivos de un país/año:

1. Haz clic de nuevo en Sincronizar Festivos
2. Los festivos sincronizados existentes se eliminan y se vuelven a importar
3. Los festivos manuales permanecen intactos

Clasificaciones de Festivos¶

Pagado Obligatorio¶

Los empleados tienen derecho a tiempo libre pagado. Si trabajan en un festivo obligatorio, reciben pago adicional.

Pagado No Obligatorio¶

Los empleados no tienen derecho a tiempo libre, pero si trabajan el día del festivo, reciben pago adicional.

Cálculos del Pago de Festivos¶

El motor de pago de festivos calcula la compensación basándose en una matriz de decisión de 4 ramas.

Matriz de Decisión¶

Pipeline de Cálculo¶

1. Detección de Categoría de Turno — Detecta automáticamente día (8h), noche (6h) o mixto (7h) según los horarios del turno
2. Horas de Turno Estándar — Obtenidas de los preajustes por país
3. División de Horas — Horas regulares vs. horas extra
4. Tarifa Hora Base — Salario fijo ÷ 160 o tarifa por hora directa
5. Tasas Específicas por País — Sobrecargo de horas extra y tasas de domingo/festivo desde los preajustes
6. Motor de Reglas — Evalúa la matriz de 4 ramas
7. Resumen de Auditoría — Construye el rastro de auditoría completo

Fórmulas Clave¶

Base Hourly Rate (fixed salary) = Salary / 160
Base Hourly Rate (hourly) = Hourly Rate
Overtime Pay Rate = Base Rate × (1 + Overtime Surcharge)
Holiday OT Rate = Base Rate × max(1 + Surcharge, Sunday/Holiday Rate)

Tipo de Actividad de la Empresa¶

El tipo de actividad de la empresa afecta los cálculos del pago de festivos:

Define el tipo de actividad en Configuración → Perfil de la Empresa.

Reporte de Pago de Festivos¶

Panel¶

El reporte proporciona 4 tarjetas de KPI:

Flujo de Estados¶

Detalles del Registro¶

Haz clic en un registro para expandirlo y ver:

• Modalidad — Mensual, quincenal o semanal
• Tipo de Actividad — Comercial o no comercial
• Clasificación — Obligatorio o no obligatorio
• Categoría de Turno — Día (8h), Noche (6h) o Mixto (7h)
• Horas Regulares / Extra — Desglose de horas
• Pago Regular / Extra / de Descanso — Componentes del pago
• Regla Aplicada — Qué rama de la matriz de decisión se usó
• Tarifa Hora Base — Tarifa usada para los cálculos
• Sobrecargo de Horas Extra — Tasa específica del país

Pasos del Cálculo (Rastro de Auditoría)¶

Cada registro incluye un rastro de auditoría paso a paso:

Exportación CSV¶

Exporta todos los registros a CSV con las columnas:

Employee, Holiday, Date, Modality, Activity, Classification, Worked, Regular Hours, Overtime Hours, Regular Pay, Overtime Pay, Holiday Rest Pay, Total Holiday Pay, Status, Applied Rule

Integración con Nómina¶

Cómo Fluyen los Festivos hacia las Corridas de Nómina¶

1. El Calendario de Festivos se mantiene por espacio de trabajo y por país
2. Cada festivo tiene una clasificación y la empresa tiene un tipo de actividad
3. Cada empleado tiene una modalidad de pago (mensual, quincenal, semanal)
4. Cuando una corrida de nómina procesa un festivo:
5. El sistema verifica si el empleado trabajó ese festivo y cuántas horas
6. Se puede asignar un turno (o predetermina a día/8h)
7. El turno se clasifica automáticamente como día/noche/mixto según la hora del día
8. El motor de reglas evalúa la matriz de decisión de 4 ramas
9. Se crea un holiday_pay_record con todas las condiciones de entrada y los montos calculados
10. Se escriben holiday_audit_logs detallados para cada paso del cálculo
11. El registro avanza por los estados: calculado → aprobado → pagado

Cálculo por Lote¶

Procesa a todos los empleados en un solo festivo de una vez:

1. Navega al Reporte de Pago de Festivos
2. Selecciona una fecha de festivo
3. Haz clic en Calcular Lote
4. El sistema genera registros para todos los empleados activos
5. Revisa y aprueba cada registro

Próximos Pasos¶

• Aguinaldo — Cálculos del 13º mes
• Ejecuciones de Nómina — Ejecuta la nómina con cálculos que consideran festivos
• Turnos de Trabajo — Define plantillas de turnos para la categorización del pago de festivos

Aún con dudas? Pregunta en Discord o explore tutoriales