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

> Gerencie as Contas Alias no Midaz Module: crie, edite e exclua os registros de conta voltados ao cliente que ligam os Titulares às Contas subjacentes deles.

Use o **Midaz Module** para gerenciar as **Contas Alias**. As Contas Alias criam o vínculo entre os Titulares e as contas do ledger do Midaz. Elas adicionam contexto de negócio, como números de conta bancária e detalhes da instituição financeira.

## O que são Contas Alias?

***

Uma **Conta Alias** conecta um Titular (pessoa física ou empresa) a uma conta específica do ledger do Midaz. No Midaz Module, cada conta alias armazena:

* **Identificação da conta** - ID do banco, agência, conta e tipo
* **Referência do titular** - Vínculo com o titular associado (Pessoa Física ou Jurídica)
* **Vínculo com a conta do ledger** - Conexão com a conta subjacente do Midaz
* **Detalhes bancários** - Data de abertura, IBAN, código do país e o Documento do Participante, em Regulatório
* **Partes relacionadas** - Pessoas vinculadas à conta, cada uma com um papel e uma data de início, em Regulatório
* **Metadados personalizados** - Campos adicionais para necessidades de integração e específicas de negócio

As Contas Alias permitem manter as informações de conta voltadas ao cliente separadas do ledger transacional. Isso oferece suporte a cenários multibanco e integração com sistemas externos.

Para detalhes técnicos sobre os recursos de CRM subjacentes, consulte a página [Visão Geral do CRM](https://docs.lerian.studio/pt/products/midaz/crm/crm-overview.md).

## Acessando a página de Contas Alias

***

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

Com o Access Manager, esta página precisa da permissão de leitura em instruments. Para criar, editar ou excluir uma conta alias, você precisa da permissão de criação, atualização ou exclusão em instruments.

A página **Contas Alias** mostra uma tabela com as Contas Alias da Organização atual, incluindo:

* **Nome do Titular** - O nome do titular associado
* **ID do Titular** - O identificador do titular associado
* **ID da Conta** - O identificador da conta do ledger vinculada
* **Ledger** - O ledger ao qual a conta vinculada pertence
* **Tipo** - Classificação da conta (checking, savings etc.)
* **Ações** - As ações disponíveis para cada conta alias

> [!NOTE]
>
> Se você não tiver nenhuma Conta Alias, a lista aparece vazia, com uma sugestão para criar a sua primeira conta alias.

### Ações disponíveis

Na página **Contas Alias**, você pode:

> [card] [Criar uma Conta Alias](https://docs.lerian.studio/pt/products/midaz/console/crm-creating-alias-account.md)
>
> Vincule um titular a uma conta do ledger do Midaz com detalhes bancários

> [card] [Editar uma Conta Alias](https://docs.lerian.studio/pt/products/midaz/console/crm-editing-alias-account.md)
>
> Atualize as informações da conta e os detalhes financeiros

> [card] [Excluir uma Conta Alias](https://docs.lerian.studio/pt/products/midaz/console/crm-deleting-alias-account.md)
>
> Remova o vínculo entre um titular e uma conta do ledger

## Casos de uso comuns

***

> [accordion] Vinculando contas de clientes
>
> Quando um cliente abre uma conta:
>
> 1. Crie um Titular com as informações do cliente (Pessoa Física ou Jurídica)
> 2. Crie uma Conta Alias vinculando o titular a uma conta do ledger do Midaz
> 3. Adicione os detalhes bancários (ID do banco, agência, conta, tipo)

> [accordion] Cenários multibanco
>
> Quando os clientes têm contas em várias instituições:
>
> * Crie várias Contas Alias para o mesmo Titular
> * Cada conta alias referencia uma conta diferente do ledger do Midaz
> * Rastreie números de conta e relacionamentos bancários diferentes
> * Mantenha uma separação clara entre os relacionamentos institucionais

> [accordion] 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 regulatórios, como o Documento do Participante

## Boas práticas

***

**1. Crie os titulares antes das contas alias**

Sempre crie o registro do Titular primeiro e só depois crie as Contas Alias para vinculá-los às contas do ledger.

**2. Use uma 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.

**3. Mantenha os detalhes da instituição financeira precisos**

Confirme que os IDs do banco e os outros detalhes bancários estão corretos, para o roteamento correto de pagamentos e a compliance regulatória.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.