Informe por CUIT · Endpoints

Saldo y presupuesto

Dos lecturas puras, ninguna gasta saldo. Si ya tenés un CUIT en mente, el presupuesto te da todo junto: lo que gastaste, lo que te queda, y cuánto te va a costar ese CUIT en la próxima llamada a generar. Si todavía no tenés un CUIT, el saldo de la cuenta alcanza.

Presupuesto de un CUIT (gratis, no gasta saldo)

Costo MÁXIMO de un POST /v1/reports subsiguiente para este CUIT. Lectura pura: nunca gasta, se puede llamar todas las veces que quieras. Es el mismo endpoint que la consola de Generar usa como paso 1 antes de cobrar — y ya trae el saldo completo de la cuenta adentro, así que no hace falta una segunda llamada para saber en qué estás parado.

GET/v1/reports/quote

Parámetros

cuitstring (query)requerido

CUIT/CUIL de 11 dígitos, sin guiones ni puntos.

Respuesta 200

tipo_accion_estimadonuevo | actualizacion

Qué va a pasar si generás este CUIT ahora.

costo_maximo_unidadesinteger

Techo del costo real — sólo puede bajar (por ejemplo a 0, si ya tenés un informe fresco de este CUIT: ver Generar), nunca subir.

saldoobject

cupo_disponible_unidades, saldo_comprado_unidades, y ya traducido: disponible_informes_nuevos, disponible_actualizaciones — el mismo dato que devuelve GET /v1/balance.

alcanzaboolean

true si tu saldo total ya cubre costo_maximo_unidades.

mensajestring | null

Explicación en lenguaje de cliente cuando no alcanza.

Errores

400cuit_invalido

cuit inválido o ausente.

401unauthenticated

Sin sesión ni API key.

403account_suspended · channel_disabled

Cuenta suspendida, o tu plan no habilita el canal API.

429rate_limited

Demasiadas llamadas seguidas — trae Retry-After.

curl -H "Authorization: Bearer alm_..." \
  "https://api.almanac.ar/v1/reports/quote?cuit=30000000007"

Consola

cuitrequerido

ejemplo200

{
  "cuit": "30000000007",
  "tipo_accion_estimado": "nuevo",
  "costo_maximo_unidades": 200,
  "saldo": {
    "cupo_disponible_unidades": 300,
    "saldo_comprado_unidades": 0,
    "disponible_informes_nuevos": 1,
    "disponible_actualizaciones": 6
  },
  "alcanza": true,
  "mensaje": null
}

Saldo de la cuenta (sin CUIT)

Para cuando todavía no tenés un CUIT puntual — cuánto te queda, ya traducido a informes y actualizaciones, sin necesidad de convertir unidades vos. El saldo no vence.

GET/v1/balance