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

La colección `servicing` (`GET /api/v1/servicings`, `GET /api/v1/servicings/{id}`) es la superficie de listado y búsqueda sobre estas cuentas, incluyendo una lectura de estado externo (`GET /api/v1/servicings/{id}/status`).

## 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 — capital, interés y cargos — **sin registrarlo**.
  </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. Las escrituras son idempotentes.
  </Step>

  <Step title="Prepaga">
    `POST /api/v1/loan-accounts/{id}/prepayments` liquida el préstamo antes de tiempo, total o parcialmente. En Brasil, toma primero una [cotización de prepago](/es/lender/brazil-regulatory-pack) vinculante.
  </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 contabilizada, revíertela:

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

Una reversión contabiliza un asiento compensatorio en el ledger en lugar de borrar nada, así la cuenta y sus libros quedan en sintonía y el registro de auditoría se mantiene completo.

<Warning>
  El servicing nunca edita el pasado. Repagos, reprogramaciones y reversiones agregan hechos nuevos; el estado se vuelve a derivar de ese historial (reprocesamiento), que es lo que mantiene reconciliables el ledger y la cuenta de préstamo.
</Warning>

## Qué pasa downstream

***

El servicing emite `repayment.recorded`, `repayment_reversal.recorded`, `loan_schedule.prepayment_applied` y `loan_schedule.rescheduled`, y cada movimiento de dinero se contabiliza en el ledger a través de 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 rastrea cada posting de vuelta al ledger.
</Card>

<Card title="Portafolio y morosidad" icon="chart-line" href="/es/lender/portfolio-and-delinquency" horizontal>
  Mira la cartera de servicing en agregado, incluyendo los préstamos vencidos.
</Card>