O módulo Regras de frete do Checkout Rishi dá frete grátis ou desconto no frete a partir de um valor do carrinho, só para as regiões que você escolher. Enquanto o cliente ainda não chegou lá, o resumo do pedido mostra uma barra com quanto falta, que enche a cada produto adicionado. Quando a meta é atingida, o frete mais barato sai grátis na própria transportadora (PAC, SEDEX ou outra), com o nome e o prazo dela e o preço original riscado. O preço dos produtos não muda.
Onde configurar
As regras ficam em WooCommerce → Regras de frete, com três abas: Regras, Região do cliente e Barra no checkout.
O módulo vem ligado em todas as lojas desde a versão 3.4.0. Se o menu não aparecer, ative o card Regras de frete na seção Módulos das configurações do Checkout Rishi (WooCommerce → Checkout Rishi). O módulo exige PHP 8.1 ou superior.
Criar uma regra
Na aba Regras, clique em Nova regra (ou em Usar exemplo) e preencha:
| Campo | O que define |
|---|---|
| Nome da regra | Um nome para você identificar a regra. Ex.: Sul. |
| Para clientes de | Todo o Brasil, Alguns estados ou Faixas de CEP (um CEP ou uma faixa por linha, como 90000-000 - 91999-999). |
| Benefícios | Cada linha diz "Acima de R$ X o cliente ganha frete grátis" ou "desconto de N% no frete". Use + Adicionar faixa para criar degraus. |
| Desconto máximo (R$) | Em Mais opções. Teto do desconto; vazio é "Sem limite". |
| Cupons contam no valor? | Em Mais opções. Por padrão, vale o valor antes do cupom. |
Com faixas, o cliente sempre vê o próximo degrau. Ex.: 20% de desconto no frete acima de R$ 200 e frete grátis acima de R$ 400. Os benefícios precisam crescer com o valor.
Se o frete passar do desconto máximo, o cliente ganha só o desconto máximo e vê um aviso explicando por que o frete não saiu grátis. Use o teto para proteger a margem nas regiões em que o frete é caro.
Clique em Salvar regras ao terminar.
Testar antes de ativar
Cada regra tem duas chaves: Ativa e Modo de teste.
- Ativa — a regra vale para todos os clientes.
- Modo de teste — gerentes da loja veem e recebem a regra no checkout mesmo com ela desativada, com o selo "Teste". Os clientes só recebem quando ela está ativa. Pedidos feitos assim saem marcados como modo de teste.
Ao clicar em Nova regra, a chave Ativa já vem ligada. Para testar antes, desligue Ativa, ligue Modo de teste e salve.
Para testar:
- Com a regra desativada e em modo de teste, entre na loja com um usuário gerente.
- Adicione produtos ao carrinho e vá ao checkout.
- Confira se a barra mostra quanto falta e se o frete fica grátis (ou com desconto) quando o carrinho passa da meta.
- Informe CEPs de regiões diferentes para conferir cada regra.
- Quando estiver tudo certo, ligue Ativa e salve.
Ao atualizar para a versão 3.4.0, a loja recebe a regra "Frete grátis Brasil", acima de R$ 299, desativada e em modo de teste. Nenhum cliente recebe o benefício até você ativá-la.
Onde a barra aparece
As opções ficam na aba Barra no checkout.
| Opção | Padrão | O que faz |
|---|---|---|
| Mostrar a barra no checkout | Ligada | Barra no resumo do pedido. No celular, ela vira uma linha acima do resumo. |
| Mostrar também na página do carrinho | Ligada | Barra acima dos totais do carrinho, atualizada quando o cliente muda quantidades ou aplica cupom. |
| Mostrar no topo de todo o site | Desligada | Faixa com o progresso do frete grátis ou, com o carrinho vazio, a oferta da região. Tem Cor de fundo, Cor do texto e as opções Ocultar na página do carrinho e Ocultar no checkout (ligadas por padrão). |
Os textos da barra podem ser editados. Cada um tem uma versão longa, para o computador e leitores de tela, e uma Versão curta (celular), que precisa caber em uma linha. Se não couber, o final é cortado com "…" e o painel avisa.
Para mostrar a barra em outra página, use o shortcode [rishi_shipping_progress], no card Em outras páginas.
Região antes do CEP
Na aba Região do cliente, você decide o que vale antes de o cliente informar o CEP:
| Opção | Como funciona |
|---|---|
| Não estimar (padrão) | Nenhuma estimativa pelo IP. |
| Somente pelo CEP | Nenhuma regra vale antes do CEP, nem a "Todo o Brasil": a barra fica oculta e o frete não recebe desconto. |
| Cloudflare | Usa a localização enviada pela Cloudflare. Exige ativar "Add visitor location headers" na Cloudflare. |
| IPinfo com token | Usa o IPinfo com o seu token. Salve o token e clique em Testar. |
| IPinfo gratuito (teste) | Versão gratuita do IPinfo, para testes. |
Com a estimativa, a barra mostra a meta da região do visitante desde a primeira tela, antes de ele digitar o CEP.
Problemas comuns
- O menu Regras de frete não aparece — ative o módulo em Módulos e confira se o servidor usa PHP 8.1 ou superior.
- Só eu vejo a barra — a regra está em modo de teste e desativada. Ligue Ativa.
- A barra aparece, mas o frete não fica grátis — o frete passou do desconto máximo. O cliente vê um aviso com o motivo.
Veja também Entrega, sobre CEP automático e a ordem dos métodos de envio.
Para ver a barra de frete grátis funcionando no checkout, acesse Barra de frete grátis no Checkout Rishi.