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

Utilice **Midaz Module** para gestionar los **Holders**. Los Titulares representan a las personas u organizaciones detrás de sus cuentas, y en la consola puede 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 sus 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, consulte 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**, seleccione 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 su sistema.

### Acciones disponibles

Desde la página de **Holders**, puede:

<Columns cols={2}>
  <Card title="Crear un Titular" icon="plus" horizontal href="/es/lerian-console/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/lerian-console/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/lerian-console/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á seleccionar el tipo de titular. Esto determina qué campos e información puede 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 le 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. Cree un titular de Persona Natural con detalles personales
    2. Añada la dirección principal e información de contacto
    3. Vincule a cuentas corrientes/de ahorro a través de Cuentas Alias
    4. Utilice 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. Cree un titular de Persona Jurídica con información de la empresa
    2. Añada detalles del representante legal para cumplimiento
    3. Incluya direcciones comerciales y puntos de contacto
    4. Vincule a cuentas de tesorería corporativa y operacionales
    5. Realice seguimiento del tamaño de la empresa y sector de actividad para reportes
  </Accordion>

  <Accordion title="Integración con sistemas externos">
    Utilice el campo External ID en la consola para mantener la sincronización:

    * Mapee cada titular a su CRM existente usando External ID
    * Mantenga los números de documento consistentes entre sistemas
    * Utilice metadatos para campos específicos de integración
    * Actualice 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">
    Seleccione 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 asegure la precisión para el cumplimiento regulatorio.
  </Step>

  <Step title="Mantener actualizada la información de contacto">
    Actualice 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, complete el campo External ID para mapear a su base de datos de clientes existente para una integración de sistemas sin problemas.
  </Step>

  <Step title="Aprovechar los metadatos para necesidades personalizadas">
    Utilice 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">
    Utilice actualizaciones de estado (Active → Suspended → Inactive → Closed) para reflejar cambios en la relación con el cliente antes de la eliminación.
  </Step>
</Steps>
