Pasale la fecha de ingreso, el año y, si querés, el sueldo bruto, y la API devuelve los días corridos de vacaciones que corresponden, si son proporcionales, cuánto se paga cada día y el total, y el período para tomarlas.
Es gratis: no descuenta créditos, solo necesita una key. La key de prueba es gratis, sin registro ni tarjeta, y trae 50 créditos. La misma key sirve en las tres APIs de la suite (AR Tools, Índices AR y Direcciones AR), con un solo saldo.
curl -X POST https://ar-tools-api-103907796853.us-east1.run.app/v1/keys -H 'content-type: application/json' -d '{"name": "mi-sistema"}'
Devuelve key (empieza con ak_, guardala: no se vuelve a mostrar), key_id y los créditos.
calcular_vacacionescurl -X POST https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/calcular_vacaciones \
-H 'Authorization: Bearer ak_...' \
-H 'content-type: application/json' \
-d '{"fecha_ingreso":"2019-03-01","anio":2026,"sueldo_mensual":1500000}'
{
"result": {
"anio": 2026,
"antiguedad_al_31_12": {
"anios": 7,
"meses": 9
},
"tramo": "más de 5 y hasta 10 años",
"dias_corridos": 21,
"proporcional": false,
"pago": {
"valor_dia": 60000,
"total": 1260000,
"diferencia_vs_sueldo": 210000
},
"periodo_para_tomarlas": {
"desde": "2026-10-01",
"hasta": "2027-04-30"
},
"aviso_minimo_dias": 30,
"fuente": "Ley de Contrato de Trabajo arts. 150 a 155 (texto con la Ley 27.802)"
},
"credits": {
"cost": 0,
"balance": 50
}
}
Cambiá el JSON y mirá la respuesta real de calcular_vacaciones. Es gratis y no gasta créditos (hasta 10 pruebas por hora). Para usarla en tu sistema, pedí la key de arriba.
import requests
r = requests.post(
"https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/calcular_vacaciones",
headers={"Authorization": "Bearer ak_..."},
json={ "fecha_ingreso": "2019-03-01", "anio": 2026, "sueldo_mensual": 1500000 },
timeout=30,
)
print(r.json()["result"])
const r = await fetch("https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/calcular_vacaciones", {
method: "POST",
headers: { Authorization: "Bearer ak_...", "content-type": "application/json" },
body: JSON.stringify({"fecha_ingreso":"2019-03-01","anio":2026,"sueldo_mensual":1500000}),
});
const { result, credits } = await r.json();
La misma tool está en el servidor MCP https://ar-tools-api-103907796853.us-east1.run.app/mcp, junto con las demás de AR Tools (por ejemplo calcular_aguinaldo y liquidacion_final).
https://ar-tools-api-103907796853.us-east1.run.app/mcp. Te pide autorización (OAuth) la primera vez que usa una tool; ahí podés generar la key de prueba.claude mcp add --transport http ar-tools https://ar-tools-api-103907796853.us-east1.run.app/mcp --header "Authorization: Bearer ak_..."
.cursor/mcp.json):{
"mcpServers": {
"ar-tools": {
"url": "https://ar-tools-api-103907796853.us-east1.run.app/mcp",
"headers": {
"Authorization": "Bearer ak_..."
}
}
}
}
Usá un nodo HTTP Request: método POST, URL https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/calcular_vacaciones, header Authorization con el valor Bearer ak_... (mejor como credencial de tipo Header Auth) y, en Body, JSON con {"fecha_ingreso":"2019-03-01","anio":2026,"sueldo_mensual":1500000}. El resultado queda en {{$json.result}}. También podés usar el nodo MCP Client con la URL https://ar-tools-api-103907796853.us-east1.run.app/mcp, o empezar por los flujos de n8n listos para importar.
Lo más fácil es la plantilla de Google Sheets: un solo script con todas las funciones de la suite, un menú para cargar la key y caché para no cobrar dos veces la misma consulta. Si preferís solo esta función, en Extensiones → Apps Script pegá el código de abajo y guardá la key en Configuración del proyecto → Propiedades de la secuencia de comandos con el nombre AR_API_KEY. Después usala en una celda: =DIAS_VACACIONES(B2; 2026). Cada celda hace una consulta y gasta créditos.
function DIAS_VACACIONES(fecha_ingreso, anio) {
// Las fechas de las celdas llegan como Date: se pasan a YYYY-MM-DD.
const v = (x) => (x instanceof Date ? Utilities.formatDate(x, SpreadsheetApp.getActive().getSpreadsheetTimeZone(), "yyyy-MM-dd") : x);
const key = PropertiesService.getScriptProperties().getProperty("AR_API_KEY");
const r = UrlFetchApp.fetch("https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/calcular_vacaciones", {
method: "post",
contentType: "application/json",
headers: { Authorization: "Bearer " + key },
payload: JSON.stringify({ fecha_ingreso: v(fecha_ingreso), anio: v(anio) }),
});
return JSON.parse(r.getContentText()).result.dias_corridos;
}
Al 31 de diciembre del año de las vacaciones, como pide el art. 150: hasta 5 años son 14 días, más de 5 son 21, más de 10 son 28 y más de 20 son 35.
Si no llegó a trabajar la mitad de los días hábiles del año, la API devuelve 1 día cada 20 trabajados (art. 153) y marca proporcional: true.
Sí, la calculadora de vacaciones gratuita usa el mismo cálculo.
La API responde 402 con un checkout_url para recargar. Los packs arrancan en USD 2 (50 créditos), se pagan una sola vez, sin suscripción, y los créditos no vencen. Ver precios.