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

# Administrar un préstamo

> Opera una cuenta de préstamo activa: lee su cronograma y sus transacciones, registra y previsualiza pagos, paga por anticipado, 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 normativo y la resolución de disputas." cta="Ver glosario" href="/es/start-here/glossary">
    {children}
  </Tooltip>;

Después del desembolso, un préstamo se convierte en una **cuenta de préstamo**, la vista de administración del contrato vivo. La administración cubre toda la vida de la cuenta. Entra dinero, el cronograma cambia y corriges errores sin reescribir la historia.

## Leer 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 actual.                                                             |
| `GET /api/v1/loan-accounts/{id}/transactions` | Lista las transacciones asentadas contra la cuenta.                                             |
| `GET /api/v1/loan-accounts/{id}/charges`      | Lista los cargos activos en la cuenta.                                                          |
| `GET /api/v1/loan-accounts/{id}/audit-events` | Lee el <GAuditTrail>registro de auditoría</GAuditTrail> inmutable de eventos del ciclo de vida. |

## Registrar dinero

***

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

  <Step title="Registrar el pago">
    `POST /api/v1/loan-accounts/{id}/repayments` registra el dinero recibido y lo asigna a lo largo del cronograma. Envía un id de solicitud 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 efectiva devuelve el pago ya registrado. El mismo id con hechos distintos responde `409`. Consulta [Idempotencia](/es/products/lender/lender-rest-api#idempotency).
  </Step>

  <Step title="Pagar por anticipado">
    `POST /api/v1/loan-accounts/{id}/prepayments` liquida el préstamo antes del cronograma, en todo o en parte. Una cuenta de préstamo brasileña necesita primero una [cotización de pago anticipado](/es/products/lender/brazil-regulatory-pack).
  </Step>
</Steps>

## Cambiar el cronograma

***

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

## Corregir sin destruir

***

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

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

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

Una reversión toma un id de solicitud en los mismos headers que un pago. El mismo id repite la reversión ya registrada solo cuando también coinciden todos los hechos de la reversión. Los hechos de la reversión son la transacción que reviertes, 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>
  La administración nunca edita el pasado. Los pagos, las reprogramaciones y las reversiones agregan hechos nuevos. El estado actual se vuelve a derivar de ese historial, así la cuenta sigue siendo explicable desde su propio registro.
</Warning>

## Lo que ocurre downstream

***

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

## Próximos pasos

***

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

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