O que são Contas Alias?
Uma Conta Alias conecta um Titular (pessoa física ou jurídica) a uma Conta específica do Ledger Midaz. No Módulo Midaz, cada Conta Alias armazena:
- Identificação da conta - Número da conta bancária, código da agência e tipo de conta
- Referência do Titular - Ligação com o Titular associado (Pessoa Física ou Jurídica)
- Ligação com Conta do Ledger - Conexão com a Conta subjacente do Midaz
- Detalhes da instituição financeira - Nome do banco, código ISPB e identificadores da instituição
- Metadados customizados - Campos adicionais para integração e necessidades específicas do negócio
Acessando a página de Contas Alias
Para abrir a página de Contas Alias, selecione a opção Aliases na seção Contas do menu lateral esquerdo. A página de Contas Alias exibe uma tabela listando todas as Contas Alias no seu sistema, incluindo:
- Número da Conta - O número da conta bancária ou identificador
- Titular - O nome do Titular associado
- Tipo de Conta - Classificação da conta (corrente, poupança, etc.)
- Status - Estado atual (Ativo, Inativo, etc.)
- Data de Criação - Quando a Conta Alias foi criada
Se você não tiver nenhuma Conta Alias, a lista aparecerá vazia com um prompt para criar sua primeira Conta Alias.
Ações disponíveis
Na página de Contas Alias, você pode:Criar uma Conta Alias
Vincular um Titular a uma Conta do Ledger Midaz com detalhes bancários
Editar uma Conta Alias
Atualizar informações da conta e detalhes financeiros
Excluir uma Conta Alias
Remover a ligação entre um Titular e uma Conta do Ledger
Casos de uso comuns
Vinculando contas de clientes
Vinculando contas de clientes
Quando um cliente abre uma conta:
- Crie um Titular com informações do cliente (Pessoa Física ou Jurídica)
- Crie uma Conta Alias vinculando o Titular a uma Conta do Ledger Midaz
- Adicione detalhes bancários (número da conta, agência, instituição)
- O cliente agora pode transacionar usando seu número de conta bancária familiar
Cenários multi-banco
Cenários multi-banco
Quando clientes têm contas em múltiplas instituições:
- Crie múltiplas Contas Alias para o mesmo Titular
- Cada Conta Alias referencia uma Conta diferente do Ledger Midaz
- Rastreie diferentes números de conta e relacionamentos bancários
- Mantenha separação clara entre relacionamentos institucionais
Integração com sistemas externos
Integração com sistemas externos
Ao integrar com sistemas bancários externos:
- Use Contas Alias para mapear números de conta externos para Contas internas do Ledger
- Armazene identificadores específicos da instituição (ISPB, códigos de participante)
- Mantenha metadados para campos específicos de integração
- Sincronize mudanças de status entre sistemas
Melhores práticas
Crie Titulares antes das Contas Alias
Sempre crie o registro do Titular primeiro, depois crie Contas Alias para vinculá-los às Contas do Ledger. Isso garante relacionamentos de dados adequados.
Use numeração de conta consistente
Siga os padrões de numeração de conta da sua instituição ao criar Contas Alias para evitar confusão e problemas de integração.
Mantenha detalhes da instituição financeira precisos
Garanta que códigos ISPB e identificadores bancários estejam corretos para roteamento adequado de pagamentos e conformidade regulatória.
Documente relacionamentos de conta
Use metadados para armazenar contexto adicional sobre relacionamentos de conta, especialmente em cenários multi-banco ou de integração.

