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 inmutable de los eventos del ciclo de vida. |
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
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.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.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 vinculante.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.
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.
Próximos pasos
Contabilidad y ejecuciones de devengo
Reconoce interés a lo largo del tiempo y rastrea cada posting de vuelta al ledger.
Portafolio y morosidad
Mira la cartera de servicing en agregado, incluyendo los préstamos vencidos.