Skip to main content
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 suas informações.

​
O que são Titulares?

Um Titular representa um indivíduo (Pessoa Física) ou uma empresa (Pessoa Jurídica) vinculado às suas Contas do Midaz. Cada Titular armazena:
  • Informações de identidade - Nome, número do documento (CPF/CNPJ) e um campo de status opcional de texto livre
  • 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
Você gerencia os Titulares na área de CRM do Módulo Midaz. Os Titulares se conectam às Contas do Ledger através de Contas Alias. Isso mantém os dados do cliente separados das operações transacionais. Para detalhes técnicos sobre as capacidades subjacentes do CRM, consulte a página Visão Geral do CRM.

​
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 mostra uma tabela com todos os Titulares no seu sistema.

​
Ações disponíveis

Na página de Titulares, você pode:

Criar um Titular

Adicionar novas pessoas físicas ou jurídicas como Titulares

Editar um Titular

Atualizar informações do Titular, detalhes de contato e status

Excluir um Titular

Remover Titulares (soft delete). O hard delete está disponível apenas pela API (?hard_delete=true)

​
Entendendo os tipos de Titular

Quando você cria um Titular, você seleciona o tipo de Titular. O tipo determina quais campos você pode gerenciar:

​
Pessoa Física

Para clientes pessoas físicas, o console mostra 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

​
Pessoa Jurídica

Para clientes pessoas jurídicas, o console mostra 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 status é um campo opcional de texto livre no formulário do Titular. Use-o para registrar qualquer classificação que seu negócio precise, como active ou under-review.
Para alterar o status, edite o Titular. A lista de Titulares mostra as colunas Name, ID, Type e Primary E-mail; abra um Titular para ver seu status.

​
Casos de uso comuns

Para 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.)
Para 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
Use o campo ID Externo no console para manter os sistemas sincronizados:
  • 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

​
Melhores práticas

1

Escolha o tipo correto de Titular na criação

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

Mantenha números de documento precisos

Números de documento (CPF, CNPJ) devem ser únicos e formatados corretamente. O campo de documento é obrigatório, mas o console não valida seu formato — verifique os números por conta própria para conformidade regulatória.
3

Mantenha informações de contato atualizadas

Atualize os endereços de email e os números de telefone no console regularmente. Isso mantém a comunicação com o cliente efetiva.
4

Use ID Externo para integração

Quando você cria um Titular, preencha o campo ID Externo. Ele mapeia o Titular para seu banco de dados de clientes existente.
5

Use metadados para necessidades customizadas

Use a etapa Metadados no formulário de Titular para armazenar informações adicionais. Você não altera 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 sua equipe e atualize-o para refletir mudanças no relacionamento com o cliente antes da exclusão.