Pular para o conteúdo principal
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çãoPropósito
GET /api/v1/loan-accounts/{id}Lê a conta de empréstimo ativa.
GET /api/v1/loan-accounts/{id}/scheduleLê o cronograma de parcelas vigente.
GET /api/v1/loan-accounts/{id}/transactionsLista as transações contabilizadas contra a conta.
GET /api/v1/loan-accounts/{id}/chargesLista os encargos ativos da conta.
GET /api/v1/loan-accounts/{id}/audit-eventsLê a 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

1

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

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

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

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

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

​
Próximos passos

Contabilidade e rotinas de apropriação

Reconheça juros ao longo do tempo e rastreie cada posting de volta ao ledger.

Portfólio e inadimplência

Veja a carteira de servicing em agregado, incluindo os empréstimos vencidos.