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

# Como funciona a originação

> O caminho que uma proposta de empréstimo percorre: a que ela se prende, as quatro decisões do ciclo de vida, a transação única que a desembolsa e a conta de empréstimo que ela deixa para trás.

A originação transforma um pedido de crédito em uma conta de empréstimo viva. Ela tem quatro decisões e uma transação que faz tudo de uma vez. Esta página acompanha uma proposta de enviada até desembolsada.

> [!NOTE]
>
> A jurisdição `XX` não registra crédito. O Lender recusa os produtos, as versões e as propostas dela com 422. Leia o [Pacote regulatório Brasil](https://docs.lerian.studio/pt/products/lender/brazil-regulatory-pack.md) para o que o perfil `BR` acrescenta a este caminho.

## A que uma proposta se prende

***

Uma proposta se prende a uma **versão de produto**, nunca a um produto sozinho. A versão fixa a moeda, os termos de taxa e a base de apropriação, então um contrato sempre volta aos termos sob os quais foi criado. Uma versão posterior não muda um empréstimo que já existe. O produto deve estar ativo, e a versão deve ser aquela em que o produto origina no momento.

A ativação exige um **perfil contábil** na versão. O desembolso monta o lançamento dele a partir das pernas do perfil. Veja [Defina um produto de empréstimo](https://docs.lerian.studio/pt/products/lender/define-a-loan-product.md).

## Prévia, se você quiser

***

A prévia do cronograma calcula as parcelas e a divulgação de custo para termos em estudo. Quando registra o resultado como uma oferta, ela retorna o identificador da oferta. Ela não cria nenhuma proposta. Use para mostrar ao tomador como o empréstimo fica antes de alguém se comprometer. Esse passo é opcional.

## Envie

***

A chamada de envio cria a proposta em `pending_approval`. Ela traz a versão do produto, o CPF ou o CNPJ e o nome do tomador, o valor pelo qual a proposta é pedida, a taxa de juros **mensal** solicitada, o número de parcelas e uma data prevista de desembolso. O valor é exatamente um entre o principal, o líquido que o tomador recebe ou a parcela que cabe, e a versão deve admitir essa âncora. O Lender aceita até 600 parcelas. A taxa solicitada deve ficar dentro da faixa de taxa da versão.

O documento define o tipo do tomador: um CPF é `pessoaFisica`, um CNPJ é `pessoaJuridica`, e a versão deve admiti-lo. O Lender busca o titular do tomador no CRM do Midaz da instituição do produto, registra um quando não existe e guarda apenas o id do titular. A liberação consulta o CRM de novo, então um titular apagado nesse meio-tempo a impede (LENDER-0257). Sem Midaz configurado, uma proposta de crédito direto responde 503 (LENDER-0259).

A proposta registra a **primeira data de vencimento** na criação: uma data que você escolhe dentro da janela da versão, ou o dia que o gerador de cronograma define para a data prevista de desembolso. Todo cronograma da proposta, e a liberação, dependem dessa data.

O corpo não traz o **analista responsável**. O Lender o toma do subject autenticado da chamada de envio e o registra. Nenhuma decisão o confere.

## Decida

***

Exatamente uma decisão resolve uma proposta pendente.

| Decisão | Resultado | Quem pode agir |
| - | - | - |
| Aprovar | `approved`, com o valor aprovado e um timestamp de decisão | Qualquer chamador que tenha a permissão da rota. Um contrato que a rail de folha CLT registrou é aprovado por essa rail. |
| Rejeitar | `rejected` | Qualquer chamador que tenha a permissão da rota. |
| Retirar | `withdrawn` | Qualquer chamador que tenha a permissão da rota. Um contrato que a rail de folha CLT registrou é retirado por essa rail. |

Uma proposta aprovada ainda pode ser retirada. `rejected` e `withdrawn` são finais, e nada sai deles.

O valor aprovado não move dinheiro. Ele delimita cada desembolso que vem depois.

## Desembolse

***

O desembolso move dinheiro, então carrega o maior número de travas. Três coisas entram na requisição:

* Um header `X-Idempotency`. O Lender exige esse header nesta operação.
* O **identificador da conta de empréstimo**. É um UUID que você escolhe, e o Lender não gera um para você. Esse identificador endereça o cronograma, as transações, os encargos e a trilha de auditoria.
* O valor bruto solicitado e o valor líquido entregue. `disbursedAt` é opcional, e o Lender usa o agora de negócio do tenant quando você o omite.

O Lender confere as regras abaixo. Ele confere todas, exceto a regra de saldo, antes de gravar qualquer coisa. Ele confere a regra de saldo dentro da transação de desembolso, então uma falha ali desfaz o desembolso inteiro.

| Verificação | Regra |
| - | - |
| Valor | Um desembolso único deve liberar exatamente o valor aprovado. Uma tranche declara o próprio `trancheNumber`. |
| Total | O bruto somado em todas as tranches deve ficar dentro do valor aprovado. |
| Cronologia | O desembolso não pode ser anterior à criação da proposta nem à decisão de aprovação. |
| Identidade | O identificador da conta de empréstimo deve ser o mesmo em todas as tranches. |
| Primeiro vencimento | A primeira liberação mantém a primeira data de vencimento que a proposta registrou. Um desembolso que informa outra data responde 422 (LENDER-0950). Em uma versão sem janela de primeiro vencimento, uma liberação em um dia diferente do dia previsto de desembolso responde 422 (LENDER-0951). |
| Tomador | O tomador deve continuar sendo um titular ativo no CRM (LENDER-0257). |
| Saldo | O líquido deve ser igual ao bruto menos as retenções que a jurisdição calcula, menos a tarifa de originação que o template `origination_fee` da versão define para esta liberação. |

Sob `BR` a retenção é o IOF. Faça a cotação antes de desembolsar com a prévia de tributos do [Pacote regulatório Brasil](https://docs.lerian.studio/pt/products/lender/brazil-regulatory-pack.md).

## Uma transação, quatro resultados

***

Um desembolso é uma única transação de banco de dados. Quatro coisas acontecem dentro dela.

**1. A proposta passa a desembolsada**

O Lender acrescenta um evento de desembolso que registra os valores, a data e o ator que desembolsou.

**2. O Lender grava o cronograma**

O Lender calcula um cronograma de amortização Price (francês) sobre o principal desembolsado acumulado. Ele guarda o resultado como versão 1 do cronograma, com o motivo de mudança `origination`.

**3. O pipeline da jurisdição roda**

Sob `BR` o pipeline calcula a retenção de IOF.

**4. O Lender enfileira a intenção de lançamento**

O Lender grava uma intenção de lançamento balanceada no outbox: principal debitado pelo bruto, caixa creditado pelo líquido, um crédito para cada retenção e um crédito para uma tarifa de originação retida.

As quatro fazem commit juntas, ou as quatro voltam atrás juntas. Não existe empréstimo meio desembolsado. Se o cronograma não puder ser gravado, ou se o lançamento não balancear, a proposta continua em `approved`.

## Mais de uma tranche

***

Você pode desembolsar uma proposta aprovada mais de uma vez. O status continua `disbursed`, o Lender acrescenta outro evento de desembolso e o Lender grava uma **nova versão do cronograma** sobre o principal acumulado. A nova versão substitui a anterior na leitura.

O total entre as tranches ainda não pode exceder o valor aprovado, e cada tranche usa o mesmo identificador de conta de empréstimo.

## Dois chamadores, uma proposta

***

Cada escrita de ciclo de vida declara o status que espera encontrar. Quando dois chamadores decidem a mesma proposta ao mesmo tempo, um ganha e o outro recebe `409 Conflict` sem mudar nada. Um desembolso repetido que não bate com o primeiro é recusado da mesma forma.

## O modelo de estados

***

| De | Decisão | Para |
| - | - | - |
| `pending_approval` | aprovar | `approved` |
| `pending_approval` | rejeitar | `rejected` |
| `pending_approval` ou `approved` | retirar | `withdrawn` |
| `approved` ou `disbursed` | desembolsar | `disbursed` |

## O que você tem no fim

***

* Uma proposta que lê `disbursed`, com um evento de desembolso por tranche.
* Uma conta de empréstimo sob o identificador que você forneceu, carregando o cronograma dela, as transações dela, os encargos dela e os eventos de auditoria dela.
* Uma intenção de lançamento a caminho do ledger. Essa contabilização é assíncrona, então cai logo depois que a requisição retorna, e não durante ela.
* Um evento de ciclo de vida no backbone de eventos para cada transição.

Continue em [Faça a gestão de um empréstimo](https://docs.lerian.studio/pt/products/lender/service-a-loan.md).

## Próximos passos

***

> [card] [Faça a gestão de um empréstimo](https://docs.lerian.studio/pt/products/lender/service-a-loan.md)
>
> Registre pagamentos, antecipe, reprograme e corrija uma conta de empréstimo ativa.

> [card] [Arquitetura do Lender](https://docs.lerian.studio/pt/products/lender/lender-architecture.md)
>
> Os domínios, o encaixe da jurisdição e o outbox que leva o dinheiro para fora.

> [card] [Contabilidade e rodadas de apropriação](https://docs.lerian.studio/pt/products/lender/accounting-and-accrual-runs.md)
>
> Regras de lançamento, rodadas de apropriação e a referência de diário que amarra uma contabilização de volta.

> [card] [Pacote regulatório Brasil](https://docs.lerian.studio/pt/products/lender/brazil-regulatory-pack.md)
>
> IOF, CET, consentimento de capitalização e o resto do perfil brasileiro.


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