Saltar al contenido principal
Utiliza Midaz Module para gestionar los Holders. Los Titulares representan a las personas u organizaciones detrás de tus cuentas, y en la consola puedes crear, visualizar, editar y gestionar su información completa.

​
¿Qué son los Titulares?

Un Holder representa a individuos (Persona Natural) o empresas (Persona Jurídica) asociados con tus cuentas de Midaz. Cada titular almacena:
  • Información de identidad - Nombre, número de documento (CPF/CNPJ) y estado del ciclo de vida
  • Datos de contacto - Direcciones de correo electrónico y números de teléfono para comunicación
  • Información de dirección - Dirección principal y adicionales con datos de ubicación completos
  • Datos específicos de persona - Detalles personales para individuos o información empresarial para compañías
  • Metadatos personalizados - Campos adicionales para integración y necesidades específicas del negocio
Los Titulares se gestionan en el área CRM del Midaz Module y se conectan a las cuentas del Ledger a través de las Cuentas Alias, manteniendo los datos del cliente organizados de forma separada de las operaciones transaccionales. Para obtener detalles técnicos sobre las capacidades subyacentes del CRM, consulta la página Resumen del CRM.

​
Acceso a la página de Titulares

Para abrir la página de Holders, selecciona la opción Holders en la sección Accounts del menú lateral izquierdo. La página de Holders muestra una tabla con todos los Titulares en tu sistema.

​
Acciones disponibles

Desde la página de Holders, puedes:

Crear un Titular

Añadir nuevos individuos o empresas como Titulares

Editar un Titular

Actualizar información del titular, datos de contacto y estado

Eliminar un Titular

Eliminar titulares usando eliminación suave (recuperable) o eliminación permanente (definitiva)

​
Comprensión de los tipos de Titular

Al crear un Titular, deberás seleccionar el tipo de titular. Esto determina qué campos e información puedes gestionar:

​
Persona Natural (Individual)

Para clientes individuales, habrá campos para:
  • Información básica: Nombre completo, documento (CPF), datos de contacto
  • Detalles personales: Nombre preferido, nombre social, género, fecha de nacimiento
  • Información familiar: Estado civil, nombre de la madre, nombre del padre
  • Datos demográficos: Nacionalidad, país de origen

​
Persona Jurídica (Empresa)

Para clientes corporativos, habrá campos para:
  • Información básica: Razón social, documento (CNPJ), datos de contacto
  • Detalles empresariales: Nombre comercial, actividad de la empresa, fecha de fundación
  • Estructura: Tamaño de la empresa, tipo de empresa, estado comercial
  • Representación legal: Nombre del representante, documento, cargo, contacto

​
Gestión del estado del Titular

La consola te permite gestionar el ciclo de vida del titular a través de cambios de estado:
  • ACTIVE - El titular está operativo y puede asociarse con cuentas activas
  • INACTIVE - El titular está temporalmente deshabilitado, preservando el historial mientras se impiden nuevas operaciones
  • SUSPENDED - El acceso del titular está restringido, útil para gestión de cumplimiento o riesgos
  • CLOSED - La relación con el titular está terminada, típicamente antes de la eliminación
Los cambios de estado pueden realizarse al editar un titular. El estado actual siempre es visible en la lista de titulares.

​
Casos de uso comunes

Al incorporar clientes individuales en la consola:
  1. Crea un titular de Persona Natural con detalles personales
  2. Añade la dirección principal e información de contacto
  3. Vincula a cuentas corrientes/de ahorro a través de Cuentas Alias
  4. Utiliza metadatos para atributos específicos del cliente (nivel de lealtad, perfil de riesgo, etc.)
Al gestionar cuentas corporativas en la consola:
  1. Crea un titular de Persona Jurídica con información de la empresa
  2. Añade detalles del representante legal para cumplimiento
  3. Incluye direcciones comerciales y puntos de contacto
  4. Vincula a cuentas de tesorería corporativa y operacionales
  5. Realiza seguimiento del tamaño de la empresa y sector de actividad para reportes
Utiliza el campo External ID en la consola para mantener la sincronización:
  • Mapea cada titular a tu CRM existente usando External ID
  • Mantén los números de documento consistentes entre sistemas
  • Utiliza metadatos para campos específicos de integración
  • Actualiza el estado en la consola para reflejar cambios del sistema externo

​
Mejores prácticas

1

Elegir el tipo de titular correcto al crear

Selecciona Persona Natural para individuos y Persona Jurídica para empresas al crear. Esto no puede cambiarse posteriormente y determina los campos disponibles en los formularios de la consola.
2

Mantener precisos los números de documento

Los números de documento (CPF, CNPJ) deben ser únicos y estar correctamente formateados. La consola valida el formato, pero asegura la precisión para el cumplimiento regulatorio.
3

Mantener actualizada la información de contacto

Actualiza regularmente las direcciones de correo electrónico y números de teléfono en la consola para asegurar una comunicación efectiva con el cliente.
4

Usar External ID para integración

Al crear titulares, completa el campo External ID para mapear a tu base de datos de clientes existente para una integración de sistemas sin problemas.
5

Aprovechar los metadatos para necesidades personalizadas

Utiliza la pestaña Metadata en los formularios de titular para almacenar información adicional sin modificar la estructura principal.
6

Gestionar adecuadamente las transiciones de estado

Utiliza actualizaciones de estado (Active → Suspended → Inactive → Closed) para reflejar cambios en la relación con el cliente antes de la eliminación.