Alias Accounts

Uma Alias Account adiciona contexto de negócio a uma Conta do Ledger no Midaz. Ela vincula um Holder a uma conta específica no ledger. Ela adiciona detalhes bancários, informações regulatórias e dados de partes relacionadas a essa conta. Sem esse vínculo, os recursos do CRM que dependem do contexto de conta não funcionam como esperado.

​

Como funciona

---

A Alias Account é uma representação a nível de CRM de uma Conta do Ledger no Midaz. Ao criar uma Alias Account, você fornece o ledgerId e o accountId que identificam a conta-alvo no ledger. A Alias Account herda automaticamente o document e o type do Holder associado. Esse design mantém os detalhes de conta voltados ao cliente separados do ledger transacional. Os números bancários, os códigos de agência e os identificadores regulatórios permanecem no CRM, não no ledger. Essa separação suporta cenários multi-banco e integração com sistemas externos.

​

Campos da Alias Account

---

​

Campos principais

​

Detalhes bancários

O objeto bankingDetails armazena informações sobre a instituição financeira do alias:

​

Campos regulatórios

O objeto regulatoryFields armazena dados que os reguladores financeiros exigem:

​

Partes relacionadas

Uma parte relacionada é uma pessoa ou entidade vinculada a uma Alias Account. Cada parte relacionada tem um papel definido e um relacionamento com prazo determinado. As partes relacionadas representam as pessoas ou organizações reais conectadas à conta, para titularidade, autoridade legal ou responsabilidade operacional. A conformidade, os relatórios regulatórios e os fluxos de trabalho do CRM as utilizam.

​

Papéis

Cada parte relacionada deve ter um dos seguintes papéis:

​

Relacionamentos com prazo determinado

Todo relacionamento de parte relacionada tem um período ativo definido:

• startDate — Obrigatório. A data em que o relacionamento entrou em vigor (AAAA-MM-DD).
• endDate — Opcional. A data em que o relacionamento terminou (AAAA-MM-DD). Se você omitir, o relacionamento permanece ativo. Quando você define, endDate deve ser posterior a startDate.

Esse design registra quem teve um relacionamento com a conta, e em qual capacidade. Ele mantém os relacionamentos passados no registro.

​

Gerenciando partes relacionadas

Você gerencia as partes relacionadas através dos endpoints de Alias Account. Não há endpoints independentes de criação ou listagem:

• Adicionar na criação — Inclua um array relatedParties no corpo da requisição de Criar Alias Account.
• Adicionar a uma existente — Inclua um array relatedParties no corpo da requisição de Atualizar Alias Account. O Midaz anexa novas entradas à lista existente. Ele não substitui as partes relacionadas existentes.
• Remover — Use o endpoint Excluir Parte Relacionada com o related_party_id específico.
• Listar — A resposta da Alias Account retorna as partes relacionadas no array relatedParties.

​

Campos

​

Segurança dos dados

---

O Midaz criptografa vários campos da Alias Account em repouso, incluindo o campo document herdado e detalhes bancários como account e iban. A criptografia protege dados financeiros sensíveis mesmo se um atacante acessar o armazenamento subjacente. Para a lista completa de campos protegidos e estratégias de criptografia, consulte Segurança de dados do CRM.

​

Gerenciando Alias Accounts

---

​

Via API

Use a API do CRM para gerenciar Alias Accounts programaticamente:

• Criar uma Alias Account — Vincular um Holder a uma Conta do Ledger no Midaz.
• Listar Alias Accounts — Visualizar todas as Alias Accounts com paginação e filtros.
• Consultar uma Alias Account — Obter os detalhes de uma Alias Account específica.
• Atualizar uma Alias Account — Editar os detalhes de uma Alias Account existente.
• Excluir uma Alias Account — Excluir logicamente ou remover permanentemente uma Alias Account.

​

Via Lerian Console

Você pode gerenciar Alias Accounts através da página Alias Accounts no Módulo Midaz do Lerian Console. O console oferece uma interface visual para criar, visualizar, editar e excluir Alias Accounts sem escrever código. Saiba mais no guia de Gerenciamento de Alias Accounts.

​

Próximos passos

---