API Honorarios Chile

API REST para calcular retención, líquido a pagar y cotizaciones previsionales de boletas de honorarios en Chile. Tasas actualizadas 2025–2028 según Ley N°21.133.

Base URL: https://honorarios.rootspa.cl

Endpoints

POST /honorarios/calcular

Calcula retención de segunda categoría, líquido a pagar y cotizaciones previsionales para una boleta de honorarios.

Request

{
  "monto_bruto": 1000000,
  "anio": 2026,
  "incluir_proyeccion_anual": true,
  "total_bruto_anual_estimado": 12000000,
  "afp": "habitat"
}

AFPs disponibles: capital, cuprum, habitat, modelo, planvital, provida, uno

Ejemplo con curl

curl -X POST https://honorarios.rootspa.cl/honorarios/calcular 
  -H "Authorization: Bearer <tu_token>" 
  -H "Content-Type: application/json" 
  -d '{"monto_bruto": 1000000, "anio": 2026}'

Response — 200 OK

{
  "monto_bruto": 1000000,
  "tasa_retencion": 0.1525,
  "monto_retencion": 152500,
  "monto_liquido": 847500,
  "cotizaciones": {
    "renta_imponible_anual": 12000000,
    "tope_imponible_anual": 14672664,
    "afp": "habitat",
    "tasa_afp": 0.1127,
    "afp_estimado": 113500,
    "salud_estimado": 70000,
    "sis_estimado": 1700,
    "atep_base": 3400
  },
  "operacion_renta_estimada": {
    "devolucion_estimada": 48000,
    "cobertura_salud_inicio": "2027-07-01"
  },
  "calendario_tasas": { "2025": 0.145, "2026": 0.1525, "2027": 0.16, "2028": 0.17 }
}

Tasas de retención

Actualizadas según Ley N°21.133 (aumento gradual de cotizaciones).

Comisiones AFP

Vigentes según Superintendencia de Pensiones 2025.

MCP Server (agentes de IA)

Endpoint MCP stateless para integraciones con Claude u otros agentes compatibles:

POST https://honorarios.rootspa.cl/mcp
Content-Type: application/json

Herramientas disponibles

Configuración en Claude Code

{
  "mcpServers": {
    "honorarios-chile": {
      "url": "https://honorarios.rootspa.cl/mcp",
      "transport": "streamable-http"
    }
  }
}

Autenticación

API Token (suscripción)

Para llamadas frecuentes, usa tu API token como alternativa al pago por request x402:

Authorization: Bearer <tu_token>

Obtener token →

Pagos x402 (pay-per-call)

Los endpoints /honorarios/* requieren pago de $0.001 USDC por request en la red Base (mainnet) si no se envía un token de suscripción.

import { wrapFetchWithPayment } from "@x402/fetch";
import { createWalletClient, http } from "viem";
import { base } from "viem/chains";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount("0xTU_CLAVE_PRIVADA");
const walletClient = createWalletClient({ account, chain: base, transport: http() });

const fetch402 = wrapFetchWithPayment(fetch, walletClient);
const res = await fetch402("https://honorarios.rootspa.cl/honorarios/tasas");
const data = await res.json();

Otros endpoints

GET /honorarios/tasas

Retorna el calendario de tasas de retención 2025–2028.

curl https://honorarios.rootspa.cl/honorarios/tasas 
  -H "Authorization: Bearer <tu_token>"

{
  "2025": 0.145,
  "2026": 0.1525,
  "2027": 0.16,
  "2028": 0.17
}

GET /honorarios/tasas/:anio

curl https://honorarios.rootspa.cl/honorarios/tasas/2026 
  -H "Authorization: Bearer <tu_token>"

Retorna 404 si el año está fuera del rango 2025–2028.

GET /honorarios/afp

curl https://honorarios.rootspa.cl/honorarios/afp 
  -H "Authorization: Bearer <tu_token>"

{
  "afp_base": 0.10,
  "afps": [
    { "nombre": "AFP Uno",       "comision": 0.0049, "tasa_total": 0.1049 },
    { "nombre": "AFP Modelo",    "comision": 0.0058, "tasa_total": 0.1058 },
    { "nombre": "AFP PlanVital", "comision": 0.0116, "tasa_total": 0.1116 },
    { "nombre": "AFP Habitat",   "comision": 0.0127, "tasa_total": 0.1127 },
    { "nombre": "AFP Capital",   "comision": 0.0144, "tasa_total": 0.1144 },
    { "nombre": "AFP Cuprum",    "comision": 0.0144, "tasa_total": 0.1144 },
    { "nombre": "AFP ProVida",   "comision": 0.0145, "tasa_total": 0.1145 }
  ]
}

Errores