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

# Mapeie o seu plano de contas

> Escolha o ledger em que o Lender contabiliza, mapeie cada evento contábil para as suas contas, leia o plano de volta e mude-o depois.

O Lender contabiliza todo evento de dinheiro de um produto no ledger (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.) do produto, no Midaz. Você mapeia esses eventos para as suas contas uma vez, em um plano. As contas são suas. O Lender define a forma de cada lançamento em partidas dobradas (Todo movimento financeiro é registrado como pelo menos duas operações: um débito de uma conta e um crédito para outra, de modo que o sistema está sempre equilibrado.) e recusa um plano que não fecha.

Este guia é para o back office e para o contador do cliente. Ele cobre o ledger, os eventos contábeis e as contas que você define. [Contabilidade e rodadas de apropriação](https://docs.lerian.studio/pt/products/lender/accounting-and-accrual-runs.md) cobre como um lançamento chega ao ledger.

## Antes de começar

***

* Crie primeiro o produto de empréstimo e uma versão. Veja [Defina um produto de empréstimo](https://docs.lerian.studio/pt/products/lender/define-a-loan-product.md).
* Para configurar um plano, o seu papel precisa de `loan_product` `write` e `accounting` `write`. Os papéis operator, editor e admin têm as duas.
* Para mudar um plano, ou para designar uma conta de suspensão, o seu papel precisa de `accounting` `supersede`. Apenas o papel admin a tem.

## O ledger do produto

***

Um plano nomeia a organização do Midaz e o ledger do Midaz em que os lançamentos do produto são contabilizados.

* No modo multi-tenant, a organização é obrigatória. No modo single-tenant, um plano sem destino usa o padrão do ambiente.
* Nomeie apenas a organização, e o Lender reutiliza o ledger em que o produto já contabiliza nela. Se o produto não tem nenhum, o Lender procura ou cria um ledger chamado `lender-product-<loan product id>`. A resposta nomeia o ledger escolhido.
* Toda versão de um produto contabiliza no ledger que a primeira versão configurada escolheu (`LENDER-0453`). Vários produtos podem compartilhar um ledger.
* O Lender recusa um ledger com validação de rota ligada (`LENDER-0452`). O Lender não envia nenhuma rota contábil ao Midaz.
* O Lender recusa uma organização ou um ledger que o Midaz não conhece (`LENDER-0442`). Se o Midaz não responde, o Lender responde `503` com `LENDER-0441`. Repita a requisição.

`MIDAZ_LEDGER_ACCOUNT_PROVISIONING_ENABLED` é `true` por padrão. Veja [Configuração e deploy](https://docs.lerian.studio/pt/products/lender/configuration-and-deploy.md). O Lender então adota o ativo pelo código ou o cria. Ele cria cada conta antes do primeiro lançamento nela.

* A natureza de uma perna define o tipo da conta. Uma natureza de crédito cria uma conta `deposit`. Uma natureza de débito cria uma conta `lender_debit`.
* A direção de uma conta é fixada quando a conta é criada.
* O Lender adota uma conta que já existe. Ele confere a direção da conta com a natureza da perna e recusa o lançamento se elas diferem.

Uma conta por contrato tem o alias `<prefix>:<id>`. O prefixo é seu, com no máximo 17 caracteres. O id são os 32 dígitos hexadecimais do id da conta de empréstimo. O Lender cria uma conta por contrato para uma posição do tomador com o titular do CRM do contrato como dono.

## Anatomia de uma regra de lançamento

***

Uma **regra de lançamento** mapeia um evento contábil para 2 a 16 pernas. Uma regra também pode levar `metadata`, um mapa de valores de texto. Cada perna movimenta dinheiro em uma conta.

| Campo | O que significa |
| - | - |
| `account` | A conta, como o alias dela no Midaz. Tem no máximo 50 letras, dígitos, `:`, `_` e `-`, com um `@` inicial opcional. Também pode ser `@external/<ASSET>`. O Lender recusa qualquer outra coisa (`LENDER-0429`). |
| `role` | O papel econômico reservado da perna: `principal`, `interest`, `iof`, `tax`, `cash`, `unapplied_cash`, `counterparty` ou `suspense`. |
| `component` | Um código aberto, como `iof`, para uma perna sem papel reservado. Defina `role` ou `component`, nunca os dois. |
| `side` | `debit` ou `credit`. |
| `nature` | A natureza da conta, não o lado da perna. Use `debit` para um ativo ou uma despesa. Use `credit` para um passivo, patrimônio ou receita. Uma conta redutora tem a própria natureza: rendas a apropriar, cada provisão e o ajuste do art. 22 têm natureza de crédito. Toda perna que nomeia uma conta declara a mesma natureza. |
| `optional` | Permite que o Lender omita o valor de uma perna de componente, ou o registre como zero. Apenas uma perna de componente pode ser opcional. |
| `perOperation` | Contabiliza a perna em uma conta para cada contrato. `account` passa a ser um prefixo de no máximo 17 caracteres. |

### Posições por contrato

Uma perna que contabiliza o que um tomador deve precisa ser por contrato (`LENDER-0408`). Estes são os códigos de valor: `principal`, `interest`, `fees`, `penalties`, `unapplied_cash`, `assignment_retained` e `returned_payment`. Dois tipos de perna são a exceção:

* Uma perna de receita ou de despesa.
* O crédito de `accrual_withholding` em rendas a apropriar.

A tarifa de originação retida é por contrato nas duas pontas, em uma só conta: o crédito `origination_fee` em `disbursement` e o débito de `accrual_fee_amortization`. Uma conta de tarifa compartilhada é aceita, mas bloqueia toda baixa para prejuízo (`LENDER-0411`), e nenhuma mudança de plano corrige isso.

Algumas contas nunca são por contrato:

* A conta do tributo sobre a receita, porque ele é um passivo da instituição com o fisco (`LENDER-0419`).
* Uma conta de receita ou de despesa (`LENDER-0987`).
* A conta de contrapartida de `renegotiation_derecognition` e `renegotiation_recognition`. Essa conta ponte é uma conta só para o produto.

### Exemplo

Esta é a regra `disbursement` de um plano. Os códigos de conta são apenas uma ilustração.

```json theme={null}
{
  "eventType": "disbursement",
  "legs": [
    { "account": "1100-10-001", "role": "principal", "side": "debit", "nature": "debit", "perOperation": true },
    { "account": "@external/BRL", "role": "cash", "side": "credit", "nature": "debit" },
    { "account": "2300-40-001", "component": "iof", "side": "credit", "nature": "credit", "optional": true },
    { "account": "2400-10-001", "component": "origination_fee", "side": "credit", "nature": "credit", "optional": true, "perOperation": true }
  ]
}
```

`@external/<ASSET>` é a conta que o Midaz cria para cada ativo. Ela registra o dinheiro que entra no ledger ou sai dele. Veja [Contas](https://docs.lerian.studio/pt/products/midaz/accounts.md).

A sua conta de tesouraria pode ficar no mesmo ledger. Então a perna `cash` pode nomeá-la. O Lender liga o saldo negativo apenas para as contas de crédito que ele lista para isso, e nunca para a conta `cash`. Veja [Balance Overdraft](https://docs.lerian.studio/pt/products/midaz/balance-overdraft.md). O Midaz portanto recusa um desembolso maior que o saldo dessa conta. O lançamento estaciona como um caso (`LENDER-0458`). Mantenha o caixa na conta.

## Os eventos contábeis

***

Um plano pode levar três tipos de evento: eventos que todo plano precisa, eventos opcionais e eventos que o Lender deriva.

### Eventos obrigatórios

O Lender recusa um plano que não tem um destes eventos.

| Evento | O Lender lança quando | O que as pernas contabilizam |
| - | - | - |
| `disbursement` | O Lender libera um empréstimo. | Um débito do principal por contrato. Um crédito do caixa líquido. Um crédito de cada tributo que a jurisdição retém, como o IOF, e da tarifa de originação que uma versão retém. |
| `repayment` | Um pagamento quita uma parcela. | Um débito do caixa. Um crédito do principal e dos juros que o pagamento quita, por contrato. A conta de juros é a que `accrual` debita (`LENDER-0440`). |
| `prepayment` | Um tomador paga um empréstimo antes do cronograma, no todo ou em parte. | Cinco pernas nesta ordem: débito `cash`, débito opcional `charge_rebate`, débito opcional `iof_refund`, crédito `principal`, crédito opcional `iof_due`. |
| `accrual` | Uma rodada de apropriação reconhece os juros de um mês. | Um débito dos juros a receber, por contrato. Um crédito da receita de juros. |
| `accrual_withholding` | Os juros são retidos em um ativo problemático (Res. CMN 4.966 art. 17). | Um débito dos mesmos juros a receber que `accrual` debita. Um crédito de rendas a apropriar, em uma conta compartilhada que não é a receita de `accrual`. |
| `renegotiation_gain` | Uma renegociação não substancial (Res. CMN 4.966 art. 22) deixa um ganho. | Um débito da conta de ajuste do contrato. Um crédito do ganho. |
| `renegotiation_loss` | Uma renegociação não substancial (Res. CMN 4.966 art. 22) deixa uma perda. | Um débito da perda. Um crédito da conta de ajuste do contrato. |
| `collection_unapplied` | Um pagamento chega e o contrato o mantém como dinheiro não aplicado. | Um débito de `cash`. Um crédito de `unapplied_cash`, por contrato. |
| `collection_reapply` | O Lender aplica o dinheiro não aplicado a um recebível, como a liquidação diária faz no vencimento. | Um débito de `unapplied_cash`, seu único débito. Um crédito de cada recebível que ele quita. |
| `collection_refund` | O Lender devolve o dinheiro não aplicado ao tomador. | Um débito de `unapplied_cash`. Um crédito de `cash`. |
| `provision_constitution` | A medição de uma data útil aumenta a provisão adicional de um contrato. | Um débito da despesa. Um crédito da provisão. O evento leva apenas o aumento. |
| `provision_reversal` | A medição de uma data útil reduz essa provisão. | Um débito da provisão. Um crédito de uma conta de despesa ou de receita de reversão. |
| `provision_incurred_constitution` | A medição de uma data útil aumenta a perda incorrida (Res. BCB 352 art. 76). | Um débito da despesa. Um crédito da provisão da perda incorrida. |
| `provision_incurred_reversal` | A medição de uma data útil reduz a perda incorrida. | Um débito dessa provisão. Um crédito de uma conta de despesa ou de receita de reversão. |

As duas constituições creditam duas contas de provisão diferentes. O Lender recusa um plano que credita uma conta só para as duas (`LENDER-0455`).

### Eventos opcionais

A última coluna diz o que acontece se você a deixa de fora.

| Família | Eventos | Leve-a quando | Sem ela |
| - | - | - | - |
| Tributo sobre a receita | `accrual_tax` | A receita de juros sofre PIS/COFINS. | A rodada de apropriação calcula o tributo e não lança nada. Ela conta o tributo como reconhecido e não lançado. |
| Tarifa de originação retida | `accrual_fee_amortization`, mais a perna opcional `origination_fee` em `disbursement` | O produto retém uma tarifa de originação no desembolso. Contabilize por contrato, em uma só conta. | O Lender recusa cada centavo da tarifa. |
| Tarifa aplicada depois da liberação | `charge_appropriation`, mais uma perna de crédito `fees` por contrato em `repayment` | Uma versão declara um template de tarifa que um operador pode aplicar depois da liberação. O template tem um valor fixo. | O Lender recusa o plano (`LENDER-0989`). |
| Renegociação substancial | `renegotiation_derecognition`, `renegotiation_recognition` | O produto renegocia de forma substancial pela Res. CMN 4.966 art. 22. O contrato antigo termina e um novo começa. | Um produto deve levar os dois eventos para ser renegociado de forma substancial. |
| Cessão, risco transferido | `assignment_derecognition`, `assignment_retained_settlement` | Você vende recebíveis a um fundo. O segundo evento é necessário para vender um recebível no meio de um ciclo. | O Lender recusa a aceitação de uma venda sobre um produto sem `assignment_derecognition` e abre um caso de exceção. |
| Cessão, risco retido | `assignment_secured_borrowing`, `assignment_funding_amortization`, `assignment_funding_payoff` | Você vende recebíveis e responde por eles. Os dois primeiros andam juntos. O terceiro ainda não é obrigatório. | O Lender recusa uma venda com risco retido sobre um produto que não tem os dois primeiros. |
| Recompra de cessão | `assignment_repurchase` | Um bancarizador pode liquidar antes um recebível vendido. | O Lender recusa o recibo de liquidação do fundo. |
| Refinanciamento | `refinance_payoff`, `refinance_payoff_reversal` | O produto é refinanciado. | Um produto deve levar os dois eventos para ser refinanciado. |
| Pagamento devolvido | `returned_payment_recognition`, `returned_payment_provision_constitution`, `returned_payment_provision_reversal`, `returned_payment_write_off` | Os pagamentos finais podem ser devolvidos depois que o mandato da folha acaba. | O Lender recusa um plano que leva o primeiro evento sem os outros três (`LENDER-0406`). |
| Repasse do empregador | `payroll_payer_provision_constitution`, `payroll_payer_provision_reversal` | A regra `repayment` leva a perna `payroll_payer_receivable`. | O Lender recusa o plano (`LENDER-0423`). |
| Contas de compensação | `compensation_control`, com os controles `written_off_credit` e `guarantee_received` | Você mantém controles fora do balanço para crédito baixado ou para garantias. | O Lender recusa uma baixa e não grava nada (`LENDER-0975`). |
| Recuperação de crédito baixado | `credit_loss_recovery` | Um tomador com crédito baixado pode pagar depois. | O Lender recusa a recuperação e não grava nada (`LENDER-0980`). |

Para os eventos de cessão, veja [Ceder recebíveis](https://docs.lerian.studio/pt/products/lender/assignment-of-receivables.md).

### Eventos que você não configura

O Lender deriva estes eventos das regras acima. Um plano não pode levá-los. Se você enviar um, o Lender responde `422`.

| Evento | Contabiliza nas contas de | O que faz |
| - | - | - |
| `reversal` | `repayment` | Estorna um pagamento. Ele inverte o lado de cada perna do pagamento. |
| `accrual_reversal` | `accrual` | Tira da receita os juros que um fechamento contabilizou além do contrato. |
| `accrual_withholding_reversal` | `accrual_withholding` | Tira de rendas a apropriar os juros que um fechamento reteve além do contrato. |
| `accrual_suspension` | `accrual`, `accrual_withholding` | Tira de novo da receita os juros de um mês fechado, quando uma caracterização tardia faz do contrato um ativo problemático dentro desse mês. |
| `accrual_tax_suspension` | `accrual_tax` | Devolve o PIS/COFINS que um mês fechado contabilizou sobre os juros que a suspensão move. |
| `suspended_income_recognition` | `accrual`, `accrual_withholding` | Reconhece como receita os juros retidos quando o recebimento chega. |
| `accrual_fee_amortization_reversal` | `accrual_fee_amortization` | Devolve a tarifa liberada além de uma reavaliação. |
| `interest_capitalization` | `disbursement`, `accrual` | Move dos juros a receber para o principal a receber os juros cobrados que um reescalonamento levou ao principal. |
| `interest_unapplied` | `repayment`, `collection_unapplied` | Move dos juros a receber para o dinheiro não aplicado, devido de volta ao tomador, os recebimentos de juros pagos por dias depois de uma quitação. |
| `modification_tax` | `disbursement` | Financia no principal o tributo que uma modificação do cronograma cobra. |
| `late_charge_recognition` | `repayment`, `accrual` | Reconhece como receita a multa e os juros de mora recebidos. |
| `late_charge_recognition_reversal` | `repayment`, `accrual` | Devolve essa receita. |
| `late_charge_capitalization` | `disbursement`, `repayment` | Move para o principal um encargo de mora reconhecido que um reescalonamento levou ao principal. |
| `late_charge_withholding` | `repayment`, `accrual_withholding` | Mantém fora da receita o encargo de mora que um reescalonamento levou a um contrato que o art. 17 suspende. |
| `late_charge_waiver` | `renegotiation_loss`, `repayment` | Leva para a perda do art. 22 o encargo de mora que um reescalonamento dispensou. |
| `renegotiation_loss_unwind` | `accrual`, `renegotiation_loss` | Reconhece de volta um ajuste do art. 22 conforme o contrato corre. |
| `renegotiation_gain_unwind` | `accrual`, `renegotiation_loss` | O espelho da reversão gradual da perda. |
| `renegotiation_gain_reversal` | `renegotiation_gain` | Tira do resultado um ganho do primeiro dia enquanto o art. 17 o retém. |
| `collection_reapply_reversal` | `collection_reapply` | Devolve ao dinheiro não aplicado uma liquidação feita no vencimento. |
| `refinance_disbursement_reversal` | `disbursement` | Encerra o contrato novo de um refinanciamento que o trilho desfez. |
| `returned_payment_collection` | `returned_payment_recognition` | Contabiliza de volta a dívida de pagamento devolvido quando o tomador paga por outro meio. |
| `charge_assessment` | `repayment`, `charge_appropriation` | Cobra uma tarifa aplicada quando o Lender a aplica, contra os recebíveis de tarifas do contrato. |
| `charge_appropriation_reversal` | `charge_appropriation` | Estorna uma apropriação de tarifa. |
| `compensation_control_release` | `compensation_control` | Libera um controle. É a regra de abertura com os lados invertidos. |
| `credit_loss_recovery_reversal` | `credit_loss_recovery` | Devolve uma recuperação, nas contas em que a recuperação contabilizou. |

## Verificações que o Lender faz no seu plano

***

O Lender verifica o plano quando você o configura ou o muda. Ele não grava nada quando uma verificação falha.

| Código | Recusado quando | Correção |
| - | - | - |
| `LENDER-0406` | O plano leva `returned_payment_recognition` sem as três regras que provisionam e baixam a dívida. | Adicione as três regras e reenvie. |
| `LENDER-0408` | Uma perna contabiliza uma posição do tomador em uma conta que todos os contratos compartilham. | Contabilize essa perna por contrato. |
| `LENDER-0419` | O tributo sobre a receita é contabilizado por contrato. | Contabilize as duas pernas do tributo em contas compartilhadas da instituição. |
| `LENDER-0423` | A regra `repayment` leva `payroll_payer_receivable` e o plano não tem o par de provisão do empregador. | Adicione as duas regras `payroll_payer_provision_*` e reenvie. |
| `LENDER-0426` | Uma versão cobra multa e juros de mora e `repayment` não tem uma perna de crédito `penalties` por contrato. | Adicione uma perna de crédito com `component` `penalties` e `perOperation` true. |
| `LENDER-0429` | Uma conta não é um alias do Midaz. | Reescreva a conta, por exemplo `1100-10-001`. |
| `LENDER-0430` | A jurisdição retém um tributo no desembolso e `disbursement` não tem uma perna de crédito para ele. | Adicione uma perna de crédito com esse `component`, por exemplo `iof`. Marque-a como `optional` se algumas versões não retêm nada. |
| `LENDER-0440` | `repayment` não tem uma perna de crédito `interest`. | Adicione uma na conta que `accrual` debita. |
| `LENDER-0442` | O Midaz não conhece a organização, ou nenhum ledger nela, com esses ids. | Corrija `midazOrganizationId` e `midazLedgerId`. |
| `LENDER-0452` | O ledger tem a validação de rota do Midaz ligada. | Desligue-a no ledger, ou nomeie outro ledger. |
| `LENDER-0453` | O produto já contabiliza em outro ledger. | Nomeie o ledger do detalhe, ou apenas a organização dele. |
| `LENDER-0455` | As duas constituições de provisão creditam uma conta de provisão só. | Credite uma provisão separada para a perda incorrida. |
| `LENDER-0987` | Uma perna de receita ou de despesa é contabilizada por contrato. | Contabilize cada perna de receita e de despesa em uma conta compartilhada. |
| `LENDER-0989` | O plano não consegue contabilizar uma tarifa aplicada depois da liberação. | Adicione a perna de crédito `fees` por contrato a `repayment` e a regra `charge_appropriation`, cada uma em uma conta própria. |

Configurar um plano para uma versão que já tem um responde `409 Conflict`.

A [lista de erros do Lender](https://docs.lerian.studio/pt/reference/products/lender/lender-error-list.md) traz o texto completo de cada código.

## Leia um plano de volta

***

| Operação | Finalidade |
| - | - |
| `GET /api/v1/accounting-profiles` | Listar os planos com a cobertura deles. |
| `GET /api/v1/accounting-profiles/{id}` | Ler um plano inteiro. |

A lista mostra, para cada plano, `eventTypes`, `missingEventTypes`, `effectiveFrom` e `createdAt`. `missingEventTypes` nomeia os eventos obrigatórios para os quais o plano não tem regra. Ela fica vazia quando o plano está completo.

A leitura por id devolve o plano inteiro. Ela traz `postingRules` com as pernas, `midazOrganizationId`, `midazLedgerId`, `effectiveFrom` e `createdAt`. Ela não tem campo de cobertura. Um id que o Lender não conhece responde `404` com `LENDER-0454`.

## Mude o plano

***

Você configura uma versão uma vez. O primeiro plano dela vale a partir de `1900-01-01`, e uma segunda chamada de configuração responde `409`. Todo plano é imutável. Uma versão guarda uma cadeia de planos datados, e uma mudança acrescenta um plano datado a toda versão configurada do produto.

Uma mudança é do produto, não de uma versão.

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

O corpo traz o plano novo completo e `effectiveFrom`. `effectiveFrom` é sempre o primeiro dia de um mês que ainda não abriu amanhã. No último dia de um mês, a escolha mais cedo é o primeiro dia do mês depois do próximo. O plano novo contabiliza no mesmo ledger do antigo (`LENDER-0443`).

O plano novo mantém toda posição por contrato do plano antigo. Uma conta compartilhada de saldo mantém a conta e o modo dela: uma provisão, um valor a pagar ou o caixa. As contas de receita e de despesa podem mudar. O Lender recusa uma mudança que envia duas posições de uma conta por contrato para contas diferentes (`LENDER-0986`).

O plano em vigor em um dia é o plano com o maior `effectiveFrom` até esse dia. Um contrato fica no plano que guarda o saldo dele até o saldo ser transferido.

**1. Registre a mudança**

Envie a mudança. Leia `movedPositions` na resposta. Ela lista cada posição cujo saldo muda de conta.

**2. Deixe os saldos se moverem**

O saldo de um contrato se move dentro do primeiro lançamento dele depois da mudança. O fechamento do mês de vigência move os contratos que não tiveram lançamento. Nada mais é necessário.

**3. Opcional: varra os contratos que ainda esperam**

Depois do fechamento do mês anterior à vigência, `POST /api/v1/loan-products/{id}/accounting-profiles/supersessions/sweeps` os move agora, com um lançamento por contrato. Ele exige o header `X-Idempotency`. Cada repetição exige uma chave nova, porque a mesma chave devolve a resposta anterior.

**4. Limpe o que segura um contrato**

`LENDER-0450` lista as causas possíveis, não a que vale para um contrato, e todo contrato que estava pronto foi movido. Confira nesta ordem: o fechamento do mês anterior à vigência; uma mudança anterior ainda aberta (varra essa primeiro); lançamentos estacionados (veja [Contabilidade e rodadas de apropriação](https://docs.lerian.studio/pt/products/lender/accounting-and-accrual-runs.md)); um valor que o ledger retém. Depois repita a varredura com uma chave `X-Idempotency` nova. Não repita em laço.

No Console, veja **Mudanças de plano de contas** e **Mover contratos em espera** em [Crédito](https://docs.lerian.studio/pt/products/lender/console/credit.md).

## Contas de suspensão

***

Alguns lançamentos precisam de uma conta de suspensão. Um desembolso em partes e um ajuste compensatório as usam. Você designa uma conta para cada moeda e papel.

| Papel | O que recebe | Conta padrão para BRL |
| - | - | - |
| `suspense` | O resíduo da CCB, de qualquer lado. | `suspensao-brl`, natureza de crédito |
| `below` | O que um desembolso em partes ainda deve ao tomador. | `valores-a-liberar-brl`, natureza de crédito |
| `above` | O que o tomador pagou além do valor liberado. | `pago-a-maior-brl`, natureza de débito |
| `loss` | A despesa de um excesso de desembolso que o tomador fica. | `perdas-brl`, natureza de débito |

`PUT /api/v1/internal/accounting/suspense-accounts/{currency}/{role}` designa a conta, com `gl_account` no corpo. Uma conta designada já deve existir no ledger. O Lender nunca a cria, a menos que ela tenha o nome exato do padrão.

Um contrato fica com a conta que guarda o primeiro valor dele em um papel. Uma conta nova vale para os contratos que ainda não têm nenhuma. Quando o Lender provisiona as contas do ledger, um papel em BRL sem conta designada contabiliza no padrão. `GET` no mesmo caminho responde `404` com `LENDER-0449` quando você não designou nenhuma. Veja [Contabilidade](https://docs.lerian.studio/pt/products/lender/console/accounting.md).

## No Console

***

A tela para configurar um plano exige as mesmas duas permissões da API. Abra **Crédito**, abra o produto e a versão, e escolha **Configurar perfil contábil**. Veja [Crédito](https://docs.lerian.studio/pt/products/lender/console/credit.md).

**1. Escolha a instituição financeira**

**Instituição financeira** nomeia a organização. O Lender cria nela o ledger do produto, ou reutiliza o ledger que já criou.

**2. Revise a planilha**

A planilha começa como uma cópia do plano mais recente do produto, quando a tela consegue editar todas as regras dele. Revise cada conta antes de registrar.

**3. Marque as pernas por contrato**

Marque como **Por contrato** cada perna que contabiliza uma posição do tomador.

**4. Registre o plano**

**Registrar perfil contábil** salva o plano em definitivo. Fechar a página descarta uma planilha que você não registrou.

A tela registra estes eventos: os eventos obrigatórios, `payroll_payer_provision_constitution`, `payroll_payer_provision_reversal`, `refinance_payoff`, `refinance_payoff_reversal`, `assignment_derecognition`, `assignment_retained_settlement`, `assignment_repurchase`, `credit_loss_recovery` e `compensation_control`.

A tela não registra estes eventos: `accrual_fee_amortization`, `charge_appropriation`, `renegotiation_derecognition`, `renegotiation_recognition`, `assignment_secured_borrowing`, `assignment_funding_amortization`, `assignment_funding_payoff` e os quatro eventos `returned_payment_*`. Para levar um deles, envie o plano com `POST /api/v1/loan-products/{id}/accounting-profiles`, com as mesmas duas permissões. Um produto só renegocia de forma substancial com o par `renegotiation_derecognition` e `renegotiation_recognition`, então você envia esse plano pela API.

A tela não copia um plano que tem uma regra que ela não edita. A planilha então abre vazia, e o aviso **Este plano tem regras que esta tela não edita** nomeia essas regras.

## Concilie com o Midaz

***

Cada lançamento é uma transação do Midaz. Use estes campos para encontrá-la.

| Campo do Midaz | O que o Lender coloca nele |
| - | - |
| Descrição | O evento, dois pontos e a referência da origem: `<eventType>:<reference>`. |
| Metadata `correlationId` | A chave do lançamento. |
| Metadata `loanAccountId` | A conta de empréstimo do lançamento, quando conhecida. |
| Metadata `requestId` | A requisição de API que causou o lançamento, quando conhecida. |

Veja [Contabilidade e rodadas de apropriação](https://docs.lerian.studio/pt/products/lender/accounting-and-accrual-runs.md) para recibos, referências de diário e lançamentos estacionados.

## Próximos passos

***

> [card] [Contabilidade e rodadas de apropriação](https://docs.lerian.studio/pt/products/lender/accounting-and-accrual-runs.md)
>
> Veja como um lançamento chega ao ledger e como as rodadas de apropriação contabilizam juros.

> [card] [Defina um produto de empréstimo](https://docs.lerian.studio/pt/products/lender/define-a-loan-product.md)
>
> Crie o produto e a versão que o plano atende.

> [card] [Crédito no Console](https://docs.lerian.studio/pt/products/lender/console/credit.md)
>
> Configure o plano e rode mudanças de plano no Console.

> [card] [Pacote regulatório Brasil](https://docs.lerian.studio/pt/products/lender/brazil-regulatory-pack.md)
>
> Sobreponha CET, IOF e estágios de PDD ao modelo contábil.


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