Publicar productos en la web

Un producto no aparece en tu tienda en línea por el simple hecho de existir en ERPNext. Tienes que publicarlo y, además, cumplir unas cuantas condiciones para que se vea bien y se pueda comprar. Esta página te da la lista completa de requisitos, cómo agrupar productos en colecciones, cómo manejar sus fotos, y qué hacer cuando un producto «no sale» aunque juras que lo publicaste.

El interruptor principal: publish_on_web

Cada artículo (Item) de ERPNext tiene una casilla que decide si sale o no en la tienda.

1. En tu Escritorio, abre la ficha del artículo: Item → busca el producto.
2. Localiza la casilla «Publish on Web (Storefront)» (publish_on_web). Está justo debajo de la casilla Disabled.
3. Enciéndela y guarda.

Eso marca el producto como candidato a aparecer. «Candidato», porque para que realmente se vea deben cumplirse todas las condiciones de la siguiente sección.

Nota [captura: ficha de Item con la casilla «Publish on Web (Storefront)» encendida]

Importante — productos con variantes: si el producto tiene variantes (por ejemplo, tallas o colores), publica el producto plantilla. La marca de publicación se copia a sus variantes automáticamente. La tienda muestra una sola ficha con un selector de opciones; el cliente elige su variante ahí. No publiques cada variante como si fuera un producto suelto.

La lista completa: qué se necesita para que un producto salga

Para que un producto aparezca en el catálogo público, se deben cumplir todas estas condiciones a la vez (es un «y», no un «o»):

1. Publicado: publish_on_web = encendido.
2. No deshabilitado: la casilla Disabled del Item debe estar apagada. Un producto deshabilitado nunca sale, aunque esté publicado.
3. Dentro del alcance del catálogo de la tienda. Cada tienda define qué universo de productos vende con el campo «Catalog Scope» (catalog_scope) del Storefront Profile. Las opciones son:
   • price_list (por defecto): solo productos que tienen precio en la lista de precios de la tienda («Selling Price List»).
   • item_group: solo un grupo de artículos (una categoría) y sus subcategorías.
   • brand: solo una marca (Item Brand).
   • collection: solo los productos de una colección.
   • all: todos los productos publicados.

   Advertencia: con el valor por defecto (price_list), un producto publicado pero sin precio en la lista de precios de la tienda NO aparece. Esta es la causa #1 de «lo publiqué y no sale». Asegúrate de que el producto tenga un Item Price en la lista correcta.

4. No oculto por una regla per-producto. Si alguien lo marcó como oculto en los overrides (ver más abajo, hidden), no sale aunque publish_on_web esté encendido.
5. Coincide con la visibilidad de existencias. Por defecto, un producto agotado sí aparece (marcado «Agotado» y en gris). Solo desaparece si la tienda activó «Hide out-of-stock items» (hide_out_of_stock). Y si es un servicio o artículo sin inventario, solo aparece si «Show non-stock items» (show_nonstock) está encendido (lo está por defecto).

Nota: también hay filtros por grupo: «Include only these groups» (included_item_groups) y «Exclude these groups» (excluded_item_groups) en el Storefront Profile. Si usas «incluir», el catálogo se limita a esos grupos; «excluir» quita grupos aunque el alcance los abarque.

Fotos del producto

La foto principal de cada producto en la tienda es la imagen del Item (image, el campo «Image» de la ficha de ERPNext). Sube una buena foto ahí y será la que se vea en la tarjeta del catálogo y en la ficha.

• Si un producto no tiene foto, igual aparece (con un espacio sin imagen), pero convierte mucho menos. Prioriza fotografiar tus productos más vendidos.
• Para una galería con varias fotos en la ficha del producto, existe el mecanismo «Storefront Item Photo» (cada renglón: image = URL pública /files/… o https, y caption = pie de foto).

  Nota [VERIFICAR: punto exacto donde se capturan los renglones de «Storefront Item Photo» — galería adicional del producto] y si el proyecto de importación masiva de fotos por catálogo ya está disponible («función en preparación»).

Importante: las URLs de imagen deben ser públicas: una ruta /files/… de tu propio ERPNext o un enlace https limpio. Una imagen «privada» (adjunto restringido) puede no cargar para un visitante anónimo.

Ajustes por producto sin re-publicar: los overrides

A veces quieres ocultar un par de productos, destacarlos, o ponerles una etiqueta («Oferta», «Nuevo») sin andar prendiendo y apagando publish_on_web. Para eso está la tabla «Item Overrides» (item_overrides, tipo «Storefront Item Override») en la pestaña «Curación» del Storefront Profile.

Cada renglón apunta a un Item y te deja marcar:

• Hidden (hidden): oculta ese producto de la tienda aunque esté publicado. Útil para retirar algo temporalmente sin tocar su ficha.
• Featured (featured): lo marca como destacado (recibe una insignia y puede salir en el carrusel de destacados de la portada).
• Badge (badge): una etiqueta corta que aparece en la tarjeta (ej. «Oferta», «Nuevo»).

Nota: los overrides solo controlan visibilidad, destacado y etiqueta. El nombre, la descripción y el precio que ve el cliente siempre vienen del Item y de la lista de precios de ERPNext — no hay un «título web» ni un «precio web» que sobrescriba lo del ERP. Si quieres otro precio en la tienda, cambia el Item Price de la lista de la tienda.

Agrupar productos en colecciones

Una colección es un conjunto curado de productos con su propia página (/c/<slug>): «Verano», «Lo más vendido», «Compatibles premium», lo que tú decidas. Sirve para campañas y para navegación temática.

Para crear una colección:

1. En el Escritorio, ve a Storefront Collection → Nuevo.
2. Llena «Collection Name» (collection_name), por ejemplo «Verano».
3. El «Slug» (slug) se genera solo a partir del nombre (minúsculas, a-z0-9-) y forma la URL /c/verano. Puedes escribir uno propio.
4. Opcional: «Title», «Description», «Hero Image URL» (hero_image, el banner de la página), y campos de SEO («SEO Title», «SEO Description»).
5. Deja «Enabled» (enabled) encendido. Con «Display Order» (display_order) ordenas cómo se listan varias colecciones.
6. Si tienes varias vitrinas en el mismo ERPNext, el campo «Storefront» (storefront) limita la colección a una sola vitrina; vacío = todas.

Para meter un producto en la colección hay dos caminos:

• Desde el producto: en la ficha del Item, campo «Storefront Collections» (storefront_collections) — agrega ahí las colecciones a las que pertenece.
• Definiendo el alcance de una tienda por colección: una tienda entera puede ser «una colección» poniendo catalog_scope = collection y eligiendo la colección en «Scope Collection» (scope_collection).

Nota: los grupos de catálogo («Storefront Catalog Group») son otra cosa: son tus categorías de ERPNext (Item Group) que usas para navegar «por categoría» y para incluir/excluir en el alcance. Las colecciones son curaduría temática; los grupos son tu árbol de categorías.

Cuando «lo publiqué y no sale»: diagnóstico

Recorre esta lista en orden; casi siempre es uno de los primeros tres:

1. ¿El Item tiene publish_on_web encendido y está guardado?
2. ¿El Item no está Disabled?
3. Con alcance price_list (el default), ¿el producto tiene precio (Item Price) en la lista de precios de la tienda? Sin precio, no sale.
4. ¿Cae dentro del catalog_scope de la tienda? Si el alcance es un grupo/marca/colección, el producto debe pertenecer a ese conjunto. Revisa también «Exclude these groups».
5. ¿Está oculto en los Item Overrides (hidden)?
6. ¿Es un servicio o no-inventariable con show_nonstock apagado? Entonces se esconde.
7. ¿Está agotado y la tienda tiene hide_out_of_stock encendido? Entonces desaparece en lugar de mostrarse en gris.

Advertencia [VERIFICAR: retraso de índice/caché del catálogo]: el catálogo usa un índice y una caché para ir rápido. Un cambio recién guardado puede tardar un poco en reflejarse para el visitante. Si tras verificar los 7 puntos el producto sigue sin salir, puede ser caché; espera unos minutos o pide al equipo Muelle refrescar el índice del catálogo.