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

# Origine um empréstimo

> Leve uma proposta de empréstimo pelo ciclo de vida dela (ver a prévia do cronograma, enviar, decidir e desembolsar) e veja a conta de empréstimo que ela produz.

A originação é a jornada de "um tomador quer crédito" até "existe uma conta de empréstimo e o desembolso está registrado". O Lender modela essa jornada como um ciclo de vida explícito de proposta. O ciclo de vida guarda um registro de cada decisão, e torna cada desembolso rastreável.

## O ciclo de vida da proposta

***

Uma proposta passa por estados nomeados. Cada transição é uma operação distinta, e cada uma guarda um registro de decisão ou de desembolso:

```
submit ─────► pending_approval ── approve ──► approved ── disburse ──► loan account
                    │       │                     │
                 reject  withdraw               withdraw
```

## Passos

***

<Steps>
  <Step title="Veja a prévia do cronograma (opcional)">
    `POST /api/v1/loan-applications/preview-schedule` calcula o cronograma de amortização para termos em estudo **sem originar nada**. Use para mostrar parcelas e divulgações antes de alguém se comprometer.
  </Step>

  <Step title="Envie a proposta">
    `POST /api/v1/loan-applications` cria a proposta contra uma versão de produto.
  </Step>

  <Step title="Decida">
    Resolva a proposta com exatamente uma destas opções:

    * `POST /api/v1/loan-applications/{id}/approve`: aceite a proposta, com um registro de decisão.
    * `POST /api/v1/loan-applications/{id}/reject`: recuse a proposta, com um registro de decisão.
    * `POST /api/v1/loan-applications/{id}/withdraw`: retire a proposta enquanto ela aguarda aprovação ou, depois da aprovação, antes do desembolso.
  </Step>

  <Step title="Desembolse">
    `POST /api/v1/loan-applications/{id}/disburse` registra os fundos entregues. Envie uma chave `X-Idempotency`: enquanto o armazenamento de idempotência estiver acessível, uma nova tentativa com a mesma chave repete a primeira resposta e não registra um segundo desembolso. O middleware falha aberto durante uma indisponibilidade do armazenamento de idempotência, então confirme o resultado antes de repetir uma falha ambígua.

    Uma transação de banco de dados faz commit do evento de desembolso, do cronograma de originação e de uma intenção de lançamento balanceada. Quando a chamada retorna, o empréstimo é uma **conta de empréstimo** ativa que você passa a gerir daqui em diante.

    A contabilização no ledger não está nessa transação. Com o relay do ledger configurado, um dispatcher do outbox repassa a intenção ao Midaz logo depois da resposta, pelo perfil contábil do produto. Caso contrário, a intenção fica no outbox. Veja [o caminho de lançamento](/pt/products/lender/lender-in-the-platform).
  </Step>
</Steps>

## O que você recebe

***

O desembolso produz uma **conta de empréstimo**, a visão de gestão do contrato vivo, carregando o cronograma, as transações, os encargos e o histórico de auditoria dela. Continue em [Faça a gestão de um empréstimo](/pt/products/lender/service-a-loan).

## O que acontece downstream

***

Com o streaming habilitado e um broker configurado, o ciclo de vida emite `loan_application.submitted.v2`, `loan_application.approved.v2`, `loan_application.rejected.v2`, `loan_application.withdrawn.v2` e `loan_application.disbursed.v2`. O desembolso registra uma intenção de lançamento durável e a repassa ao ledger apenas quando o relay do ledger está configurado. Leia [o caminho de lançamento](/pt/products/lender/lender-in-the-platform).

<Info>
  A originação brasileira adiciona passos regulados (divulgação do CET e consentimento de capitalização) cobertos no [Pacote regulatório Brasil](/pt/products/lender/brazil-regulatory-pack). O fluxo de **consignado** com desconto em folha forma um contexto delimitado brasileiro próprio. Veja [Consignado privado](/pt/products/lender/consignado-privado).
</Info>

## Próximos passos

***

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