Ayuda/Solución de Problemas/Problemas de conexión

Problemas de conexión

3 min

Conexiones en tiempo real

SGG utiliza WebSocket para actualizaciones en tiempo real. Esto permite que los pedidos, cambios de estado y notificaciones se reflejen instantáneamente sin necesidad de recargar la página. Si experimentas problemas de conexión, esta guía te ayudará a resolverlos.

¿Cómo funciona la conexión en tiempo real?

WebSocket (Preferido)

• Conexión persistente bidireccional
• Actualizaciones instantáneas
• Menor uso de recursos
• Notificaciones push

Polling (Fallback)

• Se activa si WebSocket falla
• Consulta al servidor cada 30 segundos
• Funciona en redes restrictivas
• Menor uso de batería en móviles

Indicadores de estado de conexión:

Conectado

Reconectando

Desconectado

Problemas comunes y soluciones

Indicador rojo de conexión

El indicador en la barra superior muestra desconexión

Causa: La conexión WebSocket se perdió

Solución: El sistema cambiará automáticamente a polling (actualización cada 30 segundos). Verifica tu conexión a Internet.

Pedidos no se actualizan en tiempo real

Los cambios de estado no aparecen hasta recargar la página

Causa: WebSocket no está conectado o hay problemas de red

Solución: Recarga la página. Si persiste, verifica que no haya firewall bloqueando WebSocket.

Desconexiones frecuentes

La conexión se pierde y reconecta constantemente

Causa: Conexión a Internet inestable o timeout de inactividad

Solución: Usa una conexión más estable. El sistema implementa reconexión automática.

No se reciben notificaciones

Las alertas de nuevos pedidos no llegan

Causa: WebSocket desconectado o problemas de suscripción a eventos

Solución: Recarga la página para re-suscribirse a los eventos de la tienda.

Pasos de diagnóstico

Verificar conexión a Internet

Asegúrate de tener una conexión activa

Abre otra página web para verificar conectividad
Prueba con speedtest.net para verificar velocidad
Si usas WiFi, acércate al router o usa cable Ethernet

Revisar el indicador de conexión

El POS muestra el estado de conexión en tiempo real

Verde = Conectado (actualizaciones en tiempo real)
Amarillo = Reconectando (intentando restablecer)
Rojo = Desconectado (modo polling activado)

Recargar la página

Fuerza una nueva conexión WebSocket

Presiona F5 o el botón de recargar
Para forzar recarga completa: Ctrl+Shift+R
Esto reinicia la conexión con el servidor

Verificar firewall y proxy

Algunos entornos bloquean WebSocket

WebSocket usa el puerto 443 (HTTPS) o 80 (HTTP)
Verifica que tu red no bloquee conexiones persistentes
En redes corporativas, consulta con el administrador de red

Reconexión automática

SGG implementa reconexión automática inteligente:

• Si la conexión se pierde, intenta reconectar automáticamente
• Los intentos de reconexión tienen backoff exponencial (espera más entre intentos)
• Si WebSocket falla repetidamente, cambia a modo polling
• Al restaurar Internet, la conexión se reestablece automáticamente

Redes corporativas y firewalls

Algunas redes empresariales pueden bloquear WebSocket. Si estás en una red corporativa:

• Consulta con tu administrador de red
• WebSocket usa los mismos puertos que HTTPS (443)
• El sistema funciona en modo polling como alternativa
• Considera usar una red móvil como alternativa temporal