================================================================================ VISOR DE NUMERADORES v2.1.4 ICG HIOPOS — e-Factura Uruguay (DGI / CFE) ================================================================================ DESCRIPCION ----------- Aplicación portable para Windows que monitorea en tiempo real la numeración disponible de los CAEs (Códigos de Autorización de Emisión) registrados en la base de datos SQL Server del sistema EFM (e-Factura Manager). Muestra el estado de los tipos de CFE 101 (e-Ticket), 102 (NC de e-Ticket), 111 (e-Factura) y 112 (NC de e-Factura), incluyendo el próximo número a emitir, la cantidad de comprobantes disponibles sumando el CAE en uso y todos los CAEs en cola, y el vencimiento más lejano de la cola de CAEs para cada tipo. Además sincroniza automáticamente los datos de autorización desde el SQLite de InvoiCy Conector hacia la tabla EFM_CAE de SQL Server. CONTENIDO DEL PAQUETE --------------------- VisorNumeradores.exe Ejecutable portable (todo incluido, no requiere Python) VisorNumeradores.ini Archivo de configuración editable VisorNumeradores.ico Ícono para accesos directos README.txt Este archivo REQUISITOS ---------- - Windows 10 o superior (64-bit) - SQL Server accesible en red con la base de datos EFM - InvoiCy Conector instalado (para sincronización automática de CAEs) INSTALACION ----------- 1. Copiar todos los archivos del paquete a una carpeta fija, por ejemplo: C:\Migrate\VisorNumeradores\ 2. Editar VisorNumeradores.ini con los datos de conexión (ver sección INI) 3. Ejecutar VisorNumeradores.exe 4. La aplicación se agrega automáticamente al inicio de Windows y crea un acceso directo en el escritorio (configurable en el INI o ventana de configuración) INTERFAZ -------- La aplicación tiene dos modos de visualización intercambiables desde el menú contextual (clic derecho) o desde la ventana de configuración: MODO VENTANA (por defecto) Ventana flotante en la esquina inferior derecha de la pantalla. Muestra una tabla con columnas: CFE, Tipo, Próximo, Disponibles, Vencimiento. La ventana no aparece en la barra de tareas. Clic en una fila muestra el detalle completo del CAE activo y la cola de CAEs pendientes de uso. MODO BARRA Barra horizontal compacta pegada al borde inferior de la pantalla. Muestra cada CFE en formato: Tipo | PRÓXIMO: N | DISPONIBLES: N Ideal para monitores con poco espacio vertical. MODO SILENCIOSO Oculta completamente la ventana/barra. La aplicación sigue ejecutándose en segundo plano: refresca datos, sincroniza CAEs y mantiene el ícono en la bandeja del sistema. Activar/desactivar desde el menú del trayicon. BANDEJA DEL SISTEMA (TRAYICON) ------------------------------ El ícono en la bandeja del sistema está siempre visible, en todos los modos. Clic derecho sobre el ícono muestra el menú con las siguientes opciones: ⟳ Sincronizar ahora Lanza una sincronización inmediata con InvoiCy ▭ Cambiar a modo barra Alterna entre modo ventana y modo barra 🔇 Activar modo silencioso Oculta la interfaz (o la restaura si ya está oculta) ⚙ Configuración Abre la ventana de configuración ✕ Cerrar Cierra la aplicación VENTANA DE DETALLE (MODO VENTANA) ---------------------------------- Al hacer clic en una fila de la grilla se abre una ventana de detalle que muestra: - CAE actualmente en uso: número, serie, rango, último número emitido, próximo número, disponibles y vencimiento - Cola de CAEs pendientes de uso: todos los CAEs vigentes ordenados por número de autorización - La fila "EN USO" se resalta visualmente La ventana se cierra automáticamente a los 30 segundos o con cualquier clic. SINCRONIZACION CON INVOICY --------------------------- La aplicación lee el archivo SQLite de InvoiCy Conector y sincroniza los datos de autorización de CAEs hacia la tabla EFM_CAE de SQL Server. La sincronización: - Se ejecuta automáticamente 5 segundos después del inicio (configurable) - Se repite periódicamente según el intervalo configurado (default: 30 min) - Puede lanzarse manualmente desde el menú del trayicon o desde el menú contextual de la ventana - Importa: número de autorización, tipo de CFE, serie, rangos de numeración, fecha de vigencia - Calcula automáticamente el IDRANGO correlativo por tipo de CFE - Actualiza el vencimiento del certificado digital en el INI Mapeo de campos SQLite → EFM_CAE: NUMERO ← IdAutorizacao CFE ← TipoEmissao SERIE ← Serie NUMERODESDE ← NumeracaoInicial (del CAE) NUMEROHASTA ← NumeracaoFinal (del CAE) RANGODESDE ← FaixaAutorizacao.NumeracaoInicial RANGOHASTA ← FaixaAutorizacao.NumeracaoFinal FECHAVIGENCIA ← DataVencimento ULTIMONUMERO ← RANGODESDE - 1 (inicialmente sin usar) IDRANGO ← MAX(IDRANGO) + 1 por CFE en SQL Server AUTO-ACTUALIZACION ------------------ Si está habilitada (Actualizacion.Habilitado=True), al iniciar la aplicación verifica si hay una versión más nueva en la URL configurada. Si la hay, descarga el nuevo ejecutable silenciosamente y relanza la aplicación. La URL debe servir dos archivos: version.txt Número de versión (ej: 2.1.4) VisorNumeradores.exe Ejecutable actualizado INDICADORES DE ESTADO ---------------------- Cada fila de la grilla muestra el porcentaje de uso del rango actual. Los colores del indicador son: Verde Más del 20% del rango disponible — operación normal Amarillo Entre 10% y 20% disponible — próximo a agotarse Rojo Menos del 10% disponible — requiere atención inmediata El vencimiento mostrado es la fecha más lejana entre todos los CAEs vigentes en cola para ese tipo de CFE (no solo el CAE actualmente en uso). ARCHIVO DE CONFIGURACION (VisorNumeradores.ini) ------------------------------------------------ El INI se encuentra en la misma carpeta que el ejecutable y puede editarse con cualquier editor de texto. Los cambios se aplican al reiniciar la aplicación o desde la ventana de configuración integrada. [Conexion] Servidor=LOCALHOST Nombre o IP del servidor SQL Server BaseDatos=DBFREST Nombre de la base de datos [Base] TablaCAE=EFM_CAE Nombre de la tabla de CAEs [Refresco] IntervaloSegundos=60 Cada cuántos segundos refrescar los datos (mínimo 10) [Visual] ModoBarra=False True = modo barra, False = modo ventana ModoSincronizacion=False True = modo silencioso (sin interfaz visible) MostrarProximo=True Mostrar columna "Próximo" en la grilla MostrarDisponibles=True Mostrar columna "Disponibles" en la grilla [Actualizacion] URL=http://icgit.uy/vnum URL base para verificar actualizaciones Habilitado=True Habilitar auto-actualización [Sincronizacion] Habilitado=True Habilitar sincronización con InvoiCy RutaSQLite=C:\Migrate\... Ruta al archivo invoicyconector.db RUC= RUC de la empresa (vacío = última empresa del SQLite) SincronizarAlIniciar=True Sincronizar al arrancar la aplicación IntervaloMinutos=30 Intervalo de sincronización periódica (0 = solo al inicio) [Certificado] VencimientoCertificado= Actualizado automáticamente al sincronizar [Accesos] Escritorio=True Crear acceso directo en el escritorio Autoarranque=True Iniciar con Windows (via shell:startup) LOGS Y DIAGNOSTICO ------------------ La aplicación genera logs diarios en la carpeta Logs\ junto al ejecutable: Logs\VNumAAAAMMDD.log Log diario de operación normal VNum_crash.txt Log de arranque y errores críticos (siempre actualizado) En caso de problemas, el archivo VNum_crash.txt es el primero a revisar ya que registra cada paso del inicio, incluyendo errores de conexión, fallos del trayicon y excepciones no controladas. COMPILACION (para desarrolladores) ------------------------------------ Requiere Python 3.11+ con las dependencias de requirements.txt. Ejecutar build.bat para compilar el ejecutable portable con PyInstaller. El resultado queda en dist\VisorNumeradores.exe. Dependencias principales: customtkinter Interfaz gráfica moderna sobre tkinter pyodbc Conexión a SQL Server Pillow Procesamiento de imágenes (ícono del tray) pyinstaller Empaquetado como ejecutable portable ================================================================================ Desarrollado para ICG HIOPOS — Sistema e-Factura Uruguay Versión 2.1.4 | Marzo 2026 ================================================================================