Enrolamiento de Clientes

El enrolamiento es el proceso de dar de alta a un cliente con todos sus datos: identificación, datos personales o de la sociedad, direcciones, contactos, información bancaria, clasificación FATCA/CRS, datos comerciales y ejecutivo asignado. Una vez enrolado, el cliente puede operar.

Crear un cliente

Usa Clientes/crearClienteFull para el alta completa. Recibe un arreglo Clientes, donde cada elemento describe a una persona (natural o jurídica) con sus secciones anidadas: documentos de identidad, direcciones físicas y electrónicas, teléfonos, cuentas y tarjetas bancarias, relaciones, declaración de origen de fondos, FATCA/CRS y datos de cliente.

Los campos mínimos son la identificación (IdTipoPersona, y nombres o razón social) y los datos comerciales dentro de DatosCliente. El resto de las secciones se completan según el perfil del cliente y los requisitos regulatorios que apliquen.

{
  "IdEmpresa": 1,
  "IdUsuario": "TU_USUARIO",
  "ClaveUsuario": "TU_CLAVE",
  "Clientes": [
    {
      "IdInterno": 0,
      "IdTipoPersona": "N",
      "Nombres": "PABLO EDGARDO",
      "ApellidoPaterno": "BRAVO",
      "ApellidoMaterno": "PAREDES",
      "TiposDocumento": [
        { "TipoDocumento": "R", "NumeroDocumento": "15443645-6" }
      ],
      "DatosCliente": {
        "IdTipoCliente": "RETAIL",
        "IdCategoriaInversionista": "MODERADO"
      }
    }
  ]
}

IdTipoPersona acepta N (persona natural) o J (persona jurídica). Para personas jurídicas se usa RazonSocial en lugar de nombres y apellidos, y suelen requerirse datos de constitución y representantes.

La respuesta incluye ContadorErrores, Mensajes y, cuando corresponde, un ContadorAdvertencias. Las advertencias señalan datos incompletos que no impiden el alta pero conviene completar.

Modificar un cliente

Para actualizar datos de un cliente ya enrolado, usa Clientes/modificarCliente. La estructura es análoga a la de creación: identificas al cliente por su documento y envías las secciones a actualizar.

Consultar antes de crear

Antes de enrolar, conviene verificar si el cliente ya existe con Clientes/consultarClientes (búsqueda por documento, nombre o razón social). Esto evita duplicados. El detalle de estas consultas está en Gestión de Cuentas.

Notas

Muchos campos usan códigos del sistema (país, comuna, banco, categoría de inversionista, etc.). Cuando un campo espera un código, su referencia lo indica y, en varios casos, remite al servicio de datos generales de la plataforma para obtener la lista vigente. Consulta la referencia de crearClienteFull para el detalle completo de cada sección.

Adicionalmente a crear el cliente en el sistema, es necesario generar el contrato de condiciones generales de MBI, ser firmado digitalmente por el cliente, y enviarlo en formato base64 junto con el carnet vigente del cliente.