Validá el CUIT o CUIL que carga un cliente o un proveedor antes de guardarlo: la API chequea el dígito verificador, te dice si es persona física o jurídica y lo devuelve normalizado con guiones. Acepta el número con o sin guiones, espacios o puntos.
Cuesta 1 crédito por consulta (entre USD 0,02 y USD 0,03, 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.
validar_cuitcurl -X POST https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/validar_cuit \
-H 'Authorization: Bearer ak_...' \
-H 'content-type: application/json' \
-d '{"cuit":"30-50001091-2"}'
{
"result": {
"valido": true,
"cuit": "30500010912",
"formateado": "30-50001091-2",
"tipo": "persona_juridica",
"prefijo": "30"
},
"credits": {
"cost": 1,
"balance": 49
}
}
import requests
r = requests.post(
"https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/validar_cuit",
headers={"Authorization": "Bearer ak_..."},
json={ "cuit": "30-50001091-2" },
timeout=30,
)
print(r.json()["result"])
const r = await fetch("https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/validar_cuit", {
method: "POST",
headers: { Authorization: "Bearer ak_...", "content-type": "application/json" },
body: JSON.stringify({"cuit":"30-50001091-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/validar_cuit, header Authorization con el valor Bearer ak_... (mejor como credencial de tipo Header Auth) y, en Body, JSON con {"cuit":"30-50001091-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: =CUIT_VALIDO(A2). Cada celda hace una consulta y gasta créditos.
function CUIT_VALIDO(cuit) {
const key = PropertiesService.getScriptProperties().getProperty("AR_API_KEY");
const r = UrlFetchApp.fetch("https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/validar_cuit", {
method: "post",
contentType: "application/json",
headers: { Authorization: "Bearer " + key },
payload: JSON.stringify({ cuit: cuit }),
});
return JSON.parse(r.getContentText()).result.valido;
}
No: valida que el número sea correcto (dígito verificador y prefijo). Un CUIT puede estar bien escrito y no estar asignado; para saber el titular hay que consultar la constancia de inscripción de ARCA.
Sí, CUIT y CUIL tienen el mismo formato y el mismo algoritmo. Los prefijos 20, 23, 24 y 27 son personas físicas; 30, 33 y 34, jurídicas.
No guardamos el contenido de las consultas, solo cuántas hizo cada key. Ver privacidad.
La API responde 402 con un checkout_url para recargar. Los packs se pagan una sola vez, sin suscripción, y los créditos no vencen. Ver precios.