Nómina — Resumen

El módulo de Nómina gestiona todo el ciclo de vida laboral del empleado: desde su ingreso hasta la liquidación, pasando por el procesamiento periódico de pagos, cálculo de beneficios legales, vacaciones y salud ocupacional.

Funcionalidades principales

Función	Descripción
Empleados	Ficha completa del trabajador, contratos, posiciones, documentos
Procesamiento	Cálculo y generación de nómina por período
Conceptos	Asignaciones y deducciones configurables
Vacaciones	Solicitud, aprobación y cálculo de días
Beneficios legales	Utilidades, fideicomiso, caja de ahorro
Salud ocupacional	Exámenes médicos, comités de seguridad, capacitación
Liquidaciones	Cálculo de prestaciones al terminar relación laboral

Flujo general

Ingreso del empleado → Asignación de conceptos → Procesamiento periódico
                                                        ↓
        Liquidación ← Terminación              Pago (banco/efectivo)
                                                        ↓
                                               Reportes y declaraciones

Cumplimiento legal por país

Zentto adapta los cálculos de nómina a la legislación de cada país configurado:

País	Régimen fiscal	Seguridad social	Beneficios especiales
Venezuela	ISLR (tabla progresiva)	IVSS, FAOV, INCES, RPE	Utilidades, fideicomiso, cestaticket
Colombia	Retención en la fuente	EPS, AFP, ARL, SENA, ICBF	Prima, cesantías, intereses cesantías
México	ISR (tabla quincenal/mensual)	IMSS, Infonavit, SAR	Aguinaldo, PTU, prima vacacional
España	IRPF	Seguridad Social	Pagas extra, indemnización
Estados Unidos	Federal + State tax	Social Security, Medicare	401(k), health insurance

Multi-país

La empresa puede tener empleados en diferentes países. Cada empleado hereda la configuración fiscal del país de su centro de trabajo.

Integración con otros módulos

• Bancos: Los pagos de nómina generan movimientos bancarios automáticos (transferencias masivas).
• Contabilidad: Cada procesamiento genera asientos contables por centro de costo.
• CxP: Las retenciones y aportes patronales generan obligaciones en cuentas por pagar.
• Configuración: Centros de costo, departamentos y cargos se administran desde el módulo de configuración.

Secciones del módulo

• Empleados — Gestión de ficha del empleado
• Procesar nómina — Cálculo y generación de pagos
• Conceptos — Asignaciones y deducciones
• Vacaciones — Solicitud y aprobación de vacaciones
• Beneficios legales — Utilidades, fideicomiso, caja de ahorro
• Salud ocupacional — Exámenes, comités y capacitación
• Liquidaciones — Cálculo de prestaciones por terminación

Permisos requeridos

Permiso	Descripción
payroll.employees.read	Ver fichas de empleados
payroll.employees.write	Crear y editar empleados
payroll.process	Procesar nómina
payroll.approve	Aprobar nómina calculada
payroll.concepts	Configurar conceptos
payroll.vacations	Gestionar vacaciones
payroll.benefits	Calcular beneficios legales
payroll.health	Administrar salud ocupacional
payroll.settlements	Generar liquidaciones

Flujo del usuario

Vista no técnica del proceso. Pensada para personal de operación, recursos humanos, contabilidad o administración.

Editable en draw.io: descarga el SVG → en draw.io: File → Import from → Device → selecciona el SVG. Cada nodo queda editable.

Flujo técnico

Vista técnica para desarrolladores: endpoints, stored procedures/funciones, tablas y servicios involucrados.

Componente	Tipo	Ubicación
/v1/payroll/employees	Route Express	web/api/src/routes/payroll/employees.ts
/v1/payroll/process	Route Express	web/api/src/routes/payroll/process.ts
/v1/payroll/settlements	Route Express	web/api/src/routes/payroll/settlements.ts
usp_pay_Payroll_Calculate	Stored procedure	web/api/sqlweb-pg/includes/sp/
usp_pay_Settlement_Calc	Stored procedure	web/api/sqlweb-pg/includes/sp/
pay.Employee	Tabla operativa	web/api/migrations/postgres/
pay.Payroll	Tabla operativa	web/api/migrations/postgres/
PayrollDashboard.tsx	Componente Frontend	web/modular-frontend/packages/module-payroll/src/

Editable en draw.io: descarga el SVG → File → Import from → Device.