FAQ y soporte

Respuestas a las incidencias más frecuentes del funcionamiento del sistema.

1. Acceso y cuenta

El vendedor no puede iniciar sesión

• Verificar que el usuario está activo (Vendedores en el administrador).
• Si aparece “cuenta bloqueada”, esperar 30 minutos o que el administrador lo habilite.
• Contraseña olvidada → el administrador la restablece.

¿Por qué me bloqueo?

El sistema bloquea tras 5 intentos fallidos seguidos por 30 minutos. Es una medida de seguridad contra accesos no autorizados.

2. Ventas y tickets

No aparece el botón “Vender” en el dashboard

• El botón Vender está disponible solo para los roles Vendedor y Supervisor.
• Si la cuenta es Administrador, no vende; administra. Inicie sesión con la cuenta del vendedor para operar.

“Existencias insuficientes para el número {X}. Ya fueron vendidas {V} de {M} unidades (…).”

• La cantidad pedida supera lo disponible en ese código en la jornada (existencias globales).
• El mensaje indica cuántas unidades se vendieron y cuántas quedan (“quedan 0 disponibles” significa que el código está agotado).
• Reduzca la cantidad o elija otro código; al agotarse el sistema lo marca como agotado.

¿Cómo compruebo si un ticket ganó?

• El premio no aparece impreso en el comprobante.
• Usar Consultar con el código de verificación (6 caracteres) del ticket. Después del sorteo mostrará la ganancia.

Un ticket quedó como “no pagado” (reserva) y sí se pagó

• En la lista Ventas, cambiar el estado de pago a Pagada (con los permisos). Un administrador o supervisor puede confirmar.
• Las ventas anuladas no pueden cambiar de estado.

Duplico un ticket por error

• Una venta no puede duplicarse: cada comprobante tiene un código único. Si se registró dos veces por error, el administrador o el supervisor del equipo anula el duplicado (restaura existencias) con la acción Anular. Solo se anulan ventas de jornadas abiertas.

3. Impresión

La impresora no imprime

1. Verificar que la impresora está conectada y es la impresora por defecto del dispositivo.
2. En Conf. Impresión, ver el ancho correcto (58 mm/80 mm) y pulsar Probar impresión.
3. Probar imprimir directamente desde una web (por ejemplo una nota) para descartar el equipo.
4. Si el ticket sale cortado o con márgenes raros, ajustar el ancho y volver a probar.

4. Consulta y validación

Código inválido / no encontrado

• Revisar que se escribieron todos los caracteres (el sistema usa mayúsculas y dígitos, 6 en total).
• Si el ticket es de otra jornada, cambiar el período/filtro.
• Si sigue sin aparecer, el ticket puede pertenecer a otra jornada no visible; comunicar al administrador.

5. Sesión y seguridad

Me cierra la sesión al rato

• La sesión vence (JWT expira) y se renueva con el refresh token en cookies. Es normal tras largo tiempo inactivo; vuelva a iniciar sesión.
• ¿Al estar en un dispositivo compartido? Cierre la sesión al terminar (el sistema no lo deja “abierto” indefinidamente por seguridad).

6. Errores del servidor (para TI/soporte)

• PM2: pm2 status y pm2 logs.
• ErrorLog: consulta la tabla ErrorLog para ver los mensajes grabados por la aplicación.
• Si el dashboard deja de responder: verificar PM2, BD (systemd/PostgreSQL) y red.
• Si tras una migración da error de arranque: confirmar que se ejecutó prisma migrate deploy.

7. Datos y respaldo

• La copia de seguridad y restauración está en 06-backup-restauracion.md.
• Nunca eliminar datos directamente de la BD; usar las funciones propias del sistema (Anulaciones, Borrar especiales solo sin ventas).

8. Canal de soporte

• Registro de incidentes por pantalla (mensajes) o por el administrador.
• Contacto interno para diagnóstico según el acuerdo de servicio con quien opera la plataforma.