Pular para o conteúdo
Documentação API Reference
Promoções Magento 1 Openmage

Barra de Progresso para Frete Grátis (Carrinho e Checkout)

PDF

Aprenda a configurar a barra de frete grátis da sua loja Magento, que mostra ao cliente quanto falta para ganhar frete grátis e incentiva a compra.

R Rodrigo Welter 10/07/2026 6 min de leitura
  • Exibe uma barra de progresso no carrinho e no checkout mostrando quanto falta para o cliente ganhar frete grátis.
  • Incentiva o cliente a adicionar mais itens para atingir a meta, ajudando a aumentar o valor médio dos pedidos.
  • Você define o valor mínimo, personaliza as mensagens e pode limitar a barra a determinadas faixas de CEP.
  • Disponível para lojas Magento 1.

A barra no carrinho funciona com o carrinho padrão do Magento. A barra no checkout foi feita para lojas que usam o OneStepCheckout.


Passo a Passo por Escrito

1. Acesse as configurações da barra

No painel administrativo, vá em Sistema → Configuração → Vendas → Fechar Pedido → Barra de Frete Grátis.

Resultado esperado: A tela de configuração da Barra de Frete Grátis é exibida com todos os campos disponíveis.


2. Habilite a barra

No campo Habilitar, selecione Sim.

A barra só aparece na loja se estiver habilitada e se você definir um valor mínimo maior que zero (próximo passo).

Resultado esperado: O módulo está ativado e pronto para ser configurado.


3. Defina o valor mínimo para frete grátis

No campo Valor mínimo para frete grátis, informe o valor que o cliente precisa atingir. Exemplo: 199 ou 199,90.

O valor é comparado ao subtotal do carrinho já com descontos (cupons e promoções), e não inclui o frete. Ou seja, é o valor dos produtos.

Resultado esperado: A meta do frete grátis está definida e a barra passa a medir o progresso do cliente até esse valor.


4. Personalize as mensagens

Preencha as mensagens que o cliente verá:

  1. Mensagem antes de atingir o valor mínimo — exibida enquanto falta valor. Você pode usar variáveis que são substituídas automaticamente:
    • {{remaining}} — quanto falta em dinheiro (ex.: R$ 50,00)
    • {{threshold}} — o valor mínimo configurado
    • {{percent}} — o progresso em porcentagem (ex.: 72%)
  2. Mensagem ao atingir o valor mínimo — exibida quando o cliente alcança a meta (ex.: Parabéns, você ganhou frete grátis!).
  3. Mensagem de Observação (opcional) — um texto pequeno abaixo da barra (ex.: Válido apenas para Sul e Sudeste).

Exemplo de mensagem principal: Faltam {{remaining}} para você ganhar frete grátis!

As variáveis {{remaining}}, {{threshold}} e {{percent}} funcionam apenas na mensagem principal (antes de atingir a meta).

Resultado esperado: As mensagens da barra ficam personalizadas com o texto e as variáveis que você escolheu.


5. (Opcional) Restrinja a barra por faixa de CEP

Se você só oferece frete grátis para certas regiões, use o campo Faixas de CEP permitidas. Clique em Adicionar Faixa e preencha CEP Inicial e CEP Final (apenas números, 8 dígitos). Exemplo: 01000000 até 05999999.

Você pode adicionar quantas faixas quiser. Para exibir a barra para todos os clientes, deixe o campo vazio.

Cada faixa precisa ter os dois campos com 8 dígitos e o CEP Inicial não pode ser maior que o CEP Final — caso contrário a loja não deixa salvar.

Com faixas configuradas, o cliente só vê a barra quando informa um CEP dentro de uma das faixas (no cálculo de frete do carrinho ou no endereço do checkout).

Resultado esperado: A barra passa a aparecer apenas para clientes com CEP dentro das faixas cadastradas.


6. Salve e atualize o cache

Clique em Salvar Config no topo da tela. Em seguida, atualize o cache da loja em Sistema → Gerenciamento de Cache.

Toda alteração só aparece na loja depois de atualizar o cache.

Resultado esperado: Uma mensagem de "As configurações foram salvas" é exibida e a barra passa a valer na loja.


Validação e Testes

Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.

Teste 1 — A barra aparece no carrinho

Ação: adicione um produto ao carrinho com valor abaixo da meta e abra a página do carrinho.

Resultado esperado: A barra de progresso aparece com a mensagem de quanto falta para o frete grátis.


Teste 2 — A barra reage ao valor do carrinho

Ação: adicione mais produtos até atingir ou ultrapassar o valor mínimo configurado.

Resultado esperado: A barra completa 100% e passa a exibir a mensagem de frete grátis (ex.: Parabéns, você ganhou frete grátis!).


Teste 3 — Restrição por CEP (se você configurou faixas)

Ação: no carrinho, use o Calcular Frete e informe um CEP dentro de uma faixa permitida; depois teste um CEP fora das faixas.

Resultado esperado: Com CEP dentro da faixa, a barra aparece; com CEP fora das faixas, a barra não é exibida.


Se não funcionar, verifique:

  • O campo Habilitar está em Sim.
  • O Valor mínimo para frete grátis está preenchido com um valor maior que zero.
  • Se você configurou Faixas de CEP, o CEP testado está dentro de alguma faixa.
  • O cache da loja foi atualizado após salvar.

Pronto! Dessa forma realizamos a configuração da Barra de Frete Grátis em sua loja virtual Magento 1.


Observações Importantes

  • A conta é sobre os produtos, não o frete: a barra compara a meta com o subtotal do carrinho já com descontos. O frete não entra no cálculo.
  • Cupons afetam a barra: ao aplicar um cupom de desconto, o valor considerado diminui, então a barra pode "recuar".
  • Variáveis só na mensagem principal: {{remaining}}, {{threshold}} e {{percent}} são substituídas apenas na mensagem exibida antes de atingir a meta.
  • Barra no checkout: o recurso no checkout foi desenvolvido para o OneStepCheckout. No carrinho, funciona com o carrinho padrão da loja.
  • Restrição por CEP é opcional: deixando o campo de faixas vazio, a barra aparece para todos. Com faixas, aparece apenas para os CEPs cadastrados.
  • A meta não configura o frete grátis de verdade: esta barra é um aviso visual de incentivo. A regra que realmente concede frete grátis é configurada à parte (nas regras de frete/promoção da loja). Mantenha os dois valores alinhados.

Referências e Relacionados

  • Como atualizar o cache da loja: toda alteração na barra só aparece depois de atualizar o cache. Aprenda a atualizar o cache da sua loja
  • Regras de preço do carrinho (promoções): é onde você configura a regra que de fato concede o frete grátis, para alinhar com o valor da barra.
  • Métodos e regras de frete: entenda como o frete grátis é aplicado na loja, complementando o aviso da barra.
  • Cupons de desconto: como os cupons afetam o subtotal e, consequentemente, o progresso mostrado na barra.

Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!