> ## 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 no perfil genérico `XX`.

<Info>
  Um empréstimo brasileiro regulado é originado pelo pacote Brasil, e não por `POST /api/v1/loan-applications`. Leia o [Pacote regulatório Brasil](/pt/products/lender/brazil-regulatory-pack) para esse caminho.
</Info>

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

Prenda um **perfil contábil** a essa versão antes de desembolsar. O desembolso monta o lançamento dele a partir das pernas do perfil, e um desembolso sem perfil falha. Veja [Defina um produto de empréstimo](/pt/products/lender/define-a-loan-product).

## Prévia, se você quiser

***

A prévia do cronograma calcula as parcelas e a divulgação de custo para termos em estudo. Ela não cria nada e não muda nada. 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 carrega a versão do produto, o tomador, o principal pedido, a taxa de juros **mensal** pedida, o número de parcelas e uma data esperada de desembolso. O Lender aceita até 600 parcelas.

O corpo não carrega o **analista responsável**. O Lender pega esse dado do subject autenticado da chamada de envio. As decisões seguintes são conferidas contra esse analista, então envie com a identidade que também vai aprovar e desembolsar.

## 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 | A política de aprovação da jurisdição. Sob o perfil genérico, o analista responsável. |
| Rejeitar | `rejected`                                                 | O analista responsável.                                                               |
| Retirar  | `withdrawn`                                                | O tomador, ou o analista responsável.                                                 |

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

O valor aprovado é um limite, não um pagamento. 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 pedido e o valor líquido entregue.

O Lender confere cinco regras. Ele confere as quatro primeiras antes de gravar qualquer coisa. Ele confere a regra de balanceamento dentro da transação de desembolso, então uma falha ali desfaz o desembolso inteiro.

| Trava         | Regra                                                                          |
| ------------- | ------------------------------------------------------------------------------ |
| Valor         | O bruto não deve exceder o valor aprovado.                                     |
| Total         | O bruto somado em cada tranche deve ficar dentro do valor aprovado.            |
| Cronologia    | O desembolso não deve ser anterior à decisão de aprovação.                     |
| Identidade    | O identificador da conta de empréstimo deve ser o mesmo em cada tranche.       |
| Balanceamento | O líquido deve ser igual ao bruto menos as retenções que a jurisdição calcula. |

Sob o perfil genérico não há retenções, então o **líquido é igual ao bruto**. Um líquido menor deixa o lançamento desbalanceado e o Lender rejeita o desembolso.

## Uma transação, quatro resultados

***

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

<Steps>
  <Step title="A proposta passa a desembolsada">
    O Lender acrescenta um evento de desembolso que registra os valores, a data e o ator que desembolsou.
  </Step>

  <Step title="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`.
  </Step>

  <Step title="O pipeline da jurisdição roda">
    Sob o perfil genérico o pipeline não calcula nada, então não adiciona nenhuma retenção ao desembolso.
  </Step>

  <Step title="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 e um crédito para cada retenção.
  </Step>
</Steps>

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 streaming para cada transição, quando o streaming está habilitado e um broker está configurado.

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

## Próximos passos

***

<CardGroup cols={2}>
  <Card title="Faça a gestão de um empréstimo" icon="wrench" href="/pt/products/lender/service-a-loan">
    Registre pagamentos, antecipe, reprograme e corrija uma conta de empréstimo ativa.
  </Card>

  <Card title="Arquitetura do Lender" icon="sitemap" href="/pt/products/lender/lender-architecture">
    Os domínios, o encaixe da jurisdição e o outbox que leva o dinheiro para fora.
  </Card>

  <Card title="Contabilidade e rodadas de apropriação" icon="calculator" href="/pt/products/lender/accounting-and-accrual-runs">
    Regras de lançamento, rodadas de apropriação e a referência de diário que amarra uma contabilização de volta.
  </Card>

  <Card title="Pacote regulatório Brasil" icon="brazilian-real-sign" href="/pt/products/lender/brazil-regulatory-pack">
    IOF, CET, consentimento de capitalização e o resto do perfil brasileiro.
  </Card>
</CardGroup>
