Connect
API REST

Consultar búsqueda de Convenio Marco

Lee el último listado de una búsqueda. Incluye antigüedad y cobertura; no abre el portal ni encola nada. completitudVerificada es siempre false: el portal no declara total ni páginas. no_solicitada, pendiente o fallido no significan que no haya cotizaciones; sólo sinResultados=true es un listado vacío real.

POST
/v1/tools/mercadopublico.busqueda_convenio.consultar/execute

Authorization

AuthorizationBearer <token>

API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.

In: header

Header Parameters

X-Connect-Connection*string

Cuál conexión (conn_…) ejecuta esta llamada. Obligatoria en todo sistema conectable y sin resolución implícita, ni siquiera cuando la organización tiene una sola conexión activa: la conexión ES la empresa, y elegir por ti una que hoy acierta mañana acierta distinto sin que nadie cambie nada. Los ids salen de la tool 'conexiones.estado.consultar'. Si falta, la respuesta es 'validation_error' y no se contacta al sistema externo.

Match^conn_

Request Body

application/json

La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/tools/mercadopublico.busqueda_convenio.consultar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {}  }'
{  "data": {    "claveBusqueda": "string",    "filtros": {      "tienda": "string",      "tipoServicio": "string",      "estado": "string",      "publicacionInicio": "string"    },    "estado": "no_solicitada",    "solicitadoEn": "string",    "finalizadoEn": "string",    "errorCodigo": "string",    "consultarEnSegundos": 1,    "observadoEn": "string",    "antiguedadSegundos": 0,    "resultadoAnterior": true,    "sinResultados": true,    "cantidad": 0,    "descartes": {      "filasIlegibles": 0,      "duplicadas": 0,      "filasNoConservadas": 0    },    "cobertura": {      "totalDeclarado": 0,      "completitudVerificada": false,      "nota": "string"    },    "filtrosAplicadosPortal": {      "property1": "string",      "property2": "string"    },    "motivosIncompletitud": [      "string"    ],    "resultados": [      {        "idCotizacion": "string",        "nombre": "string",        "tipoServicio": "string",        "organismo": "string",        "inicioPublicacion": "string",        "finPublicacion": "string",        "inicioEvaluacion": "string",        "finEvaluacion": "string",        "fechaSeleccion": "string",        "proveedorSeleccionado": "string",        "ordenCompra": "string",        "ofertasVigentes": 0,        "estadoCodigo": "string",        "estadoPortal": "string",        "fichaUrl": "string"      }    ]  },  "meta": {    "request_id": "string",    "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f",    "tool_id": "string",    "plane": "action",    "latency_ms": 0,    "audit_status": "recorded",    "idempotency": "replayed"  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}

Solicitar descarga de adjuntos de una licitación POST

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

Buscar cotizaciones de Convenio Marco POST

Busca cotizaciones de Convenio Marco sin conocer IDs. Encola la lectura del buscador público (tienda software3). Primera versión: servicio de desarrollo y mantención de software en estado Publicada (los valores por defecto), con un día exacto de inicio de publicación opcional. Reutiliza la búsqueda en curso y lecturas de los últimos 15 minutos con los mismos filtros. No descarga fichas ni documentos: consulta luego mercadopublico.busqueda_convenio.consultar y pide cada ID elegido con mercadopublico.cotizacion_convenio.solicitar.