Simulación de Costos de Nómina
Descripción
Section titled “Descripción”El endpoint de Simulación de Costos de Nómina te permite calcular automáticamente el costo mensual del recurso humano bajo diferentes escenarios (mejor caso, peor caso y promedio), considerando todos los componentes de nómina según la legislación laboral colombiana vigente.
Este servicio está diseñado para integrarse con sistemas de presupuestos, ERP o cualquier plataforma que requiera proyecciones de costos laborales precisas.
¿Qué puedes hacer con este endpoint?
Section titled “¿Qué puedes hacer con este endpoint?”- Calcular costos individuales por empleado con detalle completo de devengos, deducciones, aportes y provisiones
- Proyectar costos por proyecto sumando todos los empleados asignados a un proyecto específico
- Simular 3 escenarios diferentes:
- Mejor caso: Mínimo costo (solo salario base con posibles ausentismos)
- Peor caso: Máximo costo (incluye horas extras, recargos y bonificaciones al límite legal)
- Promedio: Escenario realista configurable con porcentaje de empleados con novedades
- Incluir novedades laborales: Horas extras, recargos nocturnos/festivos, bonificaciones, incapacidades, licencias y suspensiones
- Personalizar porcentajes: Ajusta tasas de seguridad social, parafiscales y provisiones según convenios especiales
Casos de Uso
Section titled “Casos de Uso”1. Presupuesto de Proyectos
Section titled “1. Presupuesto de Proyectos”Calcula el costo mensual de todo el equipo de trabajo asignado a un proyecto específico para realizar proyecciones presupuestarias precisas.
2. Análisis de Escenarios
Section titled “2. Análisis de Escenarios”Compara el costo mínimo vs. máximo de tu nómina para planificar diferentes escenarios financieros (optimista, pesimista y realista).
3. Cotizaciones
Section titled “3. Cotizaciones”Genera cotizaciones rápidas del costo laboral al incluir nuevos empleados en proyectos.
4. Planeación Financiera
Section titled “4. Planeación Financiera”Proyecta costos de nómina a 3, 6 o 12 meses con base en diferentes supuestos de productividad y novedades.
Información Técnica
Section titled “Información Técnica”Endpoint
Section titled “Endpoint”POST {{host}}/api/nomina/calculateAutenticación
Section titled “Autenticación”Este endpoint requiere autenticación mediante API Key en el header:
X-Api-Key: Bearer {tu_api_key}Rendimiento y Límites
Section titled “Rendimiento y Límites”Límites de Procesamiento
Section titled “Límites de Procesamiento”- Máximo de perfiles por petición: 1,000 empleados
- Tiempo de respuesta promedio: 3-4 segundos para 1,000 perfiles
- Rate limiting: Sin límite de peticiones por hora
Requisitos Técnicos
Section titled “Requisitos Técnicos”- PHP: 7.4 o superior (recomendado PHP 8.0+)
- Extensiones PHP requeridas:
curl,json - Content-Type:
application/json - Método HTTP:
POST
Componentes de Cálculo
Section titled “Componentes de Cálculo”El endpoint calcula automáticamente todos los componentes de nómina según la legislación colombiana:
Devengos
Section titled “Devengos”- Salario básico proporcional a días trabajados
- Auxilio de transporte (si aplica)
- Horas extras (diurnas, nocturnas, festivas)
- Recargos (nocturno, dominical, festivo)
- Bonificaciones (salariales y no salariales)
Deducciones
Section titled “Deducciones”- Salud empleado (4%)
- Pensión empleado (4%)
- Retención en la fuente (según tabla UVT)
Aportes del Empleador
Section titled “Aportes del Empleador”- Salud (8.5%)
- Pensión (12%)
- ARL (según nivel de riesgo: 0.522% - 6.96%)
- Parafiscales: SENA (2%), ICBF (3%), Caja de Compensación (4%)
Provisiones
Section titled “Provisiones”- Cesantías (8.33%)
- Intereses sobre cesantías (1% mensual)
- Prima de servicios (8.33%)
- Vacaciones (4.17%)
Siguiente: Estructura del Request
Section titled “Siguiente: Estructura del Request”En la siguiente sección encontrarás el detalle completo de todos los parámetros que puedes enviar, sus validaciones y ejemplos de estructuras JSON.