88 Liquidación de Préstamos: Cómo Cerrar Deudas y Archivarlas Correctamente en Laravel 12 ✅📦
Duración: 19 minDescripción
📦 Lección 88: Inicio del Módulo de Liquidación de Préstamos
En esta sesión de Benji V2, respondemos a la necesidad de permitir que un cliente liquide su deuda total antes de tiempo. La clave de este módulo es calcular el saldo capital pendiente para que el cliente no tenga que pagar los intereses de los meses que aún no han transcurrido [03:07].
1. 🛠️ Creación de la Función de Cálculo
Iniciamos el desarrollo en el PrestamoController creando una función dedicada llamada calcular_liquidacion. Esta función centraliza la lógica financiera necesaria para el cierre anticipado [07:05]:
- Parámetros: Recibe el modelo del Préstamo y los Ajustes (para considerar moras configuradas).
- Referencia Temporal: Utilizamos la librería Carbon (Carbon::today()) para tener una fecha base y comparar qué cuotas ya vencieron y cuáles están por vencer [09:42].
2. 📊 Filtrado de Cuotas Pendientes
Para saber cuánto debe el cliente realmente, implementamos consultas específicas:
- 🔍 Identificación de Pendientes: Filtramos todos los pagos del préstamo cuyo estado sea "pendiente", ordenándolos por fecha de vencimiento [12:10].
- 🎯 La Cuota Actual: Identificamos la primera cuota pendiente, ya que de ella extraeremos el Saldo Capital actual, que es el punto de partida para la liquidación [14:05].
3. 🧮 Lógica de Saldo Capital vs. Intereses
El corazón de la liquidación es diferenciar qué parte del pago es deuda real (capital) y qué es ganancia del prestamista (interés):
- 💰 Total Capital Restante: Recuperamos el valor del campo saldo_capital de la cuota actual. Este monto representa lo que el cliente realmente "debe" del préstamo original en ese momento [16:19].
- 📈 Comparativa: También calculamos el total_cuotas_restantes (suma de capital + interés de lo que falta). Esto sirve para mostrarle al cliente cuánto se está ahorrando al liquidar hoy mismo [18:07].
Resumen de Variables Calculadas:
- Hoy: Fecha de referencia para el cálculo.
- Cuota Actual: La cuota que toca pagar inmediatamente.
- Total Capital Restante: El monto neto a pagar para liquidar (sin intereses futuros).
- Total Cuotas Restantes: El monto total que pagaría si sigue el cronograma normal.
Lecciones
Apoya este proyecto
Si te gusta nuestro contenido, ¡apóyanos con una donación!
Donar por Airtm Donar por Binance¡Gracias por tu apoyo! ❤️
