# Recursos humanos — estado de implementación

> **Actualización de operaciones (18/09/2026):** se añadieron cálculo de finiquito desde historia, excepciones documentadas, XML RDEP validado con XSD oficial, TXT de novedades IESS, constancias SUT, integración con el módulo contable, importación de históricos, reingresos, ajustes de roles pagados, parámetros versionados, envío de roles y comparación de casos. El estado vigente y las limitaciones están en [RRHH: operaciones y validación](rrhh-operaciones-y-validacion.md). El inventario de pendientes siguiente corresponde a la entrega inicial y queda reemplazado, en esos puntos, por dicho documento. No hay despliegue externo ni homologación bancaria.

Actualizado: 18 de septiembre de 2026. Entorno local `C:\ERP\sistemaGlobal`. No se han enviado correos, ordenado pagos ni desplegado cambios en un servidor externo.

## Acceso

Página `/admin/recursos-humanos`. Módulo comercial independiente `RRHH`, disponible en la configuración de módulos contratados. No se habilita automáticamente en cuentas existentes ni en el valor predeterminado de cuentas nuevas. El administrador de cuenta y el administrador de empresas asignadas pueden operar solamente sobre sus empresas activas, con licencia vigente y módulo habilitado. Los operadores y clientes externos no pueden acceder a expedientes, roles ni descargas por URL directa.

Las migraciones `2026_09_18_000001_create_hr_module.php` y `2026_09_18_000002_hr_records_and_payments.php` fueron aplicadas en la base local. Para otro entorno, respaldar la base y ejecutar esas migraciones después de publicar el código. No habilitar RRHH para nómina real hasta completar la validación funcional con casos de la empresa y los puntos pendientes de este documento.

## Funciones disponibles

- Expedientes con identificación validada, contacto, ingreso, salida, datos bancarios cifrados, cargas acreditadas y saldo inicial de vacaciones.
- Contratos y sueldos por fecha de vigencia. Cambios durante el mes se prorratean. Las vigencias que afecten nóminas aprobadas no se pueden editar. Las correcciones de vigencias todavía abiertas dejan valores anteriores y nuevos en auditoría.
- Documentos PDF/JPG/PNG privados, con hash SHA-256, autor y descargas autorizadas. Límite 10 MB.
- Registro de asistencia, permisos y ausencias. La asistencia no genera descuentos ni horas extra sin la novedad autorizada correspondiente.
- Horas suplementarias al 50 %, extraordinarias al 100 %, recargo nocturno al 25 %, comisiones, bonos, reembolsos, días sin remuneración, anticipos, cuotas y descuentos autorizados. Control de 4 horas suplementarias por día y 12 por semana.
- Préstamos desembolsados, cuotas automáticas limitadas al saldo e historial a través de los roles aprobados. No generan desembolsos bancarios.
- Nómina mensual en USD, con dinero persistido en centavos: sueldo, IESS personal/patronal, IECE/SECAP cuando se indica que aplican, décimos, fondos de reserva y provisión de vacaciones. Bases y conceptos separados; provisiones y aportes patronales no se descuentan al trabajador.
- Proyección anual de renta por trabajador: ingresos gravados, aporte deducible, gastos, cargas, exenciones respaldadas, rebaja especial y retenciones previas de otros empleadores. Tabla progresiva; saldo de retención dividido entre los meses restantes. Los datos proyectados requieren revisión del responsable de nómina.
- Modalidad mensual/acumulada de décimos y destino del fondo de reserva. El décimo tercero acumulado se calcula sobre la base histórica; el cuarto utiliza el SBU del año de pago y los días acreditados. Se exige historia aprobada completa y se bloquean pagos superpuestos.
- Saldo y solicitud/aprobación/rechazo de vacaciones y licencias. Conteo de días calendario, incluidos descansos; saldo inicial documentado para migrar históricos. La salida detiene el devengo posterior.
- Distribución general de utilidades: 10 % por días y 5 % por días × cargas acreditadas. Se debe incluir a todo el personal y ex personal del ejercicio. Redondeo que conserva el total. Si no hay cargas acreditadas, el tramo sin distribuir queda bloqueado para revisión; no se inventa un destino.
- Salida laboral y hoja de liquidación revisada: saldos pendientes ingresados tras conciliación, bonificación por desahucio e indemnización general de despido cuando se selecciona su procedencia. Los casos de protección especial o antigüedad de 20 años o más no reciben automáticamente esta fórmula general. El documento interno no reemplaza el acta del Ministerio del Trabajo.
- Roles individuales PDF, reporte consolidado CSV, documentos anuales PDF y CSV de revisión de beneficiarios/pagos. Las hojas CSV neutralizan fórmulas y conservan identificadores con ceros iniciales como texto.
- Auditoría de operaciones, actor y fecha. Nómina: BORRADOR → CALCULADA → APROBADA → CERRADA. Antes de aprobar se vuelve a verificar la huella de trabajadores, contratos, préstamos, proyecciones y novedades. Cada rol conserva sus datos de cálculo y su cuenta bancaria al aprobarse.
- Pago confirmado individualmente con referencia bancaria. Descargar/exportar no equivale a pagar. El cierre requiere todos los pagos confirmados. Retirar aprobación exige ausencia de pagos, beneficios liquidados y períodos posteriores aprobados, con motivo y copia de los roles anteriores en auditoría.

## Alcance automático y pendientes reales

El motor automático actual cubre adultos, contratos indefinidos, jornada completa y régimen privado continental general. Los contratos especiales y Galápagos se pueden identificar en el expediente, pero su cálculo se bloquea: no se reutilizan fórmulas generales en esos casos. Aún faltan jornadas parciales, adolescentes, subsidios de enfermedad/maternidad, jubilación patronal y demás regímenes especiales. La selección de vacaciones/licencia no liquida subsidios automáticamente.

La liquidación de salida requiere conciliación manual de sueldos, décimos, vacaciones y descuentos pendientes; no es un cálculo universal automático de finiquito. Utilidades registradas y liquidaciones no se convierten automáticamente en pagos bancarios ni ajustan una proyección fiscal sin revisión.

No se han implementado interfaces de presentación RDEP, SUT o carga de planillas IESS, ni asientos contables automáticos. Los reportes internos no se presentan como archivos oficiales de estas entidades. No hay envío automático de roles por correo: el PDF se descarga para entregar al personal.

Los parámetros nacionales están versionados en `EcuadorPayroll` para 2025/2026 y se congelan en cada rol; otro año queda bloqueado hasta verificar sus parámetros. No hay editor de nuevas tablas legales en la interfaz.

**Cash Management pendiente:** se confirmaron Pichincha y Guayaquil, pero no se obtuvo una especificación vigente verificable de sus archivos para esta empresa. El sistema entrega exclusivamente un CSV identificado como revisión, no un TXT apto para importar. Se necesitan las plantillas de ambos bancos, códigos de empresa/convenio, variante del servicio y un ejemplo sin datos personales. No cargar el CSV de revisión en Cash Management.

Otros puntos que faltan antes de considerar el alcance completo: correcciones documentadas de períodos ya pagados, importación de históricos, reingresos laborales, conciliación masiva de resultados bancarios y prueba visual en navegador. No se declara este módulo como completo para todos los supuestos del Código del Trabajo.

## Fuentes verificadas

- [Código del Trabajo, catálogo de Defensoría Pública actualizado a mayo de 2026](https://biblioteca.defensoria.gob.ec/handle/37000/3819): arts. 49, 55, 69–76, 95, 97, 111–113, 184–188 y 196.
- [Ministerio del Trabajo, obligaciones del empleador MDT-2023-140](https://www.trabajo.gob.ec/wp-content/uploads/2024/01/MDT-2023-140-AM-Obligaciones-empleador-y-procedimientos-de-inspeccion-14-11-23-signed.pdf): períodos y pago de décimos, utilidades y registro de finiquitos.
- [SBU 2026, USD 482](https://www.trabajo.gob.ec/despues-de-casi-una-decada-hay-consenso-gobierno-empleadores-y-trabajadores-acuerdan-fijar-el-salario-basico-unificado-de-2026-en-usd-482-no-hay-imposicion-hay-union/).
- [SBU 2025, USD 470](https://www.trabajo.gob.ec/el-salario-basico-unificado-del-trabajador-en-general-para-el-ano-2025-sera-de-usd-47000/).
- [IESS, afiliación y tasas generales privadas](https://www.iess.gob.ec/es/preguntas-frecuentes-afiliacion).
- [IESS, fondos de reserva del 8,33 % desde el segundo año](https://www.iess.gob.ec/web/afiliado/fondos-de-reserva).
- [SRI, tablas de renta 2025 y 2026](https://www.sri.gob.ec/o/sri-portlet-biblioteca-alfresco-internet/descargar/58a7f4f6-ab51-48b6-b9ff-a8e97e1a28ef/Tablas%20de%20c%C3%A1lculo%20de%20Impuesto%20a%20la%20Renta.pdf).
- [SRI, proyección de gastos 2026](https://www.sri.gob.ec/detalle-noticias?idnoticia=1261&marquesina=1): canasta USD 821,80, rebaja 18 %, cargas y condiciones especiales.
- [Pichincha, carga de pagos](https://www.pichincha.com/sites/default/files/images/instructivo-pagos-masivos-pichincha-empresas-02-25_11.pdf): la plantilla se descarga dentro del portal; no contiene una especificación completa de campos.
- [Guayaquil, Cash Management](https://ayudaempresas.bancoguayaquil.com/hc/es/articles/360033472372--C%C3%B3mo-puedo-cargar-una-orden-de-Cash-Management-en-mi-Banca-Empresas): el enlace de diseño de nómina devolvió HTTP 404 al consultarlo. Se debe obtener la plantilla desde el banco.

## Verificación

Pruebas: `tests/Unit/EcuadorPayrollTest.php`, `tests/Feature/Hr/HumanResourcesTest.php`, `tests/Unit/ModuloContratadoTest.php`. Cubren importes, redondeo, febrero, contratos por vigencia, fondo de reserva, impuesto, cifrado, acceso entre cuentas, rol PDF, estado de pago, préstamos, duplicados de décimos, archivos privados, horas máximas, salida y distribución de utilidades.

Se usa SQLite en memoria y vistas compiladas en `storage/framework/testing-views`. Las migraciones locales también se ejecutaron correctamente. No se generaron nóminas reales ni se enviaron pagos. Antes de habilitar producción, contrastar los resultados con casos reales anonimizados revisados por el responsable laboral/contable, resolver los pendientes aplicables y validar los archivos con los bancos.

Resultados de esta sesión: regresión de RRHH, módulos, cuentas y tareas: **119 pruebas / 935 aserciones**, aprobadas. Después de los últimos ajustes de vacaciones y vista de pagos, suite específica de RRHH: **23 pruebas / 80 aserciones**, aprobadas (incluye un caso nuevo de antigüedad). Sintaxis PHP y rutas comprobadas. Migraciones locales en lotes 102 y 103; vistas compiladas limpiadas.
