Skip to main content
Usa el Módulo Midaz para administrar Titulares. Los Titulares representan a las personas u organizaciones detrás de tus cuentas. En la Console, los creas, visualizas, editas y administras.

​
¿Qué son los Titulares?

Un Titular representa a una persona individual (Persona natural) o una empresa (Persona jurídica) vinculada a tus cuentas de Midaz. Cada titular almacena:
  • Información de identidad - Nombre, número de documento (CPF/CNPJ) y un estado opcional de texto libre
  • Datos de contacto - Direcciones de correo electrónico y números de teléfono para comunicarte
  • Información de dirección - Direcciones principal y adicionales con datos completos de ubicación
  • Datos específicos de la persona - Datos personales para individuos o información empresarial para empresas
  • Metadatos personalizados - Campos adicionales para necesidades de integración y del negocio
Administras los Titulares en el área de CRM del Módulo Midaz. Los Titulares se conectan a las cuentas del ledger mediante Cuentas con alias. Esto mantiene los datos del cliente separados de las operaciones transaccionales. Para obtener detalles técnicos sobre las capacidades de CRM subyacentes, consulta la página Resumen de CRM.

​
Acceder a la página de Titulares

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

​
Acciones disponibles

Desde la página Holders, puedes:

Crear un Titular

Agregar nuevas personas o empresas como Titulares

Editar un Titular

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

Eliminar un Titular

Eliminar titulares (soft delete). El hard delete solo está disponible mediante la API (?hard_delete=true)

​
Entender los tipos de Titular

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

​
Persona natural (Individual)

Para clientes individuales, la Console muestra campos para:
  • Información básica: nombre completo, documento (CPF), datos de contacto
  • Datos 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 Console muestra campos para:
  • Información básica: nombre de la empresa, documento (CNPJ), datos de contacto
  • Datos empresariales: nombre comercial, actividad de la empresa, fecha de fundación
  • Estructura: tamaño de la empresa, tipo de empresa, estado del negocio
  • Representación legal: nombre del representante, documento, cargo, contacto

​
Administrar el estado del Titular

Status 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 dar de alta clientes individuales en la Console:
  1. Crea un titular de tipo Persona natural con sus datos personales
  2. Agrega la dirección principal y los datos de contacto
  3. Vincúlalo a cuentas corrientes o de ahorro mediante Cuentas con alias
  4. Usa metadatos para atributos específicos del cliente (nivel de fidelidad, perfil de riesgo, etc.)
Para administrar cuentas corporativas en la Console:
  1. Crea un titular de tipo Persona jurídica con la información de la empresa
  2. Agrega los datos del representante legal para cumplimiento
  3. Incluye direcciones y puntos de contacto empresariales
  4. Vincúlalo a cuentas de tesorería y operativas corporativas
  5. Registra el tamaño de la empresa y el sector de actividad para informes
Usa el campo External ID en la Console para mantener sincronizados los sistemas:
  • Vincula cada titular con tu CRM existente mediante External ID
  • Mantén los números de documento consistentes entre sistemas
  • Usa metadatos para campos específicos de la integración
  • Actualiza el estado en la Console para reflejar cambios del sistema externo

​
Prácticas recomendadas

1

Elige el tipo de titular correcto al crearlo

Selecciona Persona natural para individuos y Persona jurídica para empresas. No puedes cambiar el tipo después. El tipo define qué campos muestran los formularios de la Console.
2

Mantén los números de documento exactos

Los números de documento (CPF, CNPJ) deben ser únicos y tener el formato correcto. El campo de documento es obligatorio, pero la Console no valida su formato. Verifica los números tú mismo para el cumplimiento regulatorio.
3

Mantén actualizada la información de contacto

Actualiza las direcciones de correo electrónico y los números de teléfono en la Console con regularidad.
4

Usa External ID para la integración

Cuando crees un titular, completa el campo External ID. Este vincula el titular con tu base de datos de clientes existente.
5

Usa metadatos para necesidades personalizadas

Usa el paso Metadata del formulario del titular para almacenar información adicional. No cambias la estructura central.
6

Mantén significativo el campo de estado

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