Connect
API REST

Consultar la cartola de Mercado Pago

Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar. Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. Consulta la cartola guardada de un período: movimientos con retiros incluidos una vez, cobertura y huecos del período, netos por moneda, saldos disponibles oficiales y control mensual. Sin autorización de saldo es una cartola sin saldo: los saldos son null con saldo_no_habilitado. El neto de movimientos no es un saldo y el saldo total no está disponible. Requiere movimientos habilitado. Sólo lee datos guardados; para traer datos usa mercadopago.conexion.sincronizar_v2 con movimientos.

POST
/v1/tools/mercadopago.movimientos.consultar_v2/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_v2/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {      "desde": "string",      "hasta": "string"    }  }'
{  "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",        "fechaDisponible": "string",        "efectoDisponible": "verificado"      }    ],    "cobertura": {      "desde": "string",      "hasta": "string",      "ejeTemporal": "operacion",      "revision": 0,      "evaluadaEn": "string",      "completa": true,      "intervalosLeidos": [        {          "desde": "string",          "hasta": "string"        }      ],      "huecos": [        {          "desde": "string",          "hasta": "string",          "motivo": "falta_autorizacion"        }      ]    },    "totales": [      {        "monedaLiquidacion": "string",        "neto": "string",        "filas": 0,        "sinNeto": 0,        "enConflicto": 0,        "parcial": true      }    ],    "saldos": {      "habilitado": true,      "motivo": "falta_autorizacion",      "inicioHistoria": "string",      "ancla": {        "estado": "comprobada",        "corte": "string",        "importe": "string",        "moneda": "string"      },      "total": {        "importe": null,        "motivo": "saldo_total_no_acreditado"      },      "disponibleAlCorte": {        "moneda": "string",        "corte": "string",        "importe": "string",        "fuente": "reporte_liberaciones"      },      "tramos": [        {          "moneda": "string",          "desde": "string",          "ancla": {            "corte": "string",            "importe": "string"          },          "inicial": true,          "continuidad": "solo_corte",          "saldoDiario": "no_verificable"        }      ],      "evaluadaEn": "string"    },    "conciliacionSaldo": [      {        "moneda": "string",        "periodo": "string",        "desde": "string",        "hasta": "string",        "estado": "no_verificado",        "motivo": "falta_autorizacion",        "disponibleInicial": "string",        "disponibleFinal": "string",        "variacionDisponible": "string",        "variacionEfectiva": "string",        "diferencia": "string",        "comprobadoEn": "string"      }    ],    "gestionReportes": {      "autorizacion": "vigente",      "saldoHabilitado": true,      "accionHumana": "ninguna",      "ruta": "string"    },    "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 movimientos de la cuenta de Mercado Pago POST

Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar. Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. 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.

Consultar pagos recibidos en Mercado Pago POST

Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar. Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. 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'.