Barra de Progresso de Frete Grátis no Carrinho (VTEX)

Visão Geral

A Barra de Progresso permite gerenciar, diretamente pelo CMS, as campanhas de frete exibidas no app, como frete grátis e descontos e outras promoções. Assim, é possível atualizar informações como valores, textos e datas de forma rápida e autônoma.

Este recurso está disponível exclusivamente para lojas que utilizam o CMS VTEX e Contentful. Caso não visualize os componentes no seu painel, solicite a ativação abrindo um chamado no Portal de Suporte Kobe.

Configurando a Barra de Progresso

Realize o login no painel administrativo da VTEX e acesse o espaço destinado ao aplicativo.
No menu lateral, vá em Storefront e clique em Headless CMS.
Para iniciar a configuração, clique em "Criar Documento" e selecione a opção "Campanha Progressiva de Promoção".

Adicionando Conteúdo (Aba Seções)

Acesse a aba "Seções".
Clique no ícone de "+" e insira os componente "Promoção Progressiva" e e preencha os campos de personalização:

Campo	Descrição
Valor para atingir esta promoção	Informe o valor mínimo que o usuário precisa atingir para desbloquear a promoção. Esse valor será utilizado para calcular o progresso exibido na barra.
Texto antes do valor faltante	Texto exibido para o usuário quando houver valor faltanate para atingir a promoção.
Texto depois do valor faltante	Texto exibido após o valor restante ser completo.
Mensagem exibida ao atingir esta meta	Mensagem apresentada quando o valor mínimo da promoção for alcançado e a barra de progresso estiver completa.

Configurações Adicionais (Aba Settings)

Acesse a seção "Settings" e preencha os campos:

Campo	Descrição
isActive	Define se o componente estará ativo ou não no app.
Identificador único da campanha	ID da campanha, nome de uso interno.
Nome da campanha	Nome que será exibido no aplicativo.
Descrição da campanha	Define a descrição da campanha, normalmente com mais explicações sobre o seu funcionamento.
Exibição	Define em qual página do app a barra será exibida (carrinho, PDP ou snackbar). Marque conforme a necessidade específica da sua estratégia.
Ícone	Permite fazer o upload de uma imagem/ícone que será exibida junto à barra de progresso.
Tipo	Define o valor que barra irá considerar na sua contagem, se o Valor Total ou Valor do Subtotal.
Deve bloquear o carrinho sem valor mínimo atingido	Quando esta opção estiver habilitada, o usuário não poderá prosseguir com o carrinho enquanto o valor mínimo da campanha não for atingido.
Mensagem de valor mínimo não atingido	Mensagem exibida ao usuário quando o carrinho não atingir o valor mínimo exigido e o bloqueio do carrinho estiver habilitado.
Exibição programada (Data de início e fim)	Programa a data e a hora exatas em que essa barra deverá ficar visível no app.

Ao finalizar a criação, lembre-se de clicar em Salvar e, em seguida, em Publicar para garantir que as alterações sejam armazenadas e o conteúdo seja disponibilizado no app.

Exemplo

Importante: O valor configurado no CMS é usado apenas para a exibição visual da barra de progresso. O cálculo real do frete no checkout continua seguindo as regras de logística cadastradas na sua plataforma VTEX.

Perguntas Frequentes (FAQ)

Preciso abrir chamado para alterar o valor de frete grátis?

Não. Todas as atualizações de valor são feitas diretamente por você no CMS da VTEX. A alteração é publicada imediatamente, sem dependência do suporte Kobe.

O valor configurado no CMS substitui o cálculo de frete real no checkout?

Não. O valor do CMS é usado exclusivamente para a exibição visual da barra de progresso no carrinho. O frete cobrado na finalização da compra continua sendo calculado com base nas regras de logística e no CEP do cliente, conforme configurado na sua plataforma VTEX.

O que acontece se eu não preencher o valor no CMS?

Se o documento não existir ou estiver sem valor preenchido, a barra de progresso de frete não será exibida no aplicativo.

Posso definir um período de vigência para a campanha?

Sim. Os campos de data de início e fim permitem programar campanhas com prazo determinado — útil para promoções sazonais como Black Friday. O comportamento é semelhante ao de um cronômetro de ofertas.

O que acontece quando a campanha do CMS expira?

Quando a data de fim é atingida ou não há campanha válida no CMS, o sistema utiliza automaticamente a configuração anterior, mantendo o app funcionando sem interrupção.

Posso ter campanhas diferentes por política comercial?

Sim. É possível configurar promoções progressivas distintas por contexto de exibição e período, permitindo campanhas segmentadas.

Ainda precisa de ajuda? Se surgir qualquer dúvida durante a configuração, nossa equipe está pronta para ajudar. Clique aqui para abrir um chamado