API de Boletas de Honorarios

API REST para datos de retención de boletas de honorarios profesionales chilenos

Descripción General

Esta API proporciona datos de retención para boletas de honorarios profesionales chilenos, incluyendo tasas actuales e históricas por año.

Endpoints de la API

GET /v1/retention

Retorna la tasa de retención actual y metadatos relacionados.

GET /v1/retention/history

Retorna las tasas de retención históricas por año.

GET /health

Endpoint de verificación de estado para comprobar el estado de la API.

Ejemplos de Respuestas

GET /v1/retention

{
  "statusCode": 200,
  "rate": 15.25,
  "effectiveDate": "2026-01-01T00:00:00Z",
  "source": "SII (Servicio de Impuestos Internos) - Ley 21.133",
  "lastUpdated": "2026-01-01T00:00:00Z",
  "metadata": {
    "currency": "CLP",
    "description": "Chilean Peso withholding rate for professional service invoices (boletas de honorarios)"
  }
}

GET /v1/retention/history

{
  "statusCode": 200,
  "rates": [
    {
      "year": 2026,
      "rate": 15.25,
      "effectiveDate": "2026-01-01T00:00:00Z",
      "source": "SII (Servicio de Impuestos Internos) - Ley 21.133",
      "lastUpdated": "2026-01-01T00:00:00Z"
    },
    {
      "year": 2025,
      "rate": 14.5,
      "effectiveDate": "2025-01-01T00:00:00Z",
      "source": "SII (Servicio de Impuestos Internos) - Ley 21.133",
      "lastUpdated": "2025-01-01T00:00:00Z"
    },
    {
      "year": 2024,
      "rate": 13.75,
      "effectiveDate": "2024-01-01T00:00:00Z",
      "source": "SII (Servicio de Impuestos Internos) - Ley 21.133",
      "lastUpdated": "2024-01-01T00:00:00Z"
    },
    {
      "year": 2023,
      "rate": 13.0,
      "effectiveDate": "2023-01-01T00:00:00Z",
      "source": "SII (Servicio de Impuestos Internos) - Ley 21.133",
      "lastUpdated": "2023-01-01T00:00:00Z"
    },
    {
      "year": 2022,
      "rate": 12.25,
      "effectiveDate": "2022-01-01T00:00:00Z",
      "source": "SII (Servicio de Impuestos Internos) - Ley 21.133",
      "lastUpdated": "2022-01-01T00:00:00Z"
    },
    {
      "year": 2021,
      "rate": 11.5,
      "effectiveDate": "2021-01-01T00:00:00Z",
      "source": "SII (Servicio de Impuestos Internos) - Ley 21.133",
      "lastUpdated": "2021-01-01T00:00:00Z"
    },
    {
      "year": 2020,
      "rate": 10.75,
      "effectiveDate": "2020-01-01T00:00:00Z",
      "source": "SII (Servicio de Impuestos Internos) - Ley 21.133",
      "lastUpdated": "2020-01-01T00:00:00Z"
    },
    {
      "year": 2019,
      "rate": 10.0,
      "effectiveDate": "2019-01-01T00:00:00Z",
      "source": "SII (Servicio de Impuestos Internos)",
      "lastUpdated": "2019-01-01T00:00:00Z"
    },
    {
      "year": 2018,
      "rate": 10.0,
      "effectiveDate": "2018-01-01T00:00:00Z",
      "source": "SII (Servicio de Impuestos Internos)",
      "lastUpdated": "2018-01-01T00:00:00Z"
    },
    {
      "year": 2017,
      "rate": 10.0,
      "effectiveDate": "2017-01-01T00:00:00Z",
      "source": "SII (Servicio de Impuestos Internos)",
      "lastUpdated": "2017-01-01T00:00:00Z"
    },
    {
      "year": 2016,
      "rate": 10.0,
      "effectiveDate": "2016-01-01T00:00:00Z",
      "source": "SII (Servicio de Impuestos Internos)",
      "lastUpdated": "2016-01-01T00:00:00Z"
    }
  ],
  "total": 11
}

GET /health

{
  "statusCode": 200,
  "status": "ok",
  "timestamp": "2026-01-19T20:44:19.876Z"
}

Información Adicional

Límite de Velocidad

Máximo 100 solicitudes por minuto por dirección IP

CORS

Intercambio de Recursos de Origen Cruzado habilitado para uso público

Tipo de Contenido

Todas las respuestas se devuelven como application/json

URL Base

http://localhost:3000

Contribuir

¿Quieres contribuir a este proyecto? Las contribuciones son bienvenidas.