# 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.
{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}
| | |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID** | `mercadopago.egresos.consultar_v2` |
| **Nombre MCP** | `mercadopago__egresos__consultar_v2` |
| **Conector** | `mercadopago` |
| **Plano** | `action` |
| **Lee el alcance** | `egresos` (debe estar habilitado en la conexión) |
| **Scope (permiso)** | `mercadopago:read` |
| **Auth** | `none` |
| **Versión** | `2` |
| **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]
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.
## Entrada [#entrada]
| Campo | Tipo | Requerido | Descripción |
| ------------- | ------------------------------------------------------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `desde` | string `^\d{4}-\d{2}-\d{2}$` | no | Primer día (AAAA-MM-DD, por fecha de la operación en hora de Chile). Omítelo para no filtrar. |
| `hasta` | string `^\d{4}-\d{2}-\d{2}$` | no | Último día, incluido (AAAA-MM-DD, por fecha de la operación en hora de Chile). Omítelo para no filtrar. |
| `tipo` | `"retiro_bancario"` · `"retiro_bancario_cancelado"` · `"retiro_efectivo"` | no | Trae sólo ese tipo. Omítelo para ver todos. |
| `operacionId` | string `^[0-9A-Za-z][0-9A-Za-z_-]{0,99}$` | no | Trae sólo esa operación, por su id de Mercado Pago (texto). |
| `cursor` | string | no | Puntero opaco a la página siguiente. Reenvía tal cual el 'cursor' que devolvió la llamada anterior; nunca lo construyas a mano. Omítelo para pedir la primera página. |
| `limit` | entero 1-500 | no · default `100` | Cuántas filas trae la página, entre 1 y 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 (AAAA-MM-DD, por fecha de la operación en hora de Chile). Omítelo para no filtrar.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"x-emisso-formato": "AAAA-MM-DD"
},
"hasta": {
"description": "Último día, incluido (AAAA-MM-DD, por fecha de la operación en hora de Chile). Omítelo para no filtrar.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"x-emisso-formato": "AAAA-MM-DD"
},
"tipo": {
"description": "Trae sólo ese tipo. Omítelo para ver todos.",
"type": "string",
"enum": [
"retiro_bancario",
"retiro_bancario_cancelado",
"retiro_efectivo"
]
},
"operacionId": {
"description": "Trae sólo esa operación, por su id de Mercado Pago (texto).",
"type": "string",
"pattern": "^[0-9A-Za-z][0-9A-Za-z_-]{0,99}$"
},
"cursor": {
"description": "Puntero opaco a la página siguiente. Reenvía tal cual el 'cursor' que devolvió la llamada anterior; nunca lo construyas a mano. Omítelo para pedir la primera página.",
"type": "string"
},
"limit": {
"default": 100,
"description": "Cuántas filas trae la página, entre 1 y 500. Por omisión, 100.",
"type": "integer",
"minimum": 1,
"maximum": 500
}
}
}
```
## Salida [#salida]
| Campo | Tipo | Requerido | Descripción | |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `egresos` | lista de objeto | sí | Los retiros y cancelaciones de retiro guardados, del más nuevo al más antiguo por fecha de la operación. | |
| `egresos[].operacionId` | string | sí | El id de la operación en Mercado Pago (columna SOURCE\_ID del reporte), como texto: no lo conviertas a número. | |
| `egresos[].tipo` | `"retiro_bancario"` · `"retiro_bancario_cancelado"` · `"retiro_efectivo"` | sí | 'retiro\_bancario': transferencia a una cuenta bancaria. 'retiro\_bancario\_cancelado': la CANCELACIÓN de una de esas transferencias; es otra operación, no borra la original ni es un reembolso de un cobro. 'retiro\_efectivo': retiro de dinero en efectivo. Un retiro mueve fondos de la cuenta: Mercado Pago no informa si el destino es propio, así que no lo trates como un gasto. | |
| `egresos[].tipoMercadoPago` | string | sí | El tipo tal como lo nombra el reporte (WITHDRAWAL, WITHDRAWAL\_CANCEL, PAYOUT o PAYOUTS). | |
| `egresos[].moneda` | string | sí | La moneda de la operación (ISO 4217) según el reporte. Siempre presente. | |
| `egresos[].monto` | string | sí | El importe de la operación según el reporte, con el signo que trae el reporte, en decimal como texto (por ejemplo "15990" o "1250.5") y en la moneda de 'moneda'. No lo sumes con importes de otra moneda. | |
| `egresos[].montoNeto` | string | null | sí | El importe neto que impactó el saldo según el reporte, con su signo, en decimal como texto y en la moneda de 'moneda'. null cuando Mercado Pago no lo informó: null NO es cero. |
| `egresos[].monedaLiquidacion` | string | null | sí | La moneda del neto según el reporte. null si no vino. |
| `egresos[].comision` | string | null | sí | Las comisiones de la operación según el reporte, con su signo; no atribuyas una moneda que el reporte no identifica para este campo, en decimal como texto y en la moneda de 'moneda'. null cuando Mercado Pago no lo informó: null NO es cero. |
| `egresos[].fechaOperacion` | string | sí | Cuándo se originó la operación (ISO 8601, UTC). | |
| `egresos[].fechaLiquidacion` | string | null | sí | Cuándo se liquidó según el reporte (ISO 8601, UTC). null si Mercado Pago no la informó. |
| `egresos[].medioPago` | string | null | sí | El medio según el reporte. null si no vino. |
| `egresos[].tipoMedioPago` | string | null | sí | El tipo de medio según el reporte. null si no vino. |
| `egresos[].referenciaExterna` | string | null | sí | La referencia de la operación según el reporte, tal cual. Puede no existir. |
| `egresos[].conflicto` | booleano | sí | true si OTRO reporte trajo esta misma operación con moneda, importe o fecha distintos. Se conservan los datos primeros; no los uses para conciliar sin revisar en Mercado Pago. | |
| `egresos[].reporteId` | string | sí | El id del reporte de Mercado Pago del que sale la versión guardada (el más nuevo que la trajo). | |
| `egresos[].reporteCreadoEn` | string | sí | Cuándo generó Mercado Pago ese reporte (ISO 8601). | |
| `egresos[].sincronizadoEn` | string | sí | Cuándo guardó Connect esta versión (ISO 8601). | |
| `cobertura` | objeto | sí | Qué respalda la lista. Los retiros salen SOLO de los reportes «Todas las transacciones» que ya existen en la cuenta: Connect puede configurar y generar reportes con tu autorización en el panel. Una lista vacía, una búsqueda sin reportes o 'sin\_acceso' NO prueban que no haya retiros, y esto no es una cartola completa. | |
| `cobertura.busqueda` | objeto | sí | Estado de la última búsqueda de reportes, independiente de su descarga y lectura. | |
| `cobertura.busqueda.estado` | `"nunca"` · `"completa"` · `"parcial"` · `"sin_acceso"` · `"error_transitorio"` | sí | Cómo terminó la última búsqueda de reportes. 'nunca': aún no se sincronizó este módulo. 'sin\_acceso': Mercado Pago no dejó listar reportes con esta autorización. | |
| `cobertura.busqueda.realizadaEn` | string | null | sí | Cuándo se buscaron reportes por última vez (ISO 8601). |
| `cobertura.busqueda.reportesListados` | entero | sí | Cuántos reportes listó esa búsqueda. | |
| `cobertura.reportes` | objeto | sí | Cantidad de reportes conocidos según su estado de lectura; incluye ejecuciones anteriores. | |
| `cobertura.reportes.procesados` | entero | sí | Reportes leídos enteros. | |
| `cobertura.reportes.parciales` | entero | sí | Reportes leídos con filas ilegibles. | |
| `cobertura.reportes.pendientes` | entero | sí | Reportes que se reintentan en la próxima sincronización. | |
| `cobertura.reportes.noUsados` | entero | sí | Reportes que no se pudieron usar (formato, cuenta, moneda, conflicto, vacío). | |
| `cobertura.periodosLeidos` | lista de objeto | sí | Los períodos de los reportes leídos enteros, unidos. Fuera de ellos no se acredita lectura completa de un reporte; puede haber filas de reportes parciales. Dentro, la lista refleja lo que traían esos reportes: si la cuenta los configuró sin retiros, no aparecen. | |
| `cobertura.periodosLeidos[].desde` | string | sí | Inicio (ISO 8601). | |
| `cobertura.periodosLeidos[].hasta` | string | sí | Fin (ISO 8601). | |
| `cobertura.ultimosReportes` | lista de objeto | sí | Los reportes más recientes que vio Connect (hasta 20), con lo que pasó con cada uno. | |
| `cobertura.ultimosReportes[].reporteId` | string | sí | El id del reporte en Mercado Pago. | |
| `cobertura.ultimosReportes[].periodoDesde` | string | null | sí | Inicio del período que dice cubrir el reporte (ISO 8601). null si no vino. |
| `cobertura.ultimosReportes[].periodoHasta` | string | null | sí | Fin del período que dice cubrir el reporte (ISO 8601). null si no vino. |
| `cobertura.ultimosReportes[].creadoEn` | string | null | sí | Cuándo lo generó Mercado Pago (ISO 8601). |
| `cobertura.ultimosReportes[].formato` | string | null | sí | El formato que informa Mercado Pago ('CSV', 'XLSX'). |
| `cobertura.ultimosReportes[].estado` | `"listado"` · `"pendiente_proveedor"` · `"error_transitorio"` · `"sin_acceso"` · `"procesado"` · `"parcial"` · … | sí | Qué hizo Connect con él. 'procesado': leído entero. 'parcial': leído con filas ilegibles. 'listado', 'pendiente\_proveedor', 'error\_transitorio' o 'sin\_acceso': se reintenta. 'no\_soportado' (por ejemplo XLSX o encabezados traducidos), 'conflicto', 'cuenta\_ajena', 'moneda\_distinta', 'demasiado\_grande' o 'vacio': no se usó. | |
| `cobertura.ultimosReportes[].motivo` | string | null | sí | Código del motivo cuando no quedó 'procesado' (por ejemplo 'xlsx' o 'columnas\_faltantes'). |
| `cobertura.ultimosReportes[].retiros` | entero | sí | Filas de retiro o cancelación que traía el archivo leído. | |
| `cursor` | string | null | sí | Puntero a la página siguiente. Si viene distinto de null hay más filas: vuelve a llamar reenviándolo tal cual en 'cursor'. Un null significa que no queda nada por traer. |
| `estado` | `"ok"` · `"partial"` · `"omitted"` | sí | omitted sólo con búsqueda completa sin lectura útil y sin autorización vigente; revisa motivo y gestionReportes. partial nunca acredita cero retiros. | |
| `motivo` | `"falta_autorizar"` | null | sí | falta\_autorizar cuando la lectura quedó omitida por ausencia de consentimiento; null en los demás resultados. |
| `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. |
JSON Schema de salida
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"egresos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"operacionId": {
"type": "string",
"description": "El id de la operación en Mercado Pago (columna SOURCE_ID del reporte), como texto: no lo conviertas a número."
},
"tipo": {
"type": "string",
"enum": [
"retiro_bancario",
"retiro_bancario_cancelado",
"retiro_efectivo"
],
"description": "'retiro_bancario': transferencia a una cuenta bancaria. 'retiro_bancario_cancelado': la CANCELACIÓN de una de esas transferencias; es otra operación, no borra la original ni es un reembolso de un cobro. 'retiro_efectivo': retiro de dinero en efectivo. Un retiro mueve fondos de la cuenta: Mercado Pago no informa si el destino es propio, así que no lo trates como un gasto."
},
"tipoMercadoPago": {
"type": "string",
"description": "El tipo tal como lo nombra el reporte (WITHDRAWAL, WITHDRAWAL_CANCEL, PAYOUT o PAYOUTS)."
},
"moneda": {
"type": "string",
"description": "La moneda de la operación (ISO 4217) según el reporte. Siempre presente."
},
"monto": {
"type": "string",
"description": "El importe de la operación según el reporte, con el signo que trae el reporte, en decimal como texto (por ejemplo \"15990\" o \"1250.5\") y en la moneda de 'moneda'. No lo sumes con importes de otra moneda."
},
"montoNeto": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "El importe neto que impactó el saldo según el reporte, con su signo, en decimal como texto y en la moneda de 'moneda'. null cuando Mercado Pago no lo informó: null NO es cero."
},
"monedaLiquidacion": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "La moneda del neto según el reporte. null si no vino."
},
"comision": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Las comisiones de la operación según el reporte, con su signo; no atribuyas una moneda que el reporte no identifica para este campo, en decimal como texto y en la moneda de 'moneda'. null cuando Mercado Pago no lo informó: null NO es cero."
},
"fechaOperacion": {
"type": "string",
"description": "Cuándo se originó la operación (ISO 8601, UTC)."
},
"fechaLiquidacion": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Cuándo se liquidó según el reporte (ISO 8601, UTC). null si Mercado Pago no la informó."
},
"medioPago": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "El medio según el reporte. null si no vino."
},
"tipoMedioPago": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "El tipo de medio según el reporte. null si no vino."
},
"referenciaExterna": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "La referencia de la operación según el reporte, tal cual. Puede no existir."
},
"conflicto": {
"type": "boolean",
"description": "true si OTRO reporte trajo esta misma operación con moneda, importe o fecha distintos. Se conservan los datos primeros; no los uses para conciliar sin revisar en Mercado Pago."
},
"reporteId": {
"type": "string",
"description": "El id del reporte de Mercado Pago del que sale la versión guardada (el más nuevo que la trajo)."
},
"reporteCreadoEn": {
"type": "string",
"description": "Cuándo generó Mercado Pago ese reporte (ISO 8601)."
},
"sincronizadoEn": {
"type": "string",
"description": "Cuándo guardó Connect esta versión (ISO 8601)."
}
},
"required": [
"operacionId",
"tipo",
"tipoMercadoPago",
"moneda",
"monto",
"montoNeto",
"monedaLiquidacion",
"comision",
"fechaOperacion",
"fechaLiquidacion",
"medioPago",
"tipoMedioPago",
"referenciaExterna",
"conflicto",
"reporteId",
"reporteCreadoEn",
"sincronizadoEn"
],
"additionalProperties": false
},
"description": "Los retiros y cancelaciones de retiro guardados, del más nuevo al más antiguo por fecha de la operación."
},
"cobertura": {
"type": "object",
"properties": {
"busqueda": {
"type": "object",
"properties": {
"estado": {
"type": "string",
"enum": [
"nunca",
"completa",
"parcial",
"sin_acceso",
"error_transitorio"
],
"description": "Cómo terminó la última búsqueda de reportes. 'nunca': aún no se sincronizó este módulo. 'sin_acceso': Mercado Pago no dejó listar reportes con esta autorización."
},
"realizadaEn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Cuándo se buscaron reportes por última vez (ISO 8601)."
},
"reportesListados": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Cuántos reportes listó esa búsqueda."
}
},
"required": [
"estado",
"realizadaEn",
"reportesListados"
],
"additionalProperties": false,
"description": "Estado de la última búsqueda de reportes, independiente de su descarga y lectura."
},
"reportes": {
"type": "object",
"properties": {
"procesados": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Reportes leídos enteros."
},
"parciales": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Reportes leídos con filas ilegibles."
},
"pendientes": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Reportes que se reintentan en la próxima sincronización."
},
"noUsados": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Reportes que no se pudieron usar (formato, cuenta, moneda, conflicto, vacío)."
}
},
"required": [
"procesados",
"parciales",
"pendientes",
"noUsados"
],
"additionalProperties": false,
"description": "Cantidad de reportes conocidos según su estado de lectura; incluye ejecuciones anteriores."
},
"periodosLeidos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"desde": {
"type": "string",
"description": "Inicio (ISO 8601)."
},
"hasta": {
"type": "string",
"description": "Fin (ISO 8601)."
}
},
"required": [
"desde",
"hasta"
],
"additionalProperties": false
},
"description": "Los períodos de los reportes leídos enteros, unidos. Fuera de ellos no se acredita lectura completa de un reporte; puede haber filas de reportes parciales. Dentro, la lista refleja lo que traían esos reportes: si la cuenta los configuró sin retiros, no aparecen."
},
"ultimosReportes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"reporteId": {
"type": "string",
"description": "El id del reporte en Mercado Pago."
},
"periodoDesde": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Inicio del período que dice cubrir el reporte (ISO 8601). null si no vino."
},
"periodoHasta": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Fin del período que dice cubrir el reporte (ISO 8601). null si no vino."
},
"creadoEn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Cuándo lo generó Mercado Pago (ISO 8601)."
},
"formato": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "El formato que informa Mercado Pago ('CSV', 'XLSX')."
},
"estado": {
"type": "string",
"enum": [
"listado",
"pendiente_proveedor",
"error_transitorio",
"sin_acceso",
"procesado",
"parcial",
"conflicto",
"cuenta_ajena",
"moneda_distinta",
"no_soportado",
"demasiado_grande",
"vacio"
],
"description": "Qué hizo Connect con él. 'procesado': leído entero. 'parcial': leído con filas ilegibles. 'listado', 'pendiente_proveedor', 'error_transitorio' o 'sin_acceso': se reintenta. 'no_soportado' (por ejemplo XLSX o encabezados traducidos), 'conflicto', 'cuenta_ajena', 'moneda_distinta', 'demasiado_grande' o 'vacio': no se usó."
},
"motivo": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Código del motivo cuando no quedó 'procesado' (por ejemplo 'xlsx' o 'columnas_faltantes')."
},
"retiros": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Filas de retiro o cancelación que traía el archivo leído."
}
},
"required": [
"reporteId",
"periodoDesde",
"periodoHasta",
"creadoEn",
"formato",
"estado",
"motivo",
"retiros"
],
"additionalProperties": false
},
"description": "Los reportes más recientes que vio Connect (hasta 20), con lo que pasó con cada uno."
}
},
"required": [
"busqueda",
"reportes",
"periodosLeidos",
"ultimosReportes"
],
"additionalProperties": false,
"description": "Qué respalda la lista. Los retiros salen SOLO de los reportes «Todas las transacciones» que ya existen en la cuenta: Connect puede configurar y generar reportes con tu autorización en el panel. Una lista vacía, una búsqueda sin reportes o 'sin_acceso' NO prueban que no haya retiros, y esto no es una cartola completa."
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Puntero a la página siguiente. Si viene distinto de null hay más filas: vuelve a llamar reenviándolo tal cual en 'cursor'. Un null significa que no queda nada por traer."
},
"estado": {
"type": "string",
"enum": [
"ok",
"partial",
"omitted"
],
"description": "omitted sólo con búsqueda completa sin lectura útil y sin autorización vigente; revisa motivo y gestionReportes. partial nunca acredita cero retiros."
},
"motivo": {
"anyOf": [
{
"type": "string",
"enum": [
"falta_autorizar"
]
},
{
"type": "null"
}
],
"description": "falta_autorizar cuando la lectura quedó omitida por ausencia de consentimiento; null en los demás resultados."
},
"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."
}
},
"required": [
"egresos",
"cobertura",
"cursor",
"estado",
"motivo",
"gestionReportes"
],
"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.