Plataforma técnica · Sevastopol
Previsiones en Sevastopol
Islands Remuneraciones Imposiciones
Propósito
Section titled “Propósito”PrevisionsViewIsland consolida los descuentos previsionales del periodo en una planilla de imposiciones agrupada por institución y concepto. Es el documento mensual que el tenant declara a AFPs, Isapres y otras instituciones.
La generación reusa los datos persistidos por las liquidaciones del periodo — la previsión no recalcula descuentos, sólo los agrupa.
Decisiones de UX
Section titled “Decisiones de UX”| Decisión | Motivo |
|---|---|
| Generación con dry-run | POST /generar con dry_run: true devuelve simulación (líneas, totales) sin escribir. El operador valida y luego confirma con dry_run: false. |
| Filtros locales sobre 1000 registros | Hasta 1000 líneas por consulta — el filtro de texto se aplica en cliente sobre institucion_nombre y concepto_nombre. |
| Métricas por tipo de institución | Stats agregadas en el header: total general, AFP, ISAPRE, otros. Permite detectar concentraciones anómalas. |
monto_final con fallback a monto_total | El backend evoluciona qué campo es canónico; la island prefiere monto_final y cae a monto_total si falta. Mantiene compatibilidad. |
useActivePeriod re-fetcha | Cambiar year/month recarga la planilla del periodo. |
Eliminación puntual con confirm | Borrar una línea de la planilla afecta el cuadre — la UI obliga ratificación. |
Datos visibles
Section titled “Datos visibles”| Grupo | Campos esperados |
|---|---|
| Institución | Nombre, tipo (AFP / ISAPRE / OTROS), código. |
| Concepto | Nombre del concepto previsional. |
| Periodo | Año, mes. |
| Monto | monto_total o monto_final (preferido). |
| Glosa | Concepto narrado para la planilla impresa. |
Endpoints
Section titled “Endpoints”| Método + ruta | Uso |
|---|---|
GET /api/previsiones?tenant_id=&year=&mes=&limit=1000 | Planilla del periodo. |
POST /api/previsiones/generar?tenant_id= (dry-run y persistencia) | Generación masiva. |
DELETE /api/previsiones/:id?tenant_id= | Eliminación puntual. |
Backend de referencia
Section titled “Backend de referencia”PrevisionsService — consolida descuentos previsionales por liquidación y produce la planilla mensual.