Skip to main content
Utiliza el Midaz Module para gestionar los Holders. Los Titulares representan a las personas u organizaciones detrás de tus cuentas. En la consola, puedes crear, visualizar, editar y gestionar su información.

​
¿Qué son los Titulares?

Un Holder representa a un individuo (Persona Natural) o una empresa (Persona Jurídica) vinculado a tus cuentas de Midaz. Cada titular almacena:
  • Información de identidad - Nombre, número de documento (CPF/CNPJ) y un campo de estado opcional de texto libre
  • 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
Gestionas los Titulares en el área CRM del Midaz Module. Los Titulares se conectan a las cuentas del Ledger a través de las Cuentas Alias. Esto mantiene los datos del cliente separados 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 (eliminación suave). La eliminación permanente solo está disponible a través de la API (?hard_delete=true)

​
Comprensión de los tipos de Titular

Cuando creas un Titular, seleccionas el tipo de titular. El tipo determina qué campos puedes gestionar:

​
Persona Natural (Individual)

Para clientes individuales, la consola muestra 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

​
Persona Jurídica (Empresa)

Para clientes corporativos, la consola muestra 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

El estado es un campo opcional de texto libre en el formulario del titular. Úsalo para registrar cualquier clasificación que tu negocio necesite, como active o under-review.
Para cambiar el estado, edita el titular. La lista de titulares muestra las columnas Name, ID, Type y Primary E-mail; abre un titular para ver su estado.

​
Casos de uso comunes

Para 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.)
Para 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 los sistemas sincronizados:
  • 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. No puedes cambiar el tipo posteriormente. El tipo define qué campos muestran 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. El campo de documento es obligatorio, pero la consola no valida su formato — verifica los números por tu cuenta para el cumplimiento regulatorio.
3

Mantener actualizada la información de contacto

Actualiza las direcciones de correo electrónico y los números de teléfono en la consola con regularidad. Esto mantiene efectiva la comunicación con el cliente.
4

Usar External ID para integración

Cuando creas un titular, completa el campo External ID. Este mapea el titular a tu base de datos de clientes existente.
5

Usar los metadatos para necesidades personalizadas

Utiliza el paso Metadata del formulario de titular para almacenar información adicional. No modificas la estructura principal.
6

Dar significado al campo de estado

Si usas el campo de estado opcional, define un conjunto consistente de valores para tu equipo y actualízalo para reflejar cambios en la relación con el cliente antes de la eliminación.