> ## 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 mesma contabilidade. Os termos que você já aprendeu têm correspondentes diretos no produto.

## 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](https://docs.lerian.studio/pt/start-here/fundamentals/accounting/chart-of-accounts.md) | 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](https://docs.lerian.studio/pt/start-here/fundamentals/accounting/journal-entries.md) | Uma **transação** composta de **operações** |
| Uma única linha de débito ou crédito | Uma **operação** |
| 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
```

## Plano de contas → a hierarquia de contas

***

Um [plano de contas](https://docs.lerian.studio/pt/start-here/fundamentals/accounting/chart-of-accounts.md) organiza os grupos em que um negócio classifica seu dinheiro. No Midaz, uma [conta](https://docs.lerian.studio/pt/start-here/fundamentals/core-banking/building-blocks.md) pertence a um código de ativo e pode ter um ou mais registros de [saldo](https://docs.lerian.studio/pt/start-here/fundamentals/core-banking/building-blocks.md) 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](https://docs.lerian.studio/pt/start-here/fundamentals/core-banking/building-blocks.md) é 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](https://docs.lerian.studio/pt/start-here/fundamentals/accounting/journal-entries.md) 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](https://docs.lerian.studio/pt/start-here/fundamentals/core-banking/how-money-moves.md):

* 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](https://docs.lerian.studio/pt/start-here/fundamentals/accounting/debits-and-credits.md), 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.

O Midaz valida todo movimento aceito com uma origem clara e um destino claro. O sistema aplica essa regra em vez de uma pessoa. A [explicação de core banking sobre como o ledger registra o dinheiro](https://docs.lerian.studio/pt/start-here/fundamentals/core-banking/double-entry-explained.md) 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](https://docs.lerian.studio/pt/start-here/fundamentals/core-banking/routes-and-fees.md). 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](https://docs.lerian.studio/pt/start-here/fundamentals/core-banking/routes-and-fees.md) percorre isso por completo.

## Uma nota sobre titulares e contas

***

No Midaz, a [conta](https://docs.lerian.studio/pt/start-here/fundamentals/core-banking/holders-accounts-aliases.md) é 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ê](https://docs.lerian.studio/pt/start-here/fundamentals/core-banking/holders-accounts-aliases.md) esclarece isso.

## Próximos passos

***

> [!NOTE]
>
> **Vá mais fundo**
>
> Para ver essas entidades por completo, continue para os [Fundamentos de core banking](https://docs.lerian.studio/pt/start-here/fundamentals/core-banking/what-is-core-banking.md), ou revisite qualquer ideia na [Visão geral de contabilidade](https://docs.lerian.studio/pt/start-here/fundamentals/accounting/what-is-accounting.md).


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