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

# Contabilidade na Lerian

> Como as ideias centrais da contabilidade se mapeiam em entidades reais da Lerian e do Midaz (contas, transações, operações e rotas), para que o conceito e o produto se alinhem.

Tudo neste guia cobre contabilidade em geral. O Midaz implementa essa contabilidade em vez de reinventá-la. Os termos que você já aprendeu têm correspondentes diretos no produto e, quando você vê o mapeamento, a documentação se lê como uma língua que você já fala.

## As mesmas ideias, renomeadas para um ledger

***

A partir daqui, as palavras ficam mais específicas do produto. As ideias contábeis continuam as mesmas e apenas os nomes mudam. Na tabela abaixo, cada ideia contábil à esquerda mapeia para algo concreto no Midaz à direita.

| Ideia contábil                                                                                                                  | Na Lerian / Midaz                                        |
| ------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| [Plano de contas](/pt/start-here/fundamentals/accounting/chart-of-accounts)                                                     | A **hierarquia de contas** dentro de um Ledger           |
| As cinco famílias de contas (ativos, passivos, patrimônio líquido, receita, despesa)                                            | Como você **estrutura e agrupa** contas nessa hierarquia |
| [Lançamento contábil](/pt/start-here/fundamentals/accounting/journal-entries)                                                   | Uma **transação** composta de **operações**              |
| Uma única linha de débito ou crédito                                                                                            | Uma **operação**                                         |
| [Partidas dobradas](/pt/start-here/fundamentals/accounting/double-entry-bookkeeping) — os débitos devem ser iguais aos créditos | As operações de uma transação **sempre batem**           |
| Quais contas um tipo de lançamento pode movimentar                                                                              | Uma **rota contábil**                                    |

```mermaid theme={null}
flowchart LR
    subgraph ACC["Contabilidade"]
        direction TB
        CA["Plano de Contas"]:::a
        JE["Lançamento Contábil"]:::a
        DC["Regra de Débito / Crédito"]:::a
    end
    subgraph MID["Lerian / Midaz"]
        direction TB
        AH["Hierarquia de Contas"]:::m
        TO["Transação + Operações"]:::m
        AB["Sempre Balanceado"]:::m
    end
    CA --> AH
    JE --> TO
    DC --> AB
    classDef a fill:#dbeafe,stroke:#2563eb,color:#1e3a8a
    classDef m fill:#dcfce7,stroke:#16a34a,color:#14532d
```

O restante desta página percorre as linhas mais importantes.

## Plano de contas → a hierarquia de contas

***

Um [plano de contas](/pt/start-here/fundamentals/accounting/chart-of-accounts) organiza os grupos em que um negócio classifica seu dinheiro. No Midaz, uma [conta](/pt/start-here/fundamentals/core-banking/building-blocks) pertence a um código de ativo e pode ter um ou mais registros de [saldo](/pt/start-here/fundamentals/core-banking/building-blocks) por chave. As contas formam uma **hierarquia**, não uma lista plana. Você pode aninhá-las e agrupá-las para espelhar a estrutura de um negócio real. As cinco famílias contábeis (ativos, passivos, patrimônio líquido, receita, despesas) são o tipo de agrupamento que essa hierarquia expressa.

Um [Ledger](/pt/start-here/fundamentals/core-banking/building-blocks) é um livro de registros autocontido, e uma Organização pode ter vários. Assim, seu plano de contas vive como o conjunto estruturado de contas dentro de um Ledger. É o mesmo mapa de "onde o valor mora", com espaço para escalar.

## Lançamento contábil → transação + operações

***

Um [lançamento contábil](/pt/start-here/fundamentals/accounting/journal-entries) registra um evento como débitos e créditos correspondentes. O Midaz divide essa única ideia em duas palavras precisas que você verá em toda parte em [como o dinheiro se movimenta](/pt/start-here/fundamentals/core-banking/how-money-moves):

* Uma **transação** é um movimento completo de valor: o evento inteiro, do início ao fim. Isso é o lançamento contábil.
* Uma **operação** é uma parte desse movimento: o menor registro do Midaz para um efeito no saldo. Transferências não pendentes podem gerar operações de débito e crédito. Fluxos pendentes ou cancelados também podem incluir `ON_HOLD` ou `RELEASE`.

Então, quando você registrou "Caixa debitado em \$2.000, Receita creditada em \$2.000" como um lançamento contábil, a versão do Midaz é **uma transação composta de duas operações**. É o mesmo evento e os mesmos dois lados, no vocabulário do produto.

```mermaid theme={null}
flowchart TD
    A["Lançamento contábil<br/><i>contabilidade</i>"]:::acc --> B["Transação<br/><i>o movimento inteiro</i>"]:::mid
    B --> C["Operação<br/>débito"]:::mid
    B --> D["Operação<br/>crédito"]:::mid
    C --> E["Total de débitos"]:::tot
    D --> F["Total de créditos"]:::tot
    E --> G["Transação bate"]:::bal
    F --> G
    classDef acc fill:#dbeafe,stroke:#2563eb,color:#1e3a8a
    classDef mid fill:#dcfce7,stroke:#16a34a,color:#14532d
    classDef tot fill:#f3f4f6,stroke:#6b7280,color:#111827
    classDef bal fill:#fde68a,stroke:#d97706,color:#78350f
```

## Partidas dobradas → as transações sempre batem

***

O Midaz constrói a regra de ferro da contabilidade, [os débitos devem ser iguais aos créditos](/pt/start-here/fundamentals/accounting/debits-and-credits), em seu processamento. O Midaz valida a origem resolvida, o destino e os totais da transação antes de processar. Se eles forem diferentes, o movimento não passa. Sua origem separa a mutação atômica do saldo em cache da persistência apenas-anexação de transações e operações, então esta página não faz uma promessa de persistência tudo-ou-nada.

O Midaz valida todo movimento aceito com uma origem clara e um destino claro. O sistema aplica essa regra em vez de uma pessoa. Como a mutação do saldo e a persistência do histórico são separadas, controles de conciliação e recuperação identificam qualquer lacuna de persistência entre elas. A [explicação de core banking sobre como o ledger registra o dinheiro](/pt/start-here/fundamentals/core-banking/double-entry-explained) cobre isso do lado do ledger.

## Rotas contábeis → quais contas podem participar

***

Na contabilidade comum, você decide por julgamento quais contas um determinado tipo de lançamento deveria movimentar. O Midaz captura esse julgamento uma única vez como uma [rota contábil](/pt/start-here/fundamentals/core-banking/routes-and-fees). A rota é uma regra reutilizável para quem pode enviar, quem pode receber e quais débitos e créditos um movimento deveria registrar. Com a validação de rota habilitada para o Ledger, o Midaz confere as transações contra essa regra. Uma **tarifa** significa mais operações balanceadas na mesma transação.

Por exemplo, a rota de uma transferência de carteira define qual conta de cliente pode ser **debitada**, qual conta de cliente pode ser **creditada** e quais **contas de tarifa** entram quando uma tarifa se aplica. Com a validação de rota habilitada, o Midaz confere essas regras. O [guia de core banking sobre rotas e tarifas](/pt/start-here/fundamentals/core-banking/routes-and-fees) percorre isso por completo.

## Uma nota sobre titulares e contas

***

No Midaz, a [conta](/pt/start-here/fundamentals/core-banking/holders-accounts-aliases) é o contêiner do saldo. O dono no mundo real é um registro separado de **titular**, e apelidos amigáveis são **aliases**, mantidos separados para que o registro de valor do Ledger continue limpo. Se essa distinção importa para o seu trabalho, [quem é o dono de quê](/pt/start-here/fundamentals/core-banking/holders-accounts-aliases) esclarece isso.

## Próximos passos

***

<Note>
  **Vá mais fundo**

  Para ver essas entidades por completo, continue para os [Fundamentos de core banking](/pt/start-here/fundamentals/core-banking/what-is-core-banking), ou revisite qualquer ideia na [Visão geral de contabilidade](/pt/start-here/fundamentals/accounting/what-is-accounting).
</Note>