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

# Quem é dono do quê: Holders, contas e aliases

> Holders, contas e aliases desembaraçados — o que o ledger de fato possui, quem está por trás dele no mundo real e os nomes amigáveis que apontam para ele.

Você viu contas guardarem saldos e movimentações fluírem entre elas. Mas quem *é dono* dessas contas? E por que os sistemas bancários ficam jogando palavras como "alias" e "alias account" como se fossem obviamente coisas diferentes? Esta página desembaraça tudo isso.

Imagine uma fileira de cofres numerados em uma câmara-forte. O cofre em si apenas guarda o que está dentro dele — ele não sabe nem se importa com quem você é. Para tornar essa câmara-forte útil, você também precisa de um registro de *quem* é dono do cofre, e de uma forma mais amigável de se referir a ele do que um número longo. Esses são três trabalhos separados, e o core banking os mantém separados de propósito.

## A conta é a verdade

***

Uma **conta** é o contêiner de saldo — a verdade que vive dentro do Ledger. Ela registra exatamente quanto de um asset guarda, construído a partir de cada movimentação para dentro e para fora. É só isso que ela faz, e isso é deliberado: a conta permanece limpa e confiável porque não carrega dados confusos de identidade do mundo real.

Na câmara-forte, a conta é o cofre numerado. Ele guarda valor; não guarda o seu nome, seus documentos ou seu número de telefone.

## O Holder é a pessoa ou empresa

***

Um **Holder** é o dono do mundo real que está por trás da conta — **a pessoa ou empresa que você registra**. Este é o cadastro do cliente: nome, número do documento, dados de contato. Registrar esses donos é um trabalho próprio, frequentemente chamado de *cadastro de pessoas* — acompanhar as pessoas e empresas com as quais o seu negócio lida.

Por que manter o Holder separado da conta? Por duas razões:

* Um dono pode ter **muitas contas**. O dono é registrado uma vez; as contas se vinculam a ele.
* O Ledger permanece confiável. Os dados de identidade mudam com frequência e às vezes são sensíveis — você não quer que fiquem emaranhados nos registros que comprovam seus saldos.

Na câmara-forte, o Holder é a pessoa nomeada no contrato. Uma pessoa pode alugar vários cofres.

## Aliases: nomes amigáveis para contas

***

As contas são identificadas por IDs longos e únicos — precisos, mas nada divertidos de digitar ou lembrar. Então você dá a elas nomes mais amigáveis. É aqui que dois termos de sonoridade parecida se confundem — eles fazem coisas diferentes:

* Um **alias** é um identificador amigável para uma conta — um apelido como `marketing-fund` para você não precisar lidar com um ID longo.
* Um **alias account** é um registro que vincula os dados bancários do mundo real de um dono (banco, agência, número da conta) a uma conta subjacente no Ledger.

Então um *alias* é apenas um rótulo conveniente apontando para uma das suas próprias contas. Um *alias account* é uma ponte — ele conecta dados bancários externos à conta certa dentro do seu Ledger.

<Note>
  De volta à câmara-forte. O **alias** é o adesivo com o apelido no cofre ("Fundo de marketing") para que a equipe não precise do número do cofre. O **alias account** é a ficha de índice da recepção que vincula os dados bancários externos de um cliente a qual cofre é o dele.
</Note>

```mermaid mermaid theme={null}
flowchart LR
  H["Holder<br/>(pessoa/empresa registrada)"] --> AA["Alias account<br/>(dados bancários reais)"]
  AA --> ACC["Conta<br/>(saldo no Ledger)"]
  AL["Alias<br/>(apelido amigável)"] -.aponta para.-> ACC
  classDef bal fill:#fff8e1,stroke:#f4b400,color:#333;
  class ACC bal;
```

## Por que se dar ao trabalho de toda essa separação

***

Separar esses papéis parece trabalho extra, mas compra para você flexibilidade real:

* Um Holder, **muitas contas**, sem duplicar o dono a cada vez.
* **Aliases** amigáveis para que pessoas e sistemas referenciem contas sem IDs longos.
* **Alias accounts** que conectam a múltiplos bancos e sistemas externos — sem nunca poluir o registro limpo de valor do Ledger.

O Ledger mantém a verdade. Todo o resto aponta para ele.

## Em resumo

***

* Uma **conta** é o contêiner de saldo — a verdade dentro do Ledger, livre de dados de identidade.
* Um **Holder** é o dono do mundo real que você registra — a pessoa ou empresa (*cadastro de pessoas*). Um Holder pode ser dono de muitas contas.
* Um **alias** é um apelido amigável apontando para uma das suas contas.
* Um **alias account** é um registro que vincula dados bancários do mundo real a uma conta do Ledger.
* Manter esses papéis separados compra flexibilidade mantendo o Ledger limpo.

<Note>
  **Veja na Lerian**

  Veja essas ideias na prática: [Contas](/pt/midaz/accounts) e [Alias accounts](/pt/midaz/crm/alias-accounts).
</Note>