# RR. HH. Ecuador: definición previa a implementación

Estado: módulo general implementado localmente y en validación. Consulte `rrhh-implementacion.md` para el alcance real, las pruebas y los pendientes; este documento conserva el inventario de requisitos inicial.

## Decisiones confirmadas por el cliente

1. Empresas privadas bajo el Código del Trabajo. LOSEP queda fuera del alcance.
2. Cash Management de Banco Pichincha y Banco Guayaquil. Sigue pendiente recibir la plantilla vigente de importación para producir un archivo bancario utilizable; un CSV de revisión no equivale a un archivo validado por el banco.

## Integración técnica identificada

El sistema es Laravel 12 con Filament 5. Los módulos comerciales se registran en `modulos_comerciales`, se contratan mediante `cuenta_cliente_modulo` y se autorizan mediante `User::puedeUsarModulo`. Las empresas se aíslan por cuenta y por asignación de usuarios. RR. HH. no existe actualmente y debe incorporarse como un módulo independiente, sin habilitarlo automáticamente en cuentas que solo contrataron Gestión de tareas.

Los datos laborales y bancarios no deben exponerse a los operadores del módulo de tareas. Cada operación, reporte, archivo y rol de pago debe verificar cuenta, empresa y permiso en el servidor.

## Alcance funcional que debe resolverse

- Expediente del trabajador: identificación, contrato y vigencias, cargo, departamento, jornada, región, remuneración, cuenta bancaria, cargas familiares y documentos privados.
- Historial salarial y contractual con fechas de vigencia, sin recalcular retrospectivamente nóminas cerradas.
- Novedades: asistencia, atrasos, ausencias, permisos, licencias, horas suplementarias y extraordinarias, comisiones, anticipos, préstamos y descuentos autorizados.
- Nómina: período, liquidación individual, bases diferenciadas de aportación y beneficios, ingresos, deducciones, neto y costo patronal.
- Décimos: elección mensual/acumulada, períodos legales, proporciones, liquidación y prevención de pagos duplicados.
- Fondos de reserva: antigüedad, derecho adquirido y pago o acumulación correspondiente.
- Vacaciones: antigüedad, derechos adicionales cuando correspondan, saldo, solicitud, aprobación, disfrute y liquidación.
- Impuesto a la renta de relación de dependencia: tablas por ejercicio, proyección, rebajas y ajustes; no aplicar una tasa fija a todos los trabajadores.
- Participación de utilidades, cargas familiares y distribución cuando corresponda.
- Terminaciones: causal y componentes aplicables, con revisión antes de aprobar; no utilizar una indemnización universal.
- Reportes: rol individual, consolidado, aportes, provisiones, beneficios, vacaciones, retenciones y costo por departamento.
- Roles de pago descargables en PDF con identidad empresarial y acceso restringido; el envío por correo debe ser una acción explícita y auditable.
- Exportación bancaria por formato confirmado, totales de control, validación de cuentas y conciliación del resultado del banco.
- Flujo de borrador, cálculo, revisión, aprobación, pago y cierre. Registrar quién calcula, aprueba y confirma el pago. Exportar no significa pagar.
- Reversiones documentadas, registros históricos inmutables desde las acciones normales de la aplicación y protección contra procesos duplicados.
- Parámetros legales con vigencia, fuente y pruebas; distinguir parámetros nacionales de condiciones de la empresa y del trabajador.

## Fuentes oficiales consultadas el 18 de septiembre de 2026

- Ministerio del Trabajo, SBU 2026 de 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/
- IESS, preguntas de afiliación, tasas generales para trabajadores privados: personal 9,45 % y patronal 11,15 %: https://www.iess.gob.ec/es/preguntas-frecuentes-afiliacion
- IESS, fondos de reserva: https://www.iess.gob.ec/web/afiliado/fondos-de-reserva
- SRI, impuesto a la renta y base imponible de relación de dependencia: https://www.sri.gob.ec/impuesto-renta
- SRI, proyección de gastos personales 2026: https://www.sri.gob.ec/detalle-noticias?idnoticia=1261&marquesina=1
- Defensoría Pública, catálogo de Código del Trabajo actualizado, referencia al Registro Oficial 286 de 18 de mayo de 2026: https://biblioteca.defensoria.gob.ec/handle/37000/3819

El catálogo del Código fue localizado, pero el articulado y las reformas aplicables requieren revisión antes de traducirlas a fórmulas. Las tasas generales citadas no cubren por sí solas regímenes especiales, contribuciones adicionales ni excepciones.

## Verificación necesaria antes de uso real

Casos de ingreso y salida en mitad de mes, meses de diferente duración, año bisiesto, cambios salariales, jornadas parciales, décimos mensuales/acumulados, aniversario de fondos de reserva, vacaciones por antigüedad, horas con diferentes recargos, retenciones y cambios de ejercicio. Comparar resultados contra casos de referencia revisados; comprobar redondeo, aislamiento entre empresas, rechazo de estados inválidos y exportaciones duplicadas. Validar el formato bancario con su especificación vigente y un archivo de prueba sin ordenar pagos reales.