> ## 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 e rodadas de apropriação

> Como o Lender contabiliza no ledger: perfis contábeis e regras de lançamento, intenções de lançamento duráveis, rodadas de apropriação e referências de diário.

export const GDoubleEntry = ({children}) => <Tooltip headline="Partidas dobradas" tip="Todo movimento financeiro é registrado como pelo menos duas operações: um débito de uma conta e um crédito para outra, garantindo que o sistema esteja sempre equilibrado." cta="Ver glossário" href="/pt/start-here/glossary">
    {children}
  </Tooltip>;

export const GLedger = ({children}) => <Tooltip headline="Ledger" tip="O livro financeiro central que registra todas as transações, saldos e operações de uma organização, a fonte única de verdade para as finanças de uma unidade de negócio." cta="Ver glossário" href="/pt/start-here/glossary">
    {children}
  </Tooltip>;

O desembolso e a apropriação de juros chegam ao <GLedger>ledger</GLedger>, e um pagamento antecipado que liquida uma conta de empréstimo brasileira contra uma cotação de pagamento antecipado também chega. A camada contábil do Lender é como eles chegam lá. Um produto declara as regras de lançamento dele uma vez. Daí em diante, cada um desses eventos é contabilizado de forma automática e rastreável.

## Perfis contábeis e regras de lançamento

***

Um **perfil contábil** vincula uma versão de produto ao ledger. Ele define as **regras de lançamento**: as pernas de <GDoubleEntry>partidas dobradas</GDoubleEntry> que disparam para cada tipo de evento financeiro. Ele também define a organização de ledger e o ledger em que as transações resultantes são contabilizadas. Você cria um perfil por produto:

`POST /api/v1/loan-products/{id}/accounting-profiles`

O Lender valida as regras de lançamento quando você cria o perfil. Um produto, portanto, não pode entrar no ar com pernas que não balanceariam.

## Intenções de lançamento e o relay

***

O Lender não chama o ledger inline. Quando um evento financeiro acontece, o Lender persiste uma **intenção de lançamento** durável. Essa gravação acontece na mesma transação de banco de dados que muda o estado do domínio. Um relay então lança a transação balanceada no Midaz de forma assíncrona. É isso que torna as contabilizações confiáveis:

* **A intenção faz commit junto com a mudança de estado**: as duas caem em uma única transação de banco de dados, por um outbox transacional.
* **Idempotente**: cada lançamento carrega uma chave determinística, então novas tentativas colapsam em uma única transação do ledger.
* **Falha fechado**: se o roteamento não conseguir resolver um destino de ledger não vazio, o Lender recusa o lançamento e não o grava no lugar errado.

[O Lender na plataforma](/pt/products/lender/lender-in-the-platform) descreve o caminho inteiro.

## Rodadas de apropriação

***

Uma **rodada de apropriação** reconhece juros e os demais valores baseados em tempo. Uma rodada pega cada empréstimo cujo aniversário cai na data de referência da rodada, e produz os lançamentos dele.

`POST /api/v1/accrual-runs` começa uma rodada. O Lender seleciona as contas de empréstimo candidatas por conta própria, reconhece juros por conta e grava uma intenção de lançamento por reconhecimento.

<Tip>
  O reconhecimento é idempotente por conta de empréstimo, por mês contábil e por tipo de valor. Uma rodada começada duas vezes para o mesmo mês reconhece juros uma vez.
</Tip>

## Referências de diário

***

Cada rodada de apropriação registra uma **referência de diário**, o identificador contábil da própria rodada. O registro da referência também guarda o id de correlação que o Lender derivou para a rodada. O id da referência de diário identifica exatamente uma rodada. Uma leitura por id de correlação retorna a rodada mais recente que compartilha esse modo, essa data de referência e esse escopo de produtos.

| Operação                              | Finalidade                                                |
| ------------------------------------- | --------------------------------------------------------- |
| `GET /api/v1/journal-references`      | Consultar uma referência de diário pelo id de correlação. |
| `GET /api/v1/journal-references/{id}` | Ler uma única referência de diário.                       |

## Próximos passos

***

<Card title="Jurisdições" icon="earth-americas" href="/pt/products/lender/jurisdictions" horizontal>
  Veja como a jurisdição ativa molda as divulgações e os endpoints.
</Card>

<Card title="Pacote regulatório Brasil" icon="brazilian-real-sign" href="/pt/products/lender/brazil-regulatory-pack" horizontal>
  Sobreponha CET, IOF e estágios de PDD ao modelo contábil.
</Card>
