App Frappe para preparar EEFF por periodo (cliente + mes + anio) con flujo operativo:
- Carga de balanza de comprobacion por CSV.
- Preparacion de paquete EEFF (estados, notas y datos estadisticos).
- Mapeo contable por reglas hacia lineas/cifras/celdas destino.
- Validaciones de formulas y estructura.
- Indicadores de emision y exportacion a Word.
- La rama
v15conserva la version anterior. El desarrollo para v16 continua enmain. - MFI Tools 0.2.2 se verifico en WSL con Frappe 16.52.0, ERPNext 16.51.1 y Python 3.14.
- Requiere ERPNext y
python-docxpara la exportacion Word; Bench instala esta dependencia Python. - Se incluyen
SidebaryDockpara la navegacion nueva, yWorkspace Sidebarpara versiones como Frappe 16.5. El menu de compatibilidad se exporta enmfi_tools/workspace_sidebar/panel_mfi_tools.json. - El acceso MFI Tools aparece tanto en Apps como en Desk con el icono
mfi_tools/public/images/mfi-tools.svg. Su destino es/desk/panel-mfi-tools, sin depender de rutas con el nombre del modulo. - El menu lateral agrupa Preparacion EEFF, Estados y notas y Configuracion. El panel agrega cuatro accesos rapidos y las mismas tres secciones.
- La visibilidad de la app respeta el permiso de lectura de
Paquete EEFFpara usuarios del Desk. Los roles actuales de los documentos y paginas siguen siendoSystem Manager. - Las tasas de cambio se editan dentro de cada Balanza Comprobacion EEFF, en Tasas de Cambio por Moneda.
Tasa Cambio Balanza EEFFes una tabla hija y no tiene lista independiente.
Instalacion en un bench v16 con ERPNext instalado:
bench get-app /ruta/a/mfi_tools --soft-link --skip-assets
bench --site nombre-del-sitio backup --with-files
bench --site nombre-del-sitio install-app mfi_tools
bench build --app mfi_tools
bench --site nombre-del-sitio migrate
bench --site nombre-del-sitio clear-cacheEn un sitio que ya tiene MFI Tools, actualizar main, instalar sus dependencias con bench setup requirements --python y ejecutar build, migrate y clear-cache. La navegacion se importa desde los JSON de la app; las personalizaciones del sitio y del usuario se administran con las capas de Frappe. Recargar el navegador despues de actualizar.
Balanza Comprobacion EEFF: normaliza lineas, calculasaldo, totalesdebe/haber, valida duplicados y determinacuadra.Paquete EEFF: sincroniza nombre/periodo, controla totales, calcula formulas en datos estadisticos.Estado Financiero EEFF: calcula lineas formula (formula_lineas) con deteccion de referencias circulares.Nota EEFF: calcula cifras formula (formula_cifras) y normaliza cifras/celdas.Regla Mapeo Contable EEFF: valida origen/destino, cuentas (+/-) y periodo de valor para celdas de tablas complejas.- Servicios de mapeo: aplica reglas y actualiza destinos del paquete.
- Exportacion Word: genera documento consolidado del paquete.
Balanza Comprobacion EEFFLinea Balanza Comprobacion EEFFPaquete EEFFEstado Financiero EEFFLinea Estado Financiero EEFFNota EEFFCifra Nota EEFFCelda Nota EEFFDato Estadistico EEFFRegla Mapeo Contable EEFFCuenta Regla Mapeo EEFFPlantilla Estado Financiero EEFFFila Plantilla Estado Financiero EEFFPlantilla Nota EEFFFila Plantilla Nota EEFFPlantilla Dato Estadistico EEFFFila Plantilla Dato Estadistico EEFF
- Pagina
indicadores_emision_eeff: KPIs de cuadre, lineas huerfanas, formulas rotas y notas faltantes. - Workspace
panel_mfi_tools.
La pagina indicadores-emision-eeff requiere el rol System Manager y permiso de lectura sobre el paquete y sus documentos vinculados. La evaluacion no guarda ni recalcula los importes de estados y notas en la base de datos.
- Cuadre: suma las columnas de saldo de las lineas de la balanza, con la misma tolerancia de 0.0001 que el documento. Una balanza vacia o de otra entidad/periodo no se considera cuadrada.
- Jerarquia: comprueba padres de lineas imprimibles y filas de estados complejos por tabla.
- Formulas: comprueba referencias y ciclos de formulas de lineas y tablas complejas. Reconoce formulas de datos (
BAL,EST,VAR, funciones de periodo), cuya sintaxis y argumentos valida sin ejecutarlas. No sustituye la ejecucion del mapeo ni certifica los valores de las fuentes. - Notas: comprueba secuencia, referencias desde estados y contenido visible. Titulos, saltos, espacios HTML y celdas vacias no completan una nota.
- Integridad: detecta estados faltantes o sin filas imprimibles y totales de balanza desactualizados. Se examinan todos los estados, notas y secciones del paquete.
El score mantiene las penalizaciones por cuadre (35 por error o 10 por advertencia), huerfanas (2 por hallazgo, maximo 25), formulas (3, maximo 25) y notas (2, maximo 15); agrega integridad (5, maximo 20). Cualquier error limita el score a 59; cualquier advertencia lo limita a 84. El panel identifica el paquete, periodo y hora de evaluacion, y descarta resultados anteriores cuando cambian los filtros o falla la consulta.
- Al importar o volver a importar una balanza se mapean sus paquetes vinculados, incluyendo los enlaces comparativo y base. Guardar cambios de importes, moneda o tasas tambien activa el recalculo; guardar solo comentarios no lo repite.
- Al copiar EEFF, notas y factsheets se ejecuta el mapeo al terminar, usando las fuentes del destino. Si el mapeo falla, la carga o copia se conserva y sus importes previos no quedan parcialmente modificados. El paquete muestra Mapeo pendiente y el detalle para reintentar.
- Cambiar las fuentes de un paquete lo marca pendiente. Cambiar una balanza usada por formulas historicas tambien deja pendientes los paquetes afectados. Ejecutar Mapeo permite reintentarlo; las advertencias de reglas pendientes no se ocultan.
- Cada Estado Financiero tiene Meses de emision, con Todos los meses y doce checks. Patrimonio se inicializa en junio/diciembre y Flujos de Efectivo solo en diciembre. Los demas estados se inicializan mensuales; se pueden cambiar estas selecciones por estado. La copia conserva la configuracion.
- El paquete incluye en Word y PDF solo los estados seleccionados para su mes. Las notas consecutivas de la misma orientacion continuan en la misma pagina cuando hay espacio; los cambios de orientacion conservan el salto necesario. No se cambia el texto de la Nota 1.
La actualizacion requiere bench --site nombre-del-sitio migrate para crear los campos y configurar la periodicidad de los estados existentes. Los paquetes anteriores quedan pendientes de un primer mapeo para confirmar sus fuentes.
Estado Financiero EEFF BaseNota EEFF IndividualPaquete EEFF Completo
mfi_tools.mfi_tools.doctype.balanza_comprobacion_eeff.balanza_comprobacion_eeff.cargar_balanza_archivo(balanza_name, file_url=None, csv_content=None, tasa_cambio=None, moneda=None)mfi_tools.mfi_tools.doctype.balanza_comprobacion_eeff.balanza_comprobacion_eeff.cargar_balanza_csv(balanza_name, csv_content, tasa_cambio=None, moneda=None)mfi_tools.mfi_tools.doctype.balanza_comprobacion_eeff.balanza_comprobacion_eeff.descargar_balanza_excel(balanza_name)mfi_tools.mfi_tools.doctype.balanza_comprobacion_eeff.balanza_comprobacion_eeff.descargar_plantilla_excel(balanza_name=None)mfi_tools.mfi_tools.doctype.balanza_comprobacion_eeff.balanza_comprobacion_eeff.descargar_archivo_isc(balanza_name, id_moneda=0, longitud_cuenta="8", incluir_moneda_0=1, omitir_ceros=1, separador="|", tasa_cambio=1.0)mfi_tools.mfi_tools.doctype.balanza_comprobacion_eeff.balanza_comprobacion_eeff.validar_datos_isc(balanza_name, id_moneda=0, longitud_cuenta="8", incluir_moneda_0=1, omitir_ceros=1, separador="|", tasa_cambio=1.0)
mfi_tools.mfi_tools.doctype.paquete_eeff.paquete_eeff.ejecutar_mapeo(paquete_name)mfi_tools.mfi_tools.doctype.paquete_eeff.paquete_eeff.exportar_paquete_word(paquete_name)mfi_tools.mfi_tools.doctype.paquete_eeff.paquete_eeff.aplicar_plantillas_reutilizables(paquete_name, plantilla_estado=None, plantilla_nota=None, plantilla_dato_estadistico=None, marco_referencia=None, limpiar_estados=0, limpiar_notas=0, limpiar_datos_estadisticos=0)mfi_tools.mfi_tools.doctype.paquete_eeff.paquete_eeff.copiar_notas_desde_paquete(paquete_name, paquete_fuente, limpiar_notas=0)
mfi_tools.mfi_tools.page.indicadores_emision_eeff.indicadores_emision_eeff.get_indicator_bootstrap(cliente=None, anio=None, mes=None, paquete_name=None)mfi_tools.mfi_tools.page.indicadores_emision_eeff.indicadores_emision_eeff.run_emission_indicators(paquete_name)
cargar_balanza_archivo y cargar_balanza_csv aceptan archivos Excel (.xlsx, .xls) o CSV con detección automática de encabezados y alias equivalentes:
- Cuenta:
cuenta,codigo_cuenta,account - Descripcion:
descripcion,descripcion_cuenta,account_name - Debe:
debe,debit - Haber:
haber,credit - Centro de costo:
centro_costo,cost_center
De acuerdo con el Manual para el Envío de Información de Saldos Contables (ISC) de la CONAMI (Nicaragua), el botón Generar ISC (TXT) genera el archivo oficial isc_saldos.txt:
- Formato: Archivo plano de texto delimitado por pleca (
|), sin encabezado. - Estructura (6 campos):
cta_contable(Varchar 8, caracteres numéricos sin puntos ni guiones)Id_moneda(0 = Integradora, 1 = Nac c/MV, 2 = Nac s/MV, 3 = Extranjera)Saldo_inicial(numeric 20,2)creditos_mes(numeric 20,2)debitos_mes(numeric 20,2)Saldo(numeric 20,2)
- Validaciones automáticas: Cuadre de saldos (Σ Deudoras = Σ Acreedoras), agregación de cuentas por moneda, y generación de registros consolidados para la moneda integradora (0).
- Los nombres de documentos de balanza y paquete se sincronizan con el periodo.
- El mapeo y calculos formulan referencias por codigo y validan ciclos.
- Los indicadores de emision son informativos y no bloquean la emision.