API para calcular vacaciones en Argentina (días y pago)

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.

Para qué la usan

Empezá en un minuto

1. Pedí una key de prueba

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.

2. Llamá a calcular_vacaciones

curl -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}'

Respuesta (abreviada)

{
  "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
  }
}

Probalo acá, sin key

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.

Python

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"])

JavaScript

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();

Agentes de IA (MCP)

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).

claude mcp add --transport http ar-tools https://ar-tools-api-103907796853.us-east1.run.app/mcp --header "Authorization: Bearer ak_..."
{
  "mcpServers": {
    "ar-tools": {
      "url": "https://ar-tools-api-103907796853.us-east1.run.app/mcp",
      "headers": {
        "Authorization": "Bearer ak_..."
      }
    }
  }
}

n8n

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.

Google Sheets

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;
}

Preguntas frecuentes

¿Cómo cuenta la antigüedad?

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.

¿Qué pasa si entró en el año?

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.

¿Hay una versión sin programar?

Sí, la calculadora de vacaciones gratuita usa el mismo cálculo.

¿Qué pasa cuando se terminan los créditos?

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.

Más

Otras APIs de datos argentinos

Privacidad