> ## Documentation Index
> Fetch the complete documentation index at: https://ayuda.daia.cl/llms.txt
> Use this file to discover all available pages before exploring further.

# Solución de Problemas

> Guía para resolver problemas comunes del módulo de usuarios

Guía para diagnosticar y resolver los problemas más comunes del módulo de usuarios.

## Problemas al Crear Usuarios

### Error: "El usuario ya existe"

**Causa:** El username ya está en uso por otro usuario.

**Solución:**

1. Verifica si el usuario realmente existe:
   * Busca en la tabla de usuarios
   * Usa Ctrl+F para buscar el nombre
2. Si existe y es duplicado, usa otro username
3. Si es el usuario correcto, no necesitas crearlo de nuevo

**Prevención:** Usa convención de nombres consistente para evitar duplicados.

***

### Error: "El correo ya está registrado"

**Causa:** El email ya está asignado a otro usuario.

**Solución:**

1. Verifica si es el mismo usuario con otro username
2. Si es otra persona, usa email diferente
3. Si es necesario, desactiva/elimina el usuario antiguo primero

**Prevención:** Verifica emails antes de crear usuarios.

***

### Las contraseñas no coinciden

**Síntoma:** El formulario no se envía o muestra error de validación.

**Solución:**

1. Verifica que escribiste **exactamente** la misma contraseña
2. Revisa:
   * Mayúsculas y minúsculas
   * Espacios accidentales al inicio/final
   * Caracteres especiales
3. Copia la contraseña del primer campo y pégala en el segundo
4. O genera nueva contraseña y vuelve a intentar

***

### Error: "Contraseña no cumple requisitos"

**Causa:** La contraseña no cumple las políticas de seguridad.

**Requisitos:**

* Mínimo 8 caracteres
* Al menos 1 mayúscula
* Al menos 1 minúscula
* Al menos 1 número

**Solución:**
Usa contraseña que cumpla, ejemplo: `Temporal2025!`

**Ver:** [Requisitos de Contraseña](/usuarios/es/guides/password-management#requisitos-de-contrase%C3%B1a)

***

## Problemas con Grupos

### Usuario no aparece en autocomplete al agregar a grupo

**Síntomas:**

* Abriste modal de Miembros
* Buscas usuario pero no aparece

**Soluciones:**

<Steps>
  <Step title="Actualizar datos">
    Cierra el modal y vuelve a abrirlo
  </Step>

  <Step title="Actualizar página">
    Presiona F5 para recargar la página
  </Step>

  <Step title="Verificar creación">
    Confirma que el usuario fue creado exitosamente en Control de Usuarios
  </Step>

  <Step title="Esperar sincronización">
    Espera 10-20 segundos para sincronización de datos
  </Step>

  <Step title="Reiniciar sesión">
    Si persiste, cierra sesión y vuelve a iniciar
  </Step>
</Steps>

***

### Error al eliminar grupo: "Grupo tiene miembros"

**Causa:** El grupo no puede eliminarse mientras tenga usuarios asignados (en algunas configuraciones).

**Solución:**

1. Abre modal de Miembros del grupo
2. Remueve todos los usuarios del grupo
3. Una vez vacío, elimina el grupo

**Alternativa:** Si el error persiste, contacta soporte técnico.

***

### No puedo remover un usuario de un grupo

**Síntomas:**

* Click en botón eliminar no funciona
* O muestra error

**Soluciones:**

1. Verifica que tienes permisos de "Gestionar miembros"
2. Actualiza la página y vuelve a intentar
3. Verifica conexión a internet
4. Revisa consola del navegador (F12) para errores técnicos

***

## Problemas con Roles y Permisos

### No veo el botón "Guardar" en Roles por Grupo

**Causa:** No hay cambios pendientes de guardar.

**El botón aparece solo cuando:**

* Marcas o desmarcas un checkbox de rol
* Hay cambios sin guardar (dirty state)

**Solución:**

1. Haz un cambio (marca/desmarca un rol)
2. El botón debería aparecer
3. Si no aparece, actualiza la página

***

### Los cambios de roles no se guardan

**Síntomas:**

* Hiciste click en Guardar
* Pero al volver a seleccionar el grupo, los roles están como antes

**Soluciones:**

<Steps>
  <Step title="Verificar guardado">
    Asegúrate que viste el mensaje "Roles asignados correctamente"
  </Step>

  <Step title="Verificar permisos">
    Confirma que tienes permiso de "Asignar roles a grupos"
  </Step>

  <Step title="Revisar conexión">
    Verifica que tienes conexión a internet estable
  </Step>

  <Step title="Revisar errores">
    Abre consola del navegador (F12) y busca errores en rojo
  </Step>

  <Step title="Intentar nuevamente">
    Actualiza página, selecciona grupo, haz cambios, guarda
  </Step>
</Steps>

***

### Usuario dice que no puede acceder a un módulo

**Diagnóstico paso a paso:**

<Steps>
  <Step title="Verificar grupos del usuario">
    1. Ve a **Control de Usuarios**
    2. Busca al usuario en la tabla
    3. Revisa columna "Grupos"
    4. Anota todos los grupos
  </Step>

  <Step title="Verificar roles de cada grupo">
    1. Ve a **Roles por Grupo**
    2. Para cada grupo del usuario:
       * Selecciona el grupo
       * Revisa roles marcados
       * Busca el permiso que necesita
  </Step>

  <Step title="Determinar el problema">
    **Si el usuario NO tiene grupos:**

    * Agrégalo al grupo apropiado

    **Si tiene grupos pero el grupo NO tiene el rol:**

    * Asigna el rol necesario al grupo

    **Si tiene grupos y roles correctos:**

    * Pide al usuario que cierre sesión y vuelva a iniciar
    * Verifica que el rol es el correcto para esa acción
  </Step>
</Steps>

**Ver:** [Ver Grupos y Permisos](/usuarios/es/guides/user-management#ver-grupos-y-permisos)

***

## Problemas de Acceso

### Usuario no puede iniciar sesión

**Síntomas:** Error de "Usuario o contraseña incorrectos"

**Diagnóstico:**

<AccordionGroup>
  <Accordion title="Verificar credenciales">
    1. Confirma con el usuario:
       * Username exacto (mayúsculas/minúsculas importan)
       * Contraseña exacta
    2. Verifica que el usuario fue creado en Control de Usuarios
    3. Si olvidó contraseña, resetéala como administrador
  </Accordion>

  <Accordion title="Verificar membresía de grupos">
    1. Usuario debe pertenecer al menos a 1 grupo
    2. Si no tiene grupos, agrégalo al apropiado
    3. Los grupos deben tener roles asignados
  </Accordion>

  <Accordion title="Verificar si fue desactivado">
    1. Revisa si el usuario tiene grupos
    2. Si no tiene ninguno, pudo haber sido desactivado
    3. Agrega nuevamente a grupos si debe tener acceso
  </Accordion>

  <Accordion title="Problemas técnicos">
    1. Verifica que el sistema esté funcionando (prueba con tu usuario)
    2. Verifica conexión de red del usuario
    3. Prueba desde otro navegador
    4. Limpia caché del navegador (Ctrl+Shift+Del)
  </Accordion>
</AccordionGroup>

***

### Usuario puede acceder pero no ve ciertos módulos

**Causa:** Falta de permisos para esos módulos.

**Solución:**

1. Identifica qué módulo necesita
2. Ve a **Roles por Grupo**
3. Selecciona el grupo del usuario
4. Verifica que el grupo tiene roles de ese módulo
5. Si no los tiene, asigna los roles necesarios
6. Usuario debe cerrar sesión y volver a iniciar para ver cambios

***

### Olvid é mi contraseña de administrador

**Escenario 1: Hay otros administradores**

**Solución:**

* Solicita a otro administrador que resetee tu contraseña
* Sigue procedimiento estándar de cambio de contraseña

**Escenario 2: Eres el único administrador**

**Solución:**

1. Contacta soporte técnico de DaiaERP
   * Email: [soporte@daiasystems.com](mailto:soporte@daiasystems.com)
   * Teléfono: +56 2 2345 6789 (Ext. 1111)
2. Deberás validar tu identidad
3. Soporte tiene proceso especial de recuperación
4. Puede tomar 24-48 horas

**Prevención:**

* Siempre tener al menos 2 administradores
* Documentar quiénes son los admins activos
* Usar gestor de contraseñas corporativo

***

## Problemas de Rendimiento

### La tabla de usuarios tarda mucho en cargar

**Causa:** Muchos usuarios en el sistema (>1000)

**Soluciones:**

1. Usa función de búsqueda del navegador (Ctrl+F)
2. Espera a que cargue completamente
3. Considera agregar filtros o paginación (contacta soporte)

***

### El modal de Miembros es lento al abrir

**Causa:** Grupo con muchos miembros (>100)

**Soluciones:**

1. Espera unos segundos para carga completa
2. Usa campo de búsqueda del autocomplete
3. Considera subdividir el grupo en grupos más pequeños

***

## Errores Técnicos

### Error 403: "No autorizado"

**Causa:** Tu usuario no tiene permisos para esa acción.

**Solución:**

1. Verifica que tu usuario tiene permisos de administración
2. Contacta a administrador principal para que te otorgue permisos
3. Si eres el administrador, verifica que tus grupos tienen los roles necesarios

***

### Error 500: "Error del servidor"

**Causa:** Problema técnico en el servidor.

**Solución:**

1. Actualiza la página (F5)
2. Espera 5-10 minutos y vuelve a intentar
3. Si persiste, contacta soporte técnico con:
   * Qué acción estabas haciendo
   * Mensaje de error completo
   * Captura de pantalla si es posible

***

### Error 409: "Conflicto"

**Causa:** Intentaste crear algo que ya existe.

**Común en:**

* Username duplicado
* Email duplicado
* Código de grupo duplicado

**Solución:**
Usa un valor diferente y único.

***

## Navegador y Conexión

### Botones no responden o interfaz se congela

**Soluciones:**

<Steps>
  <Step title="Actualizar página">
    Presiona F5 para recargar
  </Step>

  <Step title="Limpiar caché">
    Ctrl+Shift+Del → Limpiar caché del navegador
  </Step>

  <Step title="Cerrar y reabrir navegador">
    Cierra todas las pestañas y abre nuevamente
  </Step>

  <Step title="Probar otro navegador">
    Chrome, Firefox, Edge (recomendados)
  </Step>

  <Step title="Verificar conexión">
    Asegúrate de tener internet estable
  </Step>
</Steps>

***

### Cambios no se reflejan inmediatamente

**Causa:** Caché del navegador o sincronización de datos.

**Solución:**

1. Actualiza la página (F5)
2. Espera 10-20 segundos
3. Cierra sesión y vuelve a iniciar
4. Limpia caché del navegador

***

## Cuándo Contactar Soporte

Contacta soporte técnico si:

* ✅ Probaste todas las soluciones de esta guía
* ✅ El problema persiste después de 30 minutos
* ✅ Afecta a múltiples usuarios
* ✅ Es un error de servidor (500, 503)
* ✅ Sospechas problema de seguridad
* ✅ Necesitas recuperar cuenta de administrador único

### Información a Proporcionar

Al contactar soporte, incluye:

1. **Descripción del problema:**
   * Qué estabas haciendo
   * Qué esperabas que pasara
   * Qué pasó en realidad

2. **Mensajes de error:**
   * Texto completo del error
   * Código de error si hay (403, 500, etc.)
   * Captura de pantalla

3. **Contexto:**
   * Navegador y versión
   * Sistema operativo
   * Usuario afectado
   * Hora del incidente

4. **Pasos para reproducir:**
   * Lista detallada de pasos
   * Permite a soporte replicar el problema

***

## Contactos de Soporte

<CardGroup cols={2}>
  <Card title="Email" icon="envelope">
    [soporte@daiasystems.com](mailto:soporte@daiasystems.com)
  </Card>

  <Card title="Teléfono" icon="phone">
    +56 2 2345 6789 (Ext. 1111)
  </Card>

  <Card title="Horario" icon="clock">
    Lunes a Viernes, 9:00 - 18:00 CLT
  </Card>

  <Card title="Emergencias" icon="triangle-exclamation">
    Seguridad: 24/7
  </Card>
</CardGroup>

***

## Documentación Relacionada

* [FAQ](/usuarios/es/faq) - Preguntas frecuentes
* [Gestión de Usuarios](/usuarios/es/guides/user-management)
* [Gestión de Grupos](/usuarios/es/guides/group-management)
* [Asignación de Roles](/usuarios/es/guides/role-assignment)

***

**¿Resolviste tu problema?** Si encontraste una solución que no está aquí, compártela con soporte para mejorar esta guía.