Modulo / Plugin : ConAgua — Facturación por Consumo de Agua
El módulo ConAgua extiende el sistema ContaPortable con un flujo completo para el registro de lecturas de consumo de agua, cálculo automático de montos en base a parametros y formulas, asi como la generación masiva de facturas electrónicas por proyecto.
📌 Introducción
Módulo ConAgua
Ver instalación del módulo ConAgua
Despues de instalar el modulo y reiniciar el sistema, se habilitará el acceso al módulo/plugin CONAGUA, para poder realizar registros y facturación por consumo de agua potable en base a lecturas. El módulo comparte la interfaz con el modulo de Proyectos pero opera con base de datos y recursos propios e independientes. Permite gestionar múltiples clientes por proyecto, registrar lecturas de consumo, exportar plantillas Excel con fórmulas y generar facturas en masa listas para transmitir y generar el DTE.
🎯 Objetivo
Propósito
- Automatizar el proceso de facturación por consumo de agua, generalmente manejado por proyectos, sin duplicar fichas de clientes.
- Automatizar el cálculo de consumo, cargos por distribución, canon, saldo pendiente y mora.
- Generar facturas electrónicas en masa en estado "Generado" para transmitirlas en bloque posterior.
- Permitir trabajo desde el sistema o desde plantilla Excel con fórmulas incluidas.
🔍 Alcance
Funciones del módulo
- Proyectos: configuración de factores (distribución, canon, mora), tipo de factura y clientes por proyecto.
- Pestaña 1 — Lecturas: registro de consumo, descarga de plantilla Excel, importación desde plantilla.
- Pestaña 2 — Facturación: traslado de lecturas registradas, conversión automática a facturas.
- Base de datos y recursos independientes de la interfaz de Proyectos estándar.
- Desactivado: si el modulo/plugin no esta activo, la interfaz de Proyectos vuelve a su estado original sin pestañas para configuración relacionada al modulo/plugin CONAGUA.
✨ Solución Implementada
Descripción de la solución
Se implementan dos pestañas integradas al módulo de Proyectos — una para el registro de lecturas y otra para la facturación — junto con la configuración de parámetros de cobro por proyecto y la gestión de clientes asociados.
⚙️ Configuración de proyectos y clientes
Configuración en Proyectos
Al activar el módulo, la sección Parámetros en Proyectos se habilita para configurar por cada proyecto:
- Factores de utilidad y costos por distribución
- Canon y mora
- Tipo de factura a emitir
También permite asociar múltiples clientes al proyecto sin duplicar su ficha, junto con datos de última lectura, última fecha de factura, etc. Se incluye opción de exportar e importar clientes desde Excel.
🚿 Pestaña 1 — Registro de lecturas
Registro de consumo
En la primera pestaña el operador registra la lectura actual para calcular el consumo y los demás parámetros de facturación. Puede elegir entre:
- Trabajar directamente desde el sistema
- Descargar la plantilla Excel (con fórmulas incluidas) para completar lecturas fuera del sistema
El registro se organiza por proyecto y puede buscarse por cliente. Los datos se guardan para facturar posteriormente.
📊 Plantilla Excel con fórmulas
Plantilla Excel
El sistema genera una plantilla Excel con las fórmulas necesarias para calcular el consumo y los cargos. El cliente puede completar las lecturas en campo y luego importarla al sistema para generar las facturas.
📄 Pestaña 2 — Facturación automática
Generación de facturas
En la segunda pestaña el operador puede:
- Importar desde sistema: traslada automáticamente las lecturas registradas en la Pestaña 1.
- Importar desde Excel: carga la plantilla completada externamente.
Al ejecutar Convertir a facturas, el sistema crea todas las facturas automáticamente en estado Generado, listas para transmisión masiva posterior. Los registros con consumo igual a cero se omiten — no se generan facturas invalidadas ni generadas para ellos.
El ítem Canon se agrega como No Sujeto en el detalle de la factura.
🔒 Comportamiento con módulo desactivado
Módulo CONAGUA desactivado
Cuando el parámetro ACTIVATEMODCONAGUA = NO, la interfaz de Proyectos mantiene su comportamiento original: sin pestaña de lecturas ni facturación de agua. El acceso a la bitácora se mantiene mediante el botón correspondiente.
⚙️ Configuración Requerida
🔧 Formas de instalación del módulo
Opción 1 — Instalación mediante formulario (recomendada)
La forma recomendada de instalar el módulo ConAgua es usando el formulario de instalación de módulos y plugins, accesible desde el menú del sistema en Datos Generales → Instalar plugin/módulo. Este método activa automáticamente el módulo sin necesidad de configuración manual.
Recursos independientes
Al activar el módulo, el sistema genera automáticamente una carpeta con los recursos propios (Base de datos y archivos) del módulo ConAgua, separados de los recursos del sistema estándar.
🔄 Flujo Funcional
Flujo completo de facturación de agua
- Ir a Proyectos → pestaña de control de consumo por proyecto.
- En la sección Parámetros de control de consumo por proyecto, configurar factores de utilidad,costo de produccion, costo por distribución, canon, mora y tipo de factura.
- Asociar los clientes del proyecto (sin necesidad de duplicar fichas de clientes).
- Opcionalmente el sistema permite exportar/importar el listado de clientes ligados al proyecto desde Excel.
- Seleccionar el proyecto a facturar.
- Elegir modalidad: registrar el consumo directamente en el sistema o descargar plantilla Excel asignar la lectura segun medidor.
- Ingresar la lectura actual de cada cliente o importar plantilla trabajada para calcular el consumo y demas costos.
- Guardar las lecturas — quedan disponibles para la pestaña de facturación y para las nuevas exportaciones de plantillas, en donde se corvertira en la lectura anterior.
- En la Pestaña 2, usar Importar desde sistema (traslada lecturas de Pestaña 1) o Importar desde Excel (carga plantilla externa).
- Revisar los datos de consumo y montos calculados.
- Ejecutar Convertir a facturas.
- El sistema genera las facturas en estado Generado — los registros con consumo=0 se omiten automáticamente.
- Transmitir las facturas en bloque generadas de forma masiva.
☑️ Validaciones y Pruebas Realizadas 🧪
Tipos de validaciones y pruebas Realizadas
Configuración de proyectos y registro de lecturas
Se validó la configuración de parámetros por proyecto, la asociación de clientes y el registro de lecturas desde sistema.
- Configuración de factores por proyecto: confirmada
- Asociación de clientes sin duplicar ficha: confirmada
- Registro de lecturas por proyecto: funcional
Generación automática de facturas
Se validó el flujo completo desde la importación de lecturas hasta la generación de facturas en estado Generado.
- Importación de lecturas desde sistema: exitosa
- Conversión a facturas en estado Generado: confirmada
- Facturas listas para transmisión masiva: confirmadas
Consumo cero — omisión de factura y Canon como No Sujeto
Se confirmó que los registros con consumo igual a cero se omiten al generar facturas automáticas. Adicionalmente, el ítem Canon se agrega como No Sujeto en el detalle de la factura.
- Registros con consumo=0 omitidos al generar facturas: confirmado en EXE_2026_03_04
- Canon agregado como ítem No Sujeto en detalle de factura: confirmado
- Facturas a cero no generadas (ni invalidadas ni generadas): confirmado
