SIIIndicadores
Consultar valor UF por fecha
Consultar valor de la Unidad de Fomento (UF) para una fecha.
GET
/api/v1/sii/indicadores/uf/anual/{anio}/{mes}/{dia}v1 · ESTABLEGET /api/v1/sii/indicadores/uf/anual/{anio}/{mes}/{dia}
Consultar valor de la Unidad de Fomento (UF) para una fecha.
Obtiene el valor oficial de la UF publicado por el SII para una fecha
especifica. Este endpoint soporta tres modos segun los parametros
presentes: diario (fecha completa), mensual (solo anio y mes) o anual
(solo anio). Los alias /uf/anual/{anio} y /uf/anual/{anio}/{mes}
delegan al mismo servicio con mayor o menor granularidad.
Autenticacion requerida: API token en header X-API-Token con scope sii:read.
Quota: Consume 1 consulta | Peso: 1x
Parametros de ruta
| Parametro | Tipo | Requerido | Rango | Descripcion |
|---|---|---|---|---|
anio | integer | Si | 1990-presente | Año a consultar |
mes | integer | Si (en este endpoint) | 1-12 | Mes a consultar |
dia | integer | Si (en este endpoint) | 1-31 | Día a consultar |
Variantes disponibles
| Ruta | Alcance |
|---|---|
/uf/anual/{anio}/{mes}/{dia} | Valor puntual de un dia |
/uf/anual/{anio}/{mes} | Todos los dias del mes |
/uf/anual/{anio} | Todos los meses y dias del año |
Respuesta exitosa - consulta diaria (200)
Errores especificos
| Codigo | error_code | Causa | Resolucion |
|---|---|---|---|
| 400 | INVALID_DATE | Dia invalido para el mes/anio | Ver details.max_dia; usar fecha valida |
| 400 | FUTURE_DATE | Fecha posterior a hoy | details.fecha_solicitada vs fecha_actual; usar fecha pasada |
| 400 | VALIDATION_ERROR | Error del service (ValueError) al parsear respuesta SII | Revisar message del SII |
| 401 | HTTP_401 | API token ausente o invalido | Enviar X-API-Token valido |
| 422 | VALIDATION_ERROR | anio \< 1990 o mes not in [1..12] | Ajustar parametros a los rangos |
| 429 | QUOTA_EXCEEDED o SII_RATE_LIMIT | Cuota del plan o del SII agotada | Esperar reset (proxima_recarga) |
| 502 | SII_GATEWAY_ERROR | SII retorno HTML/estructura inesperada | Reintentar |
| 503 | SII_UNAVAILABLE | SII en mantenimiento | Reintentar en 5 min |
Notas
- El SII publica UF diaria hasta el ultimo dia del mes siguiente; valores futuros no existen.
- Cache local recomendado: valores pasados son inmutables.
- En Operacion Renta (abril-mayo) el portal SII puede estar lento.
Parámetros
Header / Body
Tipo
Descripción
Requerido
anio
integer · path
Año de la consulta
Sí
dia
integer · path
Día de la consulta
Sí
mes
integer · path
Mes de la consulta
Sí
Respuestas
200Successful Response
400Fecha invalida o futura
401API token ausente o invalido
403Sin permisos o cuenta bloqueada
422Parametro fuera de rango
429Limite de tasa excedido
502Error en servicio SII upstream
503SII en mantenimiento
Forma de la respuesta
Código 200. Estructura del JSON devuelto.