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

# Administrar titulares

> Administra Titulares en el Módulo Midaz: crea, edita y elimina personas o empresas con su información de identidad, contacto y dirección.

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

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

<Columns cols={2}>
  <Card title="Crear un Titular" icon="plus" horizontal href="/es/products/midaz/console/crm-creating-a-holder">
    Agregar nuevas personas o empresas como Titulares
  </Card>

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

  <Card title="Eliminar un Titular" icon="trash" horizontal href="/es/products/midaz/console/crm-deleting-a-holder">
    Eliminar titulares (soft delete). El hard delete solo está disponible mediante la API (`?hard_delete=true`)
  </Card>
</Columns>

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

<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="Configurar clientes individuales">
    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.)
  </Accordion>

  <Accordion title="Administrar clientes empresariales">
    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
  </Accordion>

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

## Prácticas recomendadas

***

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

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

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

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

  <Step title="Usa metadatos para necesidades personalizadas">
    Usa el paso Metadata del formulario del titular para almacenar información adicional. No cambias la estructura central.
  </Step>

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