Consultar la cartola de Mercado Pago

{
  "$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"
  ]
}

{
  "$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
}