Novo Módulo – Barra de Frete Grátis
Patch Notes – Barra de Frete Grátis
Descrição da atualização
Disponibilizamos o módulo Barra de Frete Grátis, desenvolvido para exibir de forma clara e dinâmica o progresso do cliente em relação ao valor mínimo necessário para obter frete grátis.
A barra é exibida no carrinho e no checkout, atualizando-se automaticamente conforme o valor do pedido e o CEP informado, ajudando o cliente a entender quanto falta para atingir o benefício e incentivando o aumento do ticket médio.
O módulo foi projetado para funcionar corretamente mesmo em cenários mais complexos de checkout, garantindo que o CEP considerado seja sempre o mais atual e correto, sem impactar a experiência de compra.
O que o módulo faz
-
Exibe uma barra visual de progresso para o frete grátis;
-
Mostra quanto falta para atingir o valor mínimo configurado;
-
Atualiza automaticamente conforme o valor do carrinho;
-
Funciona tanto no carrinho quanto no checkout;
-
Considera corretamente o CEP informado pelo cliente;
-
Permite restringir a exibição da barra por faixas de CEP;
-
Exibe mensagens personalizadas antes e depois de atingir o frete grátis;
-
Atualiza dinamicamente no checkout, sem recarregar a página.
Funcionamento por CEP
O módulo identifica o CEP de forma diferente conforme o contexto, garantindo sempre o valor correto:
No Carrinho
-
Prioriza o CEP digitado no “Calcular Frete”;
-
Caso não exista, utiliza o CEP do endereço do carrinho;
-
Para clientes logados, pode usar o endereço padrão;
-
Se não houver CEP válido e existirem restrições, a barra não é exibida.
No Checkout
-
Considera imediatamente o CEP digitado em novos endereços;
-
Atualiza automaticamente quando o endereço selecionado muda;
-
Garante que o CEP mais recente sempre tenha prioridade;
-
Evita inconsistências comuns em checkouts AJAX.
Esse cuidado evita erros clássicos, como a barra aparecer para regiões não atendidas ou não reagir a mudanças de endereço.
Onde fica
Sistema → Configuração → Vendas → Fechar Pedido → Barra de Frete Grátis
Configurações disponíveis (resumo)
Habilitar
Ativa ou desativa o módulo.
Valor mínimo para frete grátis
Define o valor necessário para o cliente ganhar frete grátis.
O cálculo é feito sobre o subtotal com descontos (não inclui frete).
Faixas de CEP permitidas
Permite definir intervalos de CEP onde o frete grátis é válido.
Caso nenhuma faixa seja configurada, o módulo considera todos os CEPs como válidos.
Mensagem antes de atingir o valor mínimo
Texto exibido enquanto o cliente ainda não atingiu o frete grátis.
Suporta placeholders dinâmicos:
-
{{remaining}}– valor que falta para atingir o frete grátis -
{{threshold}}– valor mínimo configurado -
{{percent}}– percentual de progresso da barra
Mensagem ao atingir o frete grátis
Texto exibido quando o valor mínimo é alcançado ou ultrapassado.
Mensagem de observação (opcional)
Texto exibido abaixo da barra.
Exemplo: “Válido apenas para regiões Sul e Sudeste”.
Principais vantagens
-
Aumento de conversão: incentiva o cliente a adicionar mais produtos ao carrinho;
-
Experiência clara: o cliente entende visualmente o benefício do frete grátis;
-
Controle regional: possibilidade de limitar o frete grátis por CEP;
-
Compatível com checkout AJAX: sem quebras ou recarregamentos;
-
Flexível: funciona para lojas pequenas ou operações maiores;
-
Tudo pelo painel: nenhuma configuração exige alteração de código.
Observações importantes
-
Se nenhuma faixa de CEP for configurada, o módulo libera a barra para todos os clientes;
-
Caso existam faixas configuradas, a barra só será exibida para CEPs válidos;
-
CEP inválido ou inexistente impede a exibição quando há restrição ativa;
-
O módulo foi desenvolvido para não interferir no cálculo de frete nem no fluxo de checkout;
-
Funciona como um componente informativo e visual, a aplicação do frete grátis em si não é feita pelo módulo. Para que o frete grátis funcione corretamente no checkout, é obrigatória a criação de Regras de Carrinho