La plataforma VTEX se compone de diferentes módulos, cada uno responsable de una faceta específica de la operación de la tienda. Este artículo presenta una visión general y las principales configuraciones de los siguientes módulos:
El artículo Módulos de VTEX II presenta los módulos Pagos, Pedidos, y Checkout.
Catálogo
Catálogo es el módulo de VTEX mediante el cual los retailers configuran sus productos, poniéndolos a disposición en el sitio web de la tienda. La estructura del catálogo define la experiencia de compra del cliente en la tienda online, cuando este navega por las categorías de clasificación de los productos. En la guía Catalog, los desarrolladores pueden consultar una visión general del módulo Catálogo que abarca la Catalog API.
Antes de comenzar en Catálogo
No se requieren ajustes preliminares antes de realizar configuraciones en Catálogo, no obstante, los siguientes puntos deben tenerse en cuenta:
- Navegación del cliente en el sitio web: es importante que la tienda planifique cómo quiere organizar su árbol de categorías y saber de antemano la experiencia de navegación que quiere proporcionar a los clientes en la jerarquía de categorías.
- Disponibilizar productos para clientes: para que un producto esté disponible en la tienda, después de realizar la configuración de Catálogo, el SKU debe tener un precio registrado y logística para envío. Además, el CMS de la tienda debe estar correctamente configurado.
Arquitectura de Catálogo
La arquitectura de Catálogo presenta algunos conceptos fundamentales: categoría, marca, producto, SKU (Stock Keeping Unit) y especificación. La siguiente imagen ilustra la relación entre estos conceptos:

El catálogo de la tienda debe crearse siguiendo el orden de los pasos que se indican a continuación:
- Creación del árbol de categorías.
- Registro de Marcas.
- Registro de Especificaciones.
- Importación de Productos.
- Importación de SKUs.
La siguiente tabla muestra los principales ajustes de Catálogo para la tienda, según el orden de creación:
Puedes obtener información detallada sobre la importación de productos a la plataforma VTEX desde un sistema ERP (Enterprise Resource Planning) o PIM (Product Information Manager) consultando el artículo Integraciones de backend.
Árbol de categorías
El árbol de categorías define la estructura básica del catálogo. Las categorías actúan como niveles jerárquicos de clasificación de productos, simplificando la búsqueda del cliente y manteniendo el catálogo de la tienda organizado.
Recomendamos crear una jerarquía de hasta tres niveles, incluyendo Departamentos, Categorías y Subcategorias. Sin embargo, algunas tiendas pueden beneficiarse de una estructura de solamente dos niveles, con departamentos y categorías. Esto depende de la complejidad de la operación y de los tipos de productos ofrecidos.
Ejemplo: Departamento Femenino
, Categoría Blusas y camisas
y Subcategoría Camisetas
.
Antes de importar el catálogo de la tienda a VTEX, recomendamos empezar a trabajar en el árbol de categorías creando una tabla como la que se ilustra a continuación. Esto facilita la visualización de la estructura del árbol y la presentación de las especificaciones.

En el artículo Integraciones de backend puedes consultar más información sobre cómo importar especificaciones para back office.
Marcas
Las Marcas identifican a la empresa que crea o revende productos. En VTEX, las marcas deben registrarse de forma independiente, y al crear un producto, es obligatorio asociarlo a una marca ya registrada en la tienda.
Especificaciones
Las especificaciones son propiedades adicionales que se pueden asignar a los productos y SKU de la tienda, como tamaño, color, voltaje o material. Es decir, existen especificações de producto y especificaciones de SKU.
En el Catálogo de VTEX, las especificaciones se crean en el siguiente orden:
- Grupos de especificaciones: son agregadores de campos de especificación. Deben estar asociados a categorías. Es habitual que solo se cree un grupo a nivel raíz y que todos los campos de especificación se asocien a este grupo.
- Campos de especificación: son los campos que contendrán información adicional del producto y SKU. Deben estar asociados a categorías y grupos de especificaciones.
- Valores de especificación: son valores que puedes agregar a campos de especificación.
Las especificaciones siguen la jerarquía del catálogo, por lo que cuando se crea uno de estos grupos en un departamento o categoría, se reproduce en los niveles inferiores.
Productos
El Producto es el nivel de organización del catálogo que se encuentra en la jerarquía por debajo de las categorías y por encima de los SKU. Como el producto está por encima del SKU en la jerarquía del catálogo, podemos entenderlo como una definición genérica de los ítems que se venden en tu tienda. Un producto debe tener obligatoriamente al menos un SKU asociado.
SKUs
El SKU (Stock Keeping Unit) es una variación del producto y representa la unidad física en stock que adquiere el cliente. Además, representa el último nivel en la organización de un catálogo, y para que esté activo requiere contar con una imagen y que sus especificaciones estén completas.
Ajustes opcionales de Catálogo
La siguiente tabla muestra los ajustes opcionales de Catálogo en VTEX:
Funcionalidad | Descripción | Más información |
---|---|---|
Colecciones | Una colección es la agrupación de dos o más productos que pueden compartir o no características específicas. Se pueden crear colecciones para asociar productos en función de diversos criterios, como fechas conmemorativas, lanzamientos o productos más vendidos. | Help Center - Colecciones - Definición del concepto - Registrar colecciones (beta) Developer Portal - Create Collection - Get All Inactive Collections - Get All Collections - Get Collections by search terms - Import File Example - Add products to Collection by imported file |
Anexos | Un anexo es una personalización opcional y gratuita del producto que se utiliza para añadir información a un SKU. | Help Center - Registrar un anexo - Cómo crear un anexo de suscripción - ¿Qué es un anexo? Developer Portal - Catalog API - Attachment - Catalog API - SKU attachment |
Assembly Options | Assembly Options es un tipo de anexo para casos complejos, como la personalización de productos, en los que es necesario gestionar diferentes combinaciones de productos, cantidad, ítems adicionales, costos y stock, y mostrar estas opciones en la página de producto. | Developer Portal - Assembly Options - Assembly Option App |
Servicios | Servicio con costo adicional que puede ofrecerse con un producto como opcional. Se utiliza para agregar un servicio adicional a un SKU, como embalaje para regalo, personalización o acuerdos de garantía especial. | Help Center - ¿Qué es un servicio? - Gestión de servicios - Importación de servicios - Informe de servicios - Programación de servicios Developer Portal - Catalog API - SKU service - Catalog API - SKU service attachment - Catalog API - SKU service type - Catalog API - SKU service value |
Kits | Un kit es un conjunto de SKU que se venden juntos, es decir, un SKU compuesto por uno o más SKU. | Help Center - ¿Qué es un kit? - Registrar kit Developer Portal - Catalog API - SKU Kit |
Precios
Precios es el módulo de VTEX responsable de crear, editar y almacenar los datos de precios de los SKU de la tienda. Para que un producto se venda, el cliente necesita saber cuánto cuesta cada ítem mostrado en la tienda. El módulo Precios tiene funcionalidades que permiten el uso de diferentes estrategias de precios en tu negocio.
Antes de comenzar en Precios
Antes de configurar los precios de la tienda, hay que registrar en Catálogo los productos que se venderán. El catálogo de la tienda debe contener categorias, marcas, productos y SKUs activos. Si el registro del catálogo se realizó mediante una integración con un sistema ERP, es muy importante confirmar que la información esté correcta antes de continuar.
Cómo funciona el módulo Precios
En la siguiente tabla se presentan los principales términos relacionados con el módulo:
Término | Definición |
---|---|
Precios | Información de los valores de venta de los SKU de la tienda. |
Tablas de precios | Conjunto de precios de los SKU que se pueden aplicar en un determinado contexto, como una política comercial. Las tablas almacenan la información de los precios que se muestran en el storefront de la tienda. |
Precio de costo | Precio pagado por la tienda para adquirir el SKU. |
Markup | Margen de beneficio que la tienda desea obtener con la venta del SKU. |
Precio base | Valor calculado al combinar el precio de costo y el markup. Este es el precio de referencia de un SKU en todas las tablas de precios. |
Precio de lista | Precio de venta sugerido para un SKU. Este precio se mostrará en la página de producto como el precio De, mientras que el precio base será el precio Por. |
Regla de precio | Modifica el precio de un SKU en una sola tabla de precios sin cambiar el precio base en las demás. Para que funcione, se debe registrar una regla de precio asociada a la tabla deseada. |
Precio fijo | Precio con prioridad sobre todas las demás configuraciones de precios presentes en una tabla de precios. |
Redondeo de precios | Estrategia de precios que se basa en el redondeo de precios. El objetivo de este método es influenciar la decisión de compra del consumidor al mostrar precios en un formato más fácil e intuitivo. |
Bloqueo de precio | Determina las variaciones máximas y mínimas del precio de un ítem. Esta funcionalidad garantiza que los precios de los SKU no cambien a valores indeseados. |
Puedes consultar más información sobre la arquitectura de precios en el artículo Arquitectura del sistema de precios.
Registrar tabla de precios
La arquitectura del módulo Precios se basa en tres conceptos fundamentales:
- Precios
- Tablas de precios
- Contextos de aplicación de las tablas de precios
Los precios son la información del valor de venta de tus SKU. Estos precios se almacenan en tablas de precios. A su vez, estas tablas de precios pueden aplicarse a distintos contextos.
La relación entre los precios, la tabla de precios y el contexto que se aplicará se muestra en la siguiente imagen:

Puedes registrar tablas de precios para los SKU de la tienda de tres maneras:
Los precios se pueden programar para eventos especiales, como se describe en el artículo Programación de precios.
Relación entre tablas de precios y políticas comerciales
Existe una diferencia entre las tablas de precios creadas para políticas comerciales y las creadas para otros contextos.
Las listas de precios no asociadas a políticas comerciales pueden utilizarse en contextos como promociones y clústeres de clientes. Las tablas creadas para políticas comerciales solo pueden asociarse a la propia política comercial. Así, la tabla de precios asociada a una política comercial informa el precio de los SKU de esa política y no puede asociarse a otros contextos.
Los conceptos de tabla de precios y política comercial son diferentes. La política comercial es el contexto al que se asocia una tabla de precios.
A la hora de configurar una política comercial, es imprescindible especificar la moneda que se utilizará en la tienda. La creación de diferentes políticas comerciales, cada una asociada a una moneda distinta, permite a la tienda mostrar a los clientes los precios en diferentes monedas.
Promociones
En VTEX, el retailer puede crear un conjunto de reglas para indicar si los clientes pueden recibir descuentos aplicados en ciertos contextos de compra. Promociones es el módulo de VTEX responsable de crear, editar y aplicar descuentos en el carrito de compra del cliente.
Antes de comenzar en Promociones
Antes de configurar las promociones de tu tienda, es necesario registrar el Catálogo con los productos que se venderán y establecer lo precios de los SKU.
Cómo funciona el módulo Promociones
Consulta en la tabla a continuación los principales términos utilizados en este contexto:
Término | Definición |
---|---|
Promoción | Descuento concedido al cliente, que puede estar asociado a uno o varios productos del carrito, a un envío o a un regalo. |
Cupón | Código promocional, formado por una secuencia de letras y números. Los cupones están asociados a promociones aplicadas al valor total del carrito. Así, al ingresar un código de cupón válido en el momento de la compra, el cliente puede obtener descuentos sobre el valor del pedido. |
Audiencia de campañas | La Audiencia de campañas es una funcionalidad que permite definir el público objetivo para una promoción. La funcionalidad consiste en crear criterios de segmentación de clientes. A partir de estos criterios, la plataforma VTEX comprueba automáticamente si los clientes son elegibles para una determinada audiencia de campañas, y en consecuencia, para las promociones de campaña asociadas. |
Promoción de campaña | La promoción de campaña siempre está vinculada a una audiencia de campaña, es decir, a un público objetivo específico. Este tipo de promoción solo se aplicará al público objetivo definido en la campaña. |
Crear promociones
En VTEX, el retailer puede crear una serie de reglas que, según el contexto de la compra, determinan si se aplicará el descuento y cómo. Entre los parámetros considerados en estas reglas se encuentran: listas de productos, listas de clientes, rangos de códigos postales, valor mínimo de los ítems en el carrito, entre otros.
Los descuentos son, principalmente, de dos tipos:
- Nominal: descuento de un valor bruto, como $20.
- Porcentual: descuento de un valor porcentual, como el 10 % del valor total del carrito.
Hay seis tipos diferentes de promociones, cada una relacionada con un escenario distinto:
Tipo de promoción | Definición |
---|---|
Regular | Promoción que permite a la tienda ofrecer descuentos de forma flexible, combinando múltiples condiciones, restricciones y beneficios. |
Comprar Juntos | Promoción utilizada para conceder descuentos en productos cuando se agregan juntos al carrito. El descuento puede aplicarse a ambos productos. También existe la opción de que el descuento solo se aplique si se añade al carrito una determinada cantidad de uno de los productos. |
Más Por Menos | Promoción utilizada para conceder un descuento cuando el cliente añade al carrito varias unidades del mismo producto. |
Descuento Progresivo | Promoción utilizada cuando se desea ofrecer un descuento porcentual a un determinado número de productos del carrito. |
Compra uno y lleva uno gratis | Promoción utilizada para ofrecer envío gratis o un regalo si se compra un determinado producto. |
Promoción de campaña | Promoción que está siempre vinculada a una audiencia de campaña, es decir, a un público objetivo específico. |
Para todas las promociones puede establecerse un periodo de validez, así como restricciones y limitaciones de uso. Las promociones también pueden programarse para eventos especiales, como se describe en el artículo Programación de funcionalidades para eventos especiales.
Consulta más información sobre las posibilidades de aplicar promociones en el artículo Ejemplos de promociones.
Crear cupones
Puedes crear cupones de descuento en el Admin VTEX o a través de API. Para utilizarlo, el cupón debe estar vinculado al menos a una promoción.
Hay una cantidad limitada de cupones activos. Se recomienda encarecidamente la reutilización de los cupones, ya que un exceso de estos podría afectar el desempeño del módulo Promociones.
Crear promociones de campaña
Antes de crear una promoción de campaña se debe crear una audiencia de campaña para definir el público objetivo de la promoción. A partir de los criterios definidos por el retailer pueden seleccionarse segmentos de clientes elegibles para la promoción, los cuales actúan como activadores.
Una vez creada la audiencia de campaña, es necesario asociarla a una Promoción Regular, ccreando así una promoción de campaña. Este tipo de promoción engloba todas las posibilidades presentes en la Promoción Regular y las siguientes opciones adicionales:
- Público objetivo específico.
- Envío gratis para todos los envíos disponibles.
- Tabla de precios promocionales.
- Regalo entregado por sellers.
Destacar promociones en la página del producto
Para destacar una promoción en la página del producto (PDP) sigue los pasos que se indican a continuación:
- Crea una promoción de cualquier tipo, a excepción de Comprar juntos.
- Activa el campo Promoción resaltada en el formulario de promoción.
- Guarda la promoción.
- En el CMS Legado, ingresa el control de visualización de la promoción en el template:
<vtex.cmc:discountHightLight/>
.
Sincronización de fechas de promoción, banners y activos digitales
Es importante garantizar una coordinación perfecta al sincronizar la línea de tiempo de las promociones con las fechas de entrega de banners y activos digitales. Para hacerlo, debes comprobar las fechas de las promociones y los banners. Esta alineación estratégica garantiza que las campañas promocionales se apoyen en material visual relevante, maximizando su impacto y eficacia.
Logística
En VTEX, el módulo Logística es el responsable de la logística y fulfillment de los pedidos de la tienda, incluyendo la planificación, el transporte, el almacenamiento de los productos y el envío de los pedidos a los clientes.
Antes de comenzar en Logística
Para realizar los ajustes de logística, deben haberse completado los siguientes pasos:
- Registrar catálogo: como la realización de pedidos está relacionada con el almacenamiento de ítems, los productos y SKU de la tienda deben estar registrados en el Catálogo.
- Configurar política comercial: las políticas comerciales moldean la experiencia del cliente en el sitio web de una tienda, segmentando desde las condiciones de venta para cada público, hasta los productos ofrecidos, precios, promociones y métodos de envío.
Además, si el modelo de negocio incluye tiendas internacionales y ventas cross-border, es importante determinar previamente cuál sería el modelo de arquitetura de la tienda.
Ajustes obligatorios en Logística
El conjunto de configuraciones esenciales de logística para una tienda VTEX se denomina Estrategia de envío, y se compone de tres conceptos principales: política de envío, almacén y muelle.
- Política de envío: conjunto de reglas que definen las opciones y condiciones de envío del pedido.
- Muelle: local de distribución de los ítems vendidos.
- Almacén: espacio físico donde se almacenan los productos a la venta.
La imagen siguiente muestra cómo se relacionan estos conceptos en la venta de un producto:

La siguiente tabla muestra los principales ajustes de logística de la tienda VTEX:
Recomendamos en primer lugar configurar la política de envío, en segundo lugar el muelle y, finalmente, el almacén.
Tema | Configuración en el Admin VTEX | Configuración por API |
---|---|---|
Políticas de envío | Política de Envío | Create shipping policy |
Muelle | Gestionar el muelle | Create/update dock |
Almacén | Gestionar almacenes | Create/update warehouse |
Stock | Gestión del stock | Update inventory by SKU and warehouse |
Política de envío
La Política de envio es un conjunto de reglas que definen las opciones y condiciones de envío que se presentarán a los clientes en el checkout. Las condiciones de envío incluyen transportadora, plazos y valor del envío. La política de envío se vincula al almacén a través del muelle.
La transportadora responsable del envío del pedido viene determinada por la política de envío. En primer lugar, deben registrarse las transportadoras en la plantilla de envío, después, esta plantilla de envío se asocia cuando se crea una política de envío.
Muelle
El muelle es el lugar desde el que se distribuyen y envían los ítems, el punto intermedio entre el almacén y las transportadoras. El muelle integra el almacén, la política comercial y la política de envío. Algunos de los casos de uso son:
- Centros de distribución diferentes para un único almacén.
- Muelle como centro de distribución.
- Muelle y stock corresponden al mismo espacio físico.
Para determinados productos, puede no ser necesario un espacio físico de distribución. Aun así, para el correcto funcionamiento de las operaciones de la plataforma VTEX hay que configurar el muelle obligatoriamente.
Almacén
La ruta logística se inicia en el almacén, que es el espacio físico de almacenamiento para los productos que vende la tienda. Cuando los ítems vendidos se alistan en el almacén, se envían al muelle de carga.
Gestión del stock
El stock de la tienda corresponde a los ítems almacenados que están disponibles para la venta. El almacén es la identificación de la ubicación física de almacenamiento, mientras que el stock es el conjunto de SKU disponibles para la venta.
En VTEX, la actualización del stock una vez vendidos los ítems debe ser controlada por la propia tienda. De esta forma, tras la venta, el retailer garantiza un control de la cantidad de ítems restantes y de las operaciones de facturación con ERP. En el artículo Integraciones de backend puedes consultar más información sobre cómo importar stock a través del back office.
Lead time
En el Admin VTEX, en Catálogo > Stock > Gestión de stock, hay una configuración opcional denominada Lead time, que permite asignar un plazo de envío a nivel de SKU. Configurar el lead time significa añadir un periodo de tiempo al cálculo de envío del pedido, lo que resulta estratégico en algunos contextos.
Entre los principales casos de uso, podemos mencionar productos de proveedores externos, escenarios de dropshipping y venta de ítems personalizables. Configurar el lead time brinda mayor flexibilidad para definir los plazos de procesamiento y envío del producto por terceros.
Cálculo de envío de pedidos
Para realizar el cálculo de envio de los pedidos, la plataforma VTEX considera las siguientes configuraciones:

- Lead time: cantidad de tiempo configurable para el SKU de un almacén. Esta configuración es opcional y se establece en cero días de forma predeterminada.
- Tiempo de almacén: tiempo que tarda el SKU en pasar del almacén al muelle. Esta configuración es obligatoria, pero el tiempo puede establecerse en cero.
- Tiempo de muelle: tiempo que tarda el SKU en salir del muelle para ser enviado al cliente. Esta configuración es obligatoria, pero el tiempo puede establecerse en cero.
- Política de envío: agrupa las reglas y condiciones de envío que se presentan a los clientes en el checkout, incluyendo transportadoras, valor del envío, horarios de funcionamiento de las transportadoras, las ventanas de entrega y la capacidad de entrega.
El simulador de envío permite al retailer simular y analizar las opciones de entrega disponibles para un pedido en una ubicación. La simulación comprueba la viabilidad y las condiciones de envío del pedido, como disponibilidad de los ítems, métodos de envío, costos y plazos.
Ajustes opcionales de Logística
Para adaptarse a los distintos modelos de negocio, la plataforma VTEX ofrece una serie de ajustes opcionales, como se muestra en la tabla a continuación:
Funcionalidad | Descripción |
---|---|
Puntos de recogida | Los puntos de recogida son ubicaciones físicas que la tienda ha establecido para que los clientes recojan sus pedidos. Configurar puntos de recogida es una buena opción para las operaciones omnichannel, especialmente cuando hay un gran número de tiendas físicas, ya que cada tienda física puede convertirse en una opción para que el cliente recoja su pedido, aumentando la versatilidad de su red logística. |
Feriados | La funcionalidad Feriados permite a la tienda establecer días en los que no se procesan envíos, y esto se tiene en cuenta al calcular el tiempo de envío del pedido. |
Reserva | La reserva es una solución VTEX que impide que un mismo ítem se venda más de una vez. Cuando el cliente simplemente añade un producto al carrito, no se genera una reserva; su prioridad sobre el ítem solo se activa al finalizar la compra. |
Capacidad de entrega | La Capacidad de entrega es el límite de envíos que puede realizar la tienda en un periodo determinado. Poder delimitar el número de ítems o pedidos que se pueden enviar en cada ventana de envío significa tener más control sobre la preparación de los pedidos y aumentar las posibilidades de cumplir la promesa de entrega establecida con el cliente en el checkout. |
Geolocalización | La Geolocalización es el registro de las ubicaciones de entrega a partir de la latitud y la longitud de las direcciones. Esta funcionalidad es muy utilizada en direcciones de zonas rurales e industriales (donde hay división por terrenos) o en zonas de riesgo, cuando es necesario eliminar ciertos lugares de entrega dentro de una región. |
Consulta más información sobre conceptos logísticos en VTEX en el artículo Glosario de logística, también ponemos a disposición contenido específico para desarrolladores sobre la Logistics API en el artículo Fulfillment and Logistics.