# Solicitar descarga de adjuntos de una licitación

> Encola la descarga de los adjuntos PDF, Word (.docx, .doc), Excel (.xlsx, .xls) e imágenes (.png, .jpg, .jpeg) desde el portal de Mercado Público, sin utilizar su API y sin seleccionar por nombre o descripción.



{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}

|                     |                                                                     |
| ------------------- | ------------------------------------------------------------------- |
| **Tool ID**         | `mercadopublico.adjuntos.solicitar`                                 |
| **Nombre MCP**      | `mercadopublico__adjuntos__solicitar`                               |
| **Conector**        | `mercadopublico`                                                    |
| **Plano**           | `action`                                                            |
| **Scope (permiso)** | `mercadopublico:write`                                              |
| **Auth**            | `none`                                                              |
| **Versión**         | `1`                                                                 |
| **Sensible**        | no                                                                  |
| **Deprecado**       | no                                                                  |
| **Comportamiento**  | readOnly=false, destructive=false, idempotent=true, openWorld=false |

> **Requiere conexión.** Indica cuál en cada llamada: header `X-Connect-Connection` en REST, campo `connectionId` en el `execute_write` de MCP y en las opciones del SDK. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de [`conexiones.estado.consultar`](../conexiones/estado-consultar).

## Qué hace [#qué-hace]

Conserva los archivos originales y sus metadatos, sin clasificar su contenido. Devuelve el estado del trabajo; consulta luego mercadopublico.adjuntos.consultar. Reutiliza solicitudes en curso y resultados de las últimas 24 horas.

## Entrada [#entrada]

| Campo              | Tipo                         | Requerido | Descripción                                                          |
| ------------------ | ---------------------------- | --------- | -------------------------------------------------------------------- |
| `codigoLicitacion` | string `^\d+-\d+-[A-Z0-9]+$` | sí        | ID público de la licitación, por ejemplo 803-6-LE26. No acepta URLs. |

<details>
  <summary>
    JSON Schema de entrada
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "codigoLicitacion": {
        "type": "string",
        "maxLength": 50,
        "pattern": "^\\d+-\\d+-[A-Z0-9]+$",
        "description": "ID público de la licitación, por ejemplo 803-6-LE26. No acepta URLs."
      }
    },
    "required": [
      "codigoLicitacion"
    ]
  }
  ```
</details>

## Salida [#salida]

| Campo                 | Tipo                                                                                            | Requerido | Descripción                                 |                                                                                                                                                                                     |
| --------------------- | ----------------------------------------------------------------------------------------------- | --------- | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `codigoLicitacion`    | string                                                                                          | sí        | ID público de la licitación consultada.     |                                                                                                                                                                                     |
| `estado`              | `"no_solicitada"` · `"pendiente"` · `"procesando"` · `"disponible"` · `"parcial"` · `"fallido"` | sí        | Estado de la descarga solicitada a Connect. |                                                                                                                                                                                     |
| `solicitadoEn`        | string                                                                                          | null      | sí                                          | Instante ISO 8601 de la última solicitud, o null si no existe.                                                                                                                      |
| `finalizadoEn`        | string                                                                                          | null      | sí                                          | Instante ISO 8601 en que terminó la descarga, si corresponde.                                                                                                                       |
| `errorCodigo`         | string                                                                                          | null      | sí                                          | Código acotado de fallo, sin datos de sesión ni URLs del portal.                                                                                                                    |
| `consultarEnSegundos` | entero                                                                                          | null      | sí                                          | Mientras la descarga está pendiente o en proceso, cuántos segundos esperar antes de volver a llamar a mercadopublico.adjuntos.consultar. null cuando ya terminó o no hay solicitud. |

<details>
  <summary>
    JSON Schema de salida
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "codigoLicitacion": {
        "type": "string",
        "description": "ID público de la licitación consultada."
      },
      "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 volver a llamar a mercadopublico.adjuntos.consultar. null cuando ya terminó o no hay solicitud."
      }
    },
    "required": [
      "codigoLicitacion",
      "estado",
      "solicitadoEn",
      "finalizadoEn",
      "errorCodigo",
      "consultarEnSegundos"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Errores de esta tool [#errores-de-esta-tool]

| Código                | HTTP | Reintentable | Qué hacer                                                         |
| --------------------- | ---- | ------------ | ----------------------------------------------------------------- |
| `connection_disabled` | 403  | no           | Reactívala en /connections o usa otra conexión del mismo sistema. |

Toda llamada puede devolver además los códigos transversales (`validation_error`, `unauthorized`, `scope_not_granted`, `rate_limited`, entre otros): el detalle vive en el [catálogo de errores](../errores).