Pasale la mejor remuneración bruta del semestre, el año y el semestre (y, si corresponde, las fechas de ingreso o egreso), y la API devuelve el aguinaldo bruto, los aportes del 17 %, el neto y la fecha límite de pago, con los días trabajados si es proporcional.
Cuesta 1 crédito por consulta (entre USD 0,02 y USD 0,04, según el pack). 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_aguinaldocurl -X POST https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/calcular_aguinaldo \
-H 'Authorization: Bearer ak_...' \
-H 'content-type: application/json' \
-d '{"mejor_sueldo":1500000,"anio":2026,"semestre":2}'
{
"result": {
"anio": 2026,
"semestre": 2,
"periodo": {
"desde": "2026-07-01",
"hasta": "2026-12-31",
"dias": 184
},
"dias_trabajados": 184,
"proporcional": false,
"mejor_sueldo": 1500000,
"sac_bruto": 750000,
"aportes": {
"jubilacion": 82500,
"ley_19032": 22500,
"obra_social": 22500
},
"total_aportes": 127500,
"sac_neto": 622500,
"vencimiento": "2026-12-18",
"fuente": "Ley de Contrato de Trabajo arts. 121 a 123, Ley 23.041 y Ley 27.073"
},
"credits": {
"cost": 1,
"balance": 49
}
}
import requests
r = requests.post(
"https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/calcular_aguinaldo",
headers={"Authorization": "Bearer ak_..."},
json={ "mejor_sueldo": 1500000, "anio": 2026, "semestre": 2 },
timeout=30,
)
print(r.json()["result"])
const r = await fetch("https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/calcular_aguinaldo", {
method: "POST",
headers: { Authorization: "Bearer ak_...", "content-type": "application/json" },
body: JSON.stringify({"mejor_sueldo":1500000,"anio":2026,"semestre":2}),
});
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.
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_aguinaldo, header Authorization con el valor Bearer ak_... (mejor como credencial de tipo Header Auth) y, en Body, JSON con {"mejor_sueldo":1500000,"anio":2026,"semestre":2}. 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.
En Extensiones → Apps Script, pegá esta función. Guardá la key en Configuración del proyecto → Propiedades de la secuencia de comandos con el nombre AR_API_KEY, así no queda en el código. Después usala en una celda: =AGUINALDO(B2; 2026; 2). Cada celda hace una consulta y gasta créditos.
function AGUINALDO(mejor_sueldo, anio, semestre) {
const key = PropertiesService.getScriptProperties().getProperty("AR_API_KEY");
const r = UrlFetchApp.fetch("https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/calcular_aguinaldo", {
method: "post",
contentType: "application/json",
headers: { Authorization: "Bearer " + key },
payload: JSON.stringify({ mejor_sueldo: mejor_sueldo, anio: anio, semestre: semestre }),
});
return JSON.parse(r.getContentText()).result.sac_neto;
}
50 % del mejor sueldo × días trabajados ÷ días del semestre (181 o 182 en el primero, 184 en el segundo). Con fecha_ingreso o fecha_egreso la API cuenta los días por vos.
No. Descuenta los aportes del régimen general (11 % jubilación, 3 % ley 19.032, 3 % obra social), que se pueden desactivar con con_aportes: false. El impuesto a las Ganancias depende de cada empleado.
Sí, la calculadora de aguinaldo 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.