Reports

Generar o actualizar un Informe por CUIT

Genera un informe nuevo, o lo actualiza si ya existe uno previo para este CUIT en la cuenta (descuento automático: 'actualizacion' cuesta 25% de 'nuevo'). SIEMPRE corre el Motor y SIEMPRE cobra (desde 2026-08-06 este endpoint ya NO cachea por tiempo) — traer un informe ya generado sin cobrar es GET /v1/reports/{id} (o el PDF), no este POST. Para reintentos seguros ante un timeout de RED (el servidor pudo haber terminado y cobrado aunque la respuesta no haya llegado), usá el header Idempotency-Key. Ver GET /v1/reports/quote para conocer el costo MÁXIMO antes de llamar a este endpoint.

post/v1/reports

Request

  • Base URL: https://api.almanac.ar
  • URL: https://api.almanac.ar/v1/reports
  • Auth: HTTP bearer

Headers

Idempotency-Keystring uuid

UUID que identifica esta operación de forma única, opcional (mismo patrón que Stripe). Un POST repetido con la MISMA clave para el MISMO cuit devuelve la respuesta ORIGINAL (mismo informe, mismo tipo_accion, mismo costo_unidades) sin correr el Motor ni cobrar de nuevo — reemplaza a la caché de 24h que este endpoint tenía hasta 2026-08-06. Sin este header, cada POST SIEMPRE genera y cobra, incluso para el mismo CUIT consultado segundos antes. Retención: permanente (mientras exista la fila del ledger, que no se purga) — no expira a las 24h como en Stripe. Reusar la misma clave con un CUIT distinto devuelve 409 idempotency_key_conflict.

Example:6e1b9e0a-8f3b-4e9a-9d1e-2b1a5b7d9c10

Request body

cuitstring required

CUIT (11 dígitos) o DNI (7-8 dígitos, se resuelve a CUIL automáticamente).

Example request

{
  "cuit": "30000000007"
}

Response

Informe generado (o cobrado y devuelto por replay de Idempotency-Key / carrera concurrente).

cuitstring required
status'ok' | 'parcial' | 'no_resuelto' required

'ok': todas las secciones resolvieron con dato real. 'parcial': al menos una sección tiene dato real, pero no todas. 'no_resuelto': ninguna fuente entregó nada — no se cobra.

generated_atstring required
informe_idstring nullable required
cache_hitboolean

true si esta respuesta REUTILIZA un informe ya persistido y cobrado, sin correr el Motor ni cobrar de nuevo — dos casos: (a) replay de la MISMA Idempotency-Key (ver el header en POST /v1/reports), o (b) esta request perdió una carrera de generación CONCURRENTE contra otra para el mismo CUIT+cuenta y recibió el resultado de la ganadora. Desde 2026-08-06 este endpoint YA NO cachea por tiempo: sin Idempotency-Key, un POST repetido para el mismo CUIT SIEMPRE corre el Motor y SIEMPRE cobra, aunque el último informe tenga segundos de antigüedad.

tipo_accion'nuevo' | 'actualizacion' | 'null' nullable

Qué acción representa la consulta, en lenguaje de cliente — nunca 'créditos'. 'nuevo': primer informe de este CUIT para la cuenta (200 unidades). 'actualizacion': ya existía un informe previo (50 unidades) — se cobra siempre, cambie o no cambie el contenido respecto del informe anterior.

costo_unidadesinteger

Example response

{
  "cuit": "30000000007",
  "sections": {
    "identidad": {
      "title": "Identidad y situación fiscal",
      "fields": [
        {
          "label": "Denominación",
          "value": "ACME S.A.",
          "fuente_dataset_id": "arca.padron.contribuyentes",
          "snapshot_date": "2026-08-01"
        }
      ],
      "source": "arca.padron.contribuyentes",
      "snapshot_date": "2026-08-01"
    },
    "crediticio": {
      "title": "Identidad y situación fiscal",
      "fields": [
        {
          "label": "Denominación",
          "value": "ACME S.A.",
          "fuente_dataset_id": "arca.padron.contribuyentes",
          "snapshot_date": "2026-08-01"
        }
      ],
      "source": "arca.padron.contribuyentes",
      "snapshot_date": "2026-08-01"
    },
    "cheques": {
      "title": "Identidad y situación fiscal",
      "fields": [
        {
          "label": "Denominación",
          "value": "ACME S.A.",
          "fuente_dataset_id": "arca.padron.contribuyentes",
          "snapshot_date": "2026-08-01"
        }
      ],
      "source": "arca.padron.contribuyentes",
      "snapshot_date": "2026-08-01"
    },
    "screening": {
      "title": "Identidad y situación fiscal",
      "fields": [
        {
          "label": "Denominación",
          "value": "ACME S.A.",
          "fuente_dataset_id": "arca.padron.contribuyentes",
          "snapshot_date": "2026-08-01"
        }
      ],
      "source": "arca.padron.contribuyentes",
      "snapshot_date": "2026-08-01"
    },
    "comex": {
      "title": "Identidad y situación fiscal",
      "fields": [
        {
          "label": "Denominación",
          "value": "ACME S.A.",
          "fuente_dataset_id": "arca.padron.contribuyentes",
          "snapshot_date": "2026-08-01"
        }
      ],
      "source": "arca.padron.contribuyentes",
      "snapshot_date": "2026-08-01"
    },
    "riesgoFiscal": {
      "title": "Identidad y situación fiscal",
      "fields": [
        {
          "label": "Denominación",
          "value": "ACME S.A.",
          "fuente_dataset_id": "arca.padron.contribuyentes",
          "snapshot_date": "2026-08-01"
        }
      ],
      "source": "arca.padron.contribuyentes",
      "snapshot_date": "2026-08-01"
    },
    "marcas": {
      "title": "Identidad y situación fiscal",
      "fields": [
        {
          "label": "Denominación",
          "value": "ACME S.A.",
          "fuente_dataset_id": "arca.padron.contribuyentes",
          "snapshot_date": "2026-08-01"
        }
      ],
      "source": "arca.padron.contribuyentes",
      "snapshot_date": "2026-08-01"
    },
    "concursos": {
      "title": "Identidad y situación fiscal",
      "fields": [
        {
          "label": "Denominación",
          "value": "ACME S.A.",
          "fuente_dataset_id": "arca.padron.contribuyentes",
          "snapshot_date": "2026-08-01"
        }
      ],
      "source": "arca.padron.contribuyentes",
      "snapshot_date": "2026-08-01"
    }
  },
  "generated_at": "2026-08-05T14:32:00.000Z",
  "informe_id": "6e1b9e0a-8f3b-4e9a-9d1e-2b1a5b7d9c10"
}

Changes

No recorded changes to this operation across all 1 revision of this API.