Gestión de Cuentas

Una vez que un cliente está enrolado y asignado al ejecutivo/fintech correspondiente, estos servicios te permiten consultar sus datos y los portafolios asociados. Todos siguen el patrón de filtros de Optimus.

Consultar clientes

Clientes/consultarClientes busca clientes y devuelve sus datos básicos junto con documentos, cuentas y tarjetas bancarias, teléfonos, direcciones, indicadores y clasificación FATCA. Filtra por DocumentoIdentidad, TipoDocumentoIdentidad, NombreCompleto o RazonSocial.

{
  "IdEmpresa": 1,
  "IdUsuario": "TU_USUARIO",
  "ClaveUsuario": "TU_CLAVE",
  "Clientes": [
    { "IdInterno": 0, "Filtro": "DocumentoIdentidad", "Valor": "1-9" }
  ]
}

Consultar la ficha del cliente

Clientes/consultarFichaCliente entrega la ficha completa de un cliente: datos de la persona, régimen conyugal, giro, profesión, rangos de patrimonio y renta, tipos de documento, cuentas y tarjetas bancarias, teléfonos, direcciones, indicadores, relaciones, nombres de fantasía, FATCA/CRS, datos de cliente y portafolios. Es la vista más detallada de un cliente.

Filtra por DocumentoIdentidad y, opcionalmente, por tipo de bloqueo de persona o de cliente.

{
  "IdEmpresa": 1,
  "IdUsuario": "TU_USUARIO",
  "ClaveUsuario": "TU_CLAVE",
  "Filtros": [
    { "IdInterno": 0, "Filtro": "DocumentoIdentidad", "Valor": "15443645-6" }
  ]
}

Consultar portafolios

Un cliente puede tener varios portafolios (por ejemplo, intermediación, APV, administración de cartera). Clientes/consultaPortafolio lista los portafolios de un cliente con su código, estado, propósito, descripción y fecha de ingreso.

Filtra por DocumentoIdentidad, IdMatrizAgrupador o EsADC.

{
  "IdEmpresa": 1,
  "IdUsuario": "TU_USUARIO",
  "ClaveUsuario": "TU_CLAVE",
  "Clientes": [
    { "IdInterno": 0, "Filtro": "DocumentoIdentidad", "Valor": "1-9" }
  ]
}

El CodigoPortafolio que obtienes aquí es la referencia que usarás para operar (por ejemplo, al ingresar órdenes) y para acotar consultas de saldos y movimientos a un portafolio específico.

Cómo se conectan

El flujo típico es: consultar el cliente para confirmar su identidad, obtener su ficha si necesitas el detalle, y listar sus portafolios para saber sobre cuál operar o consultar. A partir de ahí, los servicios de Consultas y Operaciones trabajan con ese portafolio.