Connect
API REST

Consultar movimientos de la cuenta de Mercado Pago

Consulta los movimientos guardados de la cuenta, incluidos operaciones aprobadas, devoluciones, contracargos y retiros, con bruto, neto y desgloses informados. Requiere movimientos habilitado en la conexión. Los retiros son los mismos de egresos: no los sumes dos veces. Una operación aprobada no implica una venta y no se infiere transferencia ni rendimiento sin evidencia. Revisa cobertura antes de concluir que no hubo movimientos; no se acredita cobertura de rendimientos ni conciliación contra saldo sin saldos independientes. Para traer datos usa mercadopago.conexion.sincronizar_v2 con movimientos explícito. Sólo lee datos persistidos y no genera reportes.

POST
/v1/tools/mercadopago.movimientos.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/mercadopago.movimientos.consultar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {}  }'
{  "data": {    "movimientos": [      {        "operacionId": "string",        "tipo": "operacion_aprobada",        "tipoMercadoPago": "string",        "moneda": "string",        "montoBruto": "string",        "montoNeto": "string",        "monedaLiquidacion": "string",        "comision": "string",        "impuestos": "string",        "montoReal": "string",        "comisionMarketplace": "string",        "costoFinanciamiento": "string",        "costoEnvio": "string",        "cupon": "string",        "propina": "string",        "montoVendedor": "string",        "fechaOperacion": "string",        "fechaAprobacion": "string",        "fechaLiberacionPrevista": "string",        "fechaLiquidacion": "string",        "liberado": true,        "medioPago": "string",        "tipoMedioPago": "string",        "referenciaExterna": "string",        "descripcion": "string",        "etiquetas": "string",        "detalleImpuestos": "string",        "ordenId": "string",        "compraId": "string",        "paqueteId": "string",        "envioId": "string",        "conflicto": true,        "reporteId": "string",        "reporteCreadoEn": "string",        "sincronizadoEn": "string"      }    ],    "cobertura": {      "busqueda": {        "estado": "nunca",        "realizadaEn": "string",        "reportesListados": 0      },      "reportes": {        "conocidos": 0,        "leidos": 0,        "noDisponibles": 0,        "errores": 0,        "pendientes": 0,        "ambiguos": 0      },      "completa": true,      "periodosLeidos": [        {          "desde": "string",          "hasta": "string"        }      ],      "ultimosReportes": [        {          "reporteId": "string",          "resultado": "ok",          "motivo": "string",          "completo": true,          "intentos": -9007199254740991,          "filas": -9007199254740991,          "rechazos": -9007199254740991        }      ]    },    "gestionReportes": {      "autorizacion": "sin_autorizar",      "capacidadHabilitada": true,      "motivo": "falta_autorizar",      "accionHumana": "autorizar_reportes",      "ruta": "string",      "avance": {        "historico": {          "leidas": 0,          "total": 0,          "periodosLeidos": [            {              "desde": "string",              "hasta": "string"            }          ]        },        "diario": {          "fecha": "string",          "estado": "pedido"        }      }    },    "conciliacionSaldo": {      "estado": "no_disponible",      "motivo": "sin_saldos_de_referencia"    },    "cursor": "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  }}

Consultar retiros y autorización de reportes de Mercado Pago (Recomendada) POST

Versión recomendada: consulta retiros, cobertura y autorización para gestionar reportes. Prefiere esta versión a mercadopago.egresos.consultar. Una lista vacía no significa cero retiros. omitted indica que falta autorización humana, sólo con una búsqueda completa y sin reportes utilizables. Revisa capacidadHabilitada, accionHumana y ruta en gestionReportes. Sólo un dueño o administrador autoriza desde el panel; esta consulta no pide reportes ni otorga permisos. Para traer nuevos datos usa mercadopago.conexion.sincronizar_v2 con egresos.

Consultar pagos recibidos en Mercado Pago POST

Lee los pagos que RECIBIÓ la cuenta de Mercado Pago de esta conexión, YA sincronizados: estado, monto, moneda, lo reembolsado, el neto recibido, las comisiones y cuándo se libera el dinero. Sirve para conciliar ventas y cobros. No es saldo ni cartola: no incluye retiros ni transferencias. 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'.