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

# Conceitos centrais

> Conheça o vocabulário do Lender: produtos de empréstimo e versões, perfis contábeis, propostas, contas de empréstimo, cronogramas, rodadas de apropriação e termos específicos do Brasil.

Aprenda estes termos uma vez e cada guia, evento e operação de API passa a ser lido do mesmo jeito. Os conceitos se agrupam por domínio: o catálogo de produtos, a originação, a gestão da carteira, a contabilidade e as extensões do Brasil.

## Catálogo de produtos

***

### Produto de empréstimo

Um **produto de empréstimo** é o template a partir do qual um empréstimo é originado. É a oferta de crédito nomeada (uma linha CDC, uma linha consignado) que carrega os termos, os encargos e a configuração de taxa dela.

### Versão de produto

Os termos de um produto mudam com o tempo, então um produto de empréstimo é dono de **versões de produto imutáveis**. Cada versão congela os termos como eles estavam, e todo contrato originado remete à versão exata que ele usou na originação. Você **ativa** o produto para fixar uma versão como a versão atual dele. Os empréstimos existentes ficam com a versão em que começaram.

### Encargo

Um **encargo** é uma tarifa ou um componente de custo preso a um produto, por exemplo uma tarifa de originação. Uma versão declara **templates de encargo**. Uma versão aceita no máximo um template `origination_fee`, e o tipo do template permanece o mesmo entre revisões. Um encargo aplicado é cobrado na próxima parcela aberta.

### Perfil contábil

Um **perfil contábil** vincula uma versão de produto ao 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.). Ele declara as regras de lançamento: quais pernas de 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.) disparam para cada evento contábil (desembolso, pagamento antecipado, apropriação). Ele também declara em qual organização de ledger e em qual ledger a transação é contabilizada. Sem um perfil contábil, um produto não pode ser ativado.

## Originação

***

### Proposta de empréstimo

Uma **proposta de empréstimo** é um pedido para originar um empréstimo contra uma versão de produto. Ela percorre um ciclo de vida explícito:

| Ação | Significado |
| - | - |
| **Enviar** | Cria a proposta em um estado pendente. |
| **Aprovar** | Aceita a proposta; um registro de decisão é guardado. |
| **Rejeitar** | Recusa a proposta, com um registro de decisão. |
| **Retirar** | Retira uma proposta pendente de aprovação ou aprovada. |
| **Desembolsar** | Registra os fundos entregues; os fatos do desembolso e a conta de empréstimo resultante são mantidos. |

O Lender identifica o tomador pelo CPF ou CNPJ e pelo nome. Ele busca ou registra o tomador como **titular** no CRM do Midaz da instituição do produto, e a proposta guarda apenas o id desse titular.

### Prévia do cronograma

A **prévia do cronograma** calcula o cronograma de amortização de um empréstimo em estudo sem originar nada. Você pré-visualiza as parcelas e as divulgações antes que uma proposta (ou uma aprovação) se comprometa com elas.

## Gestão da carteira

***

### Conta de empréstimo

Uma **conta de empréstimo** é um empréstimo ativo e desembolsado, a visão de gestão da carteira de um contrato. Ela carrega o cronograma vivo, as transações lançadas contra ela, os encargos dela e o histórico de auditoria dela.

### Cronograma e parcela

O **cronograma** é o conjunto de **parcelas** que uma conta de empréstimo deve, em ordem. Cada parcela carrega o vencimento dela e os componentes de principal, juros e encargos dela.

### Pagamento e pagamento antecipado

Um **pagamento** registra dinheiro recebido contra o cronograma. O Lender o distribui entre as parcelas em aberto, das mais antigas para as mais novas. Um **pagamento antecipado** liquida antes do cronograma, no todo ou em parte. Você pode **pré-visualizar um pagamento** para ver a distribuição antes de registrá-lo.

### Reprogramação

Uma **reprogramação** reescreve o cronograma restante de uma conta de empréstimo, por exemplo após uma renegociação. Uma reprogramação pode se classificar como reestruturação, com justificativa, e pode dispensar encargos de atraso. Uma renegociação substancial substitui o contrato por uma nova conta de empréstimo.

### Estorno e replay

As correções nunca são destrutivas. Um **estorno** desfaz uma transação registrada com um lançamento compensatório. Um **replay** recalcula o estado da conta a partir do histórico de eventos. Ambos preservam uma linha do tempo consistente e auditável em vez de editar o passado.

### Baixa e recuperação de crédito

Uma **baixa** (write-off) tira um contrato de crédito direto do balanço como perda de crédito (Res. CMN 4.966 art. 49) e o deixa no estado `written_off`. Ela é irreversível. O dinheiro que o tomador paga depois é uma **recuperação de crédito**, que um operador pode estornar. Um **reembolso de quitação** (payoff refund) registra o dinheiro que o cliente devolveu a um tomador cujo contrato está liquidado.

## Contabilidade

***

### Intenção de lançamento

Uma **intenção de lançamento** é o registro durável de um evento financeiro que deve ser contabilizado no ledger. O Lender persiste a intenção como parte da mesma transação que muda o estado do domínio. Ele então entrega a intenção ao relay do ledger. A intenção fica no banco de dados, então ela sobrevive a um reinício.

### Rodada de apropriação

Uma **rodada de apropriação** calcula os juros (e outros valores baseados em tempo) apropriados ao longo de um período em toda a carteira, produzindo os lançamentos que os reconhecem. Cada reconhecimento cobre uma conta de empréstimo, um mês e um tipo de valor. Uma rodada repetida não apropria duas vezes.

### Referência de diário

Uma **referência de diário** é o identificador contábil da própria rodada de apropriação. Ela é um valor separado do id de correlação da rodada, que o registro da referência também guarda. 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 o compartilha.

## Jurisdições

***

### Jurisdição e perfil

Uma **jurisdição** é um mercado cujas regras de crédito o Lender conhece. Cada jurisdição fornece um **perfil**: as regras, as divulgações e o calendário que aquele mercado exige. O Lender entrega um perfil base **genérico**, que não registra crédito, e um perfil **Brasil (BR)**. A jurisdição ativa molda quais divulgações e endpoints se aplicam. Veja [Jurisdições](https://docs.lerian.studio/pt/products/lender/jurisdictions.md).

## Termos do Brasil

***

O perfil brasileiro adiciona conceitos regulados. Os termos em português ficam como são, com uma explicação. Para o uso de cada termo, veja o [Pacote regulatório Brasil](https://docs.lerian.studio/pt/products/lender/brazil-regulatory-pack.md).

| Termo | Explicação |
| - | - |
| **CET** | *Custo Efetivo Total*, o custo efetivo total do crédito divulgado ao tomador, cobrindo juros, tributos e tarifas. |
| **IOF** | *Imposto sobre Operações Financeiras*, um tributo federal sobre operações de crédito, que pode ser pré-visualizado antes da originação. |
| **Consentimento de capitalização** | O consentimento registrado do tomador para a capitalização de *juros compostos* no contrato. |
| **Estágio de PDD** | *Provisão para Devedores Duvidosos*, o estágio de provisionamento para perdas em que uma conta de empréstimo fica, com transições rastreadas. |
| **Descritor de crédito** | O descritor da operação de crédito no estilo SCR para uma conta de empréstimo (o perfil regulado da operação). |
| **Cotação de pagamento antecipado** | Uma cotação para liquidar uma conta de empréstimo antes do prazo. Um pagamento antecipado brasileiro liquida contra uma delas, dentro da validade da cotação: 24 horas por padrão, e uma versão pode definir de 1 a 168 horas. |
| **CCB** | *Cédula de Crédito Bancário*, o instrumento de crédito bancário de um contrato de consignado. |
| **Averbação** | Registro do desconto em folha junto à entidade pagadora, para que as parcelas sejam retidas na fonte. |

## Próximos passos

***

> [card] [O Lender na plataforma](https://docs.lerian.studio/pt/products/lender/lender-in-the-platform.md)
>
> Veja como esses conceitos são contabilizados no ledger e emitem eventos.

> [card] [Defina um produto de empréstimo](https://docs.lerian.studio/pt/products/lender/define-a-loan-product.md)
>
> Coloque os conceitos do catálogo de produtos para funcionar.


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