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

Você gerencia Titulares na área de CRM do Módulo Midaz. 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](/pt/products/midaz/crm/crm-overview).

## 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 todos os Titulares do seu sistema.

### Ações disponíveis

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

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

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

  <Card title="Excluir um Titular" icon="trash" horizontal href="/pt/products/midaz/console/crm-deleting-a-holder">
    Remova titulares (exclusão reversível). A exclusão definitiva está disponível apenas pela API (`?hard_delete=true`)
  </Card>
</Columns>

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

## Casos de uso comuns

***

<AccordionGroup>
  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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
  </Accordion>
</AccordionGroup>

## Boas práticas

***

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

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

  <Step title="Mantenha as informações de contato atualizadas">
    Atualize endereços de e-mail e números de telefone no console regularmente.
  </Step>

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

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

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