> For the complete documentation index, see [llms.txt](https://nextcommerce.gitbook.io/nextcommerce-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nextcommerce.gitbook.io/nextcommerce-docs/01-productos.md). # Productos La sección de **Productos** te permite gestionar todo el catálogo de tu tienda online, incluyendo la creación, edición y organización de tus productos. *** ## Resumen rápido **¿Para qué usar esta sección?** * Cargar y mantener tu catálogo de productos. * Organizar categorías, variantes, precios y filtros. * Controlar stock y listas de precios. * Exportar / importar productos y generar catálogos PDF. **Tareas típicas desde Productos:** * Crear un producto nuevo y publicarlo en la tienda. * Ajustar precios o marcar productos como oferta/nuevo/destacado. * Reordenar cómo se muestran los productos en las categorías. * Revisar y corregir inventario (stock) y visibilidad. * Preparar un catálogo PDF para mayoristas o campañas. Si es tu primera vez, te recomiendo este orden: 1. Crear categorías principales. 2. Cargar productos básicos (sin variantes). 3. Agregar variantes (talles/colores) a los productos clave. 4. Configurar inventario y listas de precios. 5. Revisar el orden del catálogo por categoría. *** ## Vista General Al acceder a la sección de Productos, verás un listado con todos los productos de tu tienda organizado en una tabla con las siguientes columnas: | Columna | Descripción | | --------------- | ---------------------------------------------- | | **Producto** | Imagen miniatura, nombre y código del producto | | **Precio** | Precio de venta de la variante principal | | **Promocional** | Precio promocional (si aplica) | | **Publicado** | Estado de visibilidad en la tienda | | **Acciones** | Botones para editar o eliminar | *** ## Funciones Principales ### Barra de Herramientas En la parte superior de la pantalla encontrarás los siguientes botones: * **🔍 Buscar**: Campo de búsqueda para encontrar productos por nombre, código o descripción * **⚙️ Filtrar**: Abre el panel lateral con filtros avanzados * **📊 Exportar**: Descarga un archivo Excel con los productos * **🔄 Sincronizar con ERP**: (Si está habilitado) Sincroniza productos con tu sistema de gestión * **↕️ Ordenar catálogo**: Permite reordenar manualmente los productos * **➕ Agregar Producto**: Crea un nuevo producto ### Filtros Avanzados Al hacer clic en **Filtrar**, se despliega un panel lateral con las siguientes opciones: * **Por Categoría**: Filtra productos de una o más categorías * **Estado de Publicación**: * Publicados * No publicados * **Stock**: * Con stock * Sin stock * Stock mínimo (define una cantidad) Los filtros activos se muestran como etiquetas debajo del buscador y pueden eliminarse individualmente o todos a la vez con "Limpiar todos". *** ## Crear Producto Para crear un nuevo producto: 1. Haz clic en **➕ Agregar Producto** 2. Completa la información en las siguientes secciones: ### Nombre y Descripción | Campo | Descripción | Requerido | | --------------- | ----------------------------------------------------- | --------- | | **Nombre** | Nombre del producto que verán los clientes | ✅ Sí | | **Código** | Código interno o SKU del producto | No | | **Descripción** | Descripción detallada con editor de texto enriquecido | No | > **💡 Tip**: El editor de descripción permite agregar texto con formato, listas, enlaces e imágenes. ### Categorías Selecciona una o más categorías donde aparecerá el producto. Haz clic en "Seleccionar categorías" para ver el árbol de categorías disponibles. ### Imágenes Sube las imágenes de tu producto: 1. Arrastra y suelta las imágenes en el área indicada, o 2. Haz clic para seleccionar archivos desde tu computadora **Características:** * Puedes subir múltiples imágenes * Reordena las imágenes arrastrándolas * La primera imagen será la imagen principal * Formatos soportados: JPG, PNG, GIF, WEBP ### Video de Producto Puedes agregar un video de YouTube al producto: 1. Ve a YouTube y copia el ID del video (la parte después de `v=` en la URL) 2. Pega solo el ID en el campo correspondiente **Ejemplo**: Si la URL es `https://www.youtube.com/watch?v=bVYXWVs0Prc`, pega solo `bVYXWVs0Prc` ### Precios Configura los precios en la sección **Pricing**: | Campo | Descripción | | ---------------------- | ------------------------------- | | **Precio** | Precio de venta regular | | **Precio Promocional** | Precio con descuento (opcional) | ### Variantes Si tu producto tiene diferentes opciones (talla, color, etc.), puedes crear variantes: 1. En la sección **Variantes**, haz clic en "Agregar propiedad" 2. Selecciona un atributo (ej: Talla, Color) 3. Selecciona las opciones disponibles (ej: S, M, L, XL) 4. El sistema creará automáticamente las combinaciones **Para cada variante puedes configurar:** * SKU específico * Precio * Precio promocional * Stock * Peso y dimensiones * Imagen de la variante ### Filtros de Producto Configura los filtros que permitirán a tus clientes encontrar el producto: 1. Haz clic en "Agregar filtro" 2. Selecciona el atributo (ej: Material, Temporada) 3. Selecciona los valores aplicables ### Tabla de Talles Si vendes ropa o calzado, puedes agregar una tabla de talles: * **Imagen**: Sube una imagen con la guía de talles * **HTML personalizado**: Crea una tabla personalizada con el editor ### Tags/Etiquetas Agrega etiquetas para mejorar la búsqueda y organización: 1. Escribe la etiqueta en el campo 2. Presiona Enter o coma para agregar 3. Las etiquetas se muestran como chips que puedes eliminar ### Más Opciones | Opción | Descripción | | ------------------------ | --------------------------------------------------------- | | **Mostrar en la tienda** | ✅ Publica el producto para que sea visible | | **Nuevo** | 🆕 Muestra etiqueta de "Nuevo" | | **Destacado** | ⭐ Aparece en secciones de destacados | | **Oferta** | 🏷️ Muestra etiqueta de oferta | | **Agotado** | ❌ Marca el producto como sin stock | | **Fecha de creación** | 📅 Modifica la fecha para alterar el orden en el catálogo | *** ## Editar Producto Para editar un producto existente: 1. En el listado, haz clic en el **nombre del producto** o en el botón **✏️ Editar** 2. Realiza los cambios necesarios 3. Haz clic en **Guardar** *** ## Eliminar Producto Para eliminar un producto: 1. Haz clic en el botón **🗑️ Eliminar** en la fila del producto 2. Confirma la eliminación en el diálogo > **⚠️ Advertencia**: Esta acción no se puede deshacer. El producto y todas sus variantes serán eliminados permanentemente. *** ## Exportar Productos Para exportar tu catálogo: 1. Haz clic en **📊 Exportar** 2. Selecciona el formato y las opciones deseadas 3. El archivo se descargará automáticamente *** ## Ordenar Catálogo La funcionalidad de **Ordenar Catálogo** te permite definir cómo se muestran los productos en cada categoría de tu tienda. ### Acceder al Ordenamiento 1. Ve a **Productos** 2. Haz clic en **↕️ Ordenar catálogo** 3. Se abrirá la pantalla de ordenamiento ### Seleccionar Categoría 1. En el selector **Categoría**, elige la categoría que deseas ordenar 2. Las subcategorías se muestran con formato jerárquico: * `Ropa` * `Ropa > Remeras` * `Ropa > Remeras > Manga Corta` 3. Los productos de esa categoría se cargarán automáticamente ### Criterios de Ordenamiento Selecciona cómo quieres ordenar los productos en el selector **Ordenar por**: | Criterio | Descripción | | ------------------------- | ----------------------------------- | | **Precio: menor a mayor** | Del más barato al más caro | | **Precio: mayor a menor** | Del más caro al más barato | | **Nombre: A → Z** | Alfabético ascendente | | **Nombre: Z → A** | Alfabético descendente | | **Más nuevo** | Productos más recientes primero | | **Más viejo** | Productos más antiguos primero | | **Orden manual** | Arrastra para personalizar el orden | ### Orden Manual (Drag & Drop) Cuando seleccionas **Orden manual**, puedes personalizar completamente el orden: 1. Selecciona "Orden manual" en el selector 2. Aparecerá un ícono de arrastre (⋮⋮) en cada producto 3. **Para reordenar:** * Haz clic y mantén presionado sobre un producto * Arrastra a la posición deseada * Suelta para confirmar 4. El número de posición (#1, #2, #3...) se actualiza automáticamente ### Reordenar Rápidamente Cuando estás en modo "Orden manual", aparece una opción especial para **reordenar productos**: 1. Verás un panel azul con la opción "Reordenar productos" 2. Selecciona un criterio base (ej: "Precio: menor a mayor") 3. Los productos se reorganizarán según ese criterio 4. Luego puedes ajustar manualmente posiciones específicas > **💡 Tip**: Esto es útil para empezar con un orden lógico y luego destacar productos específicos moviéndolos al principio. ### Vistas de Ordenamiento Puedes ver los productos en dos formatos: | Vista | Descripción | | ---------- | ---------------------------------------------------- | | **Lista** | Vista compacta en filas, ideal para muchos productos | | **Grilla** | Vista de tarjetas con imágenes más grandes | Cambia entre vistas usando los botones **Lista** y **Grilla**. ### Información Mostrada Cada producto muestra: * **#N**: Número de posición actual * **Imagen**: Miniatura del producto * **Nombre**: Nombre del producto (clickeable para editar) * **Precio**: Precio de la variante principal * **Fecha de creación**: Cuándo se creó el producto ### Guardar el Orden **¡Importante!** Los cambios NO se guardan automáticamente. 1. Realiza todos los cambios de orden que necesites 2. Haz clic en el botón **Grabar** (arriba a la derecha) 3. Espera la confirmación "Orden guardado" > **⚠️ Advertencia**: Si sales de la página sin guardar, perderás los cambios realizados. ### Carga Infinita Si la categoría tiene muchos productos: * Se cargan de a 30 productos por vez * Al hacer scroll hacia abajo, se cargan más automáticamente * El indicador "Cargando más productos..." aparece durante la carga * Cuando no hay más productos, verás "No hay más productos para mostrar" ### Ejemplos de Uso #### Destacar productos nuevos 1. Selecciona "Orden manual" 2. Usa "Reordenar" con "Más nuevo" 3. Los productos recientes quedan primero 4. Guarda #### Mostrar ofertas primero 1. Selecciona "Precio: menor a mayor" 2. Guarda 3. Los productos más económicos aparecen primero #### Orden personalizado para landing 1. Selecciona "Orden manual" 2. Arrastra los productos destacados a las primeras posiciones 3. Organiza visualmente para máximo impacto 4. Guarda ### Consideraciones * El orden se guarda **por categoría** * Cada categoría puede tener su propio criterio * Los productos en múltiples categorías pueden tener diferente orden en cada una * El orden afecta cómo se muestran en la tienda online *** ## Paginación En la parte inferior de la pantalla encontrarás controles de paginación: * Navega entre páginas con los botones de flecha * Cambia la cantidad de productos por página (10, 25, 50, 100) * Visualiza el total de productos encontrados *** ## Inventario La sección de **Inventario** te permite controlar el stock de todos tus productos en una sola vista, con filtros avanzados específicos para cantidades y estado de publicación. ### Búsqueda y filtros * **Buscar**: campo de texto para encontrar productos por nombre, código u otras referencias. * **Filtrar** (panel lateral): * **Categorías**: limitar el inventario a una o varias categorías. * **Publicación**: * Publicados * No publicados * **Stock**: * Con stock * Sin stock * Stock mínimo (ej. stock ≥ 5) * Stock máximo (ej. stock ≤ 20) Los filtros activos se muestran como chips bajo el buscador. Podés: * Quitar cada filtro individualmente con la `X`. * Usar **“Limpiar todos”** para volver a ver todo el inventario. ### Tabla de inventario Desde la tabla de inventario podés: * Ver rápidamente stock, estado de publicación y variantes. * Abrir un producto para editarlo haciendo clic en el nombre. * Revisar cuántos productos coinciden con la búsqueda y filtros aplicados. La paginación es similar a la del listado principal de productos. *** ## Listas de precios La sección de **Lista de precios** te permite revisar y preparar listas de productos pensadas para mayoristas, catálogos de venta o ajustes masivos de precios. ### Búsqueda y filtros Funciona con la misma lógica que **Inventario**: * **Buscar productos** por nombre o código. * **Filtrar** por: * Categorías * Publicados / no publicados * Con stock / sin stock * Stock mínimo / máximo De esta forma podés armar listas específicas (por categoría, por disponibilidad, etc.). ### Tabla de lista de precios En la tabla verás: * Producto y código. * Precios (incluyendo precios promocionales si existen). * Información relevante para la lista (según la configuración de la tienda). Desde aquí no se modifican los precios directamente, pero la lista es ideal como base para: * Exportar productos (ver más abajo). * Revisar coherencia de precios antes de hacer cambios masivos. *** ## Exportar e importar productos (CSV) Además del botón **📊 Exportar** del listado, existe una pantalla específica de **Exportar e importar** productos donde podés trabajar de forma masiva con un archivo `.csv`. ### Exportar productos 1. Ingresá a **Productos > Exportar e importar**. 2. En la pestaña **Exportar** verás: * El **total de productos** que se van a exportar (según los filtros aplicados). * El botón **Exportar**, que descarga un `.csv` con: * Datos del producto * Variantes * Categorías * Precios, stock, SKU, etc. 3. Opcionalmente podés activar **“Incluir descripciones”** para agregar descripción larga y textos de SEO. 4. Podés filtrar antes de exportar: * Por categoría * Publicados / no publicados * Con / sin stock * Stock mínimo Si tu tienda aún no tiene productos, la pantalla te permite descargar una **plantilla de ejemplo** para completar y luego importar. ### Importar productos En la pestaña **Importar** podés: 1. Subir un archivo `.csv` (idealmente generado desde la misma pantalla de exportación). 2. El sistema: * **Sube** el archivo. * **Valida** la información (formatos, campos obligatorios, precios, etc.). * Muestra: * Cantidad de filas totales. * Filas válidas. * Errores detectados (con número de fila y mensaje). 3. Si hay errores, podés: * Descargar el archivo, corregirlo y volver a subirlo. * Revisar el listado de errores (se muestran las primeras filas con problema). 4. Cuando no hay errores críticos, podés iniciar la **importación**: * El sistema crea nuevos productos. * Actualiza productos existentes y sus variantes en base al identificador interno. > **Recomendación**: trabajá siempre partiendo de un CSV exportado desde la propia tienda para asegurarte de respetar estructura y encabezados. *** ## Catálogo PDF La sección de **Catálogo PDF** te permite generar un catálogo descargable en PDF con tus productos, ideal para compartir por WhatsApp, email o usar offline. ### Parámetros generales En la pantalla de Catálogo PDF podés configurar: * **Título** y **subtítulo** del catálogo. * **Categorías** a incluir (se muestran en el orden en que las seleccionás). * Si querés incluir o no productos **no publicados**. * Un **stock mínimo** para filtrar productos (solo se incluyen los que tengan al menos esa cantidad). * Filtrar por **etiquetas/tags** de producto. También podés: * **Incluir productos individuales** aunque no estén en las categorías seleccionadas. * **Excluir productos específicos** que no querés que aparezcan en el PDF. ### Diseño y layout Podés elegir entre: * **Modo Páginas**: un producto por página, con foto grande y detalle. * **Modo Grilla**: varios productos por página, configurando: * Cantidad de columnas de la grilla. * Cantidad de productos por hoja. Opciones adicionales: * **Mostrar precios en el catálogo** (activar/desactivar). * **Incluir portada** con una imagen que subís o configurás por URL. ### Generación y vista previa 1. Configurá filtros, layout y portada. 2. Verificá la cantidad de productos que se van a incluir. 3. Usá **Previsualizar** para generar un PDF de ejemplo con un subconjunto de productos. 4. Cuando estés conforme, hacé clic en **Descargar PDF**. Si el catálogo es muy grande, el sistema puede sugerirte dividirlo por categorías o reducir la cantidad de productos o el peso de la portada. *** --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://nextcommerce.gitbook.io/nextcommerce-docs/01-productos.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.