> ## 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
* **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](/pt/products/midaz/crm/crm-overview).

## Acessando a página de Contas Alias

***

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

A página **Contas Alias** exibe uma tabela com todas as Contas Alias do seu sistema, 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.
</Note>

### Ações disponíveis

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

<Columns cols={2}>
  <Card title="Criar uma Conta Alias" icon="plus" horizontal href="/pt/products/midaz/console/crm-creating-alias-account">
    Vincule um titular a uma conta do ledger do Midaz com detalhes bancários
  </Card>

  <Card title="Editar uma Conta Alias" icon="pen" horizontal href="/pt/products/midaz/console/crm-editing-alias-account">
    Atualize as informações da conta e os detalhes financeiros
  </Card>

  <Card title="Excluir uma Conta Alias" icon="trash" horizontal href="/pt/products/midaz/console/crm-deleting-alias-account">
    Remova o vínculo entre um titular e uma conta do ledger
  </Card>
</Columns>

## Casos de uso comuns

***

<AccordionGroup>
  <Accordion title="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)
    4. O cliente já pode transacionar usando o número de conta bancária familiar a ele
  </Accordion>

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

  <Accordion title="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
    * Mantenha metadados para campos específicos de integração
    * Sincronize as mudanças de status entre os sistemas
  </Accordion>
</AccordionGroup>

## Boas práticas

***

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

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

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

  <Step title="Documente os relacionamentos entre contas">
    Use metadados para armazenar contexto adicional sobre os relacionamentos entre contas, especialmente em cenários multibanco ou de integração.
  </Step>

  <Step title="Gerencie o status adequadamente">
    Atualize o status da conta alias para refletir mudanças no relacionamento da conta (ativo, inativo, encerrado).
  </Step>
</Steps>