Pasale la categoría y la antigüedad y la API devuelve el sueldo completo de Comercio según la escala vigente: básico, sumas no remunerativas del acuerdo, adicionales, cada descuento y el neto, con el acuerdo y su homologación.
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.
escala_comerciocurl -X POST https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/escala_comercio \
-H 'Authorization: Bearer ak_...' \
-H 'content-type: application/json' \
-d '{"categoria":"Administrativo B","antiguedad_anios":3}'
{
"result": {
"convenio": "CCT 130/75 (Empleados de Comercio)",
"categoria": "Administrativo B",
"periodo": "2026-11",
"remunerativo": {
"basico": 1251955,
"antiguedad": 37558.65,
"presentismo": 107459.47,
"total": 1396973.12
},
"no_remunerativo": {
"suma_fija": 120000,
"antiguedad": 3600,
"presentismo": 10300,
"suma_unica": 25000,
"total": 158900
},
"bruto_total": 1555873.12,
"aportes": {
"jubilacion": 153667.04,
"ley_19032": 41909.19,
"obra_social_osecac": 45926.19,
"aporte_sindical_solidario": 30617.46,
"faecys": 7654.37
},
"total_aportes": 279774.25,
"neto": 1276098.87,
"fuente": "Escala FAECYS del acuerdo del 27/10/2026, Disposición DNRyRT 1424/2026"
},
"credits": {
"cost": 1,
"balance": 49
}
}
Cambiá el JSON y mirá la respuesta real de escala_comercio. 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/escala_comercio",
headers={"Authorization": "Bearer ak_..."},
json={ "categoria": "Administrativo B", "antiguedad_anios": 3 },
timeout=30,
)
print(r.json()["result"])
const r = await fetch("https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/escala_comercio", {
method: "POST",
headers: { Authorization: "Bearer ak_...", "content-type": "application/json" },
body: JSON.stringify({"categoria":"Administrativo B","antiguedad_anios":3}),
});
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 sueldo_neto y 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/escala_comercio, header Authorization con el valor Bearer ak_... (mejor como credencial de tipo Header Auth) y, en Body, JSON con {"categoria":"Administrativo B","antiguedad_anios":3}. 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: =SUELDO_COMERCIO("Vendedor B"; 5). Cada celda hace una consulta y gasta créditos.
function SUELDO_COMERCIO(categoria, antiguedad_anios) {
// 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/escala_comercio", {
method: "post",
contentType: "application/json",
headers: { Authorization: "Bearer " + key },
payload: JSON.stringify({ categoria: v(categoria), antiguedad_anios: v(antiguedad_anios) }),
});
return JSON.parse(r.getContentText()).result.neto;
}
De la escala de FAECYS del acuerdo vigente, cotejada con las planillas firmadas de la CAC. La respuesta trae el acuerdo, la homologación y las fuentes.
Cargamos la escala nueva cuando FAECYS la publica; con periodo podés pedir un mes puntual de los cargados.
Sí, la página de la escala salarial de Comercio muestra todas las categorías gratis.
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.