Preguntas Frecuentes (FAQ)

Respuestas rápidas a las preguntas más comunes sobre el Sistema de Seguimiento de Pedidos.

📚 Categorías: Acceso, App instalada, Sin conexión, Catálogos, Concurrencia, Pedidos, Productos, Estados, Roles

🔐 Acceso y Login

¿Por qué no puedo iniciar sesión?

Posibles causas:

  • Email o contraseña incorrectos (revisa mayúsculas/minúsculas).
  • Tu usuario está inactivo. Contacta al administrador.
  • Estás en Cambio obligatorio pendiente (primer acceso).
  • Problema técnico de conexión o sesión. Intenta nuevamente.

Guía completa: Autenticación y Acceso.

¿Cómo cambio mi contraseña?

Hay dos caminos según el caso:

  • Cambio obligatorio: se muestra automáticamente al primer login de una cuenta que lo requiera.
  • Recuperación: desde Login usa “¿Olvidaste tu contraseña?” y sigue el enlace enviado por correo.

¿Qué hago si olvidé qué rol tengo?

Inicia sesión con tus credenciales y revisa tu perfil en el header/menú. El rol asignado se muestra dentro de la aplicación una vez autenticado.

¿Cómo funciona la Activación de un usuario nuevo?

El Admin crea la cuenta con nombre, email y rol (sin contraseña inicial). El usuario recibe un correo con un enlace de activación para definir su propia contraseña.

¿Qué pasa cuando termino una Activación o un Reset?

Después de guardar la nueva contraseña, el sistema redirige a /login para que inicies sesión de nuevo con la clave actualizada.

📲 App instalada (celular o computadora)

¿Puedo usar el sistema como una aplicación?

Sí. Podés instalarlo en tu dispositivo para tener un icono en la pantalla de inicio y abrirlo en una ventana propia. Sigue siendo la misma aplicación; para el ingreso con email y contraseña normalmente necesitás red al menos la primera vez.

¿Funciona sin conexión a internet?

Parcialmente, con límites claros (v2). La app instalada (PWA) puede abrir la interfaz si el shell ya se precargó con red, pero no guarda listados ni pedidos en el dispositivo para consulta offline. Sin conexión al servidor verás avisos, los datos no cargarán y las mutaciones quedan bloqueadas (crear/editar pedidos, cambiar estados, checkboxes, pesos). Guía completa: Trabajar sin conexión.

¿“Persistencia activa” significa que tengo internet?

No necesariamente. Ese indicador muestra si el servidor responde bien cuando hay intento de conexión. Podés tener otro aviso de sin conexión aunque tu Wi‑Fi esté encendido. Son señales distintas; ver Trabajar sin conexión.

¿Puedo crear pedidos offline o sincronizar después?

No en esta versión. No hay cola local, snapshots de filtros ni PIN offline. Necesitás red estable para crear, editar o cambiar estados. Si perdés la conexión a mitad de un formulario, esperá a recuperar señal antes de guardar.

¿La PWA guarda datos para cuando no hay red?

No. La PWA precachea recursos de la interfaz (shell, iconos, estilos) para abrir rápido, pero no cachea respuestas de la API ni catálogos de pedidos/productos. Sin servidor activo no verás listados actualizados.

No me aparece la opción de instalar

Usá la URL oficial con HTTPS (candado seguro), un navegador actualizado y, en iPhone, Safari. En modo privado o incógnito la opción puede no mostrarse. Guía paso a paso: Instalar la aplicación.

📝 Pedidos

¿Por qué mi pedido muestra Total Estimado = $0?

Esto es normal si tu pedido solo contiene productos por KG. El Total Estimado solo incluye productos por Unidad. El valor real se calculará cuando Logística ingrese los pesos.

¿Puedo editar un pedido ya creado?

Depende del estado y tu rol:

  • Pendiente de Armado: Vendedores y Admin pueden editar
  • Pendiente de Facturación o posterior: Solo Admin puede editar
  • Facturado o Entregado: No se puede editar

¿Puedo eliminar un pedido?

Los pedidos se pueden eliminar solo si están en estado Pendiente de Armado (Vendedores pueden eliminar los suyos, Admin puede eliminar cualquiera). Los pedidos facturados o entregados no se pueden eliminar para preservar la trazabilidad.

¿Qué significa el código del pedido (ej: #78bd8e9)?

Es un identificador único abreviado del pedido. Es más fácil de leer y comunicar que un ID largo. Cada pedido tiene un código único que se muestra en listados, detalles y notificaciones.

¿Puedo buscar pedidos por cliente?

Sí, en la vista de Pedidos hay un campo de búsqueda. Puedes buscar por código de pedido, nombre del cliente o incluso por estado.

¿Cambió algo en "Nuevo Pedido" según el dispositivo?

Sí. En pantallas pequeñas, el alta de pedidos usa un wizard de 4 pasos con progreso visible y validación por etapa, optimizado para uso en mobile. En desktop se mantiene la carga en una sola vista ancha, pero ahora incluye búsqueda avanzada, atajos de teclado (F3/F4) y la posibilidad de reordenar líneas del pedido arrastrando las filas.

¿El detalle de un pedido se ve distinto en el celular?

Sí. En mobile el detalle se organiza en una columna: primero el estado y las acciones permitidas, luego cliente, líneas y totales. El botón Volver queda fijo abajo para no perderlo al hacer scroll. El historial de cambios de estado no se muestra en pantallas pequeñas; en escritorio sigue disponible. Más detalle en la guía Detalle de pedido (móvil).

📚 Catálogos del servidor

¿De dónde salen las etiquetas de estados, tipos de documento e IVA?

La aplicación consume catálogos solo lectura publicados por la API:

  • GET /api/catalogs/order-statuses — estados de pedido (orden, etiqueta, color de badge)
  • GET /api/catalogs/document-types — tipos de documento de clientes
  • GET /api/catalogs/tax-conditions — condiciones de IVA

Se descargan al iniciar sesión con red. Los cambios de metadatos en el servidor se reflejan tras recargar la app.

¿Puedo editar el catálogo de estados desde la app?

No en esta versión. El mantenimiento de catálogos maestros (OrderStatus, tipos de documento, IVA) es responsabilidad del equipo técnico o administración de datos en el servidor. Los usuarios operan el flujo con los valores publicados.

🔀 Concurrencia y merge

¿Qué pasa si dos personas editan el mismo pedido?

Si trabajan en líneas distintas (por ejemplo Logística marca Log. en un ítem y Facturación marca Fact. en otro), los cambios conviven sin problema. Si dos usuarios modifican la misma línea o la cabecera casi al mismo tiempo, el servidor detecta el conflicto y la app muestra un diálogo de merge para elegir qué versión conservar.

¿Debo recargar la página cuando aparece un conflicto?

No hace falta recargar a ciegas. Usá el diálogo de merge: compará tu versión con la del servidor y confirmá la resolución. Si cerrás el diálogo sin decidir, tu pantalla puede quedar desactualizada hasta que recargues con red.

🔄 Estados de Pedido

¿Quién puede cambiar los estados de un pedido?

Transición Quién puede hacerla
Armado ↔ Facturación Logística, Admin
Facturación ↔ Facturado Facturación, Admin
Facturado → En Tránsito → Entregado Logística, Admin

¿Por qué no puedo pasar a "Pendiente de Facturación"?

Debes verificar que:

  • ✅ Todos los productos por KG tengan peso real ingresado
  • ✅ Estés usando un usuario con rol Logística o Admin

¿Se pueden revertir los estados?

Algunas transiciones son reversibles:

  • ✅ Facturación → Armado (Logística)
  • ✅ Facturado → Facturación (Facturación)
  • ❌ Entregado → cualquier estado anterior (requiere Admin)

🏷️ Productos y Clientes

¿Cuál es la diferencia entre Unidad y KG?

Aspecto Unidad KG
Ejemplos Botellas, cajas, envases Queso, fiambres, productos a granel
Precio Por unidad Por kilogramo
En pedido Cantidad fija Cantidad estimada + peso real después
Total Estimado Incluido No incluido (hasta peso real)

¿Por qué un producto no aparece al crear pedidos?

Verifica que:

  • ✅ El producto esté Activo (no inactivo)
  • ✅ Estés buscando correctamente (prueba con parte del nombre)
  • ✅ El producto exista en el catálogo

¿Puedo cambiar el precio de un producto?

Sí, ve a Productos, busca el producto, edítalo y cambia el precio. Los cambios afectarán a nuevos pedidos. Los pedidos existentes mantienen el precio original.

¿Qué pasa si desactivo un cliente?

El cliente desaparecerá del selector al crear nuevos pedidos, pero seguirá apareciendo en pedidos históricos. Esto es útil para clientes que ya no compran.

👥 Roles y Permisos

¿Qué ve cada rol en el sistema?

Rol Vistas disponibles
Admin Todas: Panel, Productos, Clientes, Pedidos, Usuarios, Auditoría
Vendedor Panel, Productos, Clientes, Pedidos
Logística Solo Pedidos
Facturación Panel, Productos, Clientes, Pedidos

¿Los Vendedores pueden ver pedidos de otros?

Sí, todos los usuarios con acceso a Pedidos ven el listado completo. Esto permite coordinación entre áreas. Sin embargo, solo pueden editar según sus permisos.

¿Puedo tener más de un rol?

No, cada usuario tiene un único rol asignado. Si necesitas funciones de múltiples roles, habla con el Admin sobre la posibilidad de tener una cuenta Admin.

📱 Uso y Accesibilidad

¿Funciona en celulares?

Sí, el sistema es responsive. En pantallas pequeñas:

  • El menú lateral se convierte en un drawer con botón ☰
  • Las tablas permiten scroll horizontal o se muestran como cards
  • Los botones son más grandes para uso táctil

¿Puedo usar el sistema sin internet?

Solo para abrir la interfaz si ya visitaste la app con red (PWA shell). Las operaciones que modifican datos requieren servidor activo; no hay cola ni sincronización diferida. Más detalle en Trabajar sin conexión.

¿Funciona en cualquier navegador?

El sistema está optimizado para navegadores modernos: Chrome, Firefox, Safari, Edge. Se recomienda mantener el navegador actualizado.

🔔 Notificaciones y Auditoría

¿Cómo activo las notificaciones push?

Ve a Configuración (si está disponible) y busca la opción de Notificaciones. Solo el Admin puede enviar notificaciones de prueba.

¿Quién puede ver la Auditoría?

Solo los usuarios con rol Admin tienen acceso a la vista de Auditoría, donde se registran todos los cambios importantes del sistema.

¿Se guarda quién hizo cada cambio?

Sí, el sistema registra automáticamente: usuario, rol, acción realizada, fecha y hora. Esto permite trazabilidad completa.

🔁 Sincronización ERP

¿Qué hace la sincronización con ERP?

Actualiza información maestra para que el sistema trabaje con datos consistentes de:

  • Productos
  • Categorías
  • Marcas
  • Clientes

¿Dónde encuentro la guía completa de Sync ERP?

Consulta la guía paso a paso en Sincronización ERP. Incluye capturas reales del panel, creación de servicio, programación y ejecución manual.

¿Cómo uso Sync ERP si necesito continuar con un pedido?

Trabaja desde el flujo habitual del pedido:

  • Abre el pedido y valida los datos principales (cliente, productos y estado).
  • Completa los campos requeridos antes de avanzar (por ejemplo, pesos para productos por KG).
  • Realiza la acción que corresponda según tu rol.

Si aparece un mensaje de error, vuelve a intentar una vez y, si persiste, comparte una captura con el código del pedido para recibir ayuda más rápido.

💰 Precios y Totales

¿Por qué el Total Real es diferente del Total Estimado?

Porque:

  • Total Estimado: Solo suma productos por Unidad (cantidad × precio)
  • Total Real: Suma productos por Unidad + productos KG (peso real × precio por KG)

¿Los precios incluyen IVA?

Depende de la configuración de tu sistema. Consulta con el Admin o Facturación para saber si los precios mostrados incluyen o no impuestos.

¿Puedo aplicar descuentos?

La funcionalidad de descuentos depende de la versión del sistema. Si no ves opciones de descuento, consulta con el Admin.

🎯 Siguientes Pasos