A plataforma VTEX se organiza em diferentes módulos, cada um deles responsável por uma parte da operação da loja. Este artigo apresenta uma visão geral e principais configurações dos seguintes módulos:

• Catálogo
• Preços
• Promoções
• Logística

O artigo Módulos da VTEX II apresenta os módulos Pagamentos, Pedidos, e Checkout.

Catálogo é o módulo da VTEX onde lojistas configuram produtos para torná-los disponíveis no site da loja. É a estrutura do catálogo que define a experiência de compra dos clientes no ecommerce ao navegar nas categorias de classificação dos produtos. Uma visão geral de Catálogo para desenvolvedores sobre a Catalog API pode ser encontrada no guia Catalog.

Não existem configurações prévias que devam ser realizadas antes das configurações no Catálogo, mas vale ressaltar os seguintes pontos de atenção:

• Navegação do cliente no site: é importante que a loja planeje como deseja organizar sua árvore de categorias e saber de antemão qual experiência de navegação deseja promover aos clientes na hierarquia de categorias.
• Tornar produtos disponíveis para clientes: para disponibilizar um produto na loja, após as configurações de Catálogo, é preciso que o SKU tenha preço cadastrado e logística para envio. Além disso, o CMS da loja precisa estar configurado corretamente.

A arquitetura do Catálogo apresenta alguns conceitos fundamentais: categoria, marca, produto, SKU (Stock Keeping Unit) e especificação. A imagem abaixo ilustra a relação entre esses conceitos:

O catálogo da loja deve ser criado seguindo a ordem dos passos abaixo:

1. Criação da árvore de categorias.
2. Cadastro de Marcas.
3. Cadastro de Especificações.
4. Importação de Produtos.
5. Importação de SKUs.

A tabela a seguir apresenta as principais configurações de Catálogo da loja, conforme a ordem de criação:

Assunto	Configuração via Admin VTEX	Configuração via API
1. Árvore de categorias	Cadastrar uma Categoria	- Categories - Create Category
2. Marcas	Cadastrar marcas	- Brands - Create Brand
3.1. Especificações de produto	Cadastrar especificações ou campos de produto	- Product specifications - Create Specification
3.2. Especificações de SKU	Cadastrar especificações ou campos de SKU	- SKU specifications - Create Specification
4. Produtos	Cadastrar produtos	- Products - Create Product with Category and Brand
5. SKUs	Preencher campos de cadastro de SKU	- SKUs - Create SKU

Para saber como importar produtos de um sistema ERP (Enterprise Resource Planning) ou PIM (Product Information Manager) para a plataforma VTEX, veja o artigo Integrações de backend.

Árvore de categorias

A árvore de categorias é a definição da estrutura base do Catálogo. As categorias atuam como níveis hierárquicos de classificação de produtos, simplificando a busca do cliente e mantendo o catálogo da loja organizado.

Recomendamos a criação de uma hierarquia de até três níveis, incluindo Departamento, Categorias e Subcategorias. No entanto, algumas lojas podem se beneficiar de uma estrutura mais simples de dois níveis, com Departamentos e Categorias. Isso depende da complexidade da operação e tipos de produtos oferecidos.

Exemplo: Departamento Feminino, Categoria Blusas e camisas e Subcategoria Camisetas.

Antes de importar o catálogo da loja para a VTEX, recomendamos começar a trabalhar na árvore de categorias criando uma tabela como a ilustrada abaixo. Isto permite uma melhor visualização de como a árvore está organizada e como as especificações serão apresentadas.

Informações sobre como importar especificações para back-office podem ser encontradas no artigo Integrações de backend.

Marcas

Marcas geralmente identificam a empresa que cria ou revende um ou mais produtos. Na VTEX, é necessário cadastrar as marcas de maneira independente e, ao criar um produto, é obrigatório associá-lo a uma marca já cadastrada na loja.

Especificações

Especificações são propriedades adicionais que podem ser atribuídas a produtos e SKUs da loja, como por exemplo, tamanho, cor, voltagem ou material. Ou seja, existem especificações de produto e especificações de SKU.

No Catálogo da VTEX, as especificações são criadas na seguinte ordem:

1. Grupos de especificações: são agregadores de campos de especificação. Devem ser atribuídos a categorias. É comum apenas um grupo ser criado no nível raiz e todos os campos de especificação serem associados a este grupo.
2. Campos de especificação: são os campos que irão possuir as informações adicionais de produtos e SKUs. Devem ser atribuídos a categorias e grupos de especificações.
3. Valores de especificação: são valores de escolha atribuídos aos campos de especificação.

As especificações seguem a hierarquia do Catálogo, então quando um desses grupos é criado em um Departamento ou Categoria, ele é herdado nos níveis abaixo.

Produtos

O Produto é o nível da organização do catálogo que se localiza na hierarquia abaixo das Categorias e acima dos SKUs. Como o produto está acima do SKU na hierarquia do catálogo, podemos entendê-lo como uma definição genérica dos itens que são vendidos em sua loja. É obrigatório que um produto tenha pelo menos um SKU associado a ele.

SKUs

SKU (Stock Keeping Unit) é uma variação do produto e representa a unidade física em estoque que é adquirida pelo cliente. O SKU é o último nível na organização de um catálogo e, para ficar ativo, é necessário que o SKU tenha uma imagem e especificações preenchidas.

A tabela a seguir apresenta outras configurações opcionais de Catálogo na VTEX:

Funcionalidade	Descrição	Saiba mais
Coleções	Uma coleção representa o agrupamento de dois ou mais produtos que podem ou não compartilhar características específicas. As coleções podem ser criadas com o propósito de associar produtos com base em critérios diversos, como datas comemorativas, lançamentos ou produtos mais vendidos.	Help Center - Coleções - Definição de conceito - Cadastrar Coleções (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	Um anexo é uma customização opcional e gratuita do produto, usada para adicionar informações a um SKU.	Help Center - Cadastrar um anexo - Como criar um anexo de assinatura - O que é um Anexo? Developer Portal - Catalog API - Attachment - Catalog API - SKU attachment
Assembly Options	Assembly Options é um tipo de anexo para casos complexos, como personalização de produtos, no qual você precisa gerenciar diferentes combinações de produtos, quantidade, itens adicionais, custos e estoque, e exibir essas opções na página do produto.	Developer Portal - Assembly Options - Assembly Option App
Serviços	Serviço com custo extra que pode ser oferecido com um produto de forma opcional. Ele é usado para atribuir um serviço adicional a um SKU, como embalagem de presente, personalização ou acordos de garantia especial.	Help Center - O que é um Serviço? - Gerenciamento de Serviços - Importação de Serviços - Relatório de Serviços - Agendamento de Serviços Developer Portal - Catalog API - SKU service - Catalog API - SKU service attachment - Catalog API - SKU service type - Catalog API - SKU service value
Kits	Um kit é um conjunto de SKUs que são vendidos juntos, ou seja, um SKU composto por um ou mais SKUs.	Help Center - O que é um kit? - Cadastrar kit Developer Portal - Catalog API - SKU Kit

Preços é o módulo da VTEX responsável pela criação, edição e armazenamento dos dados de preços dos SKUs da loja. Para que um produto seja vendido, o cliente precisa saber quanto custa cada item exibido na loja. O módulo de preços possui funcionalidades que permitem o uso de diferentes estratégias de precificação no seu negócio.

Antes de configurar os preços da loja, é necessário cadastrar o Catálogo com os produtos que serão vendidos. O catálogo da loja deve conter categorias, marcas, produtos e SKUs já cadastrados e ativos. Caso o cadastro do catálogo tenha sido realizado pela integração com um sistema ERP, é essencial checar se as informações estão corretas antes de prosseguir.

É importante conhecer os principais termos relacionado ao módulo, eles são apresentados na tabela a seguir:

Termo	Definição
Preços	Informações dos valores de venda dos SKUs da loja.
Tabelas de preços	Conjunto de preços de SKUs que pode ser aplicado a um determinado contexto, como a uma política comercial. Essas tabelas guardam as informações dos preços que são exibidos no storefront da loja.
Preço de custo	Preço que foi pago pela loja para adquirir o SKU.
Markup	Margem de lucro desejada pela loja com a venda do SKU.
Preço base	Valor calculado através da combinação entre o preço de custo e o markup. É o preço de referência do SKU para todas as tabelas de preço.
Preço de lista	Preço de venda sugerido para um SKU. Este preço será exibido na página de produto como o preço De e o preço base funciona como o preço Por.
Regra de preço	Altera o preço de um SKU para apenas uma tabela de preço sem alterar o preço base das demais. Para isso, é necessário cadastrar uma regra de preço associada à tabela desejada.
Preço fixo	Preço que se sobrepõe a todas as outras configurações de preços existentes numa tabela de preços.
Arredondamento de preços	Estratégia de precificação que se baseia no arredondamento de preços. Este método tem como objetivo influenciar a decisão de compra do consumidor ao exibir preços com um formato mais amigável e intuitivo.
Trava de preço	Configura as variações máximas e mínimas do preço de um item. Esta funcionalidade garante que os preços dos SKUs não sejam alterados para valores indesejados.

Mais informações sobre a arquitetura de preços podem ser encontradas no artigo Arquitetura do sistema de preços.

A arquitetura do módulo Preços é organizada a partir de três conceitos fundamentais:

• Preços
• Tabelas de preços
• Contextos de aplicação das tabelas de preços

Os preços são as informações dos valores de venda dos seus SKUs. Estes preços são armazenados em tabelas de preços. Por sua vez, estas tabelas de preços podem ser aplicadas a diferentes contextos.

O relacionamento entre preços, tabela de preço e o contexto que será aplicado está representado na imagem abaixo:

É possível cadastrar tabelas de preços para os SKUs da loja de três maneiras:

• Via Admin VTEX
• Via planilha
• Via API

Preços podem ser agendados para eventos especiais, como descrito no artigo Agendar preço.

Há uma diferença entre as tabelas de preços criadas para políticas comerciais e tabelas de preços criadas para outros contextos.

As tabelas de preços não associadas a políticas comerciais podem ser usadas em contextos como promoções e clusters de clientes. As tabelas criadas para políticas comerciais só podem ser associadas à própria política comercial. Assim, a tabela de preço associada a uma política comercial informa o preço dos SKUs para esta política e não pode ser associada a outros contextos.

Os conceitos de tabela de preços e política comercial são diferentes. A política comercial é o contexto ao qual uma tabela de preços é associada.

Ao configurar uma política comercial, é essencial especificar a moeda que será utilizada na loja. A criação de políticas comerciais distintas, cada uma associada a uma moeda diferente, possibilita à loja exibir preços em diversas moedas para os clientes.

Na VTEX, o lojista pode criar uma série de regras para determinar se os clientes podem ter descontos em certos contextos de compra e esses descontos devem ser aplicados. Promoções é o módulo VTEX responsável pela criação, edição e aplicação de descontos no carrinho de compras de clientes.

Antes de configurar as promoções da loja, é necessário cadastrar o Catálogo com os produtos que serão vendidos e estabelecer os preços dos SKUs na loja.

Neste contexto, é importante conhecer os principais termos utilizados, conforme apresentado na tabela abaixo:

Termo	Definição
Promoção	Desconto concedido ao cliente, podendo estar associado a um ou mais produtos do carrinho, ou ainda ao frete ou a um brinde.
Cupom	Código promocional, composto de uma sequência de letras e números. Os cupons são associados a promoções sobre o valor do carrinho. Assim, ao informar o código de um cupom válido no momento da compra, o cliente pode obter descontos sobre o valor do pedido.
Audiência de campanha	Audiência de campanha é uma funcionalidade que permite definir o público-alvo para uma promoção. A funcionalidade consiste em criar critérios para segmentar clientes. A partir desses critérios, a plataforma VTEX valida automaticamente se os clientes são elegíveis a uma determinada audiência de campanha e, consequentemente, às promoções de campanha associadas.
Promoção de campanha	A promoção de campanha é sempre atrelada a uma audiência de campanha, ou seja, um público alvo específico. Uma promoção desse tipo será aplicada somente para o público-alvo definido na campanha.

Na VTEX, o lojista pode criar uma série de regras que, de acordo com o contexto da compra, determinam se e como o desconto será aplicado. Entre os parâmetros considerados por essas regras, estão: listas de produtos, listas de clientes, intervalos de CEP, valor mínimo de itens no carrinho, entre outros.

Os descontos podem ser de dois tipos principais:

• Nominal: desconto de um valor bruto, como R$ 20.
• Percentual: desconto de um valor percentual, como 10% do valor total do carrinho.

Há seis tipos diferentes de promoções, cada uma relacionada a um cenário diferente:

Tipo de promoção	Definição
Promoção Regular	Promoção que permite à loja oferecer descontos de forma flexível, combinando múltiplas condições, restrições e benefícios.
Compre Junto	Promoção utilizada para conceder desconto para produtos quando colocados ao mesmo tempo no carrinho. O desconto pode ser aplicado em ambos os produtos. Ainda há a opção de o desconto ser aplicado apenas se for inserida no carrinho uma determinada quantidade de um dos produtos.
Leve Mais Por Menos	Promoção usada para conceder desconto quando o cliente adiciona várias unidades do mesmo produto ao carrinho.
Desconto Progressivo	Promoção utilizada quando se deseja oferecer um percentual de desconto para determinada quantidade de produtos inseridos no carrinho.
Compre e Ganhe	Promoção utilizada para oferecer frete grátis ou um brinde caso determinado produto seja comprado.
Promoção de Campanha	Promoção que é sempre atrelada a uma audiência de campanha, ou seja, a um público alvo específico.

Para todas as promoções, é possível definir um período de validade, além de restrições e limitações de uso. Promoções também podem ser agendadas para eventos especiais, como descrito no artigo Agendamento para eventos especiais.

Mais informações sobre possibilidades de aplicação de promoções podem ser conferidas no artigo Exemplos de promoção.

É possível criar cupons de desconto pelo Admin VTEX ou por API. Para ser utilizado, um cupom precisa estar vinculado a pelo menos uma promoção.

Há uma quantidade limitada de cupons ativos. A reutilização de cupons é altamente recomendada, uma vez que um grande número de cupons pode comprometer o desempenho do módulo de Promoções.

Antes de criar uma promoção de campanha, é necessário criar uma audiência de campanha para definir o público alvo da promoção. Assim, é possível selecionar segmentos de clientes elegíveis na promoção, que funcionam como gatilho, a partir dos critérios definidos pelo lojista.

Uma vez que a audiência de campanha foi criada, é preciso associá-la a uma Promoção Regular, criando assim uma promoção de campanha. Esse tipo de promoção engloba todas as possibilidades presentes na Promoção Regular e algumas opções a mais, que são:

• Público-alvo específico.
• Frete grátis para todos os fretes disponíveis.
• Tabela de preços promocionais.
• Brinde entregue por sellers.

É possível dar destaque a uma promoção na página do produto (PDP). Para isso, basta seguir as passos abaixo:

1. Crie uma promoção de qualquer tipo, com exceção da promoção Compre Junto.
2. Ative o campo Destaque nos produtos no formulário da promoção.
3. Salve a promoção.
4. No CMS Legado, insira o controle de exibição de promoção no template: <vtex.cmc:discountHightLight/>.

É importante se certificar de uma coordenação perfeita ao sincronizar a linha do tempo das promoções com as datas de entrega dos banners e ativos digitais. Para isso, as datas das promoções e dos banners devem ser verificados. Esse alinhamento estratégico garante que as campanhas promocionais sejam apoiadas por materiais visuais oportunos e relevantes, maximizando seu impacto e eficácia.

Na VTEX, o módulo Logística é o responsável pela logística e o fulfillment de pedidos da loja, incluindo planejamento, transporte, armazenamento de produtos e envio de pedidos a clientes.

Para realizar as configurações de logística, é necessário ter concluído as seguintes etapas:

• Cadastrar catálogo: como o fulfillment de pedidos está relacionado ao armazenamento de itens, os produtos e SKUs da loja precisam estar cadastrados no Catálogo.
• Configurar política comercial: as políticas comerciais moldam a experiência do cliente no site de uma loja, segmentando desde condições de venda para cada público, até produtos ofertados, preços, promoções e formas de envio.

Além disso, caso o modelo de negócio envolva lojas internacionais e vendas cross-border, é importante primeiro considerar qual seria o modelo de arquitetura da loja.

O conjunto de configurações essenciais de logística de uma loja VTEX é chamado de Estratégia de envio, composta de três conceitos principais: política de envio, estoque e doca.

• Política de envio: conjunto de regras que definem as opções de envio do pedido e condições de frete.
• Doca: local de distribuição dos itens vendidos.
• Estoque: espaço físico de armazenamento das mercadorias vendidas.

A imagem abaixo mostra como esses conceitos se relacionam entre si na venda de um produto:

A tabela a seguir apresenta as principais configurações de logística da loja na VTEX:

A ordem de configuração inicial sugerida é a seguinte: primeiro política de envio, segundo doca e terceiro estoque.

Assunto	Configuração via Admin VTEX	Configuração via API
Política de envio	Política de Envio	Create shipping policy
Doca	Gerenciar Doca	Create/update dock
Estoque	Gerenciar Estoque	Create/update warehouse
Inventário	Gerenciamento de inventário	Update inventory by SKU and warehouse

Política de envio

Política de envio é um conjunto de regras que definem as opções e condições de envio que serão apresentadas aos clientes no checkout. As condições de envio incluem transportadora, prazos de entrega, custo de frete, entre outros. A política de envio é vinculada ao estoque pela doca.

A transportadora que será responsável pelo envio do pedido é determinada por meio da política de envio. Primeiro, o cadastro de transportadoras é feito na planilha de frete, em seguida, a planilha de frete é associada quando se cria uma política de envio.

Doca

A doca é o local a partir dos quais os itens são distribuídos e escoados para envio, o ponto intermediário entre estoques e transportadoras. Pela doca, ocorre a integração entre estoque, política comercial e política de envio. Alguns dos casos de uso são:

• Diferentes pontos de escoamento para um único estoque.
• Doca como centro de distribuição.
• Doca e estoque correspondem ao mesmo espaço físico.

Para determinados produtos, é possível que não exista necessidade de um espaço físico de distribuição. Ainda assim, a doca é uma configuração obrigatória para o funcionamento correto das operações da plataforma VTEX.

Estoque

É a partir do estoque que se inicia a rota logística. Ele corresponde ao espaço físico de armazenamento das mercadorias vendidas pela loja. Uma vez que os itens vendidos são separados do estoque, eles são encaminhados para a doca.

O inventário da loja corresponde aos itens armazenados que estão disponíveis para a venda. O estoque é a identificação do local físico de armazenamento, enquanto o inventário é o conjunto de SKUs em estoque que estão prontos para serem vendidos.

Na VTEX, a atualização de inventário após a venda dos itens precisa ser controlada pela própria loja. Desta forma, após a venda, o lojista garante o devido controle da quantidade de itens restantes e de operações de fatura com ERP. Informações sobre importação de inventário via back-office podem ser encontradas no artigo Integrações de backend.

No Admin VTEX, em Catálogo > Estoque > Gerenciamento de inventário, existe uma configuração opcional chamada Lead time, que permite atribuir um tempo de envio a nível de SKU. Configurar o lead time significa adicionar um período de tempo ao cálculo de envio de pedido, o que é estratégico em alguns contextos.

Dentre os principais casos de uso, podemos citar produtos de fornecedores externos, cenários de dropshipping e venda de itens personalizáveis. Poder configurar o lead time significa ter mais flexibilidade para definir prazos de manipulação e envio do produto por terceiros.

Para calcular o prazo de envio de pedidos, a plataforma VTEX considera as seguintes configurações:

• Lead time: quantidade de tempo configurável para o SKU de um estoque. A configuração é opcional e, por padrão, está definida como zero dias.
• Tempo de estoque: tempo que o SKU leva para sair de um estoque para uma doca. Essa configuração é obrigatória, mas o tempo pode ser definido igual a zero.
• Tempo de doca: tempo que o SKU leva para sair da doca para ser enviado para o cliente. Essa configuração é obrigatória, mas o tempo pode ser definido igual a zero.
• Política de envio: agrupa as regras e condições de envio apresentadas aos clientes no checkout, incluindo transportadoras, custo de envio, horário de funcionamento da transportadora, janelas de entrega e capacidade de entrega.

O simulador de envio permite ao lojista simular e analisar as opções de entrega disponíveis para um pedido em uma localidade. A simulação verifica a viabilidade e as condições de envio do pedido, tais como disponibilidade de itens, formas de envio, custos e prazos.

Para atender a diversos modelos de negócio, a plataforma VTEX disponibiliza uma série de configurações opcionais, conforme apresentado na tabela abaixo:

Funcionalidade	Descrição
Pontos de retirada	Pontos de retirada são locais físicos que a loja configura para que os clientes possam retirar seus pedidos. Configurar pontos de retirada é interessante para operações omnichannel, especialmente quando há um grande número de lojas físicas, pois cada loja física pode se tornar uma opção para o cliente retirar seu pedido, aumentando a versatilidade da sua malha logística.
Feriados	A funcionalidade Feriados permite que a loja configure dias que não são válidos para o envio, e isso será considerado ao calcular o prazo de envio do pedido.
Reserva	A reserva é uma solução que impede que um mesmo item seja vendido mais de uma vez. Quando o cliente apenas insere o produto no carrinho, isso não gera reserva, sua prioridade sobre o item só ocorre após a finalização do pedido.
Capacidade de entrega	A Capacidade de entrega é o limite de envios que podem ser realizados pela loja em determinado período. Poder delimitar uma quantidade de itens ou pedidos que podem ser enviados em cada janela de envio significa ter mais controle sobre o preparo de pedidos e aumentar as chances de cumprir o acordo de entrega feito ao cliente no checkout.
Geolocalização	Geolocalização é o cadastro dos locais de envio a partir da latitude e longitude dos endereços. Essa funcionalidade é muito utilizada em endereços de zonas rurais e industriais, onde há divisão por lotes, ou áreas de risco, quando é preciso excluir determinados locais de entrega dentro de uma região.

Outras informações sobre conceitos logísticos na VTEX podem ser encontradas no artigo Glossário de logística, e conteúdo para desenvolvedores sobre a Logistics API, no artigo Fulfillment and Logistics.