Generar reporte de Mercado Pago
Solicita una generación puntual del reporte «Todas las transacciones» de esta conexión, por 1 a 60 días completos GMT-03. Requiere consentimiento previo de una persona propietaria o administradora desde Ajustes o el alta y permiso mercadopago:write del actor y de la conexión y habilitación de reportes por Soporte; esta tool no otorga consentimiento. Una generación a pedido por cuenta y día de Chile, aparte de la diaria. Mercado Pago envía un correo al titular por cada reporte. Exige Idempotency-Key UUID v4 estable. Conserva la misma clave al repetir la solicitud; ante resultado_desconocido no cambies de clave ni solicites otra generación. Connect reconcilia con lecturas; sólo puede reenviar una vez tras 60 minutos sin candidatos ni pendientes comprobados. aceptado sólo confirma una generación pendiente; la descarga y validación del CSV corresponden al sync. No devuelve movimientos ni acredita cobertura.
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
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.
^conn_UUID v4 canónica generada por el caller para esta acción destructiva. Es obligatoria: el gateway no la autogenera. Reenvía exactamente la misma UUID para consultar o reconciliar el mismo intento; una UUID distinta identifica otra operación.
^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$uuidRequest 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/mercadopago.reportes.generar/execute" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Idempotency-Key: 9d1f4c2a-7b30-4e58-9c11-2f6a8de5b743" \ -H "Content-Type: application/json" \ -d '{ "input": { "beginDate": "2019-08-24T14:15:22Z", "endDate": "2019-08-24T14:15:22Z" } }'{ "data": { "estado": "aceptado", "operacionId": "string", "reporteId": "string", "puedeReintentar": false, "motivo": "permiso_rechazado" }, "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 }}Consultar reembolsos de Mercado Pago POST
Lee los reembolsos YA sincronizados de los pagos que recibió la cuenta de Mercado Pago de esta conexión, con su monto, estado y fecha. Connect sólo los lee: nunca crea ni cancela un reembolso. Lectura pura: NO contacta a Mercado Pago ni dispara una sincronización. Revisa 'cobertura' antes de concluir que no hay pagos: una lista vacía con 'cobertura.completa' en false no lo prueba. Para traer datos nuevos usa 'mercadopago.conexion.sincronizar'. Pagina con 'cursor'.
Consultar adjuntos descargados de una licitación POST
Consulta el estado y los adjuntos ya conservados por Connect, con los metadatos originales del portal y sin clasificar el contenido. No abre el portal ni inicia una descarga. no_solicitada, pendiente y fallido no significan que una licitación carezca de adjuntos. Mientras una actualización está en curso, o si falla, entrega los documentos de la descarga anterior con resultadoAnterior en true; sólo una descarga exitosa los reemplaza. Una licitación con muchos anexos se descarga por tramos: entre uno y otro, estado vuelve a pendiente y los documentos ya conservados se entregan con resultadoAnterior en true.