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.


Tool ID	`mercadopago.movimientos.consultar`
Nombre MCP	`mercadopago__movimientos__consultar`
Conector	`mercadopago`
Plano	`action`
Lee el alcance	`movimientos` (debe estar habilitado en la conexión)
Scope (permiso)	`mercadopago:read`
Auth	`none`
Versión	`1`
Sensible	sí
Deprecado	no
Comportamiento	readOnly=true, destructive=false, idempotent=true, openWorld=false

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST y campo connectionId en el execute de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de conexiones.estado.consultar.

Qué hace

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.

Entrada

Campo	Tipo	Requerido	Descripción
`desde`	string `^\d{4}-\d{2}-\d{2}$`	no	Primer día por fecha de operación en America/Santiago, AAAA-MM-DD sin zona.
`hasta`	string `^\d{4}-\d{2}-\d{2}$`	no	Último día incluido por fecha de operación en America/Santiago, AAAA-MM-DD sin zona.
`tipo`	`"operacion_aprobada"` · `"devolucion"` · `"contracargo"` · `"reclamo"` · `"retiro_bancario"` · `"retiro_bancario_cancelado"` · …	no	Filtra por la clasificación de Connect; omítelo para todas.
`tipoMercadoPago`	string `^[A-Z_]{1,40}$`	no	Filtra por el código original de Mercado Pago, sin inferir su significado.
`operacionId`	string `^[0-9A-Za-z][0-9A-Za-z_-]{0,99}$`	no	Filtra por el ID externo de una operación, siempre texto.
`moneda`	string `^[A-Z]{3}$`	no	Moneda ISO 4217 del bruto por la que quieres filtrar.
`cursor`	string	no	Cursor opaco de la página anterior; omítelo para comenzar.
`limit`	entero 1-500	no · default `100`	Máximo de filas de esta página, de 1 a 500; por omisión 100.

JSON Schema de entrada

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "desde": {
      "description": "Primer día por fecha de operación en America/Santiago, AAAA-MM-DD sin zona.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "x-emisso-formato": "AAAA-MM-DD"
    },
    "hasta": {
      "description": "Último día incluido por fecha de operación en America/Santiago, AAAA-MM-DD sin zona.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "x-emisso-formato": "AAAA-MM-DD"
    },
    "tipo": {
      "description": "Filtra por la clasificación de Connect; omítelo para todas.",
      "type": "string",
      "enum": [
        "operacion_aprobada",
        "devolucion",
        "contracargo",
        "reclamo",
        "retiro_bancario",
        "retiro_bancario_cancelado",
        "retiro_efectivo",
        "cashback",
        "envio_aprobado",
        "devolucion_envio",
        "contracargo_envio",
        "reclamo_envio",
        "otro"
      ]
    },
    "tipoMercadoPago": {
      "description": "Filtra por el código original de Mercado Pago, sin inferir su significado.",
      "type": "string",
      "pattern": "^[A-Z_]{1,40}$"
    },
    "operacionId": {
      "description": "Filtra por el ID externo de una operación, siempre texto.",
      "type": "string",
      "pattern": "^[0-9A-Za-z][0-9A-Za-z_-]{0,99}$"
    },
    "moneda": {
      "description": "Moneda ISO 4217 del bruto por la que quieres filtrar.",
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "cursor": {
      "description": "Cursor opaco de la página anterior; omítelo para comenzar.",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Máximo de filas de esta página, de 1 a 500; por omisión 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

Salida

Campo	Tipo	Requerido	Descripción
`movimientos`	lista de objeto	sí	Movimientos guardados del más nuevo al más antiguo, con retiros incluidos una sola vez.
`movimientos[].operacionId`	string	sí	Identificador externo de la operación, como texto; no convertir a número.
`movimientos[].tipo`	`"operacion_aprobada"` · `"devolucion"` · `"contracargo"` · `"reclamo"` · `"retiro_bancario"` · `"retiro_bancario_cancelado"` · …	sí	Clasificación cerrada de la operación. otro conserva tipos originales aún no clasificados.
`movimientos[].tipoMercadoPago`	string	sí	Tipo original de Mercado Pago. operacion_aprobada no implica una venta: también puede corresponder a otro ingreso.
`movimientos[].moneda`	string	sí	Moneda ISO 4217 del monto bruto, por ejemplo CLP.
`movimientos[].montoBruto`	string	sí	Monto bruto decimal en texto con el signo informado, en moneda.
`movimientos[].montoNeto`	string	null	sí
`movimientos[].monedaLiquidacion`	string	null	sí
`movimientos[].comision`	string	null	sí
`movimientos[].impuestos`	string	null	sí
`movimientos[].montoReal`	string	null	sí
`movimientos[].comisionMarketplace`	string	null	sí
`movimientos[].costoFinanciamiento`	string	null	sí
`movimientos[].costoEnvio`	string	null	sí
`movimientos[].cupon`	string	null	sí
`movimientos[].propina`	string	null	sí
`movimientos[].montoVendedor`	string	null	sí
`movimientos[].fechaOperacion`	string	sí	Creación de la operación, instante ISO 8601 en UTC.
`movimientos[].fechaAprobacion`	string	null	sí
`movimientos[].fechaLiberacionPrevista`	string	null	sí
`movimientos[].fechaLiquidacion`	string	null	sí
`movimientos[].liberado`	booleano	null	sí
`movimientos[].medioPago`	string	null	sí
`movimientos[].tipoMedioPago`	string	null	sí
`movimientos[].referenciaExterna`	string	null	sí
`movimientos[].descripcion`	string	null	sí
`movimientos[].etiquetas`	string	null	sí
`movimientos[].detalleImpuestos`	string	null	sí
`movimientos[].ordenId`	string	null	sí
`movimientos[].compraId`	string	null	sí
`movimientos[].paqueteId`	string	null	sí
`movimientos[].envioId`	string	null	sí
`movimientos[].conflicto`	booleano	sí	Otra observación contradice sus datos financieros. No uses una fila con conflicto para conciliar.
`movimientos[].reporteId`	string	sí	Identificador externo del comprobante de origen, como texto.
`movimientos[].reporteCreadoEn`	string	sí	Creación del comprobante de origen, instante ISO 8601 en UTC.
`movimientos[].sincronizadoEn`	string	sí	Persistencia de esta observación en Connect, instante ISO 8601 en UTC.
`cobertura`	objeto	sí	Evidencia de búsqueda, recuperación y completitud de los movimientos guardados.
`cobertura.busqueda`	objeto	sí	Estado de la búsqueda de comprobantes existentes.
`cobertura.busqueda.estado`	`"nunca"` · `"completa"` · `"parcial"` · `"sin_acceso"` · `"error_transitorio"`	sí	Resultado de la última búsqueda, independiente de la lectura de los datos.
`cobertura.busqueda.realizadaEn`	string	null	sí
`cobertura.busqueda.reportesListados`	entero	sí	Cantidad de comprobantes vistos en esa búsqueda.
`cobertura.reportes`	objeto	sí	Resultados de recuperación de todos los comprobantes conocidos.
`cobertura.reportes.conocidos`	entero	sí	Comprobantes conocidos de esta conexión.
`cobertura.reportes.leidos`	entero	sí	Comprobantes cuya lectura técnica terminó sin rechazos; no acredita identidad completa.
`cobertura.reportes.noDisponibles`	entero	sí	Comprobantes existentes que ya no pudieron recuperarse.
`cobertura.reportes.errores`	entero	sí	Comprobantes con error de acceso, lectura o validación.
`cobertura.reportes.pendientes`	entero	sí	Comprobantes aún sin leer o con reintento pendiente.
`cobertura.reportes.ambiguos`	entero	sí	Comprobantes con identidades en conflicto que impiden conciliar.
`cobertura.completa`	booleano	sí	true sólo con lectura e identidad comprobadas de todo el intervalo declarado. false no significa cero movimientos y no acredita que todos los rendimientos estén incluidos.
`cobertura.periodosLeidos`	lista de objeto	sí	Intervalos con lectura e identidad comprobadas; conserva los huecos.
`cobertura.periodosLeidos[].desde`	string	sí	Inicio efectivo leído, ISO 8601 UTC.
`cobertura.periodosLeidos[].hasta`	string	sí	Fin efectivo leído, ISO 8601 UTC; nunca posterior a la generación del comprobante.
`cobertura.ultimosReportes`	lista de objeto	sí	Hasta veinte comprobantes recientes y su estado de recuperación.
`cobertura.ultimosReportes[].reporteId`	string	sí	ID externo del comprobante, como texto.
`cobertura.ultimosReportes[].resultado`	`"ok"` · `"no_disponible"` · `"error"`	sí	ok acredita lectura técnica; no_disponible conserva un archivo no recuperable; error exige revisar el motivo.
`cobertura.ultimosReportes[].motivo`	string	null	sí
`cobertura.ultimosReportes[].completo`	booleano	sí	Lectura e identidad de este comprobante comprobadas.
`cobertura.ultimosReportes[].intentos`	entero	sí	Intentos de recuperación confirmados en Connect.
`cobertura.ultimosReportes[].filas`	entero	sí	Filas observadas antes de deduplicar operaciones.
`cobertura.ultimosReportes[].rechazos`	entero	sí	Filas rechazadas o identidades ambiguas observadas.
`gestionReportes`	objeto	sí	Autorización y capacidad para gestionar reportes de esta conexión, con la acción humana y el enlace al panel.
`gestionReportes.autorizacion`	`"sin_autorizar"` · `"vigente"` · `"revocada"`	sí	Autorización humana para configurar y generar reportes. Es independiente del acceso a la conexión.
`gestionReportes.capacidadHabilitada`	booleano	sí	Si soporte habilitó la gestión de reportes para esta organización; es distinta del consentimiento.
`gestionReportes.motivo`	`"falta_autorizar"` · `"capacidad_no_habilitada"` · `"requiere_atencion"`	null	sí
`gestionReportes.accionHumana`	`"autorizar_reportes"` · `"solicitar_habilitacion"` · `"revisar_reportes"` · `"ninguna"`	sí	La autorización sólo puede darla una persona propietaria o administradora en el panel; nunca la API ni MCP.
`gestionReportes.ruta`	string	null	sí
`gestionReportes.avance`	objeto	no	Avance persistido cuando esté disponible. Su ausencia significa que esta respuesta todavía no lo informa.
`gestionReportes.avance.historico`	objeto	sí	Lectura comprobada de las ventanas del histórico y sus fechas.
`gestionReportes.avance.diario`	objeto	null	sí
`conciliacionSaldo`	objeto	sí	Disponibilidad de una comprobación independiente del saldo.
`conciliacionSaldo.estado`	string	sí	No hay evidencia para certificar un saldo cuadrado.
`conciliacionSaldo.motivo`	string	sí	Faltan saldos independientes inicial y final de la misma cuenta, moneda e intervalo.
`cursor`	string	null	sí

JSON Schema de salida

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "movimientos": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "operacionId": {
            "type": "string",
            "description": "Identificador externo de la operación, como texto; no convertir a número."
          },
          "tipo": {
            "type": "string",
            "enum": [
              "operacion_aprobada",
              "devolucion",
              "contracargo",
              "reclamo",
              "retiro_bancario",
              "retiro_bancario_cancelado",
              "retiro_efectivo",
              "cashback",
              "envio_aprobado",
              "devolucion_envio",
              "contracargo_envio",
              "reclamo_envio",
              "otro"
            ],
            "description": "Clasificación cerrada de la operación. otro conserva tipos originales aún no clasificados."
          },
          "tipoMercadoPago": {
            "type": "string",
            "description": "Tipo original de Mercado Pago. operacion_aprobada no implica una venta: también puede corresponder a otro ingreso."
          },
          "moneda": {
            "type": "string",
            "description": "Moneda ISO 4217 del monto bruto, por ejemplo CLP."
          },
          "montoBruto": {
            "type": "string",
            "description": "Monto bruto decimal en texto con el signo informado, en moneda."
          },
          "montoNeto": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Impacto neto informado en el dinero de la cuenta, en monedaLiquidacion, decimal en texto. null cuando no fue informado: no equivale a cero. Conserva el signo de Mercado Pago y usa la moneda declarada para ese importe."
          },
          "monedaLiquidacion": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Moneda ISO 4217 del monto neto. null si no fue informada; no se infiere desde el bruto."
          },
          "comision": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Comisiones e IVA, como desglose; no volver a descontarlas del neto, decimal en texto. null cuando no fue informado: no equivale a cero. Conserva el signo de Mercado Pago y usa la moneda declarada para ese importe."
          },
          "impuestos": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Impuestos informados, como desglose; no volver a descontarlos del neto, decimal en texto. null cuando no fue informado: no equivale a cero. Conserva el signo de Mercado Pago y usa la moneda declarada para ese importe."
          },
          "montoReal": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Monto real informado, que no sustituye al impacto neto, decimal en texto. null cuando no fue informado: no equivale a cero. Conserva el signo de Mercado Pago y usa la moneda declarada para ese importe."
          },
          "comisionMarketplace": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Comisión del marketplace, decimal en texto. null cuando no fue informado: no equivale a cero. Conserva el signo de Mercado Pago y usa la moneda declarada para ese importe."
          },
          "costoFinanciamiento": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Costo de financiamiento, decimal en texto. null cuando no fue informado: no equivale a cero. Conserva el signo de Mercado Pago y usa la moneda declarada para ese importe."
          },
          "costoEnvio": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Costo de envío, decimal en texto. null cuando no fue informado: no equivale a cero. Conserva el signo de Mercado Pago y usa la moneda declarada para ese importe."
          },
          "cupon": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cupón, decimal en texto. null cuando no fue informado: no equivale a cero. Conserva el signo de Mercado Pago y usa la moneda declarada para ese importe."
          },
          "propina": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Propina, decimal en texto. null cuando no fue informado: no equivale a cero. Conserva el signo de Mercado Pago y usa la moneda declarada para ese importe."
          },
          "montoVendedor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Monto del vendedor, decimal en texto. null cuando no fue informado: no equivale a cero. Conserva el signo de Mercado Pago y usa la moneda declarada para ese importe."
          },
          "fechaOperacion": {
            "type": "string",
            "description": "Creación de la operación, instante ISO 8601 en UTC."
          },
          "fechaAprobacion": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Aprobación de la operación, instante ISO 8601 en UTC. null si no fue informado."
          },
          "fechaLiberacionPrevista": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Liberación prevista del dinero; no acredita liberación efectiva, instante ISO 8601 en UTC. null si no fue informado."
          },
          "fechaLiquidacion": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Liquidación efectiva; null mientras no haya una fuente que la acredite, instante ISO 8601 en UTC. null si no fue informado."
          },
          "liberado": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Indicación del proveedor de si el dinero fue liberado; null si no se informó."
          },
          "medioPago": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Medio de pago informado; null si no vino."
          },
          "tipoMedioPago": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tipo del medio de pago informado; null si no vino."
          },
          "referenciaExterna": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Referencia externa informada; puede estar ausente."
          },
          "descripcion": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Descripción de la operación informada por Mercado Pago."
          },
          "etiquetas": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Etiquetas informadas, conservadas como texto; no se usan para inferir un tipo no comprobado."
          },
          "detalleImpuestos": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Detalle de los impuestos informados, conservado como texto."
          },
          "ordenId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "ID externo de la orden, como texto; null si no vino."
          },
          "compraId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "ID externo de la compra, como texto; null si no vino."
          },
          "paqueteId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "ID externo del paquete, como texto; null si no vino."
          },
          "envioId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "ID externo del envío, como texto; null si no vino."
          },
          "conflicto": {
            "type": "boolean",
            "description": "Otra observación contradice sus datos financieros. No uses una fila con conflicto para conciliar."
          },
          "reporteId": {
            "type": "string",
            "description": "Identificador externo del comprobante de origen, como texto."
          },
          "reporteCreadoEn": {
            "type": "string",
            "description": "Creación del comprobante de origen, instante ISO 8601 en UTC."
          },
          "sincronizadoEn": {
            "type": "string",
            "description": "Persistencia de esta observación en Connect, instante ISO 8601 en UTC."
          }
        },
        "required": [
          "operacionId",
          "tipo",
          "tipoMercadoPago",
          "moneda",
          "montoBruto",
          "montoNeto",
          "monedaLiquidacion",
          "comision",
          "impuestos",
          "montoReal",
          "comisionMarketplace",
          "costoFinanciamiento",
          "costoEnvio",
          "cupon",
          "propina",
          "montoVendedor",
          "fechaOperacion",
          "fechaAprobacion",
          "fechaLiberacionPrevista",
          "fechaLiquidacion",
          "liberado",
          "medioPago",
          "tipoMedioPago",
          "referenciaExterna",
          "descripcion",
          "etiquetas",
          "detalleImpuestos",
          "ordenId",
          "compraId",
          "paqueteId",
          "envioId",
          "conflicto",
          "reporteId",
          "reporteCreadoEn",
          "sincronizadoEn"
        ],
        "additionalProperties": false
      },
      "description": "Movimientos guardados del más nuevo al más antiguo, con retiros incluidos una sola vez."
    },
    "cobertura": {
      "type": "object",
      "properties": {
        "busqueda": {
          "type": "object",
          "properties": {
            "estado": {
              "type": "string",
              "enum": [
                "nunca",
                "completa",
                "parcial",
                "sin_acceso",
                "error_transitorio"
              ],
              "description": "Resultado de la última búsqueda, independiente de la lectura de los datos."
            },
            "realizadaEn": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Última búsqueda de comprobantes, instante ISO 8601 en UTC. null si no fue informado."
            },
            "reportesListados": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Cantidad de comprobantes vistos en esa búsqueda."
            }
          },
          "required": [
            "estado",
            "realizadaEn",
            "reportesListados"
          ],
          "additionalProperties": false,
          "description": "Estado de la búsqueda de comprobantes existentes."
        },
        "reportes": {
          "type": "object",
          "properties": {
            "conocidos": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Comprobantes conocidos de esta conexión."
            },
            "leidos": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Comprobantes cuya lectura técnica terminó sin rechazos; no acredita identidad completa."
            },
            "noDisponibles": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Comprobantes existentes que ya no pudieron recuperarse."
            },
            "errores": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Comprobantes con error de acceso, lectura o validación."
            },
            "pendientes": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Comprobantes aún sin leer o con reintento pendiente."
            },
            "ambiguos": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Comprobantes con identidades en conflicto que impiden conciliar."
            }
          },
          "required": [
            "conocidos",
            "leidos",
            "noDisponibles",
            "errores",
            "pendientes",
            "ambiguos"
          ],
          "additionalProperties": false,
          "description": "Resultados de recuperación de todos los comprobantes conocidos."
        },
        "completa": {
          "type": "boolean",
          "description": "true sólo con lectura e identidad comprobadas de todo el intervalo declarado. false no significa cero movimientos y no acredita que todos los rendimientos estén incluidos."
        },
        "periodosLeidos": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "desde": {
                "type": "string",
                "description": "Inicio efectivo leído, ISO 8601 UTC."
              },
              "hasta": {
                "type": "string",
                "description": "Fin efectivo leído, ISO 8601 UTC; nunca posterior a la generación del comprobante."
              }
            },
            "required": [
              "desde",
              "hasta"
            ],
            "additionalProperties": false
          },
          "description": "Intervalos con lectura e identidad comprobadas; conserva los huecos."
        },
        "ultimosReportes": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "reporteId": {
                "type": "string",
                "description": "ID externo del comprobante, como texto."
              },
              "resultado": {
                "type": "string",
                "enum": [
                  "ok",
                  "no_disponible",
                  "error"
                ],
                "description": "ok acredita lectura técnica; no_disponible conserva un archivo no recuperable; error exige revisar el motivo."
              },
              "motivo": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Código del motivo observado; null si no hubo inconvenientes."
              },
              "completo": {
                "type": "boolean",
                "description": "Lectura e identidad de este comprobante comprobadas."
              },
              "intentos": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "Intentos de recuperación confirmados en Connect."
              },
              "filas": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "Filas observadas antes de deduplicar operaciones."
              },
              "rechazos": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "Filas rechazadas o identidades ambiguas observadas."
              }
            },
            "required": [
              "reporteId",
              "resultado",
              "motivo",
              "completo",
              "intentos",
              "filas",
              "rechazos"
            ],
            "additionalProperties": false
          },
          "description": "Hasta veinte comprobantes recientes y su estado de recuperación."
        }
      },
      "required": [
        "busqueda",
        "reportes",
        "completa",
        "periodosLeidos",
        "ultimosReportes"
      ],
      "additionalProperties": false,
      "description": "Evidencia de búsqueda, recuperación y completitud de los movimientos guardados."
    },
    "gestionReportes": {
      "type": "object",
      "properties": {
        "autorizacion": {
          "type": "string",
          "enum": [
            "sin_autorizar",
            "vigente",
            "revocada"
          ],
          "description": "Autorización humana para configurar y generar reportes. Es independiente del acceso a la conexión."
        },
        "capacidadHabilitada": {
          "type": "boolean",
          "description": "Si soporte habilitó la gestión de reportes para esta organización; es distinta del consentimiento."
        },
        "motivo": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "falta_autorizar",
                "capacidad_no_habilitada",
                "requiere_atencion"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "Por qué hace falta una acción humana. null cuando no se necesita ninguna."
        },
        "accionHumana": {
          "type": "string",
          "enum": [
            "autorizar_reportes",
            "solicitar_habilitacion",
            "revisar_reportes",
            "ninguna"
          ],
          "description": "La autorización sólo puede darla una persona propietaria o administradora en el panel; nunca la API ni MCP."
        },
        "ruta": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Ruta relativa al panel de reportes de esta conexión. null si la capacidad no está habilitada y no existe permiso vigente que revocar."
        },
        "avance": {
          "description": "Avance persistido cuando esté disponible. Su ausencia significa que esta respuesta todavía no lo informa.",
          "type": "object",
          "properties": {
            "historico": {
              "type": "object",
              "properties": {
                "leidas": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Ventanas del histórico íntegramente respaldadas por CSV leídos. No cuenta solicitudes ni períodos sólo revisados."
                },
                "total": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Ventanas de hasta 60 días que componen los 12 meses desde la autorización."
                },
                "periodosLeidos": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "desde": {
                        "type": "string",
                        "description": "Día calendario AAAA-MM-DD del reporte, en GMT-03 fijo."
                      },
                      "hasta": {
                        "type": "string",
                        "description": "Día calendario AAAA-MM-DD del reporte, en GMT-03 fijo."
                      }
                    },
                    "required": [
                      "desde",
                      "hasta"
                    ],
                    "additionalProperties": false
                  },
                  "description": "Intervalos de archivos leídos de forma completa; conserva los huecos entre intervalos."
                }
              },
              "required": [
                "leidas",
                "total",
                "periodosLeidos"
              ],
              "additionalProperties": false,
              "description": "Lectura comprobada de las ventanas del histórico y sus fechas."
            },
            "diario": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "fecha": {
                      "type": "string",
                      "description": "Día calendario AAAA-MM-DD del reporte, en GMT-03 fijo."
                    },
                    "estado": {
                      "type": "string",
                      "enum": [
                        "pedido",
                        "listo",
                        "leido",
                        "hueco"
                      ],
                      "description": "pedido: aún sin archivo listo comprobado. listo: archivo disponible, aún no leído por completo. leido: CSV íntegro guardado. hueco: sin lectura confirmada; revisa el estado del reporte."
                    }
                  },
                  "required": [
                    "fecha",
                    "estado"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ],
              "description": "Última solicitud diaria observada. null si no existe; no promete datos tras un plazo fijo."
            }
          },
          "required": [
            "historico",
            "diario"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "autorizacion",
        "capacidadHabilitada",
        "motivo",
        "accionHumana",
        "ruta"
      ],
      "additionalProperties": false,
      "description": "Autorización y capacidad para gestionar reportes de esta conexión, con la acción humana y el enlace al panel."
    },
    "conciliacionSaldo": {
      "type": "object",
      "properties": {
        "estado": {
          "type": "string",
          "const": "no_disponible",
          "description": "No hay evidencia para certificar un saldo cuadrado."
        },
        "motivo": {
          "type": "string",
          "const": "sin_saldos_de_referencia",
          "description": "Faltan saldos independientes inicial y final de la misma cuenta, moneda e intervalo."
        }
      },
      "required": [
        "estado",
        "motivo"
      ],
      "additionalProperties": false,
      "description": "Disponibilidad de una comprobación independiente del saldo."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Cursor opaco para continuar la página. null indica fin de esta consulta, no cobertura financiera completa."
    }
  },
  "required": [
    "movimientos",
    "cobertura",
    "gestionReportes",
    "conciliacionSaldo",
    "cursor"
  ],
  "additionalProperties": false
}

Errores de esta tool

Código	HTTP	Reintentable	Qué hacer
`connection_disabled`	403	no	Reactívala en /connections o usa otra conexión del mismo sistema.
`connection_not_found`	404	no	Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.
`alcance_not_enabled`	403	no	Habilita el alcance en /connections o quítalo del input de la sincronización.

Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.

Próximos pasos

mercadopago.conexion.sincronizar: la tool que escribe los datos que esta lectura devuelve.
Sincronizar y consultar: por qué leer datos reales son dos pasos.