Buscar productos en POS y usar lector de codigo

Qué vas a lograr

• Entender cómo funciona el buscador de productos dentro del POS de Flobu.
• Saber leer correctamente los resultados antes de agregar una variante al pedido.
• Usar el lector de código físico o la cámara del dispositivo para encontrar productos más rápido.

---

Paso a paso en Flobu

Cómo funciona la interfaz de Flobu en este tutorial

• Menú lateral: en este tutorial usarás Punto de venta > Caja, con una sesión de caja ya abierta.
• Panel central: arriba verás el buscador Buscar producto por nombre, SKU...; debajo aparece el pedido actual y, al enfocar el buscador, Flobu abre un panel flotante con resultados.
• Acciones clave: usarás el campo de búsqueda, el ícono de código de barras, la lista de resultados, y atajos visibles como ↓, ↑, ↵ y Esc.
• Alcance de este tutorial: aquí aprenderás a encontrar y agregar productos al pedido actual. No cubriremos todavía cliente, descuentos, forma de pago ni cierre de la venta.

---

1) Ubicar el buscador del POS y entender qué información usa Flobu

1. Entra a Punto de venta > Caja con una caja ya abierta.
2. En la parte superior del bloque izquierdo ubica el buscador con el placeholder Buscar producto por nombre, SKU...
3. Haz clic dentro del buscador para abrir el panel flotante de resultados.
4. Si Flobu está actualizando el catálogo local del POS, verás la franja Sincronizando catálogo...
5. Esa franja no significa que el POS esté bloqueado. Flobu puede seguir buscando mientras termina la sincronización.
6. Cuando la sincronización local ya existe, Flobu busca primero en la base local de esa sucursal. Si aún no termina, usa la API como respaldo.
7. Ten presente que el POS trabaja con variantes, no solo con productos generales. Por eso en cada resultado puedes ver el nombre del producto y, si aplica, el nombre de la variante.
8. Si todavía no escribes nada, Flobu puede mostrar variantes recientes del catálogo. Si no encuentra coincidencias, muestra No se encontraron productos.
9. Si el POS está vacío, debajo del buscador verás Agrega productos al pedido. Ese mensaje solo indica que aún no has agregado ítems al carrito de esta sesión.

Resultado esperado:

• Ubicaste el buscador correcto del POS.
• Entendiste que Flobu puede buscar desde datos locales o desde la API, según el estado de sincronización del catálogo.

---

2) Buscar manualmente una variante y agregarla al pedido

1. Escribe en el buscador el nombre del producto, el nombre de una variante o el SKU.
2. Si conoces el código de barras y lo escribes manualmente como número, Flobu también puede encontrar una coincidencia exacta.
3. Espera un instante mientras Flobu filtra los resultados.
4. Revisa cada tarjeta de resultado antes de hacer clic:
   • Arriba verás el nombre del producto.
   • Debajo puede aparecer el nombre de la variante.
   • También verás el SKU, el precio y, si existe, un badge de descuento.
   • A la derecha verás el estado de stock, por ejemplo 3 un. o ∞ cuando la variante no controla stock.
5. Si prefieres teclado en vez de mouse, usa ↓ y ↑ para navegar, ↵ para seleccionar y Esc para cerrar el panel.
6. Haz clic sobre una variante con stock disponible, o selecciónala con ↵.
7. Si la variante se puede vender, Flobu la agrega inmediatamente al pedido actual y cierra el panel de resultados.
8. Si la variante tiene stock controlado y no tiene unidades, Flobu muestra Producto sin stock disponible y no la agrega.
9. Después de agregarla, valida que el ítem aparezca en la sección Detalles del pedido actual.

Resultado esperado:

• Encontraste una variante por nombre, variante, SKU o código escrito manualmente.
• Agregaste correctamente el producto al pedido actual del POS.

---

3) Escanear con lector físico o con la cámara del dispositivo

1. Ubica el ícono de código de barras al lado derecho del buscador.
2. Si estás en un dispositivo móvil con cámara, al tocar el ícono Flobu puede abrir directamente el escáner.
3. Si estás en desktop con cámara, el ícono abre un popover con la opción Cámara del dispositivo y una ayuda para Lector de código de barras.
4. Si estás en desktop sin cámara, Flobu no abre el flujo de cámara y solo te muestra la ayuda del lector físico.
5. Para usar un lector USB o Bluetooth, conéctalo y escanea el producto con el POS abierto.
6. No necesitas abrir un formulario aparte para el lector físico. Flobu escucha la lectura directamente desde la pantalla del POS.
7. Si usas cámara, al abrir el modal verás Escanear código.
8. Mientras el escáner arranca, Flobu muestra Iniciando cámara...
9. Cuando queda listo, cambia a Apunta al código de barras.
10. Si tu dispositivo soporta zoom, verás controles para acercar o alejar la imagen.
11. Apunta al código del producto y espera a que Flobu lo procese.
12. Si encuentra una variante válida, el modal se cierra y el producto se agrega al pedido actual.
13. Si el código no coincide con ninguna variante registrada, Flobu muestra Producto no encontrado para este código.
14. Si el navegador no permite usar la cámara, verás el mensaje No se pudo acceder a la cámara.
15. Igual que en la búsqueda manual, si la variante encontrada no tiene stock disponible y el stock está controlado, Flobu no la agregará al pedido.

Resultado esperado:

• Pudiste buscar un producto con lector físico o con cámara, según el dispositivo disponible.
• Confirmaste que Flobu agrega la variante al pedido solo cuando el código existe y la variante se puede vender.

---

Checklist final rápido

• Entré al POS con una caja ya abierta.
• Ubiqué el buscador Buscar producto por nombre, SKU...
• Entendí que Sincronizando catálogo... no bloquea el uso del POS.
• Busqué una variante por nombre, variante o SKU.
• Supe leer precio, descuento y stock en cada resultado.
• Usé mouse o teclado para seleccionar una variante.
• Validé que el producto agregado apareciera en Detalles.
• Identifiqué cuándo conviene usar el ícono de código de barras.
• Entendí la diferencia entre lector físico y cámara del dispositivo.
• Supe reconocer los mensajes Producto no encontrado para este código y Producto sin stock disponible.

---

Errores comunes

• Pensar que el buscador solo sirve para nombre o SKU. En Flobu también puede encontrar coincidencias exactas por código de barras.
• Intentar vender una variante sin stock controlado disponible. Si el stock está en 0, Flobu no la agregará aunque la encuentres en los resultados.
• Confundir el ícono de código de barras con una acción exclusiva de cámara. En desktop también sirve como punto de entrada para entender el uso del lector físico.
• Cerrar el panel de resultados creyendo que el POS falló. Si presionas Esc o haces clic fuera, Flobu solo cierra el panel flotante; no borra el pedido actual.
• Escanear un código que no está guardado en la variante esperando que Flobu adivine el producto. El lector funciona solo si el código existe realmente en el catálogo de Flobu.