HolaGest Docs

Español

English
中文

Español

English
中文

Apariencia

No se Actualizan los Saldos de las Cuentas ​

Si tras crear asientos contables los saldos de las cuentas no se actualizan inmediatamente, es probable que haya trabajos en segundo plano pendientes de ejecución. Este comportamiento es normal y forma parte del sistema de optimización de rendimiento de HolaGest.

📋 Tabla de Contenidos ​

¿Por qué no se Actualizan los Saldos? ​

HolaGest utiliza un sistema de trabajos en segundo plano para procesos que no son críticos, mejorando el rendimiento general del sistema.

Comportamiento Normal ​

Antes (versiones antiguas):

1. Usuario crea asiento contable
2. Sistema actualiza saldos inmediatamente
3. Usuario espera 2-3 segundos
4. Asiento guardado

Ahora (versión 2024 y posteriores):

1. Usuario crea asiento contable
2. Asiento guardado inmediatamente (0,5 segundos)
3. Sistema añade tarea a la cola de trabajos
4. Saldos se actualizan en segundo plano

Ventajas del Sistema Actual ​

✅ Mayor velocidad: Operaciones más rápidas ✅ Mejor experiencia: No hay esperas innecesarias ✅ Optimización de recursos: Procesos distribuidos en el tiempo ✅ Escalabilidad: Soporta mayor volumen de operaciones

Procesos en Segundo Plano ​

Qué se procesa en segundo plano:

  • Actualización de saldos de cuentas
  • Actualización de saldos de subcuentas
  • Actualización de contadores
  • Recálculo de totales
  • Generación de estadísticas

Qué NO se procesa en segundo plano:

  • Guardado de asientos (inmediato)
  • Guardado de facturas (inmediato)
  • Validaciones (inmediatas)
  • Bloqueos de seguridad (inmediatos)

Cola de Trabajos en Segundo Plano ​

La cola de trabajos es un sistema que gestiona tareas pendientes de forma ordenada y eficiente.

¿Cómo Funciona? ​

Proceso de ejecución:

  1. Usuario realiza acción (crear asiento, factura, etc.)
  2. Sistema añade tarea a la cola (actualizar saldos)
  3. Tarea espera su turno (según prioridad)
  4. Sistema ejecuta tarea (en segundo plano)
  5. Saldos actualizados (sin intervención del usuario)

Cuándo se Ejecutan los Trabajos ​

Automáticamente en cada página:

  • Cada vez que carga una página de HolaGest
  • Se ejecutan 1-2 trabajos pendientes
  • Proceso transparente para el usuario

Mediante CRON (recomendado):

  • Tarea programada del servidor
  • Ejecuta trabajos cada X minutos
  • Más eficiente para alto volumen

Manualmente:

  • Puede forzar la ejecución
  • Útil para verificar actualizaciones
  • Ver sección "Soluciones"

Prioridad de Trabajos ​

Alta prioridad:

  • Actualización de saldos de cuentas
  • Actualización de contadores críticos
  • Se ejecutan primero

Media prioridad:

  • Recálculo de totales
  • Actualización de estadísticas
  • Se ejecutan después

Baja prioridad:

  • Limpieza de datos
  • Optimizaciones
  • Se ejecutan al final

Verificar Trabajos Pendientes ​

Puede consultar el estado de los trabajos en segundo plano para saber si hay tareas pendientes.

Acceder a Logs de Trabajos ​

Paso 1: Ir a Logs

  1. Vaya a Menú Administrador > Logs
  2. Se abrirá la pantalla de registros del sistema

Paso 2: Ver Eventos de Trabajo

  1. Haga clic en la pestaña "Eventos de Trabajo" o "Job Queue"
  2. Verá el listado de todos los trabajos

Paso 3: Filtrar Trabajos Pendientes

  1. Use el filtro "Estado"
  2. Seleccione "Pendiente" o "En espera"
  3. Verá solo los trabajos que aún no se han completado

Interpretar el Listado ​

Columnas importantes:

Nombre del trabajo:

  • Descripción de la tarea
  • Ejemplo: "Actualizar saldos de cuenta 5720000000"
  • Ejemplo: "Recalcular totales de factura FV2024/001"

Estado:

  • Pendiente: Aún no se ha ejecutado
  • En proceso: Se está ejecutando ahora
  • Completado: Ya se ejecutó correctamente
  • Error: Falló la ejecución

Fecha de creación:

  • Cuándo se añadió a la cola
  • Útil para saber cuánto tiempo lleva pendiente

Fecha de ejecución:

  • Cuándo se ejecutó (si ya se completó)
  • Vacío si aún está pendiente

Ejemplo de Listado ​

Trabajo 1:
  Nombre: Actualizar saldos cuenta 4300000000
  Estado: Completado
  Creado: 15/03/2024 10:30
  Ejecutado: 15/03/2024 10:31

Trabajo 2:
  Nombre: Actualizar saldos cuenta 5720000000
  Estado: Pendiente
  Creado: 15/03/2024 10:35
  Ejecutado: -

Trabajo 3:
  Nombre: Recalcular totales factura FV2024/001
  Estado: Pendiente
  Creado: 15/03/2024 10:36
  Ejecutado: -

Interpretación: Hay 2 trabajos pendientes que se ejecutarán próximamente.

Soluciones para Actualizar Saldos ​

Si necesita que los saldos se actualicen inmediatamente, puede forzar la ejecución de trabajos pendientes.

Solución 1: Navegar por HolaGest ​

Método más simple:

  1. Abra varias páginas de HolaGest
  2. Ejemplo: Vaya a Contabilidad > Cuentas Contables
  3. Luego a Informes > Balances
  4. Luego a Ventas > Facturas
  5. Cada página ejecuta 1-2 trabajos pendientes

Ventaja: No requiere configuración Desventaja: Puede tardar si hay muchos trabajos

Solución 2: Ejecutar CRON ​

Método recomendado para producción:

¿Qué es CRON?

  • Tarea programada del servidor
  • Ejecuta trabajos automáticamente cada X minutos
  • Más eficiente que la ejecución por página

Configurar CRON:

  1. Acceda al panel de control de su servidor (cPanel, Plesk, etc.)
  2. Busque la sección "Tareas CRON" o "Cron Jobs"
  3. Añada una nueva tarea:
bash
*/5 * * * * php /ruta/a/holagest/cron.php

Explicación:

  • */5: Cada 5 minutos
  • php: Ejecutar PHP
  • /ruta/a/holagest/cron.php: Archivo CRON de HolaGest

Resultado: Los trabajos se ejecutan automáticamente cada 5 minutos.

Solución 3: Ejecutar CRON Manualmente ​

Método para pruebas o urgencias:

Desde navegador:

  1. Abra su navegador
  2. Vaya a: https://su-dominio.com/cron.php
  3. Espere a que cargue la página
  4. Los trabajos pendientes se ejecutarán

Desde línea de comandos (si tiene acceso SSH):

bash
php /ruta/a/holagest/cron.php

Ventaja: Ejecución inmediata Desventaja: Debe hacerlo manualmente cada vez

Solución 4: Esperar ​

Método pasivo:

  • Simplemente espere unos minutos
  • Los trabajos se ejecutarán automáticamente
  • Al navegar por HolaGest o mediante CRON

Ventaja: No requiere acción Desventaja: Puede tardar

Mantener HolaGest Actualizado ​

La cola de trabajos es una funcionalidad introducida en la versión 2024, y se ha optimizado en actualizaciones posteriores.

Importancia de las Actualizaciones ​

Mejoras en cada versión:

  • Optimización de la cola de trabajos
  • Corrección de errores
  • Mejor rendimiento
  • Nuevas funcionalidades

Problemas solucionados:

  • Trabajos que no se ejecutaban
  • Trabajos duplicados
  • Trabajos que fallaban
  • Lentitud en la ejecución

Cómo Actualizar HolaGest ​

Paso 1: Verificar Versión Actual

  1. Vaya a Menú Administrador > Panel de Control
  2. En la parte superior, verá la versión actual
  3. Ejemplo: "HolaGest Core 2025.1"

Paso 2: Comprobar Actualizaciones

  1. Vaya a Menú Administrador > Actualizaciones
  2. El sistema comprobará si hay actualizaciones disponibles
  3. Si hay, verá un botón "Actualizar"

Paso 3: Realizar Actualización

  1. Importante: Haga una copia de seguridad antes
  2. Haga clic en "Actualizar"
  3. Espere a que el proceso termine
  4. No cierre la ventana durante la actualización

Paso 4: Verificar

  1. Compruebe que la versión se ha actualizado
  2. Verifique que todo funciona correctamente
  3. Revise los logs por si hay errores

Frecuencia Recomendada ​

Actualizaciones de seguridad: Inmediatamente Actualizaciones menores: Cada 1-2 meses Actualizaciones mayores: Cuando sea necesario (con planificación)

Prevención de Problemas ​

Buenas prácticas para evitar problemas con la actualización de saldos.

Configurar CRON ​

Recomendación principal: Configure CRON para ejecución automática

Beneficios:

  • Trabajos se ejecutan regularmente
  • No depende de la navegación de usuarios
  • Mejor rendimiento general
  • Menos problemas de saldos desactualizados

Configuración recomendada:

bash
*/5 * * * * php /ruta/a/holagest/cron.php

Monitorizar Logs ​

Revisión periódica:

  • Revise los logs de trabajos semanalmente
  • Verifique que no hay trabajos con errores
  • Compruebe que los trabajos se completan en tiempo razonable

Señales de alerta:

  • Muchos trabajos pendientes (> 100)
  • Trabajos con errores recurrentes
  • Trabajos que tardan mucho en ejecutarse

Mantener Sistema Actualizado ​

Actualizaciones regulares:

  • Actualice HolaGest regularmente
  • Actualice PHP a versiones soportadas
  • Actualice el servidor web (Apache, Nginx)
  • Actualice la base de datos (MySQL, MariaDB)

Optimizar Base de Datos ​

Mantenimiento periódico:

  • Optimice las tablas de la base de datos
  • Limpie registros antiguos innecesarios
  • Haga copias de seguridad regulares

Preguntas Frecuentes ​

❔ ¿Es normal que los saldos no se actualicen inmediatamente? ​

Sí, es completamente normal desde la versión 2024. Los saldos se actualizan en segundo plano para mejorar el rendimiento.

Tiempo típico de actualización:

  • Con CRON configurado: 1-5 minutos
  • Sin CRON: Al navegar por HolaGest (variable)

❔ ¿Cómo sé si los saldos están actualizados? ​

Método 1: Verificar fecha de actualización

  • En la ficha de la cuenta, verá la fecha de última actualización
  • Si es reciente, los saldos están actualizados

Método 2: Comprobar trabajos pendientes

  • Vaya a Logs > Eventos de Trabajo
  • Si no hay trabajos pendientes de actualización de saldos, están actualizados

Método 3: Generar balance

  • Genere un balance de sumas y saldos
  • Si los saldos coinciden con lo esperado, están actualizados

❔ ¿Puedo desactivar la cola de trabajos? ​

No directamente, es parte del núcleo del sistema desde la versión 2024.

Alternativa: Configure CRON para ejecución muy frecuente (cada 1 minuto) para que los trabajos se ejecuten casi inmediatamente.

❔ ¿Qué pasa si hay un error en un trabajo? ​

El sistema lo registra:

  • El trabajo queda marcado como "Error"
  • Se registra el mensaje de error en los logs
  • Puede ver el detalle del error en Logs > Eventos de Trabajo

Soluciones:

  • Revise el mensaje de error
  • Corrija el problema (ej: cuenta inexistente)
  • El sistema reintentará automáticamente en algunos casos

❔ ¿Los trabajos pendientes afectan al rendimiento? ​

No significativamente, siempre que:

  • No haya miles de trabajos pendientes
  • El CRON esté configurado correctamente
  • El sistema esté actualizado

Si hay muchos trabajos pendientes:

  • Puede ralentizar ligeramente el sistema
  • Configure CRON para ejecutar más frecuentemente
  • Considere optimizar la base de datos

❔ ¿Puedo ver qué trabajos se han ejecutado? ​

Sí, en los logs:

  1. Menú Administrador > Logs
  2. Pestaña "Eventos de Trabajo"
  3. Filtre por estado "Completado"
  4. Verá todos los trabajos ejecutados con su fecha

❔ ¿Qué hago si los saldos siguen sin actualizarse después de horas? ​

Pasos a seguir:

  1. Verificar trabajos pendientes: ¿Hay trabajos en cola?
  2. Ejecutar CRON manualmente: Fuerce la ejecución
  3. Revisar errores: ¿Hay trabajos con error?
  4. Actualizar HolaGest: Asegúrese de tener la última versión
  5. Contactar soporte: Si el problema persiste

❔ ¿El CRON debe ejecutarse como usuario específico? ​

Depende del servidor:

Hosting compartido: Normalmente se ejecuta con su usuario VPS/Servidor dedicado: Puede ejecutarse como www-data o usuario de Apache Docker: Depende de la configuración del contenedor

Recomendación: Consulte con su proveedor de hosting o administrador de sistemas.

❔ ¿Puedo priorizar ciertos trabajos? ​

No directamente desde la interfaz, pero el sistema ya tiene prioridades predefinidas:

  • Actualización de saldos: Alta prioridad
  • Recálculo de totales: Media prioridad
  • Limpieza de datos: Baja prioridad

Los trabajos se ejecutan en orden de prioridad y fecha de creación.

❔ ¿Los trabajos se pierden si reinicio el servidor? ​

No, los trabajos están almacenados en la base de datos:

  • Sobreviven a reinicios del servidor
  • Sobreviven a reinicios de Apache/Nginx
  • Se ejecutarán cuando el sistema vuelva a estar disponible

Excepción: Si la base de datos se corrompe o se pierde.

Última actualización: Marzo 2024 Versión: HolaGest Core 2025

Documentación relacionada:

Soporte técnico:

  • Si el problema persiste, contacte con el soporte técnico de HolaGest
  • Proporcione los logs de trabajos para un diagnóstico más rápido
  • Indique la versión de HolaGest que está utilizando

Documentación liberada bajo Licencia MIT

Copyright © 2025 HolaGest