Solución de Problemas

Guía de diagnóstico y solución para los problemas más comunes del sistema. Encuentra tu problema por categoría y sigue los pasos de solución.

🚨 Antes de comenzar:
  • Intenta recargar la página (F5 o Ctrl+R)
  • Verifica tu conexión a internet
  • Asegúrate de usar un navegador actualizado

📋 Índice de Problemas

🔐 Problemas de Acceso

Error: "No puedo iniciar sesión"

Síntoma Causa probable Solución
Mensaje de credenciales incorrectas Email o contraseña inválidos Verifica escritura exacta e intenta nuevamente
No puedes avanzar luego del login inicial Cambio obligatorio pendiente Completa el flujo de Cambio obligatorio y vuelve a iniciar sesión
Vuelves a login de forma repetida Sesión vencida o token inválido Inicia sesión de nuevo; si persiste, limpia caché e intenta otra vez

Flujo detallado con capturas: Autenticación y Acceso.

Error: "Me redirigen al login constantemente"

  1. Limpia el caché del navegador (Ctrl+Shift+Delete)
  2. Cierra todas las pestañas del sistema
  3. Ingresa nuevamente
  4. Si persiste, intenta en modo incógnito (Ctrl+Shift+N)

Error: "El enlace de activación o recuperación no funciona"

Síntoma Causa probable Solución
El enlace muestra "no válido" o vencido Token usado o expirado (24 h) Solicita un nuevo correo de Recuperación/Activación
No llega el correo Buzón saturado, spam o demora del servidor Revisa Spam/No deseado y confirma con Admin el email cargado
Guardas nueva contraseña y vuelves a login Comportamiento esperado Inicia sesión con la nueva contraseña

📲 App instalada / acceso directo

No veo la opción para instalar la aplicación

Qué revisar Qué hacer
URL o seguridad Abrí la dirección oficial con HTTPS (candado). Algunos navegadores no ofrecen instalación en sitios “no seguros”.
iPhone / iPad Usá Safari y el menú Compartir → Añadir a inicio. Chrome en iOS puede no mostrar la misma opción.
Ventana privada / incógnito Probá en una ventana normal del navegador.
Navegador desactualizado Actualizá Chrome, Edge o Safari a la última versión.

Guía detallada: Instalar la aplicación.

La app instalada muestra pantalla en blanco o datos viejos

  1. Cerrá la app por completo (deslizá para cerrar en el teléfono o cerrá la ventana en la PC).
  2. Volvé a abrirla desde el icono.
  3. Si sigue mal, abrí el sistema en el navegador, recargá con Ctrl+F5 (o equivalente) y repetí la instalación si hace falta.

📶 Modo sin conexión (v2)

ℹ️ Alcance actual: no hay cola local, PIN offline ni snapshots de filtros. Sin red podés ver el shell de la PWA si ya se precargó, pero no consultar listados actualizados ni guardar cambios.

Pantalla en blanco o sin datos sin internet

Causa probable Qué hacer
Primera visita sin haber abierto la app con red Abrí la app una vez con conexión para que el shell PWA se instale; sin eso, offline no hay interfaz útil.
Esperabas ver pedidos guardados en el teléfono Comportamiento v2: los listados vienen del servidor; sin red no hay datos en caché de negocio.
Instalación o caché de shell desactualizada Con red, recargá forzando (Ctrl+F5). Cerrá y reabrí la app instalada.

Guía de uso: Trabajar sin conexión.

Botones deshabilitados o mensaje “sin conexión” al guardar

  1. Confirmá Wi‑Fi o datos móviles y que el servidor responda (indicador de persistencia activa).
  2. Las mutaciones (crear/editar pedido, estados, checkboxes, pesos) requieren red en v2.
  3. No copies datos a otra app esperando “sincronizar después”; no existe cola offline.

No puedo iniciar sesión sin red

El ingreso con email y contraseña siempre requiere el servidor. No hay PIN ni desbloqueo offline en esta versión. Recuperá conexión o pedí ayuda al administrador.

🔀 Conflictos de edición (merge)

Aparece un diálogo de “Conflicto” o merge al guardar

Causa Qué hacer
Otro usuario modificó la misma línea o la cabecera del pedido Revisá las diferencias en el diálogo; elegí conservar la tuya o la del servidor según corresponda
Cerraste el diálogo sin resolver Recargá el pedido con red para ver el estado actual del servidor antes de seguir editando
El conflicto se repite en la misma línea Coordiná con el otro rol (Logística/Facturación) para no editar la misma fila al mismo tiempo

Más contexto: Cambiar estado (checkboxes y merge) y Glosario → Concurrencia.

Error al marcar Log. o Fact. — “conflicto de versión”

Los checkboxes se guardan por línea. Si Logística y Facturación marcan ítems distintos, no debería haber conflicto. Si dos personas marcan el mismo ítem, usá el merge guiado o recargá el detalle del pedido.

📝 Problemas con Pedidos

Error: "No puedo crear un pedido"

Pasos de diagnóstico:
  1. Verifica tu rol: Solo Vendedores y Admin pueden crear pedidos
  2. Confirma que estás en la vista de Pedidos
  3. Busca el botón Nuevo Pedido arriba a la derecha
  4. Si no lo ves, recarga la página

Error: "Total Estimado es $0"

Causa Solución
Solo agregaste productos por KG ✅ Es normal. El Total Estimado no incluye productos por KG.
Los productos tienen precio $0 Verifica el catálogo de productos y actualiza los precios
No agregaste ningún producto Haz clic en "Agregar Producto" y selecciona al menos uno

Error: "No puedo editar mi pedido"

Restricciones por estado:

  • ✅ Pendiente de Armado: Vendedor puede editar
  • ❌ Pendiente de Facturación: Solo Admin puede editar
  • ❌ Facturado/En Tránsito/Entregado: No editable por Vendedores

Solución: Si necesitas cambios en un pedido avanzado, contacta al Admin.

Error: "No puedo eliminar un pedido"

Las restricciones son:

  • ✅ Se puede eliminar en Pendiente de Armado
  • ❌ No se puede eliminar en estados posteriores (Facturado, Entregado)
  • ✅ Admin puede eliminar en cualquier estado (con precaución)

Error: "El cliente no aparece en el selector"

  1. Verifica que el cliente esté Activo (no Inactivo)
  2. Busca por parte del nombre (no necesitas escribirlo completo)
  3. Si sigue sin aparecer, contacta al Admin para verificar la base de clientes

Error: "El producto no aparece al agregar"

  1. Confirma que el producto esté en estado Activo
  2. Intenta buscar por parte del nombre (mínimo 3 caracteres)
  3. Verifica que la categoría/marca no esté filtrando los resultados

🔄 Problemas con Estados

Error: "No puedo pasar a Pendiente de Facturación"

Causa más común: Productos KG sin peso real
  1. Revisa el pedido: ¿tiene productos por KG?
  2. Si los tiene, deben tener peso real ingresado
  3. Intenta cambiar el estado → se abrirá el modal de pesos automáticamente
  4. Ingresa los pesos reales y confirma
  5. Luego intenta el cambio de estado nuevamente
📸

Screenshot requerido: Error "Faltan pesos por ingresar" con modal de pesos
Debe mostrar: Mensaje de error, modal de ingreso de pesos resaltado

Error: "No tengo opción para cambiar estado"

Causa Solución
Tu rol no tiene permisos • Vendedores: NO pueden cambiar estados
• Logística: Puede cambiar Armado↔Facturación, Facturado→Entregado
• Facturación: Puede cambiar Facturación↔Facturado
• Admin: Puede todo
El pedido ya está en estado final Los pedidos "Entregado" no pueden avanzar más

Error: "No puedo revertir un estado"

Algunas transiciones no son reversibles directamente:

  • ✅ Facturación → Armado: Logística puede hacerlo
  • ✅ Facturado → Facturación: Facturación puede hacerlo (si no salió)
  • ❌ Entregado → cualquier otro: Solo Admin puede revertir

🏷️ Problemas con Productos/Clientes

Error: "No puedo crear un producto"

  1. Verifica tu rol: Admin siempre puede, Vendedor/Facturación depende de permisos
  2. Asegúrate de completar todos los campos obligatorios (nombre, precio, unidad)
  3. El precio debe ser mayor a 0

Error: "Los cambios en precio no se reflejan en pedidos antiguos"

✅ Esto es el comportamiento esperado

Los pedidos guardan el precio del momento de creación para preservar el histórico. Los cambios de precio solo afectan nuevos pedidos.

Error: "No puedo activar/desactivar un cliente"

Verifica:

  • Tu rol tiene permisos de edición de clientes (Admin, Vendedor)
  • Estás haciendo clic en el toggle correcto
  • El cliente existe en el sistema

👁️ Problemas Visuales/UI

Error: "La página se ve mal en mi celular"

Problema Solución
Texto muy pequeño Usa el gesto de pellizco para hacer zoom
No veo el menú lateral Toca el botón ☰ (hamburguesa) arriba a la izquierda
Tablas se cortan Desliza horizontalmente sobre la tabla
Botones muy pequeños Rota el celular a horizontal o usa un dispositivo con pantalla más grande

Error: "Los colores/estilos no se ven bien"

  1. Verifica que no tengas alguna extensión de navegador que modifique estilos
  2. Intenta en modo incógnito (Ctrl+Shift+N)
  3. Asegúrate de que tu navegador esté actualizado

Error: "Modal/popup no se abre"

  1. Desactiva temporalmente bloqueadores de popups
  2. Recarga la página
  3. Intenta en otro navegador

💥 Errores del Sistema

Error: "Error 500 / Error del servidor"

  1. Espera 1-2 minutos y recarga
  2. Si persiste, contacta al Admin indicando:
    • Qué estabas haciendo cuando ocurrió
    • Qué pedido/producto estabas editando
    • Hora aproximada del error

Error: "No se puede guardar / Error de conexión"

  1. Verifica tu conexión a internet y que el servidor responda
  2. No cierres la ventana — tus datos siguen en el formulario mientras no navegues
  3. En v2 no hay guardado offline: necesitás red para confirmar
  4. Intenta guardar nuevamente en 10-20 segundos; si persiste, copia los datos importantes y recarga

Error: conflicto al guardar (código 409 o mensaje de versión)

  1. No recargues a ciegas: abrí el diálogo de merge si está visible
  2. Compará tu cambio con el estado del servidor
  3. Confirmá la resolución y volvé a intentar solo si hace falta un ajuste adicional

Error: "Datos desactualizados / No veo cambios recientes"

  1. Recarga la página (F5)
  2. Usa Ctrl+F5 para recarga forzada (limpia caché)
  3. Verifica que otro usuario hizo efectivamente el cambio

📞 Contacto de Soporte

Si ninguna solución funciona, contacta a soporte con esta información:

Información necesaria:

  • Tu nombre de usuario y rol
  • Navegador y versión (ej: Chrome 120)
  • Sistema operativo (Windows, Mac, Android, iOS)
  • Descripción del problema (qué intentaste hacer)
  • Mensaje de error exacto (si aparece)
  • Screenshot del problema (si es posible)

🎯 Siguientes Pasos