Préstamos
La pantalla de Préstamos muestra todos los préstamos activos en tu cartera. Cada préstamo está vinculado a un cliente y contiene un calendario completo de cuotas generado en el momento del desembolso.
Lista de Préstamos
Al abrir la pestaña Préstamos, verás la lista de todos los préstamos con su estado actual:
| Estado | Significado |
|---|---|
Activo | El préstamo está vigente y tiene cuotas pendientes |
Vencido | Una o más cuotas están atrasadas — se está acumulando mora |
Liquidado | Todas las cuotas han sido pagadas en su totalidad |
Cancelado | El préstamo fue cancelado antes de completarse |
Los préstamos vencidos están marcados visualmente. La tarjeta del préstamo muestra los días de mora y el monto total de mora acumulada.
Pantalla de Detalle del Préstamo
Al tocar un préstamo se abre su pantalla de detalle, que muestra:
- Código del préstamo (ej.
LN-A1B2C3) - Nombre del prestatario y enlace a su perfil de cliente
- Capital, tasa de interés, monto total, monto de cuota
- Fecha de desembolso, fechas de primera y última cuota
- Frecuencia de pago (Diario, Semanal, Quincenal, Mensual)
- Tasa de mora (% por mes)
- El Calendario de Cuotas completo — cada fila muestra la fecha de vencimiento, monto esperado, monto pagado, saldo pendiente e indicación si está vencida
Registrar un Pago (Abono)
Los pagos se registran por cuota. Para registrar un pago:
- En la pantalla de detalle del préstamo, toca la cuota que deseas abonar.
- Se abre el Panel de Pago, mostrando:
- El monto esperado de la cuota
- El monto ya pagado (
PaidAmount) - El saldo pendiente (
Balance)
- Ingresa el monto que se está pagando en el campo de entrada.
- Toca Confirmar Pago.
Reglas de Pago (aplicadas por el sistema)
- No se puede pagar cero ni montos negativos — el sistema rechaza montos ≤ 0.
- No se puede sobre-pagar una cuota — el monto del pago no puede superar el saldo pendiente de la cuota. Si se intenta, el sistema devuelve
Error_PaymentExceedsBalance. - No se puede pagar una cuota ya pagada — al intentarlo se obtiene
Error_InstallmentAlreadyPaid. - Los pagos parciales están permitidos — puedes pagar menos del monto total de la cuota. El saldo restante permanece en la cuota y sigue marcada como no pagada.
Cierre Automático del Préstamo
Cuando registras un pago que hace que la última cuota impagada llegue a saldo cero, el sistema cambia automáticamente el estado del préstamo de Activo a Liquidado. No se requiere ningún paso manual.
Cuotas Vencidas (Mora)
El estado de mora se calcula al momento del desembolso y es actualizado por un proceso en segundo plano. Una cuota está vencida si su FechaVencimiento es pasada y IsPaid = false.
El monto de mora de cada cuota se calcula como:
MontoMora = MontoEsperado × (TasaMora ÷ 100 ÷ 30) × DíasVencidosAl registrar un pago en una cuota vencida, el contador de DíasVencidos se reinicia a 0 al confirmar el pago.
Historial del Préstamo
Cada pago registrado crea un registro permanente de Pago vinculado a la cuota. Puedes ver el historial completo de pagos de un préstamo desplazándote por el calendario de cuotas — cada cuota pagada muestra la FechaPago y los montos aplicados.