ReportPostResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/almanac-ar/json-schema/almanac-ar-report-post-response-schema.json",
  "title": "ReportPostResponse",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/almanac-ar-v1-openapi.json#/components/schemas/ReportPostResponse",
  "allOf": [
    {
      "$ref": "#/$defs/ReportResult"
    },
    {
      "type": "object",
      "properties": {
        "informe_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "cache_hit": {
          "type": "boolean",
          "description": "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": {
          "$ref": "#/$defs/TipoAccion"
        },
        "costo_unidades": {
          "type": "integer",
          "minimum": 0
        }
      },
      "required": [
        "informe_id"
      ],
      "additionalProperties": false
    }
  ],
  "$defs": {
    "ReportResult": {
      "type": "object",
      "properties": {
        "cuit": {
          "type": "string"
        },
        "sections": {
          "type": "object",
          "properties": {
            "identidad": {
              "$ref": "#/$defs/ReportSection"
            },
            "crediticio": {
              "$ref": "#/$defs/ReportSection"
            },
            "cheques": {
              "$ref": "#/$defs/ReportSection"
            },
            "screening": {
              "$ref": "#/$defs/ReportSection"
            },
            "comex": {
              "$ref": "#/$defs/ReportSection"
            },
            "riesgoFiscal": {
              "$ref": "#/$defs/ReportSection"
            },
            "marcas": {
              "$ref": "#/$defs/ReportSection"
            },
            "concursos": {
              "$ref": "#/$defs/ReportSection"
            }
          }
        },
        "status": {
          "$ref": "#/$defs/ReportStatus"
        },
        "generated_at": {
          "type": "string"
        }
      },
      "required": [
        "cuit",
        "sections",
        "status",
        "generated_at"
      ],
      "additionalProperties": false
    },
    "ReportSection": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string"
        },
        "fields": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ReportSectionField"
          }
        },
        "source": {
          "type": "string"
        },
        "snapshot_date": {
          "type": "string"
        },
        "status": {
          "type": "string",
          "enum": [
            "ok",
            "parcial",
            "no_disponible"
          ]
        },
        "error_reason": {
          "type": "string"
        }
      },
      "required": [
        "title",
        "fields",
        "source",
        "snapshot_date",
        "status"
      ],
      "additionalProperties": {
        "nullable": true
      },
      "description": "Sección normalizada del informe. Además de los campos listados, algunas secciones traen un bloque propio: 'crediticio' → `entidades[]`, 'comex' → `comex`, 'riesgoFiscal' → `riesgoFiscal`, 'marcas' → `marcas[]`, 'concursos' → `concursos[]`. Ver NormalizedSection en lib/informes/types.ts (repo) para el detalle completo de cada bloque."
    },
    "ReportSectionField": {
      "type": "object",
      "properties": {
        "label": {
          "type": "string"
        },
        "value": {
          "type": [
            "string",
            "null"
          ]
        },
        "fuente_dataset_id": {
          "type": "string"
        },
        "snapshot_date": {
          "type": "string"
        }
      },
      "required": [
        "label",
        "value",
        "fuente_dataset_id",
        "snapshot_date"
      ],
      "additionalProperties": false
    },
    "ReportStatus": {
      "type": "string",
      "enum": [
        "ok",
        "parcial",
        "no_resuelto"
      ],
      "description": "'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."
    },
    "TipoAccion": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "nuevo",
        "actualizacion",
        null
      ],
      "description": "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."
    }
  }
}