Impuestos

Consultar la alícuota de ARBA

Consulta en el padrón de ARBA la alícuota de percepción de ingresos brutos de un cliente para un mes, siempre preguntando otra vez. Si ARBA no responde, devuelve la guardada.

POST/api/v1/taxes/lookup-arba-rate

Permiso: taxes.lookup-arba-rate
Empresa: Opera sobre la empresa activa
Tipo: Escritura: pide Idempotency-Key
Respuesta: JSON

Encabezados

Cookietextorequerido
La cookie de sesión del usuario de la integración (__Secure-erp.session_token). Cuando esté la clave API, va en Authorization: Bearer. Ver Autenticación.
X-Expected-Companyuuidrequerido
La empresa sobre la que operás. Si no coincide con la de la credencial, responde 409. Ver Empresa activa.
Idempotency-Keytextorequerido
Una clave única por intento, de hasta 255 caracteres. Reintentar con la misma clave y los mismos datos devuelve el mismo resultado sin repetir la operación. Ver Idempotencia.

Cuerpo

JSON con Content-Type: application/json.

customerIduuidrequerido
periodtexto
formato `^\d{4}-(0[1-9]|1[0-2])$`

Respuesta

200 con este JSON.

cuittextorequerido
formato `^\d{11}$`
periodfecharequerido
listedsí o norequerido
rateHundredthsenterorequeridoadmite null
consultedAtfecha y horarequerido
unavailablesí o norequerido
fromPeriodfecharequeridoadmite null

Errores

Un rechazo responde application/problem+json con un code estable. Los más comunes en esta operación:

`401`	Falta la credencial o venció.
`403`	La credencial no tiene el permiso `taxes.lookup-arba-rate`.
`409`	La empresa activa no es la de `X-Expected-Company`.
`409`	Otra persona cambió el registro desde que lo leíste (`record.stale`).
`422`	Datos inválidos o una regla de negocio rota, con el detalle por campo.
`503`	Sistema ocupado: reintentá después de `Retry-After` segundos.

La lista completa está en Errores.

curl
TypeScript

curl -X POST "$ERP_URL/api/v1/taxes/lookup-arba-rate" \
  -b sesion.txt \
  -H "X-Expected-Company: $ERP_EMPRESA" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "customerId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90"
}'

const respuesta = await fetch(`${process.env.ERP_URL}/api/v1/taxes/lookup-arba-rate`, {
  method: "POST",
  headers: {
    Cookie: process.env.ERP_SESION!,
    "X-Expected-Company": process.env.ERP_EMPRESA!,
    "Idempotency-Key": crypto.randomUUID(),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "customerId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90"
  }),
});
if (!respuesta.ok) throw new Error((await respuesta.json()).title);
const datos = await respuesta.json();

{
  "cuit": "30715742426",
  "period": "2026-10-23",
  "listed": false,
  "rateHundredths": 1,
  "consultedAt": "2026-10-23T14:30:00.000Z",
  "unavailable": false,
  "fromPeriod": "2026-10-23"
}