Connect
API REST

Consultar cotización de Convenio Marco

Entrega la ficha y documentos conservados de una cotización de Convenio Marco. Trae enlaces temporales. No abre el portal ni inicia una lectura. Mientras una actualización está en curso, o si falla, entrega la lectura anterior con resultadoAnterior en true.

POST
/v1/tools/mercadopublico.cotizacion_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.cotizacion_convenio.consultar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {      "idCotizacion": "string"    }  }'
{  "data": {    "codigo": "string",    "estado": "no_solicitada",    "solicitadoEn": "string",    "finalizadoEn": "string",    "errorCodigo": "string",    "consultarEnSegundos": 1,    "observadoEn": "string",    "completo": true,    "motivosIncompletitud": [      "string"    ],    "resultadoAnterior": true,    "convenio": "string",    "solicitud": {      "idCotizacion": "string",      "nombre": "string",      "organismo": "string",      "unidadCompra": "string",      "estadoPortal": "string",      "idOrdenCompra": "string",      "fichaServicio": "string",      "montoTexto": "string",      "inicioPublicacion": "string",      "finPublicacion": "string",      "inicioEvaluacion": "string",      "finEvaluacion": "string",      "plazoPublicacion": "string",      "plazoEvaluacion": "string",      "plazoPreguntas": "string",      "vigenciaContrato": "string",      "vigenciaCotizacion": "string",      "correoContacto": "string",      "garantiaFielCumplimiento": "string",      "beneficiario": "string",      "objetivo": "string",      "requisitosMinimos": "string",      "alcance": "string",      "servicios": [        {          "nombre": "string",          "detalle": "string"        }      ],      "plazoMaximoEjecucion": "string",      "presupuestoMaximoTexto": "string",      "modalidad": "string",      "criteriosEvaluacion": [        "string"      ],      "criteriosDesempate": "string",      "proveedoresRespondieron": 0,      "proveedorSeleccionado": "string",      "justificacionSeleccion": "string",      "otrosCampos": [        {          "etiqueta": "string",          "valor": "string"        }      ]    },    "totalAdjuntos": 0,    "documentos": [      {        "grupo": "solicitud",        "clase": "string",        "nombre": "string",        "estado": "descargado",        "formato": "pdf",        "bytes": 0,        "sha256": "string",        "archivoUrl": "string",        "urlVenceEn": "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 adjuntos de Compra Ágil POST

Encola los adjuntos públicos de una Compra Ágil. Lee su listado en Mercado Público y descarga los PDF, Word, Excel e imágenes PNG/JPEG, sin clasificar su contenido. Devuelve el estado del trabajo; consulta luego mercadopublico.compra_agil.consultar. Reutiliza solicitudes en curso y resultados completos de las últimas 24 horas; un resultado parcial se puede volver a solicitar a los 15 minutos para continuar lo pendiente sin volver a bajar lo ya conservado.

Solicitar cotización de Convenio Marco POST

Encola la ficha de una cotización de Convenio Marco por ID. Incluye requisitos, plazos, presupuesto, estado y la descarga de sus documentos públicos. No inicia sesión como proveedor ni envía ofertas; para descubrir IDs usa mercadopublico.busqueda_convenio.solicitar. Consulta luego mercadopublico.cotizacion_convenio.consultar. Reutiliza solicitudes en curso y resultados completos de las últimas 24 horas; un resultado parcial se puede volver a solicitar a los 15 minutos para continuar lo pendiente sin volver a bajar lo ya conservado.