Panel de Sincronización

El Panel de Sincronización en el Gerente HQ proporciona una vista en tiempo real de todas las conexiones de tiendas, el estado de sincronización y cualquier error que requiera atención. Esta es la herramienta principal para monitorear la salud de su red multi-tienda.

Acceder al Panel

Navegue a Gerente HQ > Tiendas. La lista de tiendas funciona también como panel de sincronización, mostrando el estado de conexión y métricas de sincronización para cada tienda.

Estado de Conexión de la Tienda

Cada tienda muestra un indicador de conexión:

• Verde (Conectada): El servidor de la tienda tiene una conexión WebSocket activa con HQ. Los datos se sincronizan en tiempo real.
• Rojo (Desconectada): La tienda no está conectada. Esto podría significar que el servidor de la tienda está fuera de línea, hay un problema de red o el token de sincronización ha sido revocado.

El estado de conexión se basa en un latido WebSocket en vivo. Si la conexión se cae, el indicador se vuelve rojo en segundos. El estado de conexión solo está disponible para tiendas que tienen un servidor de tienda activo -- no refleja si los Terminales POS individuales de la tienda están encendidos.

Métricas de Sincronización por Tienda

Para cada tienda conectada, el panel muestra:

• Última Sincronización: La marca de tiempo de la operación de sincronización exitosa más reciente en cualquier dirección. Si esta marca de tiempo es antigua a pesar de que la tienda está conectada, puede haber un problema con la cola de sincronización.
• Estado de Sincronización por Entidad: Un desglose del estado de sincronización por tipo de entidad (productos, ventas, ajustes de inventario, etc.). Para cada tipo de entidad, puede ver:
  • La dirección (envío de la tienda a HQ, o descarga de HQ a la tienda)
  • La última marca de tiempo de sincronización exitosa
  • Total de registros enviados y recibidos
• Conteo de Errores de Sincronización: El número de operaciones de sincronización que han fallado. Un conteo de errores diferente de cero requiere investigación.

Actividad del Día

El panel también muestra la actividad de cada tienda para el día actual:

• Conteo de Ventas: Número de transacciones de venta completadas hoy.
• Ingresos Totales: Ingresos brutos del día.
• Impuestos Totales: Impuestos recaudados hoy.
• Descuentos Totales: Descuentos aplicados hoy.
• Anulaciones: Número y valor total de transacciones anuladas.
• Cajas Abiertas: Sesiones de caja actualmente abiertas con sus IDs de terminal y horarios de apertura.

Investigar Errores de Sincronización

Cuando una tienda muestra errores de sincronización, haga clic en la tienda para ver los detalles del error. Los errores comunes de sincronización incluyen:

1. Tiempo de espera de red: La transferencia de datos HTTP falló debido a una conexión lenta o inestable. Estos típicamente se resuelven en el reintento automático.
2. Carga muy grande: Un lote de sincronización contenía demasiados datos. Esto puede ocurrir después de períodos prolongados sin conexión. El motor de sincronización automáticamente divide los lotes grandes en partes más pequeñas al reintentar.
3. Incompatibilidad de esquema: El esquema de la base de datos de la tienda no coincide con la versión esperada. Esto generalmente significa que el servidor de la tienda necesita actualizarse.
4. Token rechazado: El token de sincronización de la tienda es inválido o ha expirado. Genere un nuevo token en la configuración de la tienda.

Latido (Heartbeat)

Cada tienda conectada envía un latido periódico a HQ (intervalo predeterminado: 30 segundos). El latido confirma que la tienda está activa y respondiendo. Si HQ no recibe un latido dentro de la ventana esperada, la tienda se marca como desconectada. El latido también lleva datos de estado ligeros (sesiones de caja actuales, marca de tiempo de la última venta) que actualizan el panel en tiempo real.

Forzar una Resincronización

En casos raros, puede necesitar forzar una resincronización completa para una tienda. Esto reenvía todos los datos de HQ (productos, departamentos, tasas de impuesto, usuarios, etc.) a la tienda, independientemente de si la tienda ya tiene la versión más reciente. Use esto solo cuando esté solucionando inconsistencias de datos, ya que genera tráfico de red significativo. La opción de forzar resincronización está disponible en la página de detalle de la tienda bajo configuración avanzada.

Mejores Prácticas

• Revise el panel diariamente. Un vistazo rápido a los estados de conexión y conteos de errores puede detectar problemas antes de que afecten las operaciones.
• Investigue los errores con prontitud. Los errores de sincronización significan que los datos no fluyen correctamente. Las ventas de una tienda desconectada no se pierden (se encolan localmente), pero los datos retrasados afectan los reportes de HQ.
• Monitoree las tiendas después de actualizaciones. Después de implementar una actualización del sistema, observe el panel para confirmar que todas las tiendas se reconectan y sincronizan exitosamente.