Sistemas

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 (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).

Es un sistema de pago: se usa con una conexión, 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

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:
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"}}'
{
  "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

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"}}'
{
  "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

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"}}'
{
  "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

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

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

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

CódigoQué pasó
licitacion_no_encontradaEl portal no tiene una ficha con ese ID. Revisa el código.
portal_no_disponibleMercado Público no respondió o no dejó abrir la lista de adjuntos. Suele ser transitorio.
descarga_fallidaLa lista se abrió pero la descarga no terminó.
limite_excedidoUn archivo supera el tope de tamaño.
almacenamiento_fallido, ingesta_fallida, lease_expiradoUn problema de nuestro lado. Vuelve a pedirla; si se repite, escríbenos.

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

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.

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"}}'
{
  "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

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 MarcoTiendaLos IDs empiezan con
Desarrollo, mantención de software e IaaS (2239-19-LR23)software35802363-
Productos y servicios de ferretería (2239-9-LR23)ferreteria25802338-
Mobiliario general (2239-4-LR25)mobiliario35802381-
Transporte de pasajeros y arriendo de vehículos (2239-12-LR25)transporte5802394-

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.

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"}}'
{
  "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.
  • 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

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.

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":{}}'
{
  "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):

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":{}}'
{
  "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

Con un idCotizacion de resultados, el recorrido sigue como en la sección anterior:

  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

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:

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

CódigoQué pasó
portal_no_disponibleEl buscador no respondió a tiempo o respondió un error (la CDN del portal corta a veces con 503). Suele ser transitorio.
listado_no_reconocidoLa página no tiene la forma conocida del listado: el portal pudo cambiar.
listado_incompletoLa página llegó cortada.
filtro_no_aplicadoEl portal no aplicó un filtro pedido: no se entregan filas que podrían no corresponder.
paginacion_no_soportada, listado_inconsistenteEl listado trae paginación o datos contradictorios (por ejemplo, un ID que no calza con su ficha).
limite_excedidoLa página supera el tope de 4 MiB.
busqueda_fallida, lease_expiradoUn problema de nuestro lado. Vuelve a pedirla; si se repite, escríbenos.

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, 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

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.

En esta página