Consultar retiros y autorización de reportes de Mercado Pago
Consulta los retiros guardados desde «Todas las transacciones», su cobertura y la autorización para gestionar los 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.
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_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.egresos.consultar_v2/execute" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{ "input": {} }'{ "data": { "egresos": [ { "operacionId": "string", "tipo": "retiro_bancario", "tipoMercadoPago": "string", "moneda": "string", "monto": "string", "montoNeto": "string", "monedaLiquidacion": "string", "comision": "string", "fechaOperacion": "string", "fechaLiquidacion": "string", "medioPago": "string", "tipoMedioPago": "string", "referenciaExterna": "string", "conflicto": true, "reporteId": "string", "reporteCreadoEn": "string", "sincronizadoEn": "string" } ], "cobertura": { "busqueda": { "estado": "nunca", "realizadaEn": "string", "reportesListados": -9007199254740991 }, "reportes": { "procesados": -9007199254740991, "parciales": -9007199254740991, "pendientes": -9007199254740991, "noUsados": -9007199254740991 }, "periodosLeidos": [ { "desde": "string", "hasta": "string" } ], "ultimosReportes": [ { "reporteId": "string", "periodoDesde": "string", "periodoHasta": "string", "creadoEn": "string", "formato": "string", "estado": "listado", "motivo": "string", "retiros": -9007199254740991 } ] }, "cursor": "string", "estado": "ok", "motivo": "falta_autorizar", "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" } } } }, "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 de Mercado Pago POST
Compatibilidad v1: prefiere mercadopago.egresos.consultar_v2, que distingue autorización y cobertura incompleta. Lee los retiros de dinero de la cuenta de Mercado Pago de esta conexión (transferencias a cuentas bancarias, sus cancelaciones y retiros en efectivo), YA sincronizados desde los reportes «Todas las transacciones» que la cuenta tiene. Sirve para conciliar salidas de fondos. Requiere el módulo 'egresos' habilitado en la conexión. Un retiro a una cuenta propia es movimiento de fondos, no un gasto. Lectura pura: NO contacta a Mercado Pago, NO genera reportes y no es saldo ni cartola completa. Revisa 'cobertura' antes de concluir que no hubo retiros. Para traer datos nuevos usa 'mercadopago.conexion.sincronizar' con 'egresos'. Pagina con 'cursor'.
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'.