# Mercado Público

> Pide una licitación, una Compra Ágil o una solicitud de cotización pública de Convenio Marco por su ID, o busca las cotizaciones publicadas de desarrollo y mantención de software, y recibe sus documentos en PDF, Word, Excel, PowerPoint, imagen o ZIP, con enlaces de descarga. Sin clave: la conexión sólo pide la empresa.



`mercadopublico` descarga los adjuntos de una licitación de [Mercado Público](https://www.mercadopublico.cl) (bases, anexos, resoluciones, actas) y te los entrega con enlaces de descarga. Das el ID público de la licitación (por ejemplo `803-6-LE26`) y Emisso guarda cada archivo tal como lo publicó el comprador, con su nombre, tipo y descripción.

Se descargan los adjuntos en **PDF**, **Word** (`.docx`, `.docm`, `.dotx`, `.doc`, `.dot`) y **RTF**, **Excel** (`.xlsx`, `.xlsm`, `.xls`), **PowerPoint** (`.pptx`, `.ppt`), **imagen** (`.png`, `.jpg`, `.jpeg`) y **comprimido** (`.zip`), de hasta 25 MiB cada uno. El ZIP se entrega tal como lo publicó el organismo, sin abrirlo. Emisso revisa el contenido de cada archivo, no sólo su nombre, y entrega el formato real en `formato`: un `.doc` que en realidad es un `.docx` llega como `docx`.

No usa la API de Mercado Público ni clasifica los documentos: descarga todos los adjuntos admitidos de la licitación en el orden del portal, y decidir cuál es la base administrativa queda de tu lado.

Con la misma conexión también puedes descargar los adjuntos de una **Compra Ágil**, **buscar** las solicitudes de cotización publicadas del Convenio Marco de software sin conocer sus IDs, y leer por su ID las solicitudes de cotización de los Convenios Marco de software, ferretería, mobiliario y transporte, con su detalle y sus documentos (ver [más abajo](#compra-ágil)).

Es un sistema **de pago**: se usa con una [conexión](/docs/conceptos/conexiones), que se cobra como cualquier otra de tu plan. Todas sus tools llevan el `conn_…` en cada llamada (en REST, el header `X-Connect-Connection`).

## Qué necesitas para conectar [#qué-necesitas-para-conectar]

Licitaciones, Compras Ágiles y solicitudes de cotización publicadas son públicas, así que **no se pide ninguna clave**. La conexión sólo pide el **RUT de la empresa** para la que la usas: la conexión es la empresa, y una misma empresa no se conecta dos veces.

Se crea de dos formas:

* **Desde el panel**: Conexiones → Conectar → Mercado Público, con el RUT de la empresa.
* **Desde un agente**, con `conexiones.conexion.crear`. Si esa empresa ya tiene una conexión activa, devuelve la misma y no crea otra:

```bash
curl -X POST https://connect.emisso.ai/api/v1/tools/conexiones.conexion.crear/execute \
  -H "Authorization: Bearer connect_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"input":{"sistema":"mercadopublico","empresaRut":"76.123.456-0"}}'
```

```json
{
  "data": {
    "id": "conn_...",
    "sistema": "mercadopublico",
    "sistemaNombre": "Mercado Público",
    "nombre": "Mercado Público",
    "empresaRut": "76123456-0",
    "creada": true
  }
}
```

A diferencia de los sistemas con clave, Mercado Público **no se conecta por enlace**: no hay nada que un tercero tenga que entregar. `conexiones.enlace.crear` lo rechaza y te indica `conexiones.conexion.crear`.

Para llamar a las tools necesitas, además, una **API key de tu organización** con los scopes `mercadopublico:read` (las `consultar`) y `mercadopublico:write` (las `solicitar`), y que la conexión esté **activa**. Si tu plan o tu prueba venció, las llamadas pueden responder `subscription_required` y la conexión queda pausada por falta de suscripción. Una conexión deshabilitada también puede responder `connection_disabled`. Revisa Facturación y el estado con `conexiones.estado.consultar` antes de integrar; regenerar la API key no resuelve una suscripción vencida.

## Pedir una licitación: `mercadopublico.adjuntos.solicitar` [#pedir-una-licitación-mercadopublicoadjuntossolicitar]

```bash
curl -X POST https://connect.emisso.ai/api/v1/tools/mercadopublico.adjuntos.solicitar/execute \
  -H "Authorization: Bearer connect_sk_..." \
  -H "X-Connect-Connection: conn_..." \
  -H "Content-Type: application/json" \
  -d '{"input":{"codigoLicitacion":"803-6-LE26"}}'
```

```json
{
  "data": {
    "codigoLicitacion": "803-6-LE26",
    "estado": "pendiente",
    "solicitadoEn": "2026-09-25T22:25:49.625Z",
    "finalizadoEn": null,
    "errorCodigo": null,
    "consultarEnSegundos": 300
  }
}
```

La descarga **no es inmediata**: `solicitar` deja la licitación en cola y responde al instante. Emisso la toma en su próxima pasada, que corre cada cinco minutos, y la descarga suele tardar menos de un minuto. `consultarEnSegundos` te dice cuándo volver a preguntar: 300 mientras espera turno, 60 mientras se descarga y `null` cuando terminó.

Pedir otra vez la misma licitación no duplica nada: si hay una descarga en curso, o una terminada en las últimas 24 horas, `solicitar` devuelve esa. El ID se acepta tal como sale en el portal; una URL no se acepta.

## Leer los adjuntos: `mercadopublico.adjuntos.consultar` [#leer-los-adjuntos-mercadopublicoadjuntosconsultar]

```bash
curl -X POST https://connect.emisso.ai/api/v1/tools/mercadopublico.adjuntos.consultar/execute \
  -H "Authorization: Bearer connect_sk_..." \
  -H "X-Connect-Connection: conn_..." \
  -H "Content-Type: application/json" \
  -d '{"input":{"codigoLicitacion":"803-6-LE26"}}'
```

```json
{
  "data": {
    "codigoLicitacion": "803-6-LE26",
    "estado": "disponible",
    "solicitadoEn": "2026-09-25T22:25:49.625Z",
    "finalizadoEn": "2026-09-25T22:27:10.655Z",
    "errorCodigo": null,
    "consultarEnSegundos": null,
    "observadoEn": "2026-09-25T22:27:10.647Z",
    "totalAnexos": 12,
    "completo": true,
    "motivosIncompletitud": [],
    "resultadoAnterior": false,
    "documentos": [
      {
        "id": "5b992ef3ed73b240e17b4c4a6601ce59a148a0e54b33adfa76bf4343abeade6b",
        "nombre": "BASES 803-6-LE26 DIFUSION.pdf",
        "descripcion": "BASES ID 803-6-LE26 DIFUSION",
        "tipo": "Otros Anexos de adquisición",
        "estado": "descargado",
        "formato": "pdf",
        "bytes": 811972,
        "sha256": "5b992ef3ed73b240e17b4c4a6601ce59a148a0e54b33adfa76bf4343abeade6b",
        "archivoUrl": "https://…/mercadopublico-bases/803-6-LE26/5b992ef3….pdf?token=…",
        "urlVenceEn": "2026-09-25T22:32:35.022Z"
      }
    ]
  }
}
```

`consultar` nunca abre el portal: lee lo que Emisso ya guardó. Recortado a un documento.

**`estado`** dice en qué va el trabajo: `no_solicitada`, `pendiente`, `procesando`, `disponible` (se descargó todo lo que había), `parcial` (se descargó lo que se pudo; los motivos están en `motivosIncompletitud`) o `fallido` (con la causa en `errorCodigo`). Ninguno de `no_solicitada`, `pendiente` o `fallido` significa que la licitación no tenga adjuntos. Una licitación con muchos anexos se descarga por tramos: entre uno y otro vuelve a `pendiente`, y `consultar` entrega lo ya conservado con `resultadoAnterior: true`.

**`completo`** y **`motivosIncompletitud`** cuentan cuánto del listado del portal quedó cubierto. Un anexo en otro formato, por ejemplo un plano `.dwg`, se inventaría (entra en `totalAnexos`, con `estado: "omitido_formato"`) pero no se descarga, y aparece el motivo `formatos_no_admitidos`. Otros motivos son `omitido_tamano`, `descarga_fallida`, `tiempo_agotado`, `limite_paginas` y `paginacion_incompleta`.

**Los documentos** conservan el nombre, el tipo y la descripción que les puso el comprador, y su huella SHA-256 (que además es su `id`). El archivo es el original, sin modificar.

## Los enlaces de descarga [#los-enlaces-de-descarga]

Cada `archivoUrl` es un enlace firmado que vence a los **cinco minutos** (`urlVenceEn`). Para bajar el archivo después, vuelve a llamar a `consultar`: firma enlaces nuevos al instante, sin volver al portal. Mientras está vigente, el enlace funciona para quien lo tenga, así que trátalo como el documento mismo, que es público.

Si un enlace no se pudo firmar, ese documento viene con `archivoUrl: null` y el resto sale igual.

## Actualizar una licitación [#actualizar-una-licitación]

Pasadas 24 horas, un nuevo `solicitar` vuelve a descargar la licitación: el comprador puede haber agregado anexos o cambiado alguno. Mientras eso ocurre, y también si esa actualización falla, `consultar` **sigue entregando los documentos de la descarga anterior** con `resultadoAnterior: true`; `observadoEn` dice de cuándo son. Sólo una descarga exitosa los reemplaza. Tras un fallo, puedes volver a pedirla a los 15 minutos.

## Si algo falla [#si-algo-falla]

`errorCodigo` acota la causa, sin datos de la sesión ni URLs del portal:

| Código                                                        | Qué pasó                                                                                  |
| ------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `licitacion_no_encontrada`                                    | El portal no tiene una ficha con ese ID. Revisa el código.                                |
| `portal_no_disponible`                                        | Mercado Público no respondió o no dejó abrir la lista de adjuntos. Suele ser transitorio. |
| `descarga_fallida`                                            | La lista se abrió pero la descarga no terminó.                                            |
| `limite_excedido`                                             | Un archivo supera el tope de tamaño.                                                      |
| `almacenamiento_fallido`, `ingesta_fallida`, `lease_expirado` | Un problema de nuestro lado. Vuelve a pedirla; si se repite, escríbenos.                  |

## Límites [#límites]

Emisso descarga todos los anexos admitidos de una licitación, sin tope de cantidad ni de peso total: el único tope es de **25 MiB por archivo**. Se admiten PDF, Word (`.docx`, `.docm`, `.dotx`, `.doc`, `.dot`), RTF, Excel (`.xlsx`, `.xlsm`, `.xls`), PowerPoint (`.pptx`, `.ppt`), PNG, JPEG y ZIP; otros formatos, como planos o comprimidos `.rar`, se inventarían pero no se descargan. Un archivo más pesado o en otro formato deja el resultado `parcial`, y lo dice en `motivosIncompletitud`.

## Compra Ágil [#compra-ágil]

`mercadopublico.compra_agil.solicitar` y `mercadopublico.compra_agil.consultar` siguen el mismo recorrido que los adjuntos de una licitación: pides por el código de la Compra Ágil (por ejemplo `1493149-76-COT26`), Emisso la encola y la descarga en su próxima pasada, y `consultar` entrega lo guardado con enlaces firmados de cinco minutos.

```bash
curl -X POST https://connect.emisso.ai/api/v1/tools/mercadopublico.compra_agil.solicitar/execute \
  -H "Authorization: Bearer connect_sk_..." \
  -H "X-Connect-Connection: conn_..." \
  -H "Content-Type: application/json" \
  -d '{"input":{"codigo":"1493149-76-COT26"}}'
```

```json
{
  "data": {
    "codigo": "1493149-76-COT26",
    "estado": "pendiente",
    "solicitadoEn": "2026-10-19T01:30:55.000Z",
    "finalizadoEn": null,
    "errorCodigo": null,
    "consultarEnSegundos": 300
  }
}
```

Emisso lee el listado de adjuntos que muestra el buscador público de Compra Ágil y descarga cada uno. Cada documento trae su `idPortal` (el identificador del adjunto en Mercado Público), su `nombre` y, si se descargó, `formato`, `bytes`, `sha256` y `archivoUrl`. Una Compra Ágil sin adjuntos devuelve `disponible` con `documentos: []`; un código que no existe termina en `fallido` con `proceso_no_encontrado`.

## Solicitudes de cotización de Convenio Marco [#solicitudes-de-cotización-de-convenio-marco]

`mercadopublico.cotizacion_convenio.solicitar` y `mercadopublico.cotizacion_convenio.consultar` leen la **ficha pública** de una solicitud de cotización de Convenio Marco por su ID (por ejemplo `5802363-4018GUDX`). Cada Convenio Marco es una tienda distinta del portal, y el comienzo del ID indica a cuál pertenece, así que basta con el ID:

| Convenio Marco                                                 | Tienda        | Los IDs empiezan con |
| -------------------------------------------------------------- | ------------- | -------------------- |
| Desarrollo, mantención de software e IaaS (2239-19-LR23)       | `software3`   | `5802363-`           |
| Productos y servicios de ferretería (2239-9-LR23)              | `ferreteria2` | `5802338-`           |
| Mobiliario general (2239-4-LR25)                               | `mobiliario3` | `5802381-`           |
| Transporte de pasajeros y arriendo de vehículos (2239-12-LR25) | `transporte`  | `5802394-`           |

Otras tiendas de Convenio Marco todavía no se leen: varias no publican solicitudes de cotización, y las que sí se agregan cuando las verifiquemos.

```bash
curl -X POST https://connect.emisso.ai/api/v1/tools/mercadopublico.cotizacion_convenio.solicitar/execute \
  -H "Authorization: Bearer connect_sk_..." \
  -H "X-Connect-Connection: conn_..." \
  -H "Content-Type: application/json" \
  -d '{"input":{"idCotizacion":"5802363-4018GUDX"}}'
```

```json
{
  "data": {
    "codigo": "5802363-4018GUDX",
    "estado": "pendiente",
    "solicitadoEn": "2026-10-19T01:30:57.000Z",
    "finalizadoEn": null,
    "errorCodigo": null,
    "consultarEnSegundos": 300
  }
}
```

`consultar` entrega `solicitud` con lo que publica la ficha (organismo, estado, montos y presupuesto como texto del portal, fechas, plazos, objetivo, requisitos mínimos, alcance, servicios, criterios de evaluación, proveedores que respondieron y el seleccionado) y `documentos` con los adjuntos del comprador y los de la evaluación, cada uno con su `grupo` (`solicitud`, `evaluacion_tecnica` o `evaluacion_economica`). `convenio` dice en qué tienda se leyó la ficha.

En las fichas de mobiliario y transporte, el comprador detalla cada producto en una tabla: cada línea llega como un elemento de `servicios`, con su cantidad, descripción y presupuesto en `detalle`, y el adjunto de la línea, si lo trae, llega en `documentos` junto con los demás de la solicitud.

Qué **no** hace:

* No busca por sí misma: necesitas el ID. Para encontrarlo sin entrar al portal usa el [buscador](#buscar-cotizaciones-de-convenio-marco).
* No inicia sesión como proveedor: sólo ve lo que la ficha muestra a cualquier visitante. Lo que el portal reserva a proveedores con sesión no está.
* No envía ofertas ni responde cotizaciones.
* Sólo lee las tiendas de la tabla. Un ID que empieza distinto se prueba en ellas, y si ninguna tiene esa ficha termina en `proceso_no_encontrado`, igual que un ID que no existe. Cuando ChileCompra publique el convenio que reemplaza al de software en una tienda nueva, se agrega después de verificarla.

## Buscar cotizaciones de Convenio Marco [#buscar-cotizaciones-de-convenio-marco]

`mercadopublico.busqueda_convenio.solicitar` y `mercadopublico.busqueda_convenio.consultar` leen el buscador público de cotizaciones de la tienda `software3` y te entregan sus filas, cada una con el ID que luego pides con `cotizacion_convenio.solicitar`. No necesitas conocer ningún ID.

En esta primera versión la búsqueda es **una sola**: solicitudes de **SERVICIO DE DESARROLLO Y MANTENCIÓN DE SOFTWARE** en estado **Publicada** (las que hoy reciben cotizaciones). Son los valores por defecto, así que basta con un input vacío. Puedes acotarla, opcionalmente, a un **día exacto** de inicio de publicación con `publicacionInicio` (`AAAA-MM-DD`, entre `2015-01-01` y mañana, hora de Chile). Es igualdad, **no** «desde esa fecha». Otros servicios, otros estados (proveedor elegido, finalizada…) o una URL se rechazan con `validation_error`: los estados con historia traen cientos de filas y el portal no alcanza a responderlos a tiempo.

```bash
curl -X POST https://connect.emisso.ai/api/v1/tools/mercadopublico.busqueda_convenio.solicitar/execute \
  -H "Authorization: Bearer connect_sk_..." \
  -H "X-Connect-Connection: conn_..." \
  -H "Content-Type: application/json" \
  -d '{"input":{}}'
```

```json
{
  "data": {
    "claveBusqueda": "81c8cb3375d06f8ef510df223ecda79160e60b2c17f10c0db10242ba894b33c9",
    "filtros": {
      "tienda": "software3",
      "tipoServicio": "SERVICIO DE DESARROLLO Y MANTENCIÓN DE SOFTWARE",
      "estado": "publicada",
      "publicacionInicio": null
    },
    "estado": "pendiente",
    "solicitadoEn": "2026-10-19T15:19:12.000Z",
    "finalizadoEn": null,
    "errorCodigo": null,
    "consultarEnSegundos": 300
  }
}
```

Como en el resto de Mercado Público, `solicitar` encola y Emisso lee el buscador en su próxima pasada (cada cinco minutos). Dos solicitudes con los mismos filtros comparten el trabajo: si hay una lectura en curso, o una terminada en los últimos **15 minutos**, `solicitar` devuelve esa. Tras un fallo, se puede volver a pedir a los 5 minutos.

Luego `consultar`, **con los mismos filtros** (aquí, también vacío):

```bash
curl -X POST https://connect.emisso.ai/api/v1/tools/mercadopublico.busqueda_convenio.consultar/execute \
  -H "Authorization: Bearer connect_sk_..." \
  -H "X-Connect-Connection: conn_..." \
  -H "Content-Type: application/json" \
  -d '{"input":{}}'
```

```json
{
  "data": {
    "claveBusqueda": "81c8cb3375d06f8ef510df223ecda79160e60b2c17f10c0db10242ba894b33c9",
    "filtros": { "tienda": "software3", "tipoServicio": "SERVICIO DE DESARROLLO Y MANTENCIÓN DE SOFTWARE", "estado": "publicada", "publicacionInicio": null },
    "estado": "disponible",
    "solicitadoEn": "2026-10-19T15:19:12.000Z",
    "finalizadoEn": "2026-10-19T15:19:14.531Z",
    "errorCodigo": null,
    "consultarEnSegundos": null,
    "observadoEn": "2026-10-19T15:19:14.529Z",
    "antiguedadSegundos": 4,
    "resultadoAnterior": false,
    "sinResultados": false,
    "cantidad": 8,
    "descartes": { "filasIlegibles": 0, "duplicadas": 0, "filasNoConservadas": 0 },
    "cobertura": {
      "totalDeclarado": null,
      "completitudVerificada": false,
      "nota": "El portal no declara total ni paginación verificable: estas filas son las que mostró una única página para estos filtros en ese instante. No prueban que no existan otras ni representan historia ni otras tiendas."
    },
    "filtrosAplicadosPortal": { "status": "1", "service_type": "SERVICIO DE DESARROLLO Y MANTENCIÓN DE SOFTWARE", "publication_start": "" },
    "motivosIncompletitud": [],
    "resultados": [
      {
        "idCotizacion": "5802363-1067BGBH",
        "nombre": "SERVICIO DE SOPORTE Y MANTENCIÓN EVOLUTIVA DEL GESTOR DOCUMENTAL EXEDOC",
        "tipoServicio": "SERVICIO DE DESARROLLO Y MANTENCIÓN DE SOFTWARE",
        "organismo": "SUBSECRETARIA DEL MINISTERIO DE HACIENDA",
        "inicioPublicacion": "2026-10-14",
        "finPublicacion": "2026-10-21",
        "inicioEvaluacion": "2026-10-22",
        "finEvaluacion": "2026-10-26",
        "fechaSeleccion": null,
        "proveedorSeleccionado": null,
        "ordenCompra": null,
        "ofertasVigentes": 0,
        "estadoCodigo": "1",
        "estadoPortal": "Publicada",
        "fichaUrl": "https://conveniomarco2.mercadopublico.cl/software3/quote_public/requestquote/view/id/5802363-1067BGBH/"
      }
    ]
  }
}
```

Recortado a una fila y a algunos filtros del eco. `consultar` **nunca abre el portal ni encola nada**: sólo lee la última búsqueda guardada.

Cómo leer el resultado:

* **`estado`** es el del trabajo en Emisso, no el de las cotizaciones: `no_solicitada`, `pendiente`, `procesando`, `disponible`, `parcial` (hubo filas que no se pudieron leer: ver `descartes` y `motivosIncompletitud`) o `fallido` (con `errorCodigo`).
* **`sinResultados: true`** es lo único que significa «el portal mostró un listado vacío para estos filtros». `no_solicitada`, `pendiente` y `fallido` **no** significan que no haya cotizaciones.
* **`resultadoAnterior: true`** indica que las filas son de una lectura anterior (`observadoEn` dice de cuándo): hay una actualización en curso o la última falló. Un fallo nunca borra el último listado bueno.
* **`cobertura.completitudVerificada` es siempre `false`.** El portal no declara un total ni pagina de forma verificable, así que Emisso no puede asegurar que no falten filas. Que un ID deje de aparecer tampoco prueba que la cotización se haya cerrado o cancelado.
* **`filtrosAplicadosPortal`** es el eco de los filtros que el formulario del portal mostró como aplicados. Si el portal no aplica un filtro pedido, la lectura falla con `filtro_no_aplicado` en vez de entregar filas que no corresponden.
* **Las filas no traen ficha, presupuesto ni documentos.** La búsqueda no descarga nada por su cuenta: eliges los IDs que te interesan y pides cada uno.

### De la búsqueda a la ficha [#de-la-búsqueda-a-la-ficha]

Con un `idCotizacion` de `resultados`, el recorrido sigue como en la [sección anterior](#solicitudes-de-cotización-de-convenio-marco):

1. `mercadopublico.cotizacion_convenio.solicitar` con `{"idCotizacion":"5802363-1067BGBH"}`.
2. `mercadopublico.cotizacion_convenio.consultar` con el mismo ID hasta que `estado` sea `disponible` o `parcial`: trae `solicitud` (organismo, requisitos, presupuesto, fechas, plazos) y `documentos`.
3. Descarga cada `archivoUrl` antes de que venza (`urlVenceEn`, cinco minutos) y, si quieres comprobarlo, compara su SHA-256 con `sha256`.

### Ejemplo ejecutable [#ejemplo-ejecutable]

Todo el recorrido en Node 20 o superior, sin dependencias. Lee la API key y el `conn_…` de variables de entorno y no los imprime. Guárdalo como `mercadopublico.mjs` y córrelo con `CONNECT_API_KEY=connect_sk_... CONNECT_CONNECTION=conn_... node mercadopublico.mjs`:

```js
import { createHash } from "node:crypto";

const BASE = "https://connect.emisso.ai/api/v1";
const { CONNECT_API_KEY, CONNECT_CONNECTION } = process.env;
const dormir = (s) => new Promise((r) => setTimeout(r, s * 1000));

async function tool(id, input) {
  const res = await fetch(`${BASE}/tools/${id}/execute`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${CONNECT_API_KEY}`,
      "X-Connect-Connection": CONNECT_CONNECTION,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ input }),
  });
  const cuerpo = await res.json();
  if (!res.ok) throw new Error(`${id}: ${cuerpo.error?.code}`);
  return cuerpo.data;
}

// Consulta hasta que el trabajo termine (consultar no abre el portal).
async function esperar(id, input) {
  for (;;) {
    const r = await tool(id, input);
    if (r.estado !== "pendiente" && r.estado !== "procesando") return r;
    await dormir(Math.min(r.consultarEnSegundos ?? 60, 60));
  }
}

// 1. Buscar sin conocer IDs: desarrollo y mantención de software, Publicada.
await tool("mercadopublico.busqueda_convenio.solicitar", {});
const busqueda = await esperar("mercadopublico.busqueda_convenio.consultar", {});
console.log(busqueda.estado, busqueda.cantidad, "filas, observadas", busqueda.observadoEn);
for (const f of busqueda.resultados) console.log(f.idCotizacion, f.finPublicacion, f.organismo, ":", f.nombre);

// 2. Elegir un ID y leer su ficha.
const idCotizacion = busqueda.resultados[0]?.idCotizacion;
if (!idCotizacion) process.exit(0);
await tool("mercadopublico.cotizacion_convenio.solicitar", { idCotizacion });
const ficha = await esperar("mercadopublico.cotizacion_convenio.consultar", { idCotizacion });
console.log(ficha.estado, ficha.solicitud?.organismo, ficha.solicitud?.presupuestoMaximoTexto);

// 3. Bajar un documento por su enlace firmado y comprobar su SHA-256.
const doc = ficha.documentos.find((d) => d.estado === "descargado" && d.archivoUrl);
if (doc) {
  const bytes = new Uint8Array(await (await fetch(doc.archivoUrl)).arrayBuffer());
  const sha256 = createHash("sha256").update(bytes).digest("hex");
  console.log(doc.nombre, bytes.byteLength, "bytes", sha256 === doc.sha256 ? "hash OK" : "hash distinto");
}
```

La primera corrida puede tardar hasta unos diez minutos: la búsqueda y la ficha esperan cada una la próxima pasada de Emisso.

### Si la búsqueda falla [#si-la-búsqueda-falla]

| Código                                             | Qué pasó                                                                                                                 |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `portal_no_disponible`                             | El buscador no respondió a tiempo o respondió un error (la CDN del portal corta a veces con 503). Suele ser transitorio. |
| `listado_no_reconocido`                            | La página no tiene la forma conocida del listado: el portal pudo cambiar.                                                |
| `listado_incompleto`                               | La página llegó cortada.                                                                                                 |
| `filtro_no_aplicado`                               | El portal no aplicó un filtro pedido: no se entregan filas que podrían no corresponder.                                  |
| `paginacion_no_soportada`, `listado_inconsistente` | El listado trae paginación o datos contradictorios (por ejemplo, un ID que no calza con su ficha).                       |
| `limite_excedido`                                  | La página supera el tope de 4 MiB.                                                                                       |
| `busqueda_fallida`, `lease_expirado`               | Un problema de nuestro lado. Vuelve a pedirla; si se repite, escríbenos.                                                 |

## Cómo se comportan Compra Ágil y Convenio Marco [#cómo-se-comportan-compra-ágil-y-convenio-marco]

* **Reutilización:** un resultado `disponible` se reutiliza 24 horas. Un `parcial` o un `fallido` se puede volver a pedir a los 15 minutos: lo ya descargado no se vuelve a bajar y se sigue con lo pendiente.
* **Límites:** hasta **60 documentos** por proceso, **25 MiB por archivo**, y por pasada hasta **30 descargas nuevas** y **128 MiB nuevos**. Si una pasada se queda sin tiempo o alcanza un límite, el resultado queda `parcial`, cada documento pendiente dice por qué (`plazo_agotado`, `limite_corrida`, `limite_documentos`) y una nueva solicitud continúa desde ahí.
* **Honestidad del resultado:** si un documento de la ficha no se pudo leer, el resultado no se declara `completo` y `motivosIncompletitud` lo indica; nunca se informa como «sin documentos». Si el listado o la ficha no se pueden leer, el trabajo queda `fallido` y `consultar` sigue entregando la lectura anterior con `resultadoAnterior: true`.
* **Errores:** los mismos códigos de [Si algo falla](#si-algo-falla), con `proceso_no_encontrado` en lugar de `licitacion_no_encontrada`, más `respuesta_no_reconocida`: Mercado Público respondió, pero con algo que Emisso no reconoce, por lo general porque cambió el sitio. Es un problema de nuestro lado y nos llega una alerta para corregirlo; vuelve a pedirla más tarde.

## Por MCP [#por-mcp]

El recorrido de un agente es el mismo de siempre, con una diferencia: si Mercado Público aparece con `conectado: false`, el camino es `conexiones.conexion.crear`, no un enlace.

1. `search_docs` para ver el catálogo.
2. `conexiones.estado.consultar` para obtener el `connectionId` (o `conexiones.conexion.crear` si todavía no hay conexión).
3. `execute_write` con `mercadopublico.adjuntos.solicitar`, `mercadopublico.compra_agil.solicitar`, `mercadopublico.busqueda_convenio.solicitar` o `mercadopublico.cotizacion_convenio.solicitar`.
4. `execute` con el `consultar` correspondiente, esperando lo que diga `consultarEnSegundos`.

Para encontrar cotizaciones sin conocer IDs: `busqueda_convenio.solicitar` y `busqueda_convenio.consultar` con `{}`, luego `cotizacion_convenio.solicitar` y `cotizacion_convenio.consultar` con el `idCotizacion` elegido. Las tools `solicitar` exigen el scope `mercadopublico:write` y `execute_write`; las `consultar`, `mercadopublico:read`.

La ficha técnica de cada tool está en la [referencia](/docs/referencia/mercadopublico).


---

Esta página es parte de la documentación de Emisso. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/sistemas/mercadopublico.
