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

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

Criar um Titular

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

Editar um Titular

Atualize informações do titular, dados de contato e status

Excluir um Titular

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

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