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

# Gerenciando Titulares

> Gerencie Titulares no Módulo Midaz: crie, edite e exclua pessoas físicas ou jurídicas com suas informações de identidade, contato e endereço.

Use o **Módulo Midaz** para gerenciar **Titulares**. Titulares representam as pessoas ou organizações por trás das suas contas. No console, você cria, visualiza, edita e gerencia as informações delas.

## O que são Titulares?

***

Um **Titular** representa uma pessoa física (Pessoa Física) ou uma empresa (Pessoa Jurídica) vinculada às suas contas do Midaz. Cada titular guarda:

* **Informações de identidade** - Nome, número do documento (CPF/CNPJ) e um status opcional em texto livre
* **Dados de contato** - Endereços de e-mail e números de telefone para comunicação
* **Informações de endereço** - Endereço principal e endereços adicionais com dados completos de localização
* **Dados específicos da pessoa** - Detalhes pessoais para indivíduos ou informações empresariais para empresas
* **Metadados personalizados** - Campos adicionais para integração e necessidades específicas do negócio

Titulares se conectam a contas do ledger por meio de Contas de Alias. Isso mantém os dados de clientes separados das operações transacionais.

Para detalhes técnicos sobre os recursos de CRM subjacentes, consulte a página [Visão geral do CRM](https://docs.lerian.studio/pt/products/midaz/crm/crm-overview.md).

## Acessando a página de Titulares

***

Para abrir a página **Titulares**, selecione a opção **Titulares** na seção Contas do menu lateral esquerdo.

A página **Titulares** mostra uma tabela com os Titulares da Organização atual.

### Ações disponíveis

Na página **Titulares**, você pode:

> [card] [Criar um Titular](https://docs.lerian.studio/pt/products/midaz/console/crm-creating-a-holder.md)
>
> Adicione novas pessoas físicas ou jurídicas como Titulares

> [card] [Editar um Titular](https://docs.lerian.studio/pt/products/midaz/console/crm-editing-a-holder.md)
>
> Atualize informações do titular, dados de contato e status

> [card] [Excluir um Titular](https://docs.lerian.studio/pt/products/midaz/console/crm-deleting-a-holder.md)
>
> Remova titulares (exclusão reversível). A exclusão definitiva está disponível apenas pela API (`?hard_delete=true`)

## Entendendo os tipos de Titular

***

Ao criar um Titular, você seleciona o tipo de titular. O tipo determina quais campos você pode gerenciar:

### Pessoa Física (Indivíduo)

Para clientes pessoa física, o console mostra campos para:

* **Informações básicas**: Nome completo, documento (CPF), dados de contato
* **Detalhes pessoais**: Nome preferido, nome social, gênero, data de nascimento
* **Informações familiares**: Estado civil, nome da mãe, nome do pai
* **Dados demográficos**: Nacionalidade

### Pessoa Jurídica (Empresa)

Para clientes pessoa jurídica, o console mostra campos para:

* **Informações básicas**: Razão social, documento (CNPJ), dados de contato
* **Detalhes empresariais**: Nome fantasia, atividade da empresa, data de fundação
* **Estrutura**: Porte da empresa, tipo de empresa, status do negócio
* **Representação legal**: Nome do representante, documento, cargo, contato

## Gerenciando o status do Titular

***

**Status** é um campo opcional em texto livre no formulário do titular. Use-o para registrar qualquer classificação que o seu negócio precisar, como `active` ou `under-review`.

> [!NOTE]
>
> Para mudar o status, edite o titular. A lista de titulares mostra as colunas **Nome**, **ID**, **Tipo** e **E-mail Principal**. Abra um titular para ver o status dele.

## Casos de uso comuns

***

> [accordion] Configurando clientes pessoa física
>
> Para integrar clientes pessoa física no console:
>
> 1. Crie um titular Pessoa Física com detalhes pessoais
> 2. Adicione o endereço principal e as informações de contato
> 3. Vincule a contas corrente/poupança por meio de Contas de Alias
> 4. Use metadados para atributos específicos do cliente (nível de fidelidade, perfil de risco etc.)

> [accordion] Gerenciando clientes empresariais
>
> Para gerenciar contas corporativas no console:
>
> 1. Crie um titular Pessoa Jurídica com as informações da empresa
> 2. Adicione os detalhes do representante legal para conformidade
> 3. Inclua endereços e pontos de contato empresariais
> 4. Vincule às contas de tesouraria e operacionais corporativas
> 5. Acompanhe o porte da empresa e o setor de atividade para relatórios

> [accordion] Integrando com sistemas externos
>
> Use o campo External ID no console para manter os sistemas sincronizados:
>
> * Mapeie cada titular ao seu CRM existente usando o External ID
> * Mantenha os números de documento consistentes entre os sistemas
> * Use metadados para campos específicos de integração
> * Atualize o status no console para refletir mudanças no sistema externo

## Boas práticas

***

**1. Escolha o tipo de titular correto na criação**

Selecione Pessoa Física para indivíduos e Pessoa Jurídica para empresas. Você não pode mudar o tipo depois. O tipo define quais campos os formulários do console mostram.

**2. Mantenha os números de documento precisos**

Os números de documento (CPF, CNPJ) devem ser únicos e formatados corretamente. O campo de documento é obrigatório, mas o console não valida o formato dele. Verifique os números você mesmo para a conformidade regulatória.

**3. Mantenha as informações de contato atualizadas**

Atualize endereços de e-mail e números de telefone no console regularmente.

**4. Use o External ID para integração**

Ao criar um titular, preencha o campo External ID. Ele mapeia o titular ao seu banco de dados de clientes existente.

**5. Use metadados para necessidades personalizadas**

Use a etapa de Metadados no formulário do titular para guardar informações extras. Você não muda a estrutura principal.

**6. Mantenha o campo de status significativo**

Se você usar o campo de status opcional, defina um conjunto consistente de valores para a sua equipe e atualize-o para refletir mudanças no relacionamento com o cliente antes da exclusão.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.