Problemas Comunes

Esta guía te ayudará a resolver los problemas más comunes que puedes encontrar al gestionar usuarios, roles, permisos e invitaciones en el sistema.

Si no encuentras la solución a tu problema aquí, contacta a tu supervisor o al equipo de soporte.

Problemas frecuentes

No puedo crear nuevos usuarios

Síntomas:

El botón "Nuevo Usuario" no aparece
Error al intentar guardar el usuario
Formulario bloqueado o inaccesible

Soluciones:

Verificar permisos

Confirma que tienes el permiso "Crear usuarios"
Verifica acceso a la sección de gestión de usuarios

Revisar límites del plan

Verifica si has alcanzado el límite de usuarios de tu suscripción
Contacta al administrador para revisar el plan actual

Confirmar datos requeridos

Asegúrate de completar todos los campos obligatorios
Verifica que el email sea válido y único

Error: "Email ya existe"

Causa: Ya hay un usuario con ese correo en tu organización

Soluciones:

Busca el usuario existente en la lista
Verifica si hay una invitación pendiente
Confirma que no hay duplicados con emails similares
Edita el usuario existente en lugar de crear uno nuevo

Error: "Dominio no válido"

El sistema no puede verificar que el email pueda recibir correos.

Soluciones:

Verifica que el email esté escrito correctamente
Confirma que el dominio del email existe
Prueba con un email alternativo si es posible
Contacta al usuario para confirmar su dirección

Los permisos no funcionan correctamente

Síntomas:

Usuario no puede acceder a funciones que debería tener
Permisos parecen no aplicarse
Cambios no se reflejan en el sistema

Verificaciones:

Revisar dependencias

Confirma que el usuario tenga todos los permisos base necesarios
Verifica las dependencias de permisos en la documentación

Verificar sucursales

Confirma que el usuario tenga acceso a las sucursales relevantes
Asegúrate de que la sucursal esté activa

Forzar actualización

Cierra todas las sesiones del usuario
Pide al usuario que cierre sesión y vuelva a entrar
Espera unos minutos para que se propaguen los cambios

No puedo asignar ciertos permisos

Posibles causas:

Solo puedes otorgar permisos que tú tienes
Algunos permisos están restringidos por rol
Faltan permisos de dependencia

Soluciones:

Contacta a un administrador con más permisos
Revisa las dependencias de permisos faltantes
Asigna permisos base antes que permisos avanzados

Usuario sigue sin acceso después de cambios

Pasos a seguir:

Verificar permisos: Confirma que los permisos están asignados
Cerrar sesiones: Fuerza el cierre de sesión del usuario
Cache del navegador: Usuario debe limpiar cache/cookies
Esperar propagación: Los cambios pueden tardar unos minutos
Verificar sucursales: Confirma acceso a sucursales necesarias

Usuario no recibe la invitación

Diagnóstico paso a paso:

Verificar email

¿El email está escrito correctamente?
¿Es una dirección válida y activa?
¿El usuario confirma que puede recibir correos?

Revisar filtros de spam

Pide al usuario que revise su carpeta de spam
Verifica si hay filtros automáticos bloqueando emails
Comprueba si el dominio está en lista negra

Confirmar estado de invitación

Verifica que la invitación se envió correctamente
Revisa el estado en la lista de usuarios
Confirma que no está expirada

Reenviar si es necesario

Usa la función "Reenviar invitación"
Espera unas horas antes de intentar nuevamente
Considera contacto directo para verificar recepción

El enlace de invitación no funciona

Posibles causas y soluciones:

Si la invitación venció:

Reenvía una nueva invitación desde el sistema
Verifica la fecha de expiración en la configuración
Explica al usuario que debe usar el enlace más reciente
Considera ajustar el tiempo de expiración si es muy corto

Si el enlace se cortó o modificó:

Reenvía la invitación completa
Instruye al usuario a copiar la URL completa
Sugiere abrir desde el cliente de email web
Evita reenviar enlaces via mensajes de texto

Si el usuario tiene dificultades:

Verifica que esté usando el navegador correcto
Pide que desactive extensiones del navegador
Sugiere probar desde un dispositivo diferente
Ofrece asistencia paso a paso por teléfono

Invitación aceptada pero sin acceso

Verificaciones necesarias:

Estado de cuenta: Confirma que la aceptación se procesó
Permisos básicos: Verifica permisos mínimos de acceso
Sucursales: Confirma asignación de al menos una sucursal
Sesión del usuario: Puede necesitar cerrar y volver a entrar
Tiempo de propagación: Esperar unos minutos para cambios

Usuario no puede iniciar sesión

Diagnóstico completo:

Verificar estado del usuario

¿Está activo en el sistema?
¿Hay una invitación pendiente sin aceptar?
¿El email está confirmado?
¿El usuario no está eliminado?

Revisar credenciales

¿Está usando el email correcto?
¿La contraseña es la correcta?
¿Necesita restablecer contraseña?
¿Está intentando acceder al dominio correcto?

Verificar permisos de acceso

¿Tiene permisos básicos para acceder al sistema?
¿Tiene al menos una sucursal asignada?
¿Los permisos están activos?

Probar soluciones

Restablecer contraseña del usuario
Reenviar confirmación de email si es necesario
Cerrar todas las sesiones y intentar nuevamente
Verificar desde un navegador diferente

Usuario perdió acceso de repente

Posibles causas:

Cambios recientes en permisos
Modificación de sucursales asignadas
Expiración de sesión
Cambios en el rol del usuario

Soluciones:

Revisar cambios recientes en el perfil del usuario
Verificar que no haya sido desactivado
Confirmar que las sucursales siguen asignadas
Cerrar sesiones y pedir nuevo inicio de sesión

Error: "Sin permisos para acceder"

Verificaciones:

¿El usuario tiene permisos básicos de acceso?
¿Está intentando acceder a la función correcta?
¿Tiene acceso a la sucursal necesaria?
¿Los permisos están actualizados?

Soluciones:

Asignar permisos básicos de acceso al sistema
Verificar que tenga sucursales asignadas
Confirmar que no hay restricciones por rol
Contactar al administrador si persiste el problema

Roles no reflejan permisos

Recuerda que los roles son solo etiquetas organizacionales. Los permisos se asignan independientemente.

Problema común:

Usuario tiene rol "Administración" pero no puede administrar
Esperaba permisos automáticos basados en el rol
Confusión entre rol y permisos reales

Solución:

Explicar el sistema: Los roles no otorgan permisos automáticamente
Revisar permisos específicos: Verificar permisos individuales asignados
Asignar permisos necesarios: Configurar permisos según las necesidades reales
Documentar configuración: Anotar permisos especiales para referencia futura

Problemas de gestión

No puedo editar ciertos usuarios

Restricciones del sistema:

No puedes editar tu propio usuario
No puedes editar al propietario (a menos que seas el propietario)
Solo puedes asignar permisos que tú tienes
Algunos usuarios pueden tener protecciones especiales

Soluciones:

Para editar tu perfil: Contacta a otro administrador
Para editar al propietario: Solo el propietario puede hacer esto
Para permisos especiales: Contacta a alguien con más permisos
Para usuarios protegidos: Verifica restricciones especiales

Error al eliminar usuarios

Posibles causas:

Intento de eliminar al propietario del negocio
Usuario tiene datos importantes asociados
Falta de permisos para eliminar usuarios
Usuario está en uso activo en el sistema

Verificaciones:

Confirmar permisos: ¿Tienes permiso para eliminar usuarios?
Verificar rol: ¿No es el propietario del negocio?
Revisar dependencias: ¿Hay órdenes u otros datos asociados?
Considerar alternativas: ¿Es mejor desactivar temporalmente?

Transferencia no funciona

Requisitos para transferencia:

Solo el propietario actual puede iniciar el proceso
El nuevo propietario debe ser usuario activo de la organización
No debe haber transferencias pendientes
Ambos usuarios deben confirmar la transferencia

Soluciones:

Verificar propietario actual: Solo él puede iniciar transferencia
Confirmar usuario destino: Debe estar activo en la organización
Revisar transferencias pendientes: Solo una a la vez
Confirmar por email: Ambos deben confirmar vía email

Errores técnicos

Error 403: "Sin permisos"

Causas comunes:

Permisos insuficientes para la acción
Sesión expirada o inválida
Restricciones por sucursal
Cambios de permisos no aplicados

Soluciones:

Verificar permisos específicos: ¿Tienes el permiso exacto necesario?
Renovar sesión: Cierra sesión y vuelve a entrar
Confirmar sucursales: ¿Tienes acceso a la sucursal relevante?
Esperar propagación: Los cambios pueden tardar unos minutos

Error 404: "Usuario no encontrado"

Posibles causas:

El usuario fue eliminado
No tienes acceso a ese usuario específico
Error en el ID o enlace del usuario
Restricciones por sucursal

Verificaciones:

Buscar en la lista: ¿Aparece el usuario en la lista general?
Verificar filtros: ¿Hay filtros que oculten al usuario?
Confirmar acceso: ¿Tienes permisos para ver ese usuario?
Revisar URL: ¿El enlace o ID son correctos?

Error 500: "Error interno del servidor"

Pasos a seguir:

Recargar página: Intenta nuevamente la acción
Verificar conexión: Confirma tu conexión a internet
Probar más tarde: Puede ser un problema temporal del servidor
Reportar a soporte: Si persiste, contacta soporte técnico con:
- Hora exacta del error
- Acción que intentabas realizar
- Usuario específico involucrado
- Captura de pantalla si es posible

Problemas de datos

Información inconsistente entre pantallas

Soluciones:

Recargar páginas: Actualiza las páginas afectadas
Verificar múltiples sesiones: Cierra sesiones duplicadas
Limpiar cache: Borra cache y cookies del navegador
Verificar sincronización: Espera unos minutos para sincronización

Información duplicada o incorrecta

Prevención:

Verifica emails antes de crear usuarios
Confirma información con el usuario antes de registrar
Usa funciones de búsqueda antes de crear nuevos usuarios
Mantén información de contacto actualizada

Si ya ocurrió:

Edita la información incorrecta
Elimina usuarios duplicados innecesarios
Consolida información en el usuario correcto
Documenta cambios para referencia futura

Contacto con soporte

Cuándo contactar soporte

Errores técnicos que no puedes resolver
Problemas de permisos que el administrador no puede solucionar
Inconsistencias de datos que afectan operaciones
Solicitudes de funcionalidades adicionales
Problemas de rendimiento del sistema

Información que debes proporcionar

Describe el problema:

Descripción exacta del error o problema
Mensaje de error completo (si aparece)
Pasos exactos para reproducir el problema
Resultado esperado vs resultado obtenido
Frecuencia del problema (siempre, a veces, primera vez)

Información del usuario:

Nombre y email del usuario afectado
Rol asignado en el sistema
Sucursales a las que tiene acceso
Permisos específicos relevantes
Cuándo se creó o modificó por última vez

Información técnica:

Navegador y versión utilizada
Sistema operativo del dispositivo
Hora exacta del problema
Capturas de pantalla si es posible
Pasos realizados antes del error

Situación específica:

Qué intentabas hacer cuando ocurrió el problema
Si es un problema nuevo o recurrente
Cambios recientes en permisos o configuración
Otros usuarios afectados por el mismo problema
Impacto en las operaciones diarias

Canales de soporte

Email de soporte

Para problemas complejos que requieren documentación

Esta documentación

Consulta primero para soluciones rápidas

Administrador interno

Contacta a tu administrador para problemas de permisos

Prevención de problemas

Al crear usuarios

Verifica datos cuidadosamente
- Email correcto y funcional
- Nombre completo y preciso
- Rol apropiado para su función
- Sucursales necesarias asignadas
Asigna permisos gradualmente
- Empieza con permisos mínimos necesarios
- Agrega permisos según demanda real
- Documenta permisos especiales

Al gestionar permisos

Entiende las dependencias
- Revisa qué permisos requieren otros permisos
- Asigna permisos base antes que avanzados
- Verifica dependencias antes de quitar permisos
Mantén organización clara
- Usa roles para categorizar usuarios
- Documenta configuraciones especiales
- Revisa permisos periódicamente

Seguridad y mantenimiento

Revisa accesos regularmente
- Elimina usuarios que ya no trabajan en la organización
- Actualiza permisos cuando cambien responsabilidades
- Verifica que la información de contacto esté actualizada
Mantén comunicación clara
- Avisa a usuarios sobre cambios en sus permisos
- Proporciona instrucciones claras para nuevos usuarios
- Documenta procesos para referencia futura