API de vencimientos de ARCA, feriados provinciales y ferias judiciales

Pasale la terminación del CUIT y un rango de fechas y la API devuelve los vencimientos de ARCA de la agenda oficial. Con una provincia o un fuero judicial, cuenta días hábiles o calcula un vencimiento sumando sus feriados y la feria a los nacionales.

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.

Para qué la usan

Empezá en un minuto

1. Pedí una key de prueba

curl -X POST https://indices-ar-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 calendario_fiscal

curl -X POST https://indices-ar-api-103907796853.us-east1.run.app/v1/tools/calendario_fiscal \
  -H 'Authorization: Bearer ak_...' \
  -H 'content-type: application/json' \
  -d '{"terminacion_cuit":7,"desde":"2026-12-01","hasta":"2026-12-31"}'

Respuesta (abreviada)

{
  "result": {
    "desde": "2026-12-01",
    "hasta": "2026-12-31",
    "terminacion_cuit": 7,
    "vencimientos_arca": [
      {
        "fecha": "2026-12-11",
        "obligacion": "f931",
        "descripcion": "Empleadores: F.931 (aportes y contribuciones)",
        "periodo": "2026-11",
        "terminaciones": "7, 8, 9"
      },
      {
        "fecha": "2026-12-16",
        "obligacion": "ganancias_anticipo_ph",
        "descripcion": "Ganancias personas humanas: anticipo",
        "periodo": "2026-12",
        "terminaciones": "7, 8, 9"
      },
      {
        "fecha": "2026-12-21",
        "obligacion": "monotributo",
        "descripcion": "Monotributo: pago mensual",
        "periodo": "2026-12",
        "terminaciones": "todas"
      },
      {
        "fecha": "2026-12-23",
        "obligacion": "iva",
        "descripcion": "IVA: declaración jurada y pago",
        "periodo": "2026-11",
        "terminaciones": "6, 7"
      }
    ],
    "cobertura": {
      "vencimientos_arca_hasta": "2026-12-24",
      "nota": null
    }
  },
  "credits": {
    "cost": 1,
    "balance": 49
  }
}

Probalo acá, sin key

Cambiá el JSON y mirá la respuesta real de calendario_fiscal. 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://indices-ar-api-103907796853.us-east1.run.app/v1/tools/calendario_fiscal",
    headers={"Authorization": "Bearer ak_..."},
    json={ "terminacion_cuit": 7, "desde": "2026-12-01", "hasta": "2026-12-31" },
    timeout=30,
)
print(r.json()["result"])

JavaScript

const r = await fetch("https://indices-ar-api-103907796853.us-east1.run.app/v1/tools/calendario_fiscal", {
  method: "POST",
  headers: { Authorization: "Bearer ak_...", "content-type": "application/json" },
  body: JSON.stringify({"terminacion_cuit":7,"desde":"2026-12-01","hasta":"2026-12-31"}),
});
const { result, credits } = await r.json();

Agentes de IA (MCP)

La misma tool está en el servidor MCP https://indices-ar-api-103907796853.us-east1.run.app/mcp, junto con las demás de Índices AR (por ejemplo dias_habiles y intereses_judiciales).

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

n8n

Usá un nodo HTTP Request: método POST, URL https://indices-ar-api-103907796853.us-east1.run.app/v1/tools/calendario_fiscal, header Authorization con el valor Bearer ak_... (mejor como credencial de tipo Header Auth) y, en Body, JSON con {"terminacion_cuit":7,"desde":"2026-12-01","hasta":"2026-12-31"}. El resultado queda en {{$json.result}}. También podés usar el nodo MCP Client con la URL https://indices-ar-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: =VENCIMIENTOS_ARCA(7; "2026-12-01"; "2026-12-31"). Cada celda hace una consulta y gasta créditos.

function VENCIMIENTOS_ARCA(terminacion_cuit, desde, hasta) {
  // 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://indices-ar-api-103907796853.us-east1.run.app/v1/tools/calendario_fiscal", {
    method: "post",
    contentType: "application/json",
    headers: { Authorization: "Bearer " + key },
    payload: JSON.stringify({ terminacion_cuit: v(terminacion_cuit), desde: v(desde), hasta: v(hasta) }),
  });
  return JSON.parse(r.getContentText()).result.vencimientos_arca[0].fecha;
}

Preguntas frecuentes

¿Necesita el CUIT completo?

No, solo el último dígito (terminacion_cuit). No se guarda ni se consulta ningún dato del contribuyente.

¿De dónde salen las fechas?

De la Agenda de Vencimientos oficial de ARCA, con los traslados por feriados. Los feriados provinciales salen de cada ley provincial y las ferias, de las acordadas de la CSJN y la SCBA.

¿Qué pasa con los meses que ARCA todavía no publicó?

La respuesta trae cobertura.vencimientos_arca_hasta y un aviso si el rango pedido lo supera.

¿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