Problemas que aparecem quando o simulador está renderizado mas não calcula direito. Se o simulador nem aparece, veja /article/simulador-nao-aparece primeiro.
Preço não muda com variação ou quantidade
Sintoma: o cliente troca a variação ou aumenta a quantidade, e o frete continua o mesmo.
Causa: o JavaScript do simulador procura a quantidade e a variação selecionada dentro de uma div chamada container do produto. Em temas customizados (especialmente os feitos com construtor), essa div tem um nome diferente do padrão.
Solução:
- Abra a página do produto e inspecione o HTML.
- Encontre a
divque envolve o título do produto, preço, descrição curta, formulário de variação e botão de compra. É o "summary" do produto. - Veja qual classe ela tem.
- Vá em WooCommerce → Configurações → Produtos → Simulador de frete e mude Container do produto pro seletor correto (ex:
.product-summary,.summary-inner).
Se você não consegue identificar a div, mande no suporte que ajudamos.
Prazo de entrega não é exibido
Sintoma: o método aparece com o preço, mas sem prazo.
Causa mais comum: o plugin de frete não envia o prazo no formato esperado, ou o plugin do simulador ainda não tem integração específica com esse plugin de frete.
Solução:
- Confirme se você está na versão 1.9.2 ou superior.
- Confira se o prazo aparece no carrinho normal (adicione o produto, vá pro carrinho e simule lá). Se não aparece nem no carrinho, o plugin de frete não está enviando — não é problema do simulador.
- Se aparece no carrinho mas não no simulador, ative Habilitar debug, faça uma simulação e envie o log no suporte. Uma integração específica é adicionada na próxima atualização.
Pra customizar o texto do prazo (ex: "Entrega em X dias úteis" → "Em X dias"), veja /article/personalizar-textos.
CEP retorna vazio ou cidade errada
Causa mais comum: a API ViaCEP está fora do ar momentaneamente.
Solução: alterne pra BrasilAPI:
add_filter( 'wc_shipping_simulator_use_brasil_api', '__return_true' );
Mensagem de "nenhum método disponível"
Quando acontece: nenhum método de envio foi encontrado pra aquele CEP.
Causas possíveis:
- Nenhuma zona de envio cobre o estado do cliente.
- Os métodos configurados têm restrições (peso máximo, valor mínimo) que o produto não cumpre.
- Um plugin como Conditional Shipping and Payments está bloqueando.
Como customizar a mensagem: veja /article/personalizar-textos.
Performance: simulador carrega devagar
- Mantenha Habilitar debug desligado em produção.
- Mantenha Carregamento de scripts com a opção padrão (só na página do produto), a não ser que você tenha um motivo específico.
- Reveja zonas e métodos de envio: se você tem 30 métodos pra o mesmo CEP, todos são calculados.
Continua com problema?
Ative Habilitar debug e mande o log no suporte. Veja /article/como-ativar-debug.