Tienda online

GridPOS publica un catálogo online donde tus clientes ven productos, arman el carrito y confirman pedidos. La misma configuración alimenta el menú/carta digital con QR por mesa.

Pantalla	Ruta
Configuración	`/config/store-online`
Menú digital (QR por mesa)	`/config/menu-digital`
Tienda pública	`https://app.gridpos.co/tienda/:slug`
Carrito / checkout	`https://app.gridpos.co/tienda/:slug/cart`
Pedidos online (admin)	`/online-store/orders`

Menú en la app: Configuración → Tienda online · Pedidos online

Antes de publicar

Productos visibles: en Inventario → Productos, cada ítem debe tener Mostrar en tienda online = Sí y stock en la bodega asignada.
Slug de la empresa: la URL pública es https://app.gridpos.co/tienda/tu-slug. El slug se define en la configuración del cliente (no en la pantalla de tienda).
Bodega: elige en la tienda la bodega de la que se descuenta inventario al vender.
WhatsApp con prefijo de país: obligatorio para que los pedidos abran el chat correcto (ver sección siguiente).

Número de WhatsApp (prefijo de país)

En Configuración → Tienda online → General → Número de WhatsApp debes guardar el número en formato internacional completo, solo dígitos, incluyendo el código del país. No uses el signo +, espacios ni guiones.

País	Código	Ejemplo correcto	Ejemplo incorrecto
Colombia	57	`573001234567`	`3001234567` (falta 57)
Chile	56	`56912345678`	`912345678`
México	52	`5215512345678`	`15512345678`
Perú	51	`51987654321`	`987654321`
Ecuador	593	`593991234567`	`0991234567`
Argentina	54	`5491112345678`	`91112345678`
Estados Unidos	1	`13051234567`	`3051234567`

Dónde se usa ese número

Botón flotante WhatsApp en la tienda (enviar pedido).
Al pulsar Realizar pedido en el checkout: se registra el pedido en GridPOS y se abre WhatsApp con el resumen del carrito hacia ese número.
Consultas por producto (Preguntar por WhatsApp), cuando la funcionalidad lo permite.

Teléfono del cliente en el checkout

En pedidos Domicilio y Recoger, el cliente debe indicar su Teléfono (WhatsApp). Recomienda en tu tienda que también lo escriban con prefijo de país (por ejemplo 573001234567) para que tú puedas contactarlo sin errores desde el panel de pedidos.

Configurar la tienda (`/config/store-online`)

En la parte superior tienes accesos rápidos:

Visualizar tienda — abre el catálogo público.
Visualizar menú/carta — misma tienda con ?view=menu (modo carta).
Copiar link / Generar QR — compartir la URL.
Menú/Carta Digital (QR por mesa) — atajo a /config/menu-digital.

Pestaña General

Campo	Detalle
Número de WhatsApp	Contacto del negocio. Con prefijo de país, solo dígitos. Campo obligatorio.
Nombre de la tienda	Título público y en mensajes de confirmación.
Bodega	Bodega de inventario para la tienda. Obligatoria.
Publicar tienda	Activo (visible) / Inactivo (muestra error 403 al entrar).
Funcionalidad	Ver abajo.
Categoría “Todos”	Mostrar u Ocultar la pestaña que agrupa todo el catálogo.
Categoría por defecto	Si ocultas “Todos”, puedes fijar qué categoría se abre primero.
URL de la tienda	Enlace público `https://app.gridpos.co/tienda/tu-slug` (solo lectura).
Descripción	Texto de bienvenida en el pie de la tienda (editor enriquecido).
Logotipo	Imagen del negocio en la tienda y en QR. Comprime imágenes pesadas antes de subir.

Funcionalidad de la tienda

Valor	Comportamiento
Solo visualizar carta	Catálogo y menú sin carrito ni checkout. Ideal para carta digital o consulta.
Para tomar pedidos	Carrito, checkout, registro de pedidos y envío a WhatsApp.

Pestaña Redes

Campo	Uso
URL de Facebook	Enlace en la tienda pública.
Facebook Pixel ID	Seguimiento de visitas (PageView) en la tienda.
URL de Instagram	Enlace en la tienda.
URL de TikTok	Enlace en la tienda.

Pestaña Pagos

Campo	Detalle
Costo de envío	Se suma al total cuando el cliente elige Domicilio.
Número Nequi / Daviplata / Bancolombia	Datos que ves en el pie de la tienda.
QR Nequi / Daviplata / Bancolombia	Imágenes QR para que el cliente pague; se pueden ampliar al tocar.

En el checkout, los métodos de pago disponibles dependen de lo configurado aquí y del endpoint de métodos de pago de la tienda (efectivo, crédito, Nequi, etc.).

Pestaña SEO

Controla cómo se ve el enlace al compartir en WhatsApp, Facebook u otras redes:

Campo	Recomendación
Título SEO	~60 caracteres. Si está vacío, usa el nombre de la tienda.
Descripción SEO	Hasta 320 caracteres para vista previa social.
Palabras clave	Separadas por comas.
Directiva robots	Por defecto `index, follow`. Usa `noindex` si no quieres indexación en buscadores.
Nombre del sitio (og:site_name)	Nombre al compartir enlace.
Imagen para compartir	Vista previa Open Graph (recomendado 1200×630 px).

Guarda los cambios al terminar cada pestaña.

Experiencia del cliente (tienda pública)

URL: https://app.gridpos.co/tienda/tu-slug

Catálogo

Barra de categorías desplazable (incluye TODO si está habilitado).
Búsqueda de productos por nombre.
Tarjetas con imagen, precio, variantes y modificadores (extras) cuando el producto los tiene.
Paginación si hay muchos productos.

Carrito

Icono MI CARRITO en escritorio; en móvil, botón flotante.
Ruta: /tienda/tu-slug/cart.
Ajuste de cantidades, subtotal, impuestos (si aplican) y envío.

Checkout — tipos de pedido

Tipo	Campos principales
Domicilio	Nombre, teléfono WhatsApp, dirección, barrio, método de pago, comentario. Suma costo de envío.
Recoger	Nombre, teléfono, método de pago, comentario. Sin envío.
En mesa	Mesa (selector si hay mesas libres, o texto/QR). Teléfono opcional. Sin método de pago en formulario.

Flujo al confirmar:

GridPOS guarda el pedido (store-orders).
Se abre WhatsApp con un mensaje estructurado (cliente, productos, modificadores, total, notas).
El carrito se vacía y el cliente vuelve al catálogo.

Si la tienda está Inactiva, el visitante ve que no está disponible.

Menú / carta digital con QR

Ruta admin: /config/menu-digital

URL base del menú

https://app.gridpos.co/tienda/tu-slug?view=menu

Modo optimizado para restaurantes: buscador compacto, sin pie comercial completo, enfoque en la carta.

QR por mesa

Crea mesas en el módulo de Zonas y pedidos.
En Menú digital, descarga el QR de cada mesa o copia su enlace.
El enlace incluye table={id} para pre-asignar la mesa.
El cliente escanea, elige productos y al pedir En mesa la mesa ya viene seleccionada.

Instrucciones resumidas: imprime QR → colócalo en la mesa → el cliente escanea → pedido asociado a esa mesa.

Productos, precios, logo y WhatsApp se configuran en Tienda online, no en Menú digital.

Panel de pedidos online

Ruta: /online-store/orders

Filtros y KPIs

Rango de fechas (por defecto hoy).
Ventas, productos vendidos, órdenes y producto más vendido del periodo.
Indicador de pedidos pendientes.
Descargar reporte Excel del rango seleccionado.

Tabla de pedidos

Columnas: #, Tipo (Domicilio / Recoger / Mesa), Cliente (con botón WhatsApp), Entrega, Pago, Total, Estado, Fecha.

Estado	Significado
Pendiente	Recién registrado; fila resaltada.
Completado	Gestionado / cerrado.

Detalle y acciones

Al abrir un pedido ves productos, cantidades, precios, datos del cliente y comentarios.

Según el tipo:

Tipo	Acción típica
Domicilio	Crear pedido de domicilio → envía al Kanban de domicilios (`/tables?tab=pedidos`).
Mesa	Aprobar y pasar a mesa → crea orden en la mesa y abre la zona (`/tables?tableId=…`). Si la mesa está ocupada, puedes elegir otra disponible.
Recoger	Contactar al cliente y marcar como completado cuando entregues.

Contactar por WhatsApp: desde la fila o el detalle, abre chat con el cliente (ideal que su teléfono tenga prefijo de país).

Tiempo real

Los pedidos nuevos pueden actualizar la lista por WebSocket (store-order:created) cuando tienes la página abierta y visible. También hay notificaciones en la app que refrescan el listado.

Productos, variantes y modificadores

Solo aparecen productos con Mostrar en tienda online = Sí.
Variantes (talla, color, etc.): el cliente elige antes de agregar al carrito.
Modificadores (extras, ingredientes): se muestran en el detalle del producto y en el mensaje de WhatsApp.
Impuestos: según configuración del producto (tax_mode), el total del carrito puede incluir impuesto y envío.

Resolución de problemas

Problema	Qué revisar
La tienda no abre / error 403	Publicar tienda = Activo.
No aparecen productos	`show_online`, stock en la bodega de la tienda, categoría visible.
WhatsApp abre número equivocado	Número de WhatsApp con prefijo de país (`57…`, `56…`, etc.), solo dígitos.
No hay carrito	Funcionalidad debe ser Para tomar pedidos.
QR de mesa no asigna mesa	Mesa activa en Zonas; enlace con `table=` correcto.
Cliente no recibe respuesta	Teléfono del cliente con prefijo; revisa pedidos Pendientes en admin.

Relacionado

Pedidos online y domicilios
Inventario — productos
Zonas y pedidos
Configuración
WhatsApp Business / GridBOT (canal distinto al WhatsApp de contacto de la tienda)