Cómo funciona tu tienda en línea

Tu tienda en línea es un sitio público que se arma solo con lo que ya tienes en tu ERPNext (tu catálogo, tus precios, tu inventario). No es un catálogo aparte que tengas que copiar y mantener sincronizado: cuando publicas un producto, cambias un precio o vendes una pieza en el mostrador, la tienda en línea refleja ese mismo dato. Esta página te explica qué partes tiene, cuáles son gratis y cuáles se pagan, y de dónde sale cada cosa, para que sepas dónde tocar cuando quieras cambiar algo.

Nota: La tienda en línea es una función nueva (MVP). Varias piezas ya están en producción y otras están marcadas como «en preparación». Cuando algo dependa de una configuración que hace el equipo de Muelle (no tú desde tu Escritorio), lo señalamos.

Las dos partes: la portada gratis y el webshop de pago

Tu tienda tiene dos capas y es importante distinguirlas porque se activan por separado:

1. La portada (landing) — gratis para todos. Es tu página pública: un encabezado con tu marca, una imagen o video, tus productos destacados, tus sucursales, un formulario de contacto y tus datos (WhatsApp, dirección, horario). El cliente puede navegar tu catálogo, ver fotos, precios y disponibilidad, y contactarte. Lo que no puede hacer en esta capa es pagar en línea: es una vitrina que empuja al cliente a escribirte por WhatsApp o a visitarte.

2. El webshop (carrito + pago) — de pago, se activa aparte. Es la capa de comercio: carrito, checkout, cobro con tarjeta o efecto (Conekta / MercadoPago), cupones, envío o recoger en tienda, y el pedido queda registrado como una Sales Order (orden de venta) en tu ERPNext. Esta capa solo aparece cuando alguien la activa (ver más abajo). Si está apagada, la tienda funciona como vitrina: el cliente ve todo pero no hay botón de «Agregar al carrito» ni «Pagar».

Importante: El mismo catálogo alimenta ambas capas. No hay «productos de la vitrina» y «productos del webshop» por separado. Un producto que publicas se ve en las dos. Lo único que cambia entre una capa y otra es si el cliente puede comprarlo en línea o solo verlo y contactarte.

Una sola fuente de inventario: tu ERPNext

El principio de diseño más importante de tu tienda es este: el inventario viene directo de ERPNext, no hay una copia. Cuando la tienda dice «Disponible», «Quedan pocas» o «Agotado», está leyendo el stock real de tus almacenes en ese momento.

• Esto significa que no puedes sobrevender: si vendes la última pieza en el mostrador, la tienda la marca como «Agotado» sin que tú hagas nada.
• El checkout vuelve a verificar el stock al momento de pagar (con bloqueo de la fila), así que dos clientes no pueden llevarse la misma última pieza.
• No hay que «sincronizar» ni apretar ningún botón de actualización. El precio y la existencia que ve el cliente son los de tu ERPNext.

Los tres estados de existencia que verá el cliente son:

El umbral para «Quedan pocas» lo defines tú (por defecto, 3 piezas o menos). Se configura en dos lugares que conviven: low_stock_threshold («Low-Stock Threshold») en el Storefront Profile de esa tienda, y storefront_low_stock_threshold («Storefront Low-Stock Threshold») en Doco Business Settings como valor general.

Qué páginas tiene tu tienda

Estas son las direcciones (URLs) que un cliente puede visitar. Las que dependen del webshop están marcadas.

Nota [captura: portada de ejemplo con encabezado, hero y destacados]: la apariencia exacta (colores, tipografía, esquinas) depende de tu marca y del preset que elijas. Ver la página Editar la portada y secciones.

Los interruptores: qué prende cada cosa

Hay tres niveles de «encendido», y solo dos los tocas tú desde tu Escritorio (Desk) de ERPNext:

1. La tienda existe y tiene dominio. Que tu tienda esté publicada en una dirección de internet (tu dominio) lo configura el equipo de Muelle al dar de alta tu sitio. No es algo que actives desde tu Escritorio.

   Advertencia [VERIFICAR: nombres exactos de los flags de alta]: el alta de la tienda (dominio, secreto compartido) vive en la capa de infraestructura de Muelle (storefront_enabled, storefront_domain). Si tu tienda todavía no abre en su dirección, es un paso del equipo Muelle, no una casilla en tu Escritorio.

2. El webshop de pago (carrito + checkout). Este sí lo controlas tú con la casilla storefront_webshop_enabled («Storefront Webshop Enabled») en Doco Business Settings (sección «Utilities»). Es el interruptor autoritario: si está apagado, el checkout responde webshop_disabled y el cliente no puede pagar aunque vea todo el catálogo. Hay además una casilla webshop_enabled («Webshop Enabled (paid checkout)») dentro de cada Storefront Profile, para tiendas con varias vitrinas en un mismo ERPNext.

   Importante: activar el webshop supone que ya tienes configurada una pasarela de pago (Conekta como principal, MercadoPago como secundaria). Esa configuración de cobros vive aparte (Conekta Settings / MercadoPago Settings) y normalmente la deja lista el equipo Muelle. Prender el webshop sin pasarela deja el checkout sin forma de cobrar.

3. Qué productos aparecen. Cada producto sale en la tienda solo si lo marcas con publish_on_web («Publish on Web (Storefront)») en su ficha de Item, y además cae dentro del alcance del catálogo de tu tienda. Esto se explica a detalle en Publicar productos en la web.

Dónde administras todo: el Escritorio (Desk)

Toda la operación de la tienda vive en tu ERPNext, en un espacio de trabajo dedicado.

1. Entra a tu ERPNext (tu Escritorio / Desk).
2. Busca el espacio de trabajo «Tienda» en la barra lateral. [VERIFICAR: etiqueta exacta del workspace; se crea con la consola de administración de la tienda]
3. Ahí encuentras accesos directos a: Pedidos (tus Sales Order de la tienda), Productos (Item), Configuración (Storefront Profile), Mensajes (Storefront Lead) y Embudo (el reporte Storefront Funnel con tu analítica).

Nota: también verás tarjetas con números del mes (mensajes nuevos, eventos, embudo de conversión) tomadas de la analítica de la tienda (Storefront Event / Storefront Analytics Daily).

Qué ya funciona y qué está en preparación

• Ya en producción: portada editable (3 estilos), catálogo + búsqueda + existencia en 3 estados, ficha de producto con variantes, colecciones, sucursales con stock por tienda, captura de contacto (leads), reseñas, cuentas de cliente, y el webshop (carrito, checkout, cupones, envío/recoger) cuando está activado.
• En preparación / requiere apoyo del equipo Muelle: el alta del dominio, las pasarelas de pago, cotización de paqueterías en vivo (live_carrier_rates), surtido multi-sucursal (multi_origin_fulfillment, §18.7) y las notificaciones por WhatsApp al comprador (requieren plantillas aprobadas por Meta).

Advertencia: por ser MVP, si algo que esperas no aparece, primero revisa los tres interruptores de arriba antes de asumir una falla: (a) ¿la tienda ya abre en su dominio?, (b) ¿el webshop está activado?, (c) ¿el producto está publicado y dentro del alcance del catálogo?