Plan de pagos (cronograma del crédito)

Herramienta para generar, editar, anular e imprimir el cronograma de cuotas de un Contrato de crédito. Soporta tres sistemas de amortización (Alemán, Francés y Americano), periodicidad mensual o por días, prorratea el interés anual por período y calcula automáticamente interés, amortización, cuota y saldo. Permite múltiples planes por crédito (con número e IdPP únicos) y bloquea/desbloquea la edición.

📘 Propósito del formulario

Definir el cronograma de pagos de un crédito. El plan se asocia al Contrato de crédito (campo Correspondiente al crédito Nº). Puede existir más de un plan por crédito; cada plan tiene su Número y un Identificador único (IdPP). El plan activo se devuelve al contrato en el campo Plan de pagos vigente.

🧭 Encabezado y datos base

Campo	Descripción
Correspondiente al crédito Nº	Vincula el plan con el crédito (IdCC del contrato).
Moneda	Moneda del crédito.
NIT / Nombre o razón social	Datos del cliente referenciados.
Fecha de transacción	Fecha del contrato.
Fecha inicial plan de pagos	Primera fecha del cronograma (Fecha inicio).
Precio total / Cuota inicial	Montos pactados en el contrato.
Monto crédito	Calculado: `Precio total − Cuota inicial`.
Saldo capital	Saldo inicial que se amortiza (se lee del contrato).
Tipo de periodo	Mensual (el sistema avanza por meses y considera 28/29/30/31 días y bisiestos). Periodo en días (habilita el campo Periodo).
Periodo	Número de días entre cuotas (visible si el periodo es “en días”).
Cant. de cuotas	Número de cuotas del plan.
Tasa de interés anual	Tasa anual expresada en tanto por uno o porcentaje (se prorratea por días del período).
Formulario	Cargo/comisión por cuota (se suma a la cuota).

🧮 Sistemas de amortización (campo “Sistema”)

Sistema	Cálculo resumido	Uso típico
Alemán (cuota variable)	Amortización fija (= Saldo inicial / Cuotas). Interés decrece cada período. Cuota = Interés + Amortización + Formulario.	Créditos comerciales con cuotas decrecientes.
Francés (cuota fija)	Cuota fija por fórmula: `r = S · [i(1+i)^n]/[(1+i)^n − 1]`, con `i` = tasa por período (tasa anual × días/365). En la última cuota se ajusta la amortización para cerrar saldo.	Consumo/financiero con cuota constante.
Americano (balón final)	Cuotas de solo interés y cargo; el capital se paga íntegro en la última cuota.	Puentes o créditos de corto plazo.

El sistema Francés no permite tasa 0%. Si la tasa es 0, seleccione Alemán o Americano.

⚙️ Generación del plan

Complete Sistema, Tipo de periodo y Periodo/Cuotas/Interés.
Pulse Generar plan de pagos. El sistema:
- Limpia cuotas previas del plan (si existían).
- Agrega la fila 0 como estado inicial (capital = saldo; interés y cuota = 0).
- Calcula para cada cuota: Fecha (según periodicidad), Interés prorrateado por días, Amortización, Cuota y Saldo.

El interés por período se prorratea con interés anual × (días del período / 365). En meses, los días varían (28/29/30/31); en modo “por días” se usa el valor de Periodo.

📋 Detalle (cuotas)

Columnas: CuotaNº, Fecha, Capital (saldo a inicio), Interés, Amortización, Formulario, Cuota, Saldo.
En edición, el subformulario recalcula: Cuota = Interés + Amortización + Formulario, y Saldo = Capital − Amortización.
Atajo: doble clic en Capital copia el Saldo de la cuota anterior.

🧰 Barra de acciones

Nuevo: crea un plan vacío, asigna Número correlativo y precarga datos del contrato (monto, tasa, formulario).
Editar / Bloquear: alterna permisos de edición del encabezado y del detalle.
Anular: marca el plan como Anulado/Habilitado con confirmación.
Eliminar: elimina el plan y todas sus cuotas (pide confirmación).
Vista previa / Imprimir: abre el reporte CtasCobrarPP filtrado por IdPP.
Cerrar: cierra y refresca el contrato de crédito.

🛡️ Validaciones y mensajes frecuentes

“El método de amortizaciones es obligatorio” — seleccione un Sistema.
“No se ha establecido la cantidad de cuotas” — complete Cuotas.
“No ha establecido el periodo en días” — requerido si el Tipo de periodo es “en días”.
En Francés con tasa 0% se mostrará un aviso y no se generará el plan.
Al eliminar, primero se borran las cuotas del detalle y luego el encabezado del plan.

🚀 Flujo rápido sugerido

Abra el Contrato de crédito y pulse Plan de pagos.
En el plan, verifique monto/tasa y elija Sistema, periodicidad y cuotas.
Pulse Generar plan de pagos y revise la tabla (ajuste la última cuota si desea redondeos específicos).
Vista previa o Imprimir para entregar al cliente.