Consultar adjuntos de Compra Ágil

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "codigo": {
      "type": "string",
      "maxLength": 40,
      "pattern": "^\\d{1,10}-\\d{1,10}-COT\\d{2}$",
      "description": "Código público de la Compra Ágil, por ejemplo 1057539-228-COT26. No acepta URLs."
    }
  },
  "required": [
    "codigo"
  ]
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "codigo": {
      "type": "string",
      "description": "Código o ID público consultado, canonizado en mayúsculas."
    },
    "estado": {
      "type": "string",
      "enum": [
        "no_solicitada",
        "pendiente",
        "procesando",
        "disponible",
        "parcial",
        "fallido"
      ],
      "description": "Estado de la descarga solicitada a Connect."
    },
    "solicitadoEn": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Instante ISO 8601 de la última solicitud, o null si no existe."
    },
    "finalizadoEn": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Instante ISO 8601 en que terminó la descarga, si corresponde."
    },
    "errorCodigo": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Código acotado de fallo, sin datos de sesión ni URLs del portal."
    },
    "consultarEnSegundos": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "Mientras la descarga está pendiente o en proceso, cuántos segundos esperar antes de consultar de nuevo. null cuando ya terminó o no hay solicitud."
    },
    "observadoEn": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Instante ISO 8601 de la última lectura del portal conservada."
    },
    "completo": {
      "type": "boolean",
      "description": "Se leyó el listado entero y se conservaron todos los adjuntos admitidos dentro de los límites."
    },
    "motivosIncompletitud": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Razones por las que el listado o las descargas requieren revisión."
    },
    "resultadoAnterior": {
      "type": "boolean",
      "description": "true si los datos son de una lectura anterior: hay una actualización en curso o la última falló. observadoEn dice de cuándo son."
    },
    "totalAdjuntos": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Cantidad de adjuntos listados por Mercado Público."
    },
    "documentos": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "idPortal": {
            "type": "string",
            "description": "Identificador (UUID, en minúsculas) del adjunto en Mercado Público. Es su identidad natural."
          },
          "nombre": {
            "type": "string",
            "description": "Nombre del archivo declarado por el comprador."
          },
          "estado": {
            "type": "string",
            "enum": [
              "descargado",
              "omitido_formato",
              "omitido_tamano",
              "no_descargado"
            ],
            "description": "'descargado': hay archivo conservado (lleva archivoUrl). 'omitido_formato': no es PDF, Word, Excel ni PNG/JPEG, o su contenido no corresponde a su extensión. 'omitido_tamano': supera el tope. 'no_descargado': se observó pero no se conserva (error o límite)."
          },
          "formato": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "pdf",
                  "docx",
                  "doc",
                  "xlsx",
                  "xls",
                  "png",
                  "jpg"
                ],
                "description": "Formato del archivo conservado, verificado por su contenido: 'pdf'; Word ('docx', 'doc'); Excel ('xlsx', 'xls'); imagen ('png', 'jpg')."
              },
              {
                "type": "null"
              }
            ],
            "description": "Formato del archivo conservado; null si no se descargó."
          },
          "bytes": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Tamaño en bytes del archivo conservado; null si no se descargó."
          },
          "sha256": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Huella SHA-256 del archivo conservado; null si no se descargó."
          },
          "archivoUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Enlace temporal al archivo conservado por Connect; null si no se descargó o no pudo firmarse. Nunca es una URL del portal."
          },
          "urlVenceEn": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Instante ISO 8601 en que caduca archivoUrl, si se firmó."
          }
        },
        "required": [
          "idPortal",
          "nombre",
          "estado",
          "formato",
          "bytes",
          "sha256",
          "archivoUrl",
          "urlVenceEn"
        ],
        "additionalProperties": false
      },
      "description": "Todos los adjuntos listados, sin clasificar: los descargados llevan enlace firmado; el resto indica su estado."
    }
  },
  "required": [
    "codigo",
    "estado",
    "solicitadoEn",
    "finalizadoEn",
    "errorCodigo",
    "consultarEnSegundos",
    "observadoEn",
    "completo",
    "motivosIncompletitud",
    "resultadoAnterior",
    "totalAdjuntos",
    "documentos"
  ],
  "additionalProperties": false
}