Plataforma técnica · Sevastopol
Régimen previsional en Sevastopol
Islands Remuneraciones Regimen Previsional
Propósito
Section titled “Propósito”El régimen previsional del frontend mantiene las adscripciones del trabajador a instituciones de previsión (AFP/APV) y de salud (Isapre). Cada island opera sobre un contrato del trabajador y mantiene su vigencia con desde/hasta. Los catálogos AFP e Isapre se consultan en cada alta para validar institución, régimen y plan.
No hay cálculo aquí — el régimen elegido aquí condiciona el cálculo que ejecuta PayrollService en liquidaciones.
Decisiones de UX
Section titled “Decisiones de UX”| Decisión | Motivo |
|---|---|
| Una island por institución (APV vs Isapre) | Los modelos divergen: APV cubre régimen A/B + periodicidad + monto (UF/CLP/%); Isapre cubre plan, GES, adicionales y descuentos en UF. Tabbing comprimiría dos formularios incompatibles. |
| Selección guiada por empleado → contrato → institución | El alta exige los tres antes de habilitar campos. Si el operador elige sólo empleado, la lista de contratos se filtra; al elegir contrato, el formulario habilita la institución. |
| Catálogo de AFP con fallback de endpoints | APVContractsViewIsland prueba /api/apv_contracts?scope=afps, /api/afp y /api/remuneraciones/afp antes de rendirse. Soporta entornos donde el endpoint canónico cambia. |
| Total UF calculado en cliente | IsapreContractsViewIsland computa cotizacion_total_uf como plan + ges + adicionales − descuentos si el backend no la trae. Evita ida al servidor para previsualizar. |
| Filtro por empleado y por contrato cargan endpoints distintos | /api/apv_contracts?empleado_id= vs ?contrato_id= — el operador puede entrar por trabajador (ve todo su histórico) o por contrato (sólo el régimen vigente para ese contrato). |
Islands del subdominio
Section titled “Islands del subdominio”| Island | Endpoint base | Catálogo | Documentación |
|---|---|---|---|
APVContractsViewIsland | /api/apv_contracts | /api/afp | Contratos APV |
IsapreContractsViewIsland | /api/isapre_contracts | /api/isapre | Contratos Isapre |
Backend de referencia
Section titled “Backend de referencia”Régimen previsional (Orchestrator) expone AfpService e IsapreService para catálogos. Los CRUDs de contratos APV/Isapre son endpoints propios del Orchestrator que mantienen vigencia y régimen por contrato.
Relación con otros dominios
Section titled “Relación con otros dominios”- Maestro laboral provee empleado + contrato como prerrequisito.
- Liquidaciones lee el contrato APV/Isapre vigente para aplicar descuentos previsionales y de salud al cálculo del periodo.
- Imposiciones cuadra el total descontado contra la planilla mensual al cierre.
Estas relaciones se documentan en cada destino, no aquí.