Parámetros y Datos Comunes API

Propósito

Endpoints de lectura de catálogos y parámetros compartidos del ecosistema: indicadores económicos (UF, UTM), tasas previsionales (AFC, AFP, Isapre), impuestos (segunda categoría, retenciones) y los endpoints que disparan cargas ETL desde Nostromo. Estos datos viven en la base compartida nostromo_common y son consumidos por casi todos los dominios al hacer cálculos sensibles al periodo.

Tip

La vigencia de los indicadores es crítica: el cálculo de remuneraciones, liquidaciones y declaraciones debe usar los parámetros del periodo liquidado, no los del día de consulta.

Mapa de Familias

Familia	Prefijo	Router	Fuente del dato
Indicadores y parámetros	/api/parameters	routes/_common/parameters.ts	nostromo_common.parametros
AFC (Cesantía)	/api/afc	routes/_common/afc.ts	nostromo_common.afc_tasas
Impuesto 2ª categoría	/api/impuesto_2cat	routes/_common/impuesto_2cat.ts	nostromo_common.impuesto_2cat
ETL — cargas masivas	/api/etl	routes/etlRoutes.ts	Disparador de Nostromo

Indicadores y Parámetros

/api/parameters expone UF, UTM, IPC, sueldo mínimo, topes imponibles y otros valores legales. Acepta filtros por fecha para obtener los valores vigentes en un periodo específico.

Método	Ruta	Uso
GET	/api/parameters	Obtiene indicadores para una fecha.
GET	/api/parameters/uf?date=YYYY-MM-DD	UF para la fecha.
GET	/api/parameters/utm?date=YYYY-MM	UTM del mes.
GET	/api/parameters/topes-imponibles?date=YYYY-MM-DD	Topes imponibles AFP y salud.

Request

curl -X GET "http://localhost:8000/api/parameters?date=2026-05-01" \
  -b cookies.txt

Response 200

{
  "success": true,
  "data": {
    "uf": 37500.50,
    "utm": 65000.00,
    "ipc_mensual": 0.3,
    "sueldo_minimo": 500000,
    "tope_imponible_afp": 81.6,
    "tope_imponible_salud": 81.6,
    "tope_imponible_afc": 122.4
  }
}

AFC (Cesantía)

Método	Ruta	Uso
GET	/api/afc/percentages	Tasas vigentes del empleador y empleado.
GET	/api/afc/historico	Histórico de tasas.

Request

curl -X GET http://localhost:8000/api/afc/percentages -b cookies.txt

Response 200

{
  "success": true,
  "data": { "empleador": 2.4, "empleado": 0.6 }
}

Impuesto 2ª Categoría

Método	Ruta	Uso
GET	/api/impuesto_2cat	Tramos de impuesto único para sueldos vigentes en una fecha.

ETL (cargas masivas)

Endpoints que disparan trabajos del ETL Python (Nostromo) para refrescar parámetros desde fuentes externas (SII, Banco Central, Previred). No ejecutan el ETL en proceso del Orchestrator; encolan el trabajo y devuelven un job_id.

Método	Ruta	Uso
POST	/api/etl/uf-utm	Refresca UF y UTM desde Banco Central.
POST	/api/etl/sii/ventas	Carga libro de ventas SII del periodo.
POST	/api/etl/sii/compras	Carga libro de compras SII del periodo.
GET	/api/etl/jobs/:id	Estado del job ETL.

El detalle de los scripts ETL y su ejecución vive en Nostromo · ETL Scripts.