10 de noviembre de 2026 · 3 min de lectura
Impuestos y retenciones en Fineract: dónde se modelan y qué pasa cuando cambia la tasa
Fineract separa el componente de impuesto del grupo que lo agrupa, y guarda el histórico de tasas. Por qué esa separación importa, dónde se aplica y qué no cubre.
En Latinoamérica casi ningún producto financiero se liquida limpio. Al interés se le retiene, a la comisión se le suma IVA, y al movimiento de la cuenta se le aplica un impuesto a las transacciones financieras. Esos tres conceptos tienen reglas distintas, bases distintas y cuentas distintas, y conviene saber dónde los pone Fineract antes de parametrizar el primer producto.
La separación que Fineract hace
Hay dos niveles, y entender por qué están separados ahorra la mitad del trabajo.
El componente de impuesto es un concepto individual: un nombre, un porcentaje, una fecha desde la que aplica y la cuenta contable a la que va. IVA del 19 % sería un componente. La retención en la fuente sobre rendimientos financieros sería otro.
El grupo de impuestos es un conjunto de componentes que se aplican juntos. Es lo que se asocia a un producto.
La razón de la separación es práctica: un mismo componente se reutiliza en varios grupos. Cuando el IVA cambia, se toca en un solo lugar y todos los productos que lo incluyen quedan actualizados. Si se hubiera modelado el impuesto dentro del producto, cada cambio de tasa sería una revisión de todo el catálogo.
El histórico de tasas, que es lo que de verdad importa
Fineract guarda el histórico de los componentes. No sobrescribe el porcentaje cuando cambia: registra que desde tal fecha el valor es otro.
Eso resuelve el problema que aparece siempre y tarde. Cuando el regulador cambia una tasa a mitad de año y seis meses después alguien tiene que recalcular una liquidación de marzo, el sistema necesita saber qué porcentaje estaba vigente en marzo, no el de hoy. Sin histórico, ese recálculo da un número distinto al original y nadie puede explicar la diferencia.
Es la misma disciplina que exige un cierre contable: lo que se publicó para una fecha se reconstruye igual siempre. Si tu implementación tiene impuestos modelados fuera de ese mecanismo —en una tabla propia, o peor, en el código de una integración— vas a perder esa propiedad justo cuando la necesites.
Dónde se aplica
Los grupos de impuestos se asocian a los productos de captación: cuentas de ahorro y depósitos a término. Ahí es donde el caso de uso es más directo, porque la retención sobre rendimientos financieros se calcula cuando se liquida el interés.
Para el lado del crédito, el tratamiento del IVA sobre comisiones depende de cómo se modelen los cargos, y conviene revisarlo producto por producto en lugar de asumir que se comporta igual.
Lo que no cubre y hay que decidir
El impuesto a las transacciones financieras. El GMF colombiano y sus equivalentes no se calculan sobre el interés sino sobre el movimiento, con exenciones por cuenta y topes mensuales. Esa lógica no es un porcentaje sobre una base: es un conjunto de reglas por cliente. Se resuelve como extensión, no como parametrización.
La declaración y el reporte. Fineract calcula y contabiliza, pero el formato que pide la autoridad tributaria —con sus periodicidades y sus agrupaciones— sale de la capa de reportería, desde una réplica de lectura.
Los certificados al cliente. El documento anual de retenciones que el partícipe necesita para su declaración se construye fuera, con los datos que el core ya guarda.
El orden que seguiría
Lista primero los conceptos tributarios que aplican a cada producto, con su base de cálculo y su cuenta contable, y valídalos con el área fiscal. Ese listado es el que se traduce en componentes.
Agrúpalos después según los productos que comparten tratamiento. Si dos productos tienen la misma combinación de impuestos, comparten grupo; si difieren en uno solo, necesitan grupos distintos.
Y antes de configurar nada, haz la pregunta que casi nadie hace a tiempo: qué pasa el día que cambie una tasa a mitad de periodo. Si la respuesta de tu diseño es “se actualiza el valor”, tienes un problema de auditoría esperando. Si es “se registra una vigencia nueva y la anterior se conserva”, vas bien.