> ## 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 desde la Console para gestionar a las personas y entidades dueñas de tus Cuentas y mantener su información centralizada.

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](/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 (eliminación suave). La eliminación permanente solo está disponible a través de la API (`?hard_delete=true`)
  </Card>
</Columns>

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

<Note>
  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.
</Note>

## Casos de uso comunes

***

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

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

  <Accordion title="Integración con sistemas externos">
    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
  </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. No puedes cambiar el tipo posteriormente. El tipo define qué campos muestran 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. El campo de documento es obligatorio, pero la consola no valida su formato — verifica los números por tu cuenta para el cumplimiento regulatorio.
  </Step>

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

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

  <Step title="Usar los metadatos para necesidades personalizadas">
    Utiliza el paso Metadata del formulario de titular para almacenar información adicional. No modificas la estructura principal.
  </Step>

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