← Volver al blog

13 de octubre de 2026 · 4 min de lectura

Migrar cartera viva a Fineract: la decisión que se toma antes de la primera carga

Una migración no se decide en la herramienta de carga sino en dos preguntas anteriores: qué se migra y dónde se corta. Equivocarse en cualquiera se descubre el día que contabilidad no puede cuadrar el saldo de apertura.

Migración · Cartera · Operación

La pregunta que llega primero siempre es con qué herramienta se carga la cartera. Es la última que importa. Una migración se define en dos decisiones anteriores —qué se migra y dónde se corta— y equivocarse en cualquiera de las dos no se nota durante semanas: se descubre el día en que contabilidad no logra cuadrar el saldo de apertura con el mayor, cuando ya hay clientes pagando en el sistema nuevo.

Saldos o historia: la decisión que define el proyecto

Migrar solo saldos significa crear cada crédito en Fineract como si se hubiera desembolsado el día del corte, por el monto insoluto, con el plazo que le queda. Es rápido, es predecible y el saldo cuadra por construcción. Lo que pierdes es el pasado: el cliente que lleva tres años pagando puntualmente aparece como recién originado, y con él se va el historial de mora que alimenta la calificación, las provisiones y cualquier modelo de riesgo que tengas.

Migrar la historia completa carga el crédito con su fecha de desembolso original y luego reproduce cada pago recibido. Conservas el comportamiento, pero apareces un requisito que sorprende a todos: Fineract regenera el plan de pagos a partir de los parámetros del producto, y ese plan tiene que coincidir con lo que el sistema anterior cobró realmente. Al centavo. Si el core viejo calculaba intereses sobre base 360 y el producto nuevo usa 365, cada crédito migrado nace con una diferencia que nadie autorizó.

La decisión no es técnica, es de negocio, y tiene una tercera vía que suele ser la correcta: saldos para la cartera vigente, historia solo para lo que la necesita —los créditos en mora, los reestructurados, los que están en cobranza judicial—, que suelen ser menos del 10 % y son exactamente los que un juez o un regulador puede pedirte.

El corte y la ventana

El corte contable y el operativo casi nunca son el mismo día. El contable es el cierre del mes: la fecha cuyos saldos vas a reproducir y contra la que vas a conciliar. El operativo es cuando dejas de recibir transacciones en el sistema viejo. Entre uno y otro pasan días, y en esos días la cartera se mueve: entran pagos, se desembolsan créditos, alguien reversa una transacción de la semana pasada.

Hay dos formas de tratar ese intervalo. Congelar —no se opera hasta que el sistema nuevo esté encendido— es limpio y caro; solo funciona si cae en un fin de semana largo. Capturar y reproducir —seguir operando en el viejo y aplicar después ese delta en Fineract— es lo habitual, y exige que el proceso de carga sea idempotente: tiene que poder correrse dos veces sin duplicar nada. El campo externalId de Fineract existe justamente para eso, y es la diferencia entre repetir una carga fallida con tranquilidad o tener que vaciar la base y empezar de nuevo.

Lo que tu cartera tiene y Fineract no acepta

Esta fase siempre toma más de lo estimado, porque los registros problemáticos no aparecen en las pruebas: aparecen a las tres horas de la carga real, fallando por lotes. Los sospechosos habituales son cuatro. Créditos reestructurados sin rastro del original, con un saldo que no se deriva de ningún desembolso. Tasas fuera del rango del producto, normalmente por una excepción que alguien aprobó hace años por teléfono. Fechas imposibles: primer pago anterior al desembolso, o desembolsos en fin de semana que el calendario nuevo no admite. Y clientes duplicados, la misma persona con dos identificaciones distintas y un crédito en cada una.

Ninguno se arregla programando: cada uno es una decisión de negocio, y el error es descubrirlos durante la migración. Extrae esas excepciones seis semanas antes y entrégalas a operaciones como una lista de casos a resolver.

Las tres cifras que deben cuadrar antes de encender

Si una sola no cuadra, no se enciende. No hay excepción razonable a esta regla.

El saldo de capital por producto contra el mayor contable, por producto y no en total: dos productos con errores de signo contrario suman cero y esconden ambos. El número de créditos activos por agencia, que detecta lotes que fallaron en silencio. Y la suma de cuotas pendientes contra la proyección del sistema anterior, que es la que revela las diferencias de cálculo de intereses cuando el capital ya cuadraba.

Esa tercera es la que más se omite y la que más cara sale, porque un capital correcto con intereses mal calculados pasa la revisión del primer día y aparece en el primer cierre.

El plan de reversa

Escríbelo antes de empezar, no cuando haga falta. Y que responda a una pregunta concreta: qué significa volver atrás el día tres, cuando ya hay pagos registrados en Fineract que no existen en el sistema viejo.

La respuesta honesta casi siempre es que no se vuelve: se corrige hacia adelante. Saberlo antes cambia la preparación, porque obliga a un ensayo completo sobre una copia de producción con las cifras de conciliación reales.