# Consultar la cartola de Mercado Pago > Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar. {/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */} | | | | ------------------- | ------------------------------------------------------------------ | | **Tool ID** | `mercadopago.movimientos.consultar_v2` | | **Nombre MCP** | `mercadopago__movimientos__consultar_v2` | | **Conector** | `mercadopago` | | **Plano** | `action` | | **Lee el alcance** | `movimientos` (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] Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. Consulta la cartola guardada de un período: movimientos con retiros incluidos una vez, cobertura y huecos del período, netos por moneda, saldos disponibles oficiales y control mensual. Sin autorización de saldo es una cartola sin saldo: los saldos son null con saldo\_no\_habilitado. El neto de movimientos no es un saldo y el saldo total no está disponible. Requiere movimientos habilitado. Sólo lee datos guardados; para traer datos usa mercadopago.conexion.sincronizar\_v2 con movimientos. ## Entrada [#entrada] | Campo | Tipo | Requerido | Descripción | | ------------------- | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------- | ---------------------------------------------------------------------------------------- | | `desde` | string `^\d{4}-\d{2}-\d{2}$` | sí | Primer día del período, AAAA-MM-DD en America/Santiago. | | `hasta` | string `^\d{4}-\d{2}-\d{2}$` | sí | Último día incluido, AAAA-MM-DD en America/Santiago; a lo más 366 días después de desde. | | `ejeTemporal` | `"operacion"` | no · default `"operacion"` | Eje de fechas del período: fecha de operación. | | `tipo` | `"operacion_aprobada"` · `"devolucion"` · `"contracargo"` · `"reclamo"` · `"retiro_bancario"` · `"retiro_bancario_cancelado"` · … | no | Filtra por la clasificación de Emisso. No cambia el alcance del control de saldo. | | `tipoMercadoPago` | string `^[A-Z_]{1,40}$` | no | Filtra por el código original de Mercado Pago. | | `operacionId` | string `^[0-9A-Za-z][0-9A-Za-z_-]{0,99}$` | no | Filtra por el ID externo de una operación, siempre texto. | | `monedaLiquidacion` | string `^[A-Z]{3}$` | no | Moneda ISO 4217 del neto por la que quieres filtrar. | | `cursor` | string | no | Cursor de la página anterior con los mismos filtros; 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": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "x-emisso-formato": "AAAA-MM-DD", "description": "Primer día del período, AAAA-MM-DD en America/Santiago." }, "hasta": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "x-emisso-formato": "AAAA-MM-DD", "description": "Último día incluido, AAAA-MM-DD en America/Santiago; a lo más 366 días después de desde." }, "ejeTemporal": { "default": "operacion", "description": "Eje de fechas del período: fecha de operación.", "type": "string", "enum": [ "operacion" ] }, "tipo": { "description": "Filtra por la clasificación de Emisso. No cambia el alcance del control de saldo.", "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.", "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}$" }, "monedaLiquidacion": { "description": "Moneda ISO 4217 del neto por la que quieres filtrar.", "type": "string", "pattern": "^[A-Z]{3}$" }, "cursor": { "description": "Cursor de la página anterior con los mismos filtros; 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 } }, "required": [ "desde", "hasta" ] } ```
## Salida [#salida] | Campo | Tipo | Requerido | Descripción | | | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `movimientos` | lista de objeto | sí | Movimientos del período, 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 Emisso, instante ISO 8601 en UTC. | | | `movimientos[].fechaDisponible` | string | null | sí | Instante ISO 8601 UTC en que la operación afectó el saldo disponible. null mientras no esté acreditado; no es fechaLiberacionPrevista. | | `movimientos[].efectoDisponible` | `"verificado"` · `"no_verificado"` | sí | verificado sólo con evidencia de cuándo la operación afectó el saldo disponible. | | | `cobertura` | objeto | sí | Cobertura del período pedido. | | | `cobertura.desde` | string `^\d{4}-\d{2}-\d{2}$` | sí | Primer día pedido, AAAA-MM-DD de America/Santiago. | | | `cobertura.hasta` | string `^\d{4}-\d{2}-\d{2}$` | sí | Último día pedido e incluido, AAAA-MM-DD de America/Santiago. | | | `cobertura.ejeTemporal` | `"operacion"` | sí | Eje de las fechas pedidas: fecha de operación en America/Santiago. | | | `cobertura.revision` | entero | sí | Revisión de los datos guardados usada en esta respuesta y en su cursor. | | | `cobertura.evaluadaEn` | string | null | sí | Última evaluación guardada de la cobertura, instante ISO 8601 UTC; null si nunca se evaluó. | | `cobertura.completa` | booleano | sí | true sólo si todo el período pedido está acreditado en el eje pedido. Se refiere a este período, no a toda la cuenta ni a la página. | | | `cobertura.intervalosLeidos` | lista de objeto | sí | Intervalos de comprobantes leídos con identidad comprobada, recortados al período. Acreditan la selección del comprobante; por sí solos no prueban la fecha de operación. | | | `cobertura.intervalosLeidos[].desde` | string | sí | Inicio, instante ISO 8601 UTC incluido. | | | `cobertura.intervalosLeidos[].hasta` | string | sí | Fin, instante ISO 8601 UTC excluido. | | | `cobertura.huecos` | lista de objeto | sí | Partes del período sin acreditar y su motivo. Un hueco no significa cero movimientos. | | | `cobertura.huecos[].desde` | string | sí | Inicio, instante ISO 8601 UTC incluido. | | | `cobertura.huecos[].hasta` | string | sí | Fin, instante ISO 8601 UTC excluido. | | | `cobertura.huecos[].motivo` | `"falta_autorizacion"` · `"configuracion_requiere_revision"` · `"periodo_incompleto"` · `"informacion_insuficiente"` · `"archivo_no_disponible"` · `"identidad_no_verificada"` · … | sí | Qué falta para acreditar el dato. falta\_autorizacion se resuelve en la pestaña Retiros de la conexión y saldo\_no\_habilitado en Ajustes; periodo\_incompleto y saldo\_sin\_referencia esperan nuevas lecturas; fechas\_no\_comparables indica que aún no hay fechas en que cada operación afectó el saldo disponible. | | | `totales` | lista de objeto | sí | Netos de todas las filas del filtro por moneda, no sólo de la página. | | | `totales[].monedaLiquidacion` | string | null | sí | Moneda ISO 4217 del neto; null para filas sin moneda informada. | | `totales[].neto` | string | null | sí | Suma decimal exacta en texto de montoNeto de todas las filas del filtro, sin las que están en conflicto. Es una variación de operaciones, no un saldo. | | `totales[].filas` | entero | sí | Filas del filtro en esta moneda, en todas las páginas. | | | `totales[].sinNeto` | entero | sí | Filas sin neto informado; no se suman como cero. | | | `totales[].enConflicto` | entero | sí | Filas con datos financieros contradictorios, excluidas de la suma. | | | `totales[].parcial` | booleano | sí | true si faltan netos, hay conflictos o la cobertura del período no está completa. | | | `saldos` | objeto | sí | Saldos de la cuenta según referencias oficiales guardadas. | | | `saldos.habilitado` | booleano | sí | La autorización de saldo está vigente. false: cartola sin saldo; los importes son null. | | | `saldos.motivo` | `"falta_autorizacion"` · `"configuracion_requiere_revision"` · `"periodo_incompleto"` · `"informacion_insuficiente"` · `"archivo_no_disponible"` · `"identidad_no_verificada"` · … | null | sí | Por qué falta un saldo; null si hay referencias. | | `saldos.inicioHistoria` | string | null | sí | Corte del inicio de la historia cargada, instante ISO 8601 UTC (00:00 GMT-03). Nunca la fecha de autorización. | | `saldos.ancla` | objeto | sí | Saldo disponible al inicio de la historia. | | | `saldos.ancla.estado` | `"comprobada"` · `"pendiente"` · `"conflicto"` · `"no_habilitada"` | sí | comprobada: hay un saldo disponible oficial exactamente en inicioHistoria. | | | `saldos.ancla.corte` | string | null | sí | Instante ISO 8601 UTC del ancla. | | `saldos.ancla.importe` | string | null | sí | Saldo disponible en el ancla, decimal en texto. null sin referencia acreditada; no equivale a cero. | | `saldos.ancla.moneda` | string | null | sí | Moneda ISO 4217 del ancla. | | `saldos.total` | objeto | sí | Saldo total, que incluiría dinero retenido o por liberar. No se obtiene sumando movimientos. | | | `saldos.total.importe` | null | sí | Siempre null: no hay una fuente independiente del saldo total. | | | `saldos.total.motivo` | string | sí | No hay una fuente independiente del saldo total. | | | `saldos.disponibleAlCorte` | objeto | null | sí | Último saldo disponible oficial hasta el fin del período. No se arrastra como saldo de hoy. | | `saldos.disponibleAlCorte.moneda` | string | sí | Moneda ISO 4217. | | | `saldos.disponibleAlCorte.corte` | string | sí | Instante ISO 8601 UTC del corte, no hoy. | | | `saldos.disponibleAlCorte.importe` | string | sí | Saldo disponible oficial en ese corte, decimal en texto. | | | `saldos.disponibleAlCorte.fuente` | string | sí | Reporte de dinero liberado de Mercado Pago. | | | `saldos.tramos` | lista de objeto | sí | Tramos con saldo acreditado; un tramo posterior no sana un hueco anterior. | | | `saldos.tramos[].moneda` | string | sí | Moneda ISO 4217. | | | `saldos.tramos[].desde` | string | sí | Inicio del tramo, instante ISO 8601 UTC. | | | `saldos.tramos[].ancla` | objeto | sí | Saldo oficial con que parte el tramo. | | | `saldos.tramos[].inicial` | booleano | sí | El tramo parte en inicioHistoria. | | | `saldos.tramos[].continuidad` | `"solo_corte"` · `"continua"` · `"interrumpida"` | sí | solo\_corte: el saldo está acreditado en el corte, pero no se calcula después. | | | `saldos.tramos[].saldoDiario` | `"no_verificable"` · `"calculado"` · `"comprobado"` | sí | no\_verificable: no hay saldo diario; no se rellena con ceros ni con el último corte. | | | `saldos.evaluadaEn` | string | null | sí | Evaluación guardada usada, instante ISO 8601 UTC. | | `conciliacionSaldo` | lista de objeto | sí | Un control por mes del período pedido. | | | `conciliacionSaldo[].moneda` | string | null | sí | Moneda ISO 4217 verificada; null sin saldo habilitado. | | `conciliacionSaldo[].periodo` | string | sí | Mes AAAA-MM del calendario de los reportes (GMT-03). | | | `conciliacionSaldo[].desde` | string | sí | Inicio del control, instante ISO 8601 UTC. | | | `conciliacionSaldo[].hasta` | string | sí | Fin del control, instante ISO 8601 UTC excluido. | | | `conciliacionSaldo[].estado` | `"no_verificado"` · `"pendiente"` · `"no_comparable"` · `"cuadrado"` · `"descuadrado"` | sí | Resultado del control mensual de TODA la cuenta, aunque filtres la página. no\_comparable no es un descuadre; pendiente espera el cierre mensual. | | | `conciliacionSaldo[].motivo` | `"falta_autorizacion"` · `"configuracion_requiere_revision"` · `"periodo_incompleto"` · `"informacion_insuficiente"` · `"archivo_no_disponible"` · `"identidad_no_verificada"` · … | null | sí | Por qué el control no está cuadrado; null si no aplica. | | `conciliacionSaldo[].disponibleInicial` | string | null | sí | Saldo disponible oficial al inicio, decimal en texto. null sin referencia acreditada; no equivale a cero. | | `conciliacionSaldo[].disponibleFinal` | string | null | sí | Saldo disponible oficial al fin, decimal en texto. null sin referencia acreditada; no equivale a cero. | | `conciliacionSaldo[].variacionDisponible` | string | null | sí | disponibleFinal menos disponibleInicial, decimal en texto. null sin referencia acreditada; no equivale a cero. | | `conciliacionSaldo[].variacionEfectiva` | string | null | sí | Variación reconstruida desde operaciones con fecha efectiva, decimal en texto. null sin referencia acreditada; no equivale a cero. | | `conciliacionSaldo[].diferencia` | string | null | sí | Diferencia entre ambas variaciones; sólo con magnitudes comparables, decimal en texto. null sin referencia acreditada; no equivale a cero. | | `conciliacionSaldo[].comprobadoEn` | string | null | sí | Evaluación guardada de este control, instante ISO 8601 UTC. | | `gestionReportes` | objeto | sí | Autorización y próxima acción en el panel; no expone configuración técnica. | | | `gestionReportes.autorizacion` | `"vigente"` · `"sin_autorizar"` · `"revocada"` | sí | Autorización de reportes de la conexión. | | | `gestionReportes.saldoHabilitado` | booleano | sí | Autorización vigente para comprobar el saldo. | | | `gestionReportes.accionHumana` | `"ninguna"` · `"autorizar_reportes"` · `"ampliar_saldo"` · `"revisar_reportes"` | sí | Próxima acción de un dueño o administrador en el panel: autorizar\_reportes en la pestaña Retiros; ampliar\_saldo (opcional) y revisar\_reportes en Ajustes. | | | `gestionReportes.ruta` | string | null | sí | Enlace a Ajustes de la conexión. | | `cursor` | string | null | sí | Cursor opaco ligado a filtros y revisión. null indica fin de esta consulta. |
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 Emisso, instante ISO 8601 en UTC." }, "fechaDisponible": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Instante ISO 8601 UTC en que la operación afectó el saldo disponible. null mientras no esté acreditado; no es fechaLiberacionPrevista." }, "efectoDisponible": { "type": "string", "enum": [ "verificado", "no_verificado" ], "description": "verificado sólo con evidencia de cuándo la operación afectó el saldo disponible." } }, "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", "fechaDisponible", "efectoDisponible" ], "additionalProperties": false }, "description": "Movimientos del período, del más nuevo al más antiguo, con retiros incluidos una sola vez." }, "cobertura": { "type": "object", "properties": { "desde": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "x-emisso-formato": "AAAA-MM-DD", "description": "Primer día pedido, AAAA-MM-DD de America/Santiago." }, "hasta": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "x-emisso-formato": "AAAA-MM-DD", "description": "Último día pedido e incluido, AAAA-MM-DD de America/Santiago." }, "ejeTemporal": { "type": "string", "enum": [ "operacion" ], "description": "Eje de las fechas pedidas: fecha de operación en America/Santiago." }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991, "description": "Revisión de los datos guardados usada en esta respuesta y en su cursor." }, "evaluadaEn": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Última evaluación guardada de la cobertura, instante ISO 8601 UTC; null si nunca se evaluó." }, "completa": { "type": "boolean", "description": "true sólo si todo el período pedido está acreditado en el eje pedido. Se refiere a este período, no a toda la cuenta ni a la página." }, "intervalosLeidos": { "type": "array", "items": { "type": "object", "properties": { "desde": { "type": "string", "description": "Inicio, instante ISO 8601 UTC incluido." }, "hasta": { "type": "string", "description": "Fin, instante ISO 8601 UTC excluido." } }, "required": [ "desde", "hasta" ], "additionalProperties": false }, "description": "Intervalos de comprobantes leídos con identidad comprobada, recortados al período. Acreditan la selección del comprobante; por sí solos no prueban la fecha de operación." }, "huecos": { "type": "array", "items": { "type": "object", "properties": { "desde": { "type": "string", "description": "Inicio, instante ISO 8601 UTC incluido." }, "hasta": { "type": "string", "description": "Fin, instante ISO 8601 UTC excluido." }, "motivo": { "type": "string", "enum": [ "falta_autorizacion", "configuracion_requiere_revision", "periodo_incompleto", "informacion_insuficiente", "archivo_no_disponible", "identidad_no_verificada", "datos_en_conflicto", "saldo_sin_referencia", "saldo_no_habilitado", "cadena_saldo_interrumpida", "saldo_total_no_acreditado", "fechas_no_comparables", "moneda_no_comparable", "diferencia_de_saldo" ], "description": "Qué falta para acreditar el dato. falta_autorizacion se resuelve en la pestaña Retiros de la conexión y saldo_no_habilitado en Ajustes; periodo_incompleto y saldo_sin_referencia esperan nuevas lecturas; fechas_no_comparables indica que aún no hay fechas en que cada operación afectó el saldo disponible." } }, "required": [ "desde", "hasta", "motivo" ], "additionalProperties": false }, "description": "Partes del período sin acreditar y su motivo. Un hueco no significa cero movimientos." } }, "required": [ "desde", "hasta", "ejeTemporal", "revision", "evaluadaEn", "completa", "intervalosLeidos", "huecos" ], "additionalProperties": false, "description": "Cobertura del período pedido." }, "totales": { "type": "array", "items": { "type": "object", "properties": { "monedaLiquidacion": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Moneda ISO 4217 del neto; null para filas sin moneda informada." }, "neto": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Suma decimal exacta en texto de montoNeto de todas las filas del filtro, sin las que están en conflicto. Es una variación de operaciones, no un saldo." }, "filas": { "type": "integer", "minimum": 0, "maximum": 9007199254740991, "description": "Filas del filtro en esta moneda, en todas las páginas." }, "sinNeto": { "type": "integer", "minimum": 0, "maximum": 9007199254740991, "description": "Filas sin neto informado; no se suman como cero." }, "enConflicto": { "type": "integer", "minimum": 0, "maximum": 9007199254740991, "description": "Filas con datos financieros contradictorios, excluidas de la suma." }, "parcial": { "type": "boolean", "description": "true si faltan netos, hay conflictos o la cobertura del período no está completa." } }, "required": [ "monedaLiquidacion", "neto", "filas", "sinNeto", "enConflicto", "parcial" ], "additionalProperties": false }, "description": "Netos de todas las filas del filtro por moneda, no sólo de la página." }, "saldos": { "type": "object", "properties": { "habilitado": { "type": "boolean", "description": "La autorización de saldo está vigente. false: cartola sin saldo; los importes son null." }, "motivo": { "anyOf": [ { "type": "string", "enum": [ "falta_autorizacion", "configuracion_requiere_revision", "periodo_incompleto", "informacion_insuficiente", "archivo_no_disponible", "identidad_no_verificada", "datos_en_conflicto", "saldo_sin_referencia", "saldo_no_habilitado", "cadena_saldo_interrumpida", "saldo_total_no_acreditado", "fechas_no_comparables", "moneda_no_comparable", "diferencia_de_saldo" ], "description": "Qué falta para acreditar el dato. falta_autorizacion se resuelve en la pestaña Retiros de la conexión y saldo_no_habilitado en Ajustes; periodo_incompleto y saldo_sin_referencia esperan nuevas lecturas; fechas_no_comparables indica que aún no hay fechas en que cada operación afectó el saldo disponible." }, { "type": "null" } ], "description": "Por qué falta un saldo; null si hay referencias." }, "inicioHistoria": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Corte del inicio de la historia cargada, instante ISO 8601 UTC (00:00 GMT-03). Nunca la fecha de autorización." }, "ancla": { "type": "object", "properties": { "estado": { "type": "string", "enum": [ "comprobada", "pendiente", "conflicto", "no_habilitada" ], "description": "comprobada: hay un saldo disponible oficial exactamente en inicioHistoria." }, "corte": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Instante ISO 8601 UTC del ancla." }, "importe": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Saldo disponible en el ancla, decimal en texto. null sin referencia acreditada; no equivale a cero." }, "moneda": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Moneda ISO 4217 del ancla." } }, "required": [ "estado", "corte", "importe", "moneda" ], "additionalProperties": false, "description": "Saldo disponible al inicio de la historia." }, "total": { "type": "object", "properties": { "importe": { "type": "null", "description": "Siempre null: no hay una fuente independiente del saldo total." }, "motivo": { "type": "string", "const": "saldo_total_no_acreditado", "description": "No hay una fuente independiente del saldo total." } }, "required": [ "importe", "motivo" ], "additionalProperties": false, "description": "Saldo total, que incluiría dinero retenido o por liberar. No se obtiene sumando movimientos." }, "disponibleAlCorte": { "anyOf": [ { "type": "object", "properties": { "moneda": { "type": "string", "description": "Moneda ISO 4217." }, "corte": { "type": "string", "description": "Instante ISO 8601 UTC del corte, no hoy." }, "importe": { "type": "string", "description": "Saldo disponible oficial en ese corte, decimal en texto." }, "fuente": { "type": "string", "const": "reporte_liberaciones", "description": "Reporte de dinero liberado de Mercado Pago." } }, "required": [ "moneda", "corte", "importe", "fuente" ], "additionalProperties": false }, { "type": "null" } ], "description": "Último saldo disponible oficial hasta el fin del período. No se arrastra como saldo de hoy." }, "tramos": { "type": "array", "items": { "type": "object", "properties": { "moneda": { "type": "string", "description": "Moneda ISO 4217." }, "desde": { "type": "string", "description": "Inicio del tramo, instante ISO 8601 UTC." }, "ancla": { "type": "object", "properties": { "corte": { "type": "string", "description": "Instante ISO 8601 UTC." }, "importe": { "type": "string", "description": "Saldo disponible oficial, decimal en texto." } }, "required": [ "corte", "importe" ], "additionalProperties": false, "description": "Saldo oficial con que parte el tramo." }, "inicial": { "type": "boolean", "description": "El tramo parte en inicioHistoria." }, "continuidad": { "type": "string", "enum": [ "solo_corte", "continua", "interrumpida" ], "description": "solo_corte: el saldo está acreditado en el corte, pero no se calcula después." }, "saldoDiario": { "type": "string", "enum": [ "no_verificable", "calculado", "comprobado" ], "description": "no_verificable: no hay saldo diario; no se rellena con ceros ni con el último corte." } }, "required": [ "moneda", "desde", "ancla", "inicial", "continuidad", "saldoDiario" ], "additionalProperties": false }, "description": "Tramos con saldo acreditado; un tramo posterior no sana un hueco anterior." }, "evaluadaEn": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Evaluación guardada usada, instante ISO 8601 UTC." } }, "required": [ "habilitado", "motivo", "inicioHistoria", "ancla", "total", "disponibleAlCorte", "tramos", "evaluadaEn" ], "additionalProperties": false, "description": "Saldos de la cuenta según referencias oficiales guardadas." }, "conciliacionSaldo": { "type": "array", "items": { "type": "object", "properties": { "moneda": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Moneda ISO 4217 verificada; null sin saldo habilitado." }, "periodo": { "type": "string", "description": "Mes AAAA-MM del calendario de los reportes (GMT-03)." }, "desde": { "type": "string", "description": "Inicio del control, instante ISO 8601 UTC." }, "hasta": { "type": "string", "description": "Fin del control, instante ISO 8601 UTC excluido." }, "estado": { "type": "string", "enum": [ "no_verificado", "pendiente", "no_comparable", "cuadrado", "descuadrado" ], "description": "Resultado del control mensual de TODA la cuenta, aunque filtres la página. no_comparable no es un descuadre; pendiente espera el cierre mensual." }, "motivo": { "anyOf": [ { "type": "string", "enum": [ "falta_autorizacion", "configuracion_requiere_revision", "periodo_incompleto", "informacion_insuficiente", "archivo_no_disponible", "identidad_no_verificada", "datos_en_conflicto", "saldo_sin_referencia", "saldo_no_habilitado", "cadena_saldo_interrumpida", "saldo_total_no_acreditado", "fechas_no_comparables", "moneda_no_comparable", "diferencia_de_saldo" ], "description": "Qué falta para acreditar el dato. falta_autorizacion se resuelve en la pestaña Retiros de la conexión y saldo_no_habilitado en Ajustes; periodo_incompleto y saldo_sin_referencia esperan nuevas lecturas; fechas_no_comparables indica que aún no hay fechas en que cada operación afectó el saldo disponible." }, { "type": "null" } ], "description": "Por qué el control no está cuadrado; null si no aplica." }, "disponibleInicial": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Saldo disponible oficial al inicio, decimal en texto. null sin referencia acreditada; no equivale a cero." }, "disponibleFinal": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Saldo disponible oficial al fin, decimal en texto. null sin referencia acreditada; no equivale a cero." }, "variacionDisponible": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "disponibleFinal menos disponibleInicial, decimal en texto. null sin referencia acreditada; no equivale a cero." }, "variacionEfectiva": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Variación reconstruida desde operaciones con fecha efectiva, decimal en texto. null sin referencia acreditada; no equivale a cero." }, "diferencia": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Diferencia entre ambas variaciones; sólo con magnitudes comparables, decimal en texto. null sin referencia acreditada; no equivale a cero." }, "comprobadoEn": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Evaluación guardada de este control, instante ISO 8601 UTC." } }, "required": [ "moneda", "periodo", "desde", "hasta", "estado", "motivo", "disponibleInicial", "disponibleFinal", "variacionDisponible", "variacionEfectiva", "diferencia", "comprobadoEn" ], "additionalProperties": false }, "description": "Un control por mes del período pedido." }, "gestionReportes": { "type": "object", "properties": { "autorizacion": { "type": "string", "enum": [ "vigente", "sin_autorizar", "revocada" ], "description": "Autorización de reportes de la conexión." }, "saldoHabilitado": { "type": "boolean", "description": "Autorización vigente para comprobar el saldo." }, "accionHumana": { "type": "string", "enum": [ "ninguna", "autorizar_reportes", "ampliar_saldo", "revisar_reportes" ], "description": "Próxima acción de un dueño o administrador en el panel: autorizar_reportes en la pestaña Retiros; ampliar_saldo (opcional) y revisar_reportes en Ajustes." }, "ruta": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Enlace a Ajustes de la conexión." } }, "required": [ "autorizacion", "saldoHabilitado", "accionHumana", "ruta" ], "additionalProperties": false, "description": "Autorización y próxima acción en el panel; no expone configuración técnica." }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Cursor opaco ligado a filtros y revisión. null indica fin de esta consulta." } }, "required": [ "movimientos", "cobertura", "totales", "saldos", "conciliacionSaldo", "gestionReportes", "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. --- Esta página es parte de la documentación de Emisso Connect. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/referencia/mercadopago/movimientos-consultar_v2.