Contabilidade e rotinas de apropriação

O desembolso e a apropriação de juros chegam ao , e o mesmo vale para um pagamento antecipado que liquida uma conta de empréstimo brasileira contra uma cotação de pagamento antecipado. A camada contábil do Lender é como eles chegam lá: um produto declara suas regras de posting uma vez, e daí em diante cada um desses eventos contabiliza de forma automática e rastreável.

​

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 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:

• A intenção é confirmada junto com a mudança de estado — os dois caem numa única transação de banco de dados, através de um 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.

​

Rotinas de apropriação

---

Uma rotina de apropriação reconhece os juros e os demais valores baseados no tempo. Uma rotina toma cada empréstimo cujo aniversário cai na data de negócio dela, e produz os postings correspondentes. POST /api/v1/accrual-runs inicia uma rotina. O Lender seleciona por conta própria as contas de empréstimo candidatas, reconhece os juros de cada uma e escreve uma intenção de posting por reconhecimento.

​

Referências de lançamento

---

Cada rotina de apropriação registra uma referência de lançamento — o identificador contábil da própria rotina. O registro da referência também guarda o id de correlação que o Lender derivou para a rotina. O id da referência de lançamento identifica uma única rotina de forma exata; uma leitura por id de correlação devolve a rotina mais recente que compartilha aquele modo, aquela data de negócio e aqueles produtos restringidos.

​

Próximos passos

---