Plataforma técnica · Orchestrator
Régimen Previsional (services)
Orchestrator Remuneraciones Afp
El subdominio Régimen Previsional mantiene los catálogos institucionales (AFP, Fonasa, Isapre) y sus tasas/planes vigentes por periodo. Los services son lectores: el cálculo previsional se ejecuta en PayrollService y la consolidación en PrevisionsService. Este subdominio sólo asegura que los parámetros del periodo estén disponibles y vigentes cuando esos services consultan.
La lectura contable equivalente vive en accounting/remuneraciones/regimen-previsional.
Servicios
Section titled “Servicios”| Servicio | Responsabilidad | Doc |
|---|---|---|
AfpService | Catálogo de AFP con tasas obligatorias, comisiones administradoras y SIS por vigencia. | → |
IsapreService | Catálogo de Fonasa e Isapres con planes UF, vigencia y cotización mínima legal. | → |
APV no vive acá: se administra dentro de PrevisionsService porque su naturaleza es un descuento voluntario sujeto a régimen tributario (A o B), no un parámetro previsional puro.
Mapa de dependencias
Section titled “Mapa de dependencias”flowchart LR
subgraph SVC["domain/"]
AFP["AfpService<br/>(afp/)"]
ISA["IsapreService<br/>(isapre/)"]
end
subgraph TBL["Tablas tenant"]
AFP_T[("afp")]
ISA_T[("isapre")]
PLN_T[("isapre_plans")]
end
subgraph CONS["Consumidores"]
PAY["PayrollService"]
PRV["PrevisionsService"]
CON["ContractService"]
end
AFP --> AFP_T
ISA --> ISA_T
ISA --> PLN_T
CON -. selecciona .-> AFP
CON -. selecciona .-> ISA
PAY -. lee tasas vigentes .-> AFP
PAY -. lee plan vigente .-> ISA
PRV -. agrupa por institución .-> AFP
PRV -. agrupa por institución .-> ISA Patrones aplicados
Section titled “Patrones aplicados”| Patrón | Dónde |
|---|---|
| Repository | AfpRepository, IsapreRepository. |
| Catálogo con vigencia | Cada tasa y plan tienen vigente_desde/vigente_hasta; los lectores filtran por la fecha del periodo liquidado. |
| Template Method (BaseService) | Validaciones y manejo de pool heredados. |
Reglas críticas
Section titled “Reglas críticas”- Tasa AFP: cotización obligatoria del trabajador es 10% por ley (constante), pero la comisión administradora varía por AFP y por periodo. El catálogo debe permitir leer la comisión del mes liquidado, no la actual.
- SIS (Seguro de Invalidez y Sobrevivencia): aporte de cargo del empleador. Su tasa varía por periodo y se aplica a todos los trabajadores afiliados a AFP.
- Cotización Fonasa: 7% legal sobre imponible, sin diferencia pactada.
- Cotización Isapre: el mayor entre 7% legal y el valor UF del plan pactado vigente.
- AFC (Seguro de Cesantía): aunque opera junto con previsión, su catálogo de tasas no vive en este subdominio; vive en parámetros legales generales del sistema.
Consumidores downstream
Section titled “Consumidores downstream”| Service | Cómo consume |
|---|---|
ContractService | Permite seleccionar AFP e Isapre del trabajador al emitir contrato. |
PayrollService | Lee tasas vigentes del periodo para calcular descuentos AFP, salud e impuesto. |
PrevisionsService | Agrupa montos calculados por institución para sustentar la planilla Previred. |