> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestión de Titulares

> Crea, edita y elimina Titulares para gestionar a las personas y entidades dueñas de tus Cuentas.

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](/es/midaz/crm/crm-overview).

## 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:

<Columns cols={2}>
  <Card title="Crear un Titular" icon="plus" horizontal href="/es/midaz/console/crm-creating-a-holder">
    Añadir nuevos individuos o empresas como Titulares
  </Card>

  <Card title="Editar un Titular" icon="pen" horizontal href="/es/midaz/console/crm-editing-a-holder">
    Actualizar información del titular, datos de contacto y estado
  </Card>

  <Card title="Eliminar un Titular" icon="trash" horizontal href="/es/midaz/console/crm-deleting-a-holder">
    Eliminar titulares usando eliminación suave (recuperable) o eliminación permanente (definitiva)
  </Card>
</Columns>

## 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

<Note>
  Los cambios de estado pueden realizarse al editar un titular. El estado actual siempre es visible en la lista de titulares.
</Note>

## Casos de uso comunes

***

<AccordionGroup>
  <Accordion title="Configuración de clientes individuales">
    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.)
  </Accordion>

  <Accordion title="Gestión de clientes empresariales">
    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
  </Accordion>

  <Accordion title="Integración con sistemas externos">
    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
  </Accordion>
</AccordionGroup>

## Mejores prácticas

***

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>