# RR. HH.: operaciones, archivos y validación

Estado al 18 de septiembre de 2026. Implementación local. No equivale a una homologación bancaria, aceptación de una entidad ni validación del responsable de nómina.

## Liquidación de salida

En Personal registre la salida antes de aprobar el último mes. En Beneficios use **Calcular finiquito desde el historial**. Se exige historia aprobada de todos los meses de esa relación laboral. Los meses faltantes se importan primero; no se completan con ceros.

El cálculo identifica netos aprobados pendientes, décimos acumulados descontando los pagos ya registrados, vacaciones por año de servicio y bonificaciones de desahucio/despido según la causal. Para vacaciones se distribuye la base remunerativa histórica entre los años de servicio y se consumen primero los derechos más antiguos. El saldo inicial de días debe estar conciliado; las vacaciones adicionales pactadas, postergaciones del artículo 74 y otros derechos especiales se desglosan con respaldo.

La remuneración habitual para indemnizaciones se confirma expresamente: puede incluir componentes que no están identificados automáticamente en una historia migrada. Nunca puede ser inferior al último sueldo contractual. La vista previa no confirma un pago. Registrar el finiquito reserva los roles y beneficios para impedir pagos separados duplicados; **Confirmar pago de finiquito** requiere comprobante y actualiza los roles incluidos.

Excepciones: el operador administrativo debe identificar la causal y los derechos reconocidos, no lo decide el programa. Se calculan las indemnizaciones adicionales de 12 remuneraciones del artículo 195.3 y de 6 remuneraciones del artículo 179 cuando se seleccionan y existe informe/documento en el expediente. Los demás conceptos excepcionales se ingresan desglosados, con base legal y respaldo. La jubilación patronal y otros cálculos especializados no se sustituyen por una suma automática inventada. Desde 20 años de servicio, incluidos períodos anteriores vinculados, se exige revisión especializada. Si hay ajustes de roles o cambios de región escolar que impidan conciliar un beneficio, use la liquidación revisada.

**Limitación explícita:** no es un motor universal automático para toda causal, régimen o resolución judicial. No automatiza actuarialmente la jubilación patronal ni decide procedencia de derechos controvertidos. Conserve el informe y el acta correspondiente.

## RDEP, IESS y SUT

- **RDEP:** se descarga una conciliación CSV con columnas del XSD oficial y valores conocidos de roles efectivamente pagados. Los datos desconocidos quedan vacíos: nombres separados, residencia, discapacidades, beneficios pagados, utilidades, otros empleadores, gastos y exenciones deben conciliarse. Importe el CSV completo para generar XML. Se comprueban historia mensual, trabajadores, duplicados, importes de nómina, base e impuesto anual, códigos básicos y XSD. Ejercicios admitidos: 2025/2026, una vez terminados. El esquema se distribuye sin modificaciones en `resources/schemas/hr/rdep-2023.xsd`. El XML debe validarse también en DIMM y comprimirse para presentación. No se transmite automáticamente al SRI. El régimen de salario neto con impuesto asumido requiere tratamiento especializado y está bloqueado en este exportador. Las rectificaciones tributarias de ajustes posteriores no se infieren de diferencias sin clasificación fiscal.
- **IESS:** TXT ASCII delimitado por `;`, sin encabezado, para ENT, SAL, MSU e INS, según el formato batch publicado por IESS. El administrador debe confirmar sucursal, códigos y compatibilidad con el portal de su empresa. Se limita al período actual; las salidas extemporáneas se tramitan en IESS. La generación y pago de la planilla se realizan en el portal, no en este exportador. No cubre todos los tipos de novedades, subsidios ni planillas de diferencias.
- **SUT:** la normativa consultada exige elaborar el acta en SUT y cargar el acta firmada y el comprobante de pago PDF. El ERP conserva los documentos privados, su integridad y la constancia con el HASH entregado por el Ministerio. Su PDF interno no es un acta oficial ni genera un HASH oficial. Beneficios permite registrar la constancia; muestra como referencia el plazo general de 15 días. No se encontró un formato público vigente de importación masiva de finiquitos que permita afirmar una carga automática.

## Contabilidad

En Nómina genere el asiento auxiliar indicando cuentas de gasto, aportes, beneficios, neto, IESS, retenciones y descuentos. El asiento debe cuadrar en centavos y solo se genera una vez por período. Puede descargarse como CSV.

Si la cuenta tiene Contabilidad contratada, **Enviar a Contabilidad** crea un borrador real en ese módulo. Exige cuentas activas de movimiento de la misma empresa y período contable abierto. La fuente `RRHH_NOMINA` evita duplicar el asiento. La revisión y contabilización se realizan con el flujo del módulo contable. No se generan automáticamente asientos de pagos bancarios, finiquitos, ajustes o utilidades a partir de comprobantes no conciliados.

## Historial y administración

- Personal → **Importar nóminas anteriores**. Descargue la plantilla de encabezados. CSV UTF-8 con `;`, importes en USD y máximo dos decimales. Deben existir el trabajador y su contrato histórico. Importe meses completos y ordenados antes de aprobar meses posteriores. Se rechazan duplicados, períodos existentes, netos que no cuadran y trabajadores ambiguos; un error revierte todo el archivo. Conserva los valores declarados, comprobante, fuente, autor y hash del archivo. No recalcula el pasado con leyes actuales. No se importan automáticamente documentos ni cuotas históricas de préstamos.
- **Registrar reingreso** crea otro expediente laboral ligado al anterior, con igual identificación. Exige salida y liquidación anteriores, impide superposición y conserva roles/documentos originales. Requiere contrato y proyección nuevos. Se conserva el tiempo previo para fondo de reserva; no se trasladan vacaciones ya liquidadas. No es un procedimiento de reintegro por despido ineficaz.
- **Ajustar rol pagado** conserva el original y registra diferencias, motivo y autorización por concepto. La conciliación del ajuste exige referencia de pago/recuperación. No altera silenciosamente retenciones presentadas, beneficios liquidados ni un período cerrado. Las declaraciones sustitutivas se concilian antes de presentarse.
- **Publicar parámetros legales** crea versiones por empresa/año con SBU, canasta, IESS, fondos de reserva, IECE/SECAP y tabla de renta. Exige fuente y revisión. Los roles aprobados conservan sus parámetros; los borradores detectan el cambio y requieren recálculo. Fórmulas estructurales especiales siguen requiriendo desarrollo normativo, no basta cambiar una tasa.

## Correos de roles

La aprobación ofrece enviar automáticamente los roles PDF. También puede programarse el envío desde Nómina. Se usa el correo congelado en el rol y la configuración de correo de la empresa; no se adjuntan cuentas bancarias. Un registro único por rol evita programar duplicados. La cola es `hr-mail`, conexión `database`, procesada por el scheduler.

Se muestran estados PENDIENTE, ENVIANDO, ENVIADO y REVISAR. Si el transporte no confirma entrega, no se reenvía automáticamente porque pudo haber entregado el mensaje antes del error. El administrador puede reintentar después de cinco minutos y de comprobar que no se entregó. Se conserva auditoría. En pruebas se utilizaron Mail/Queue falsos: no se enviaron correos reales.

## Validación y publicación pendientes de datos externos

La pantalla permite descargar una plantilla de valores esperados en **centavos enteros** y compararla con el cálculo del responsable. Registra diferencias, revisión, huella de nómina y referencia del revisor. Todavía no se han aportado casos reales ni firmado una aceptación funcional.

Para publicar se necesita:

1. Servidor de destino, procedimiento de acceso y respaldo de base/documentos/clave de cifrado.
2. Casos anonimizados revisados por el responsable: nómina ordinaria, ingreso/salida parcial, salario variable, cambio salarial, beneficios acumulados, vacaciones, reingreso y casos especiales aplicables.
3. Plantillas vigentes de Cash Management de Pichincha y Guayaquil, códigos de convenio y archivo de prueba autorizado. Continúa pendiente el desarrollo de esos dos archivos bancarios; el CSV de revisión no debe cargarse al banco.
4. Validación de RDEP en DIMM/SRI y de novedades en el portal IESS, con comprobantes de aceptación. Elaboración/registro del acta en SUT por el responsable autorizado.
5. Prueba de correo con destinatario autorizado y revisión visual de las pantallas en el entorno de destino.

Preparación técnica: ejecutar las migraciones pendientes, verificar almacenamiento privado y extensión DOM/SimpleXML, configurar correo y asegurar el programador Laravel. `php artisan rrhh:verificar-produccion` comprueba requisitos técnicos sin enviar nada. Luego validar configuración/vistas y procesador de cola antes de habilitar RRHH a una cuenta. No deshacer la migración de reingresos si ya existen varias relaciones con la misma identificación.

## Fuentes verificadas

Verificación local: regresión ampliada de RRHH, contabilidad, cuentas y tareas: 187 pruebas y 1315 comprobaciones satisfactorias. Verificación final de RRHH tras los ajustes de vacaciones: 40 pruebas y 129 comprobaciones satisfactorias. Migraciones de operaciones e historial aplicadas en MySQL, lotes 104 y 105. Se corrigió el orden de sustitución del índice de identificación para conservar el soporte de la clave foránea de empresa. El comprobador de producción identifica este entorno como local; esto no constituye publicación ni aceptación externa.

- Código del Trabajo actualizado a mayo de 2026: https://biblioteca.defensoria.gob.ec/handle/37000/3819 (arts. 71, 74, 179, 185, 188, 195.3, 197 y 216).
- SRI, catálogo de anexos y guías: https://www.sri.gob.ec/formularios-e-instructivos1
- SRI, ficha RDEP: https://www.sri.gob.ec/o/sri-portlet-biblioteca-alfresco-internet/descargar/b19da703-5b63-4e4b-8222-10d8e3d21c89/Ficha%20Tecnica%20RDEP%202024.pdf
- SRI, XSD utilizado: https://www.sri.gob.ec/o/sri-portlet-biblioteca-alfresco-internet/descargar/62837cc4-2de7-472c-9108-9b61bce8a38e/Esquema%20RDEP%202023.xsd
- IESS, formatos batch: https://hl5.iess.gob.ec/emp/PrjEmpNovBatJSPhtml/ksempm1320b.html
- Ministerio del Trabajo, MDT-2025-053: https://www.trabajo.gob.ec/wp-content/uploads/2025/06/ACUERDO-MINISTERIAL-MDT-2025-053.pdf
- Jubilación patronal y sus coeficientes: https://www.trabajo.gob.ec/jubilacion-patronal/