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

> Crie, edite e exclua Titulares para gerenciar as pessoas e entidades donas das suas Contas.

Use o **Módulo Midaz** para gerenciar **Titulares**. Titulares representam as pessoas ou organizações por trás das suas Contas, e no console você pode criar, visualizar, editar e gerenciar suas informações completas.

## O que são Titulares?

***

Um **Titular** representa pessoas físicas (Pessoa Física) ou empresas (Pessoa Jurídica) associadas às suas Contas do Midaz. Cada Titular armazena:

* **Informações de identidade** - Nome, número do documento (CPF/CNPJ) e status do ciclo de vida
* **Detalhes de contato** - Endereços de email e números de telefone para comunicação
* **Informações de endereço** - Endereço principal e adicionais com dados completos de localização
* **Dados específicos da pessoa** - Detalhes pessoais para pessoas físicas ou informações empresariais para empresas
* **Metadados customizados** - Campos adicionais para integração e necessidades específicas do negócio

Titulares são gerenciados na área de CRM do Módulo Midaz e se conectam às Contas do Ledger através de Contas Alias, mantendo os dados do cliente organizados separadamente das operações transacionais.

Para detalhes técnicos sobre as capacidades subjacentes do CRM, consulte a página [Visão Geral do CRM](/pt/midaz/crm/crm-overview).

## Acessando a página de Titulares

***

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

A página de **Titulares** exibe uma tabela listando todos os Titulares no seu sistema.

### Ações disponíveis

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

<Columns cols={2}>
  <Card title="Criar um Titular" icon="plus" horizontal href="/pt/lerian-console/midaz-console/crm-creating-a-holder">
    Adicionar novas pessoas físicas ou jurídicas como Titulares
  </Card>

  <Card title="Editar um Titular" icon="pen" horizontal href="/pt/lerian-console/midaz-console/crm-editing-a-holder">
    Atualizar informações do Titular, detalhes de contato e status
  </Card>

  <Card title="Excluir um Titular" icon="trash" horizontal href="/pt/lerian-console/midaz-console/crm-deleting-a-holder">
    Remover Titulares usando soft delete (recuperável) ou hard delete (permanente)
  </Card>
</Columns>

## Entendendo os tipos de Titular

***

Ao criar um Titular, você precisará selecionar o tipo de Titular. Isso determina quais campos e informações você pode gerenciar:

### Pessoa Física

Para clientes pessoas físicas, haverá campos para:

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

### Pessoa Jurídica

Para clientes pessoas jurídicas, haverá campos para:

* **Informações básicas**: Razão social, documento (CNPJ), detalhes de contato
* **Detalhes do negócio**: 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 status do Titular

***

***

O console permite que você gerencie o ciclo de vida do Titular através de mudanças de status:

* **ACTIVE** - Titular está operacional e pode ser associado a Contas ativas
* **INACTIVE** - Titular está temporariamente desabilitado, preservando histórico enquanto previne novas operações
* **SUSPENDED** - Acesso do Titular está restrito, útil para compliance ou gestão de riscos
* **CLOSED** - Relacionamento do Titular está encerrado, tipicamente antes da exclusão

<Note>
  Mudanças de status podem ser feitas ao editar um Titular. O status atual está sempre visível na lista de Titulares.
</Note>

## Casos de uso comuns

***

<AccordionGroup>
  <Accordion title="Configurando clientes pessoas físicas">
    Ao fazer onboarding de clientes pessoas físicas no console:

    1. Crie um Titular Pessoa Física com detalhes pessoais
    2. Adicione endereço principal e informações de contato
    3. Vincule a contas correntes/poupança via Contas Alias
    4. Use metadados para atributos específicos do cliente (nível de fidelidade, perfil de risco, etc.)
  </Accordion>

  <Accordion title="Gerenciando clientes empresariais">
    Ao gerenciar contas corporativas no console:

    1. Crie um Titular Pessoa Jurídica com informações da empresa
    2. Adicione detalhes do representante legal para compliance
    3. Inclua endereços comerciais e pontos de contato
    4. Vincule a contas de tesouraria corporativa e operacionais
    5. Rastreie porte da empresa e setor de atividade para relatórios
  </Accordion>

  <Accordion title="Integrando com sistemas externos">
    Use o campo ID Externo no console para manter sincronização:

    * Mapeie cada Titular para seu CRM existente usando ID Externo
    * Mantenha números de documento consistentes entre sistemas
    * Use metadados para campos específicos de integração
    * Atualize status no console para refletir mudanças do sistema externo
  </Accordion>
</AccordionGroup>

## Melhores práticas

***

<Steps>
  <Step title="Escolha o tipo correto de Titular na criação">
    Selecione Pessoa Física para indivíduos e Pessoa Jurídica para empresas ao criar. Isso não pode ser alterado posteriormente e determina os campos disponíveis nos formulários do console.
  </Step>

  <Step title="Mantenha números de documento precisos">
    Números de documento (CPF, CNPJ) devem ser únicos e formatados corretamente. O console valida o formato, mas garanta a precisão para conformidade regulatória.
  </Step>

  <Step title="Mantenha informações de contato atualizadas">
    Atualize regularmente endereços de email e números de telefone no console para garantir comunicação efetiva com o cliente.
  </Step>

  <Step title="Use ID Externo para integração">
    Ao criar Titulares, preencha o campo ID Externo para mapear para seu banco de dados de clientes existente para integração perfeita entre sistemas.
  </Step>

  <Step title="Aproveite metadados para necessidades customizadas">
    Use a aba Metadados nos formulários de Titular para armazenar informações adicionais sem modificar a estrutura principal.
  </Step>

  <Step title="Gerencie transições de status adequadamente">
    Use atualizações de status (Ativo → Suspenso → Inativo → Encerrado) para refletir mudanças no relacionamento com o cliente antes da exclusão.
  </Step>
</Steps>