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

# Fazer servicing de um empréstimo

> Opere uma conta de empréstimo ativa — leia seu cronograma e transações, registre e pré-visualize repagamentos, faça pagamento antecipado, reprograme e corrija com estornos.

export const GAuditTrail = ({children}) => <Tooltip headline="Trilha de auditoria" tip="Um registro cronológico e imutável de cada ação e transação no sistema — essencial para conformidade regulatória e resolução de disputas." cta="Ver glossário" href="/pt/glossary">
    {children}
  </Tooltip>;

Uma vez que um empréstimo é desembolsado, ele se torna uma **conta de empréstimo** — a visão de servicing do contrato vivo. O servicing é tudo o que acontece ao longo da vida dele: dinheiro entra, o cronograma muda, e erros são corrigidos sem nunca reescrever o histórico.

## Leia a conta

***

| Operação                                      | Propósito                                                                                  |
| --------------------------------------------- | ------------------------------------------------------------------------------------------ |
| `GET /api/v1/loan-accounts/{id}`              | Lê a conta de empréstimo ativa.                                                            |
| `GET /api/v1/loan-accounts/{id}/schedule`     | Lê o cronograma de parcelas vigente.                                                       |
| `GET /api/v1/loan-accounts/{id}/transactions` | Lista as transações contabilizadas contra a conta.                                         |
| `GET /api/v1/loan-accounts/{id}/charges`      | Lista os encargos ativos da conta.                                                         |
| `GET /api/v1/loan-accounts/{id}/audit-events` | Lê a <GAuditTrail>trilha de auditoria</GAuditTrail> imutável dos eventos do ciclo de vida. |

A coleção `servicing` (`GET /api/v1/servicings`, `GET /api/v1/servicings/{id}`) é a superfície de listagem e busca sobre essas contas, incluindo uma leitura de status externo (`GET /api/v1/servicings/{id}/status`).

## Registre dinheiro

***

<Steps>
  <Step title="Pré-visualize a alocação">
    `POST /api/v1/loan-accounts/{id}/preview-repayment` mostra como um repagamento seria alocado entre as parcelas em aberto — principal, juros e encargos — **sem registrá-lo**.
  </Step>

  <Step title="Registre o repagamento">
    `POST /api/v1/loan-accounts/{id}/repayments` registra o dinheiro recebido e o aloca ao longo do cronograma. As escritas são idempotentes.
  </Step>

  <Step title="Pague antecipadamente">
    `POST /api/v1/loan-accounts/{id}/prepayments` liquida o empréstimo antes do prazo, total ou parcialmente. No Brasil, obtenha primeiro uma [cotação de pagamento antecipado](/pt/lender/brazil-regulatory-pack) vinculante.
  </Step>
</Steps>

## Mude o cronograma

***

`POST /api/v1/loan-accounts/{id}/reschedules` reescreve o cronograma restante — para uma renegociação, por exemplo. A mudança é um novo estado do cronograma, não uma edição do anterior.

## Corrija sem destruir

***

Correções preservam uma linha do tempo consistente e auditável. Para desfazer uma transação contabilizada, estorne-a:

`POST /api/v1/loan-accounts/{id}/transactions/{transactionId}/reverse`

Um estorno contabiliza um lançamento compensatório no ledger em vez de apagar qualquer coisa, assim a conta e seus livros ficam em sintonia e a trilha de auditoria fica completa.

<Warning>
  O servicing nunca edita o passado. Repagamentos, reprogramações e estornos acrescentam fatos novos; o estado é re-derivado desse histórico (reprocessamento), que é o que mantém o ledger e a conta de empréstimo reconciliáveis.
</Warning>

## O que acontece downstream

***

O servicing emite `repayment.recorded`, `repayment_reversal.recorded`, `loan_schedule.prepayment_applied` e `loan_schedule.rescheduled`, e cada movimento de dinheiro contabiliza no ledger através da [rota de posting](/pt/lender/lender-in-the-platform).

## Próximos passos

***

<Card title="Contabilidade e rotinas de apropriação" icon="calculator" href="/pt/lender/accounting-and-accrual-runs" horizontal>
  Reconheça juros ao longo do tempo e rastreie cada posting de volta ao ledger.
</Card>

<Card title="Portfólio e inadimplência" icon="chart-line" href="/pt/lender/portfolio-and-delinquency" horizontal>
  Veja a carteira de servicing em agregado, incluindo os empréstimos vencidos.
</Card>