Comprás un CUIT, no una consulta.

La unidad de compra es el CUIT

No pagás por request: pagás por generar (o mantener al día) el informe de una entidad puntual. La primera vez que tu cuenta pide el informe de un CUIT es un informe nuevo. Si ya lo tenías y volvés a pedirlo, es una actualización — y sale más barato que comprarlo de nuevo, porque ya tenías la base.

“Unidades” es contabilidad interna — a vos te hablamos en informes y actualizaciones. La unidad aparece al lado del dato, nunca sola.

El presupuesto es un techo, nunca un piso

GET /v1/reports/quote?cuit=... te dice el costo máximo de la próxima llamada a POST /v1/reports para ese CUIT, sin gastar nada — es lectura pura. El costo real nunca puede terminar siendo mayor a ese número: puede ser menor si ya tenés un informe fresco de ese CUIT (ver más abajo). Probalo en Saldo y presupuesto.

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

{
  "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
}

Sólo consultás lo que tu cuenta generó

GET /v1/reports lista únicamente los informes que tu cuenta generó (paginado, más reciente primero). GET /v1/reports/{id} devuelve 404 si el informe no existe o pertenece a otra cuenta — no hay forma de leer un informe ajeno por id.

Un informe fresco no se vuelve a cobrar

Si ya generaste el informe de ese CUIT en las últimas 24 horas y el contenido sigue vigente, POST /v1/reports te devuelve el mismo resultado (cache_hit: true) sin cobrar de nuevo.

Tu saldo, en dos bolsillos

GET /v1/balance devuelve cuántos informes nuevos y actualizaciones te alcanzan, ya convertidos desde unidades — no hace falta que hagas la cuenta vos:

{
  "cupo": {
    "unidades_disponibles": 300,
    "informes_nuevos": 1,
    "actualizaciones": 6,
    "unidades_mensuales": 1000,
    "unidades_usadas": 700
  },
  "comprado": {
    "unidades_disponibles": 0,
    "informes_nuevos": 0,
    "actualizaciones": 0
  }
}

• cupo: la asignación de tu plan.
• comprado: lo que compraste aparte, en packs.

Cómo se carga saldo hoy

Todavía no existe un endpoint para comprar saldo desde la API. El saldo se carga por la web — Planes y precios. Una vez cargado, se consume igual sea que lo gastes desde la web o desde /v1/reports: es el mismo saldo.