Troubleshooting de usuario final

Esta página resuelve los problemas operativos más frecuentes. Si no encuentras tu caso, escribe a soporte@emahealth.io con un screenshot del error y la URL de tu pantalla.

Consejo

Antes de reportar un bug: prueba con Ctrl + Shift + R (hard refresh) y verifica que tu navegador esté actualizado. El 60% de los “bugs” reportados se resuelven con esto.

No puedo loguearme

”Credenciales inválidas”

• Revisa que el correo esté escrito sin espacios.
• Confirma con tu admin que tu usuario está activo.
• Si olvidaste la contraseña, click en ¿Olvidaste tu contraseña? → recibirás un magic link por email.

”Tenant no resuelto”

• Verifica que estés en la URL correcta de tu clínica (ej: aurora.emahealth.io, no clinic.emahealth.io directamente).
• Limpia el localStorage del navegador (DevTools → Application → Local Storage → Clear).
• Pídele a tu admin que verifique tu fila en user_roles.

”Tu sesión expiró”

• Normal después de ~1h de inactividad.
• Solo vuelve a loguearte. El trabajo no terminado se guarda en draft cuando es posible.

La pantalla está en blanco / no carga

1. Hard refresh: Ctrl + Shift + R (o ⌘ + Shift + R en Mac).
2. Si sigue blanco, abrir DevTools (F12) y ver consola.
3. Si ves error de CORS o Network, probablemente Aidbox o Supabase están caídos. Revisar status o esperar 5 min.
4. Si nada de lo anterior funciona: cambiar de navegador (probar Chrome incógnito).
5. Si sigue, reportar con screenshot de la consola.

No veo el menú de Urgencia / Caja / Reportes

Causa: tu rol no tiene acceso a ese módulo.

• Ver matriz de roles para confirmar.
• Si crees que deberías tener acceso, pedir al admin que ajuste tu rol en user_roles.

El paciente no aparece al buscarlo

Posibles causas:

• Está en otra clínica — los pacientes están aislados por tenant. Cada clínica solo ve los suyos.
• No fue creado — verificar con secretaria si fue admitido.
• Está escrito distinto — probar con identificador nacional en vez de nombre.
• Soft-deleted — admin puede ver pacientes “inactive” en filtros avanzados.

La búsqueda global está lenta

• Usar identificador nacional en vez de nombre — la query es más rápida.
• Si tienes >5000 pacientes, considera paginar por filtros (médico, fecha de último encuentro).

”EMI no responde” (botón grisado)

Causas posibles:

1. Tu clínica no tiene EMI activo — pide al admin que lo active en Configuración → EMI.
2. Estás offline — EMI requiere conexión.
3. EMI overflow — has hecho >50 consultas hoy. Espera al refresh del rate limit (1 min).

El triaje ESI no me sugiere un nivel

• Verifica que hayas completado todas las preguntas obligatorias del wizard (las marcadas con *).
• Si vitales son inválidos (ej: PA = 0), el motor falla. Re-medir y re-ingresar.
• Si sigue fallando: marca ESI manualmente y registra como override con razón “motor no respondió”.

El documento fiscal no se emitió

• Esperar 30 seg — la emisión es async y puede demorar un momento.
• Si pasados 5 min no aparece, ir a Caja → Pendientes y click Re-emitir.
• Si falla con “identificador nacional inválido”: verificar el identificador nacional del receptor en la ficha del paciente.
• Si persiste: reportar a soporte con el cash_movement_id.

La firma del documento no aparece

EMA Clinic firma con QR (no FEA todavía). Si no ves QR:

• El documento aún no fue cerrado. Click en Cerrar y firmar.
• Si está cerrado pero sin QR, recargar la página.
• Si persiste, reportar.

”Error 503” al abrir Pacientes / Agenda

• Aidbox está caído o tu clínica no tiene credenciales OAuth (mal provisioning).
• Avisar al admin para que verifique con soporte.
• Mientras tanto, los módulos no-FHIR (caja, audit, settings) siguen funcionando.

El layout se ve roto en mi tablet/celular

EMA Clinic es responsive. Si se ve mal:

• Ancho ≥ 1024px → sidebar fijo.
• Ancho 640-1024px → sidebar overlay (tocar para abrir).
• Ancho < 640px → bottom nav con 4 items + overflow.

Si el layout salta entre breakpoints o se rompe, reportar con:

• Modelo del dispositivo.
• Navegador + versión.
• Screenshot.

Olvidé mi contraseña / quiero cambiarla

• En login, click en ¿Olvidaste tu contraseña?.
• Recibes magic link por email (válido 15 min).
• Al ingresar, configuras nueva contraseña en Mi perfil.

¿Cómo veo los cambios que hice?

Cualquier rol puede ver el audit de su propia actividad en Mi perfil → Mi actividad. El admin puede ver el de toda la clínica en Config → Audit logs.

Reportar un bug

Si nada de lo anterior aplica:

1. Reproducir el bug.
2. Tomar screenshot.
3. Abrir DevTools (F12) → tab Console → screenshot también.
4. Enviar a soporte@emahealth.io con:
   • Pasos para reproducir.
   • Screenshots.
   • Hora aprox del bug.
   • Tu rol y la URL de tu clínica.

Consejo

EMI puede ayudarte a diagnosticar errores. Click en el botón coral, pega el mensaje de error y pregunta. Ella tiene contexto del producto.