13 de septiembre de 2026 · 3 min de lectura
Term Loan en Fineract: las siete decisiones que definen el producto
Qué significa cada parámetro clave de un producto de crédito a plazo en Apache Fineract, cómo afecta la cuota y el asiento contable, y qué combinaciones producen resultados que después nadie sabe explicar.
Un crédito a plazo (term loan) es el producto más simple de Fineract y, aun así, la pantalla de creación tiene más de cuarenta campos. La mayoría son valores por defecto razonables. Siete no lo son: cada uno cambia el plan de pagos o el asiento contable, y una combinación equivocada se descubre meses después, cuando contabilidad no puede conciliar los intereses devengados.
1. Método de amortización
Equal installments (cuota fija, sistema francés) o Equal principal payments (abono constante a capital, cuota decreciente). En Latinoamérica lo habitual en consumo y microcrédito es cuota fija; el abono constante aparece en cartera comercial. La decisión es de producto, pero conviene verificar contra el reglamento: “cuota fija” en un reglamento a veces significa capital fijo en la práctica.
2. Método de interés
Declining balance (sobre saldo) o Flat (sobre monto original durante toda la vida). Flat existe porque algunas microfinancieras lo usan históricamente, pero en la mayoría de las jurisdicciones la tasa efectiva resultante supera con facilidad el tope de usura. Si el reglamento dice “tasa sobre saldo”, es declining balance sin discusión.
3. Periodo de cálculo de interés
Same as repayment period o Daily. Con el primero, el interés de cada cuota se calcula sobre el periodo completo sin importar el día exacto del pago. Con Daily, cada día cuenta y un pago anticipado reduce el interés de la cuota. Daily es lo que un cliente espera y lo que un regulador entiende; Same as repayment period simplifica la cartera pero produce discusiones cuando alguien paga el día 3 y se le cobra el mes completo.
4. Estrategia de aplicación de pagos
Define en qué orden un pago cubre mora, intereses, cargos y capital. Fineract trae varias (Penalties, Fees, Interest, Principal es la más común). Esta decisión rara vez es técnica: viene del reglamento o de la norma local. Lo que sí es técnico es verificar que la estrategia elegida hace lo que el reglamento dice con un pago parcial, que es donde todas se diferencian.
5. Días del año y del mes
Actual/Actual, Actual/365, 30/360. Cambia el devengo diario y por lo tanto la cuota y el interés acumulado en el cierre. Si la institución ya tiene cartera en otro sistema, este parámetro debe ser idéntico al del sistema anterior o la migración nunca cuadra al centavo.
6. Tipo de contabilidad
None, Cash, Accrual (periodic) o Accrual (upfront). Con Cash, el interés solo se reconoce cuando se paga. Con Accrual periodic, un job diario devenga el interés y lo lleva a una cuenta por cobrar; el pago después la cancela. Para una entidad vigilada, Accrual periodic es lo normal, y exige definir las cuentas de: cartera, interés por cobrar, ingreso por intereses, ingreso por cargos, ingreso por mora, castigo, sobrepago y transitoria de fondos. Ocho cuentas mínimo por producto; con reglas por oficina o por fondo, muchas más.
7. Cargos asociados
Un cargo se crea aparte (Charges) y se asocia al producto. Lo que define su comportamiento es la combinación de tipo de cálculo (monto fijo, % del monto, % de interés, % de monto+interés) y momento (desembolso, cuota específica, vencido, mora). Cada cargo tiene su propia cuenta de ingreso. La trampa clásica: un cargo por desembolso como % del monto que el reglamento cobra con IVA; el impuesto no es un cargo más, es una configuración aparte (tax group) que se encadena al cargo.
La combinación que conviene evitar
Flat + Same as repayment period + Cash accounting. Es la que produce un producto que parece simple y que nadie puede explicar cuando un cliente paga anticipado, cuando se reestructura o cuando auditoría pide el devengo del mes. Si la institución no está lista para accrual, que sea Declining balance + Daily + Cash: al menos el plan de pagos será defendible y el paso a accrual después será solo contable.
Antes de crear el producto
Tener el reglamento aprobado, el plan de cuentas con los ocho conceptos y un caso de prueba calculado a mano en una hoja de cálculo (monto, tasa, plazo, un pago anticipado, un pago atrasado). Fineract debe reproducir esa hoja al centavo. Si no lo hace, uno de los siete parámetros no es el que se cree.