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

# Servicing de un préstamo

> Opera una cuenta de préstamo activa — lee su cronograma y transacciones, registra y previsualiza repagos, prepaga, reprograma y corrige con reversiones.

export const GAuditTrail = ({children}) => <Tooltip headline="Registro de auditoría" tip="Un registro cronológico e inmutable de cada acción y transacción en el sistema — esencial para el cumplimiento regulatorio y la resolución de disputas." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

Una vez que un préstamo se desembolsa se convierte en una **cuenta de préstamo** — la vista de servicing del contrato vivo. El servicing es todo lo que pasa a lo largo de su vida: entra dinero, cambia el cronograma y se corrigen errores sin reescribir nunca el historial.

## Lee la cuenta

***

| Operación                                     | Propósito                                                                                           |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| `GET /api/v1/loan-accounts/{id}`              | Lee la cuenta de préstamo activa.                                                                   |
| `GET /api/v1/loan-accounts/{id}/schedule`     | Lee el cronograma de cuotas vigente.                                                                |
| `GET /api/v1/loan-accounts/{id}/transactions` | Lista las transacciones contabilizadas contra la cuenta.                                            |
| `GET /api/v1/loan-accounts/{id}/charges`      | Lista los cargos activos de la cuenta.                                                              |
| `GET /api/v1/loan-accounts/{id}/audit-events` | Lee el <GAuditTrail>registro de auditoría</GAuditTrail> inmutable de los eventos del ciclo de vida. |

## Registra dinero

***

<Steps>
  <Step title="Previsualiza la asignación">
    `POST /api/v1/loan-accounts/{id}/preview-repayment` muestra cómo se asignaría un repago entre las cuotas pendientes **sin registrarlo**. Lender paga primero la cuota vencida más antigua. Dentro de cada cuota paga penalidades, luego cargos, luego interés y por último capital.
  </Step>

  <Step title="Registra el repago">
    `POST /api/v1/loan-accounts/{id}/repayments` registra el dinero recibido y lo asigna a lo largo del cronograma. Envía un id de request en `X-Request-ID`, o en `X-Idempotency` como respaldo — una llamada sin ninguno de los dos responde `422`. El mismo id con la misma cuenta de préstamo, el mismo monto y la misma fecha de efecto devuelve el repago ya registrado. El mismo id con datos distintos responde `409`. Lee [Idempotencia](/es/lender/lender-rest-api#idempotencia).
  </Step>

  <Step title="Prepaga">
    `POST /api/v1/loan-accounts/{id}/prepayments` liquida el préstamo antes de tiempo, total o parcialmente. Una cuenta de préstamo brasileña necesita antes una [cotización de prepago](/es/lender/brazil-regulatory-pack).
  </Step>
</Steps>

## Cambia el cronograma

***

`POST /api/v1/loan-accounts/{id}/reschedules` reescribe el cronograma restante — para una renegociación, por ejemplo. El cambio es un nuevo estado del cronograma, no una edición del anterior.

## Corrige sin destruir

***

Las correcciones preservan una línea de tiempo consistente y auditable. Para deshacer una transacción registrada, revíertela:

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

Una reversión agrega una transacción compensatoria en lugar de borrar nada, así la cuenta conserva un registro de auditoría completo.

Una reversión toma un id de request en los mismos headers que un repago. El mismo id repite la reversión ya registrada solo cuando también coincide cada hecho de la reversión: la transacción que se reversa, la cuenta de préstamo, la fecha efectiva de la reversión, el motivo, la versión del perfil y el código de jurisdicción. Cualquier diferencia en esos hechos responde `409`.

<Warning>
  El servicing nunca edita el pasado. Repagos, reprogramaciones y reversiones agregan hechos nuevos. El estado vigente se vuelve a derivar de ese historial, así la cuenta siempre se explica desde su propio registro.
</Warning>

## Qué pasa downstream

***

Cuando el streaming está habilitado y hay un broker configurado, el servicing emite `repayment.recorded`, `repayment_reversal.recorded`, `loan_schedule.prepayment_applied` y `loan_schedule.rescheduled`. Un prepago liquidado contra una cotización de prepago brasileña registra una intención de posting durable y la transmite al ledger solo cuando el relay del ledger está configurado. Lee [la ruta de posting](/es/lender/lender-in-the-platform).

## Próximos pasos

***

<Card title="Contabilidad y ejecuciones de devengo" icon="calculator" href="/es/lender/accounting-and-accrual-runs" horizontal>
  Reconoce interés a lo largo del tiempo y lee la referencia de asiento que registra cada ejecución.
</Card>

<Card title="Pack regulatorio de Brasil" icon="brazilian-real-sign" href="/es/lender/brazil-regulatory-pack" horizontal>
  Lee la etapa de PDD de un préstamo vencido y aplica una transición de etapa.
</Card>