# 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.
{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}
| | |
| ------------------- | ------------------------------------------------------------------ |
| **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`](/docs/referencia/conexiones/estado-consultar).
## Qué hace [#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 [#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
```json
{
"$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 [#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í | 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. |
| `movimientos[].monedaLiquidacion` | string | null | sí | Moneda ISO 4217 del monto neto. null si no fue informada; no se infiere desde el bruto. |
| `movimientos[].comision` | string | null | sí | 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. |
| `movimientos[].impuestos` | string | null | sí | 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. |
| `movimientos[].montoReal` | string | null | sí | 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. |
| `movimientos[].comisionMarketplace` | string | null | sí | 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. |
| `movimientos[].costoFinanciamiento` | string | null | sí | 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. |
| `movimientos[].costoEnvio` | string | null | sí | 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. |
| `movimientos[].cupon` | string | null | sí | 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. |
| `movimientos[].propina` | string | null | sí | 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. |
| `movimientos[].montoVendedor` | string | null | sí | 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. |
| `movimientos[].fechaOperacion` | string | sí | Creación de la operación, instante ISO 8601 en UTC. | |
| `movimientos[].fechaAprobacion` | string | null | sí | Aprobación de la operación, instante ISO 8601 en UTC. null si no fue informado. |
| `movimientos[].fechaLiberacionPrevista` | string | null | sí | Liberación prevista del dinero; no acredita liberación efectiva, instante ISO 8601 en UTC. null si no fue informado. |
| `movimientos[].fechaLiquidacion` | string | null | sí | Liquidación efectiva; null mientras no haya una fuente que la acredite, instante ISO 8601 en UTC. null si no fue informado. |
| `movimientos[].liberado` | booleano | null | sí | Indicación del proveedor de si el dinero fue liberado; null si no se informó. |
| `movimientos[].medioPago` | string | null | sí | Medio de pago informado; null si no vino. |
| `movimientos[].tipoMedioPago` | string | null | sí | Tipo del medio de pago informado; null si no vino. |
| `movimientos[].referenciaExterna` | string | null | sí | Referencia externa informada; puede estar ausente. |
| `movimientos[].descripcion` | string | null | sí | Descripción de la operación informada por Mercado Pago. |
| `movimientos[].etiquetas` | string | null | sí | Etiquetas informadas, conservadas como texto; no se usan para inferir un tipo no comprobado. |
| `movimientos[].detalleImpuestos` | string | null | sí | Detalle de los impuestos informados, conservado como texto. |
| `movimientos[].ordenId` | string | null | sí | ID externo de la orden, como texto; null si no vino. |
| `movimientos[].compraId` | string | null | sí | ID externo de la compra, como texto; null si no vino. |
| `movimientos[].paqueteId` | string | null | sí | ID externo del paquete, como texto; null si no vino. |
| `movimientos[].envioId` | string | null | sí | ID externo del envío, como texto; null si no vino. |
| `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í | Última búsqueda de comprobantes, instante ISO 8601 en UTC. null si no fue informado. |
| `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í | Código del motivo observado; null si no hubo inconvenientes. |
| `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í | Por qué hace falta una acción humana. null cuando no se necesita ninguna. |
| `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í | Ruta relativa al panel de reportes de esta conexión. null si la capacidad no está habilitada y no existe permiso vigente que revocar. |
| `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í | Última solicitud diaria observada. null si no existe; no promete datos tras un plazo fijo. |
| `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í | Cursor opaco para continuar la página. null indica fin de esta consulta, no cobertura financiera completa. |
JSON Schema de salida
```json
{
"$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 [#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](/docs/referencia/errores).
## Próximos pasos [#próximos-pasos]
* [`mercadopago.conexion.sincronizar`](/docs/referencia/mercadopago/conexion-sincronizar): la tool que escribe los datos que esta lectura devuelve.
* [Sincronizar y consultar](/docs/conceptos/sincronizar-consultar): por qué leer datos reales son dos pasos.