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):

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

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:

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):

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:

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

AnteriorConfiguración de impuestos y retencionesSiguiente📑Menú Informes

Última actualización