Ayuda/Solución de Problemas/El POS no carga

El POS no carga

3 min

¿El Punto de Venta no carga o muestra errores?

Esta guía te ayudará a diagnosticar y resolver los problemas más comunes cuando el POS no carga correctamente, muestra una pantalla en blanco, o presenta errores de conexión.

Pasos de diagnóstico

1. Verificar conexión a Internet

Asegúrate de que tu dispositivo esté conectado a Internet.

Abre otra página web para verificar que tienes conexión
Si usas WiFi, verifica que estés conectado a la red correcta
Prueba reiniciar el router si la conexión es lenta
Considera usar una conexión por cable para mayor estabilidad

2. Limpiar caché del navegador

Datos antiguos almacenados pueden causar problemas de carga.

Presiona Ctrl+Shift+Delete (Windows) o Cmd+Shift+Delete (Mac)
Selecciona 'Imágenes y archivos en caché'
Selecciona 'Cookies y datos del sitio'
Haz clic en 'Borrar datos'
Recarga la página del POS

3. Verificar el token de sesión

El token de autenticación puede haber expirado.

Cierra completamente el POS
Vuelve a la página de login del POS
Ingresa tu PIN de 4 dígitos nuevamente
Esto generará un nuevo token de sesión

4. Probar en modo incógnito

Descarta problemas de extensiones o caché.

Abre una ventana de incógnito (Ctrl+Shift+N)
Navega a la URL del POS
Si funciona en incógnito, el problema son las extensiones o caché

Errores comunes y soluciones

Pantalla en blanco

Causa: El JavaScript no se cargó correctamente

Solución: Recarga la página con Ctrl+F5. Si persiste, limpia el caché del navegador.

"Tu cuenta no tiene un negocio asignado"

Causa: El usuario no tiene un tenant configurado

Solución: Contacta al administrador para que te asigne a un negocio.

Spinner de carga infinito

Causa: El backend no responde o hay problemas de red

Solución: Verifica tu conexión a Internet. Si el problema persiste, el servidor puede estar en mantenimiento.

Error de CORS o red

Causa: La URL del backend está mal configurada

Solución: Verifica que estés accediendo desde la URL correcta del sistema.

"Error al cargar productos"

Causa: No hay productos creados o hubo error en la consulta

Solución: Verifica que existan productos activos en el sistema. Ve a Productos desde el panel admin.

¿El servidor está funcionando?

Si todos los pasos anteriores no funcionan, el problema puede estar en el servidor:

• El servidor puede estar en mantenimiento programado
• Puede haber un problema temporal de infraestructura
• Consulta el estado del servicio o contacta a soporte

Tips para evitar problemas de carga

Usa navegadores actualizados (Chrome, Firefox, Edge, Safari)
Mantén una conexión a Internet estable, preferiblemente por cable
Evita tener demasiadas pestañas abiertas que consuman memoria
Limpia el caché del navegador periódicamente