Previsions Service

Orchestrator · Remuneraciones

ServiceImposicionesPreview/Commit

PrevisionsService genera imposiciones mensuales a partir de liquidaciones. Consolida descuentos y aportes por institución, periodo y tipo de obligación, separando simulación (dryRun) de persistencia definitiva.

Ubicación

Pieza	Ruta
Service	src/domain/previsions/PrevisionsService.ts
Repository	src/domain/previsions/PrevisionsRepository.ts
Route	src/routes/remuneraciones/previsiones.ts
Tablas	Consolidados previsionales del schema remuneraciones

Método Principal

async generate(
  year: number,
  month: number,
  userId: string,
  dryRun: boolean = true
): Promise<GenerationResult>

Parámetro	Tipo	Uso
year	number	Año del periodo.
month	number	Mes del periodo, entre 1 y 12.
userId	string	Usuario que ejecuta el proceso.
dryRun	boolean	true simula, false persiste.

Resultado

interface GenerationResult {
  mensaje: string;
  registros_generados: number;
  monto_total_consolidado: number;
}

Flujo de Generación

1. Lee agregados del periodo desde liquidaciones y vistas de remuneraciones.

2. Consolida AFP, salud, AFC, aportes patronales, impuesto único y retenciones soportadas.

3. Mapea cada agregado a entidades de previsión por institución y tipo de obligación.

4. Si dryRun es true, retorna totales sin persistir.

5. Si dryRun es false, reemplaza transaccionalmente el consolidado del periodo.

Consideraciones Técnicas

Regla	Criterio
Idempotencia por periodo	La ejecución definitiva debe reemplazar el consolidado del mismo periodo de forma controlada.
Preview antes de commit	La UI debe permitir revisar montos antes de persistir.
Liquidaciones fuente	El proceso depende de liquidaciones aprobadas o cerradas según regla vigente.
Auditoría	userId debe quedar asociado a la generación.

Ejemplo

import { PrevisionsService } from '@/domain/previsions/PrevisionsService';
import { PrevisionsRepository } from '@/domain/previsions/PrevisionsRepository';

const repo = new PrevisionsRepository(pool);
const service = new PrevisionsService(repo);

const preview = await service.generate(2026, 5, 'user-123', true);
const result = await service.generate(2026, 5, 'user-123', false);

Ver También

Servicio de Imposiciones Lectura contable de la consolidación previsional mensual.

Servicio de Liquidaciones Fuente del detalle de haberes, descuentos y aportes.

API de Remuneraciones Endpoints de payroll, parámetros e imposiciones.