Consultas: Saldos, Movimientos y Custodia
Cómo consultar saldos, movimientos de caja y posiciones en custodia.
Consultas Masivas
Si ya tienes cliente creados en MBI Corredores de Bolsa y están asignados a tu ejecutivo/fintech puedes solicitar que te lleguen dos archivos csv todos los días al comienzo del día a una casilla de correo. Este correo diario contiene:
- Custodia consolidada de todas las posiciones de tus clientes al cierre del día anterior con el detalle de cantidad, precio mercado, precio compra, rentabilidad y otros campos relevantes
- Movimientos de todos tus clientes hechos el día anterior como abonos, retiros, compras, ventas y dividendos
Consultas
Estos servicios te dan la fotografía financiera del cliente: cuánto tiene disponible, qué movimientos ha registrado y qué instrumentos mantiene en custodia. Todos usan el patrón de filtros de Optimus.
Saldos
CuentaInversion/consultarSaldos devuelve los saldos del cliente. Filtra por DocumentoIdentidad, rango de fechas, moneda, portafolio o matriz agrupadora, y admite TipoSaldoConsultar para acotar el tipo de saldo.
{
"IdEmpresa": 1,
"IdUsuario": "TU_USUARIO",
"ClaveUsuario": "TU_CLAVE",
"CuentaInversion": [
{
"IdInterno": 0,
"Filtro": "DocumentoIdentidad;IdMoneda",
"Valor": "12721971-0;CLP"
}
]
}Movimientos de caja
CuentaInversion/consultarMovimientos lista los movimientos de la cuenta de inversión del cliente (abonos, cargos, liquidaciones y demás). Es la vista para conciliar la caja del cliente en un periodo.
CuentaInversion/consultarHistorialMovimientos entrega el histórico de movimientos, útil cuando necesitas un rango temporal más amplio o el detalle completo más allá de los movimientos recientes.
Ambos se filtran por documento, fechas, moneda y portafolio, igual que los saldos.
Custodia
La custodia refleja los instrumentos que el cliente mantiene depositados (posiciones).
Custodia/consultarCustodia devuelve las posiciones en custodia del cliente: instrumentos, cantidades y su detalle.
Custodia/consultarPatrimonioCustodia entrega la valorización del patrimonio en custodia, es decir, el valor de esas posiciones. Úsalo cuando necesitas el patrimonio total valorizado y no solo el listado de posiciones.
{
"IdEmpresa": 1,
"IdUsuario": "TU_USUARIO",
"ClaveUsuario": "TU_CLAVE",
"...": "filtros según la referencia del servicio"
}Cómo combinarlos
Para armar un estado de cuenta completo: consulta saldos para la liquidez, movimientos para la actividad del periodo, custodia para las posiciones y patrimonio en custodia para valorizarlas. Acotar por IdPortafolio te permite separar la vista por cada portafolio del cliente. El detalle de campos de respuesta de cada servicio está en su referencia.
Updated 9 days ago
