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

> Como o Lender contabiliza no ledger — perfis contábeis e regras de posting, intenções de posting duráveis, rotinas de apropriação e reexecuções, e referências de lançamento.

export const GDoubleEntry = ({children}) => <Tooltip headline="Partidas dobradas" tip="Cada movimentação financeira é registrada como pelo menos duas operações: um débito de uma conta e um crédito em outra, garantindo que o sistema esteja sempre balanceado." cta="Ver glossário" href="/pt/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/glossary">
    {children}
  </Tooltip>;

Cada evento financeiro de uma jornada de crédito termina no <GLedger>ledger</GLedger>. A camada contábil do Lender é como ele chega lá: um produto declara suas regras de posting uma vez, e daí em diante desembolsos, repagamentos, apropriações e estornos contabilizam automática e rastreavelmente.

## Perfis contábeis e regras de posting

***

Um **perfil contábil** amarra uma versão do produto ao ledger. Ele define as **regras de posting** — os lançamentos de <GDoubleEntry>partidas dobradas</GDoubleEntry> que disparam para cada tipo de evento financeiro — e 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`

As regras de posting são validadas quando o perfil é criado, então um produto não pode entrar em produção com lançamentos que não balanceariam.

## Intenções de posting e o relay

***

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

* **Sem postings perdidos** — a intenção é confirmada junto com a mudança de estado, num outbox transacional.
* **Idempotente** — cada posting carrega uma chave determinística, então reexecuções colapsam para uma única transação do ledger.
* **Falha fechado** — se o roteamento não consegue resolver um destino de ledger não vazio, o posting é recusado em vez de gravado no lugar errado.

A rota completa é descrita em [O Lender na plataforma](/pt/lender/lender-in-the-platform).

## Rotinas de apropriação

***

Juros e outros valores baseados no tempo são reconhecidos por uma **rotina de apropriação** — um lote que calcula o que foi apropriado ao longo de um período em toda a carteira e produz os postings correspondentes.

<Steps>
  <Step title="Inicie uma rotina">
    `POST /api/v1/accrual-runs` enfileira uma rotina de apropriação.
  </Step>

  <Step title="Reexecute se necessário">
    `POST /api/v1/accrual-runs/{id}/retry` reenfileira os itens de uma rotina que não completaram, sem reapropriar o que já teve sucesso.
  </Step>
</Steps>

## Referências de lançamento

***

Uma **referência de lançamento** amarra um evento financeiro do Lender à transação do ledger que o registrou, para que você possa rastrear um posting nas duas direções.

| Operação                              | Propósito                                                |
| ------------------------------------- | -------------------------------------------------------- |
| `GET /api/v1/journal-references`      | Busca uma referência de lançamento por id de correlação. |
| `GET /api/v1/journal-references/{id}` | Lê uma referência de lançamento.                         |

<Tip>
  Reconcilie o Lender contra o ledger por id de correlação: uma referência de lançamento aponta para a transação exata do Midaz que um repagamento ou apropriação produziu.
</Tip>

## Próximos passos

***

<Card title="Portfólio e inadimplência" icon="chart-line" href="/pt/lender/portfolio-and-delinquency" horizontal>
  Veja a carteira contabilizada em agregado.
</Card>

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