← Volver al blog

6 de octubre de 2026 · 4 min de lectura

Fondos en Fineract: las tres decisiones que deciden si el modelo aguanta una auditoría

La mecánica del valor cuota es la parte fácil. Lo que separa un fondo operable de un prototipo caro son tres decisiones de diseño —de dónde sale el valor, dónde vive la posición del inversor y si el histórico se reescribe— que casi siempre se aplazan.

Fondos de inversión · Auditoría · Arquitectura

Modelar un fondo de valor cuota sobre Apache Fineract es más sencillo de lo que parece: un aporte que se convierte al precio del cierre anterior no diluye a nadie, y esa regla se implementa en una tarde. Es lo que todo el mundo discute, y es la parte fácil.

Lo que decide si tienes un fondo operable o un prototipo caro son tres decisiones que casi nadie toma al principio, porque ninguna de las tres impide que el sistema funcione en la demo. Las tres se cobran después.

Decisión 1: ¿el valor del fondo se digita o se deriva?

Es tentador exponer un endpoint que reciba el saldo en banco, la cartera colocada y otros activos, y los sume. Funciona el primer día, y es lo que casi todas las implementaciones hacen.

El problema es que ese es el número del que depende el patrimonio de todos los partícipes. Si se digita, un error de tipeo reparte o destruye dinero de terceros sin dejar rastro de conciliación, y nadie lo detecta hasta el estado de cuenta.

Hay una consecuencia menos evidente y más dañina. El proceso que rellena los días sin captura manual no tiene de dónde sacar un valor por cada día, así que acaba repitiendo el mismo para toda la ventana que reconstruye. El precio de la cuota entonces solo se mueve por aportes y retiros, nunca por el rendimiento real de la cartera. Los partícipes ven un fondo plano durante diez días y un salto el día once.

La pata de crédito es derivable: Fineract sabe calcular el saldo insoluto agregado a una fecha. La de tesorería sale de la contabilidad. Empezar con captura manual es legítimo; dejarla como mecanismo definitivo, no.

Decisión 2: ¿la posición del inversor se deriva o se almacena?

Si las cuotas de cada transacción se guardan sin signo, la participación de un inversor solo se obtiene sumando esas filas y deduciendo el signo del tipo de transacción: depósito suma, retiro resta. Funciona como consulta.

Lo que significa es que no existe ninguna cifra oficial de cuánto tiene cada partícipe. Cada reporte la recalcula, y basta que dos lo hagan con criterios distintos —uno incluye las transacciones reversadas, otro no— para que empiece una discusión que nadie puede zanjar, porque no hay una fuente de verdad contra la cual contrastar.

Un saldo de cuotas por inversor como entidad propia —fondo, cuenta, cuotas, costo promedio— hace la participación consultable y, sobre todo, conciliable contra la suma de transacciones. Ese contraste entre el saldo almacenado y el derivado es la mejor alarma temprana que vas a tener: cuando dejan de coincidir, algo se rompió esa semana y no seis meses atrás.

Decisión 3: ¿el histórico es mutable o sellado?

Esta es la que convierte un problema de código en uno de auditoría.

Recalcular un día es una necesidad operativa: llega una transacción atrasada, se corrige un saldo, se repara un proceso que falló. La pregunta es qué pasa con las cuotas que ya se asignaron. Si el recálculo las reescribe con el precio vigente en ese momento, el histórico de participaciones es mutable: la respuesta a “¿cuántas cuotas me correspondieron en febrero?” cambia según cuándo se pregunte.

Un fondo real necesita cierres sellados. Publicado el precio de una fecha, un error se corrige con un asiento de ajuste fechado, no sobrescribiendo el original. Es la misma disciplina que ya aplicas en contabilidad, donde a nadie se le ocurre editar un asiento de hace tres meses.

Ponerla desde el principio cuesta una columna de estado y una regla. Retroceder cuando el regulador pide la trazabilidad cuesta un proyecto.

El caso aparte: las comisiones

Guardar la comisión fija y la variable no es lo mismo que aplicarlas. Es frecuente encontrar ambas persistidas en el cierre diario y el precio de la cuota calculado sin ellas: el resultado es idéntico con comisión cero o con comisión de diez mil.

No es un error de programación, es una decisión de producto que nadie tomó. ¿Se descuenta del valor del fondo antes de dividir? ¿Se devenga sobre el patrimonio medio del periodo? ¿La variable es un success fee sobre el rendimiento por encima de un umbral? Mientras no esté escrita, el módulo no refleja el contrato que firmó el partícipe.

Antes de recibir dinero de terceros

Tres invariantes en pruebas automatizadas, y ninguna es opcional cuando el software reparte patrimonio ajeno:

  1. En cada cierre, el precio por las cuotas en circulación debe igualar el valor del fondo.
  2. La suma de las cuotas de todos los inversores debe igualar la circulación.
  3. Un aporte o un retiro no puede mover el precio de la cuota.

Sobre la primera, una advertencia de precisión: Fineract calcula con diecinueve dígitos significativos, mientras que las columnas monetarias suelen declararse con seis decimales. Recalcular esa cifra de control desde los valores leídos de la base no reproducirá exactamente el almacenado, porque el precio se persistió redondeado. Para seguimiento es aceptable; para conciliar centavo a centavo hay que decidir dónde se redondea y dejarlo escrito antes de que lo pregunte el auditor.