← Tutoriales por extra

📱 Menús QR mesa

QR pegado en mesa · cliente escanea con cámara móvil · ordena sin descargar app · staff recibe pedido en KDS · útil restaurante · café · bar · room service hotel.

1. ¿Qué resuelve?

• Sin app descargas · cliente abre URL pública sin login · UX similar a Uber Eats embedded.
• Mesero menos viajes · cliente ordena directo · mesero solo entrega + cobra.
• Upselling foto + descripción · ve plato visual antes pedirlo · detalla alérgenos.
• Pedidos accuracy · cliente escribe modificadores · cocinero recibe texto directo · cero malentendidos.

2. Cuándo activarlo

• Restaurante / café / bar · ≥ 8 mesas.
• Hotel con room service · QR habitación.
• Eventos catering · QR mesa boda · invitados ordenan bebida directo.

3. Setup

1. Activar extras restaurant.qr_menus + restaurant.qr_orders desde /extras.
2. Cargar productos del menú con foto + descripción + alérgenos en /products · marca active_in_qr_menu.
3. Crear menú QR en /restaurant/qr-menus:
   • Nombre: "Menú principal" · idioma: es · default tenant theme.
   • Categorías: entradas · principales · bebidas · postres.
   • Asignar productos a categorías · ordenar drag-drop.
4. Configurar mesas en /restaurant/floor-plan · cada mesa genera QR único codifica menu_id + table_id.
5. Imprimir QR PDF + laminar · pegar mesa.

4. Flujo típico (cliente)

1. Cliente sienta mesa · escanea QR con cámara móvil.
2. Abre URL pública qr.vertix.lat/{slug}/menu/{table_id} · ve menú niche-aware del tenant.
3. Navega categorías · agrega productos al carrito · indica modificadores (sin cebolla · término medio).
4. Submit pedido · ingresa nombre + teléfono · pedido aparece en /qr-orders staff KDS estado pending.
5. Staff acepta · marca preparing · cocinero ve receta + cantidad · prepara.
6. Listo · mesero entrega plato · marca ready · luego delivered.
7. Cliente solicita cuenta · mesero cobra POS · ticket cierra mesa.

5. Reportes útiles

• QR scans · QR orders · ratio · indica si menú confunde o convierte bien.
• Tiempo pendiente → preparing· alertan staff si pedido espera > 5 min ack.
• Mesas top revenue QR · adoption rate por ubicación.

6. Troubleshooting

• QR no abre · verifica URL pública renderiza · puede requerir provisionar subdominio QR Caddy config qr.vertix.lat.
• Producto no aparece menú QR · verifica active_in_qr_menu flag · stock disponible > 0 · categoría asignada.
• Pedido duplicado · cliente double-tap submit · sistema dedupes por token sesión 30s.
• Sin notificación staff · activa qr_orders.realtime_refresh · pull cada 5s o websocket si activo.

7. Integraciones

• POS Restaurant · pedido QR aparece directo en KDS / floor plan mesa.
• Storage MinIO · imágenes plato hospedadas · cache CDN.
• QRcode.react · genera QR PNG/SVG imprimible PDF.
• Webhooks · evento qr_order.placed dispara WhatsApp staff notification.

8. Privacy

QR público no requiere login · cliente solo da nombre + tel optional. Nada PII guardado beyond pedido. Tenant niche dental/clinica NO debe usar QR público (privacy concern). Apto restaurante · bar · hotel room service.

Reference: apps/web/app/restaurant/qr-menus/ + app/qr-orders/ · módulo restaurant.qr_menus + restaurant.qr_orders en module_extras.