O produto está no carrinho, mas o cliente não vê uma opção de entrega? Quando o frete WooCommerce não aparece no checkout, comece pelo endereço usado no cálculo, pela zona que corresponde a ele e pelo método disponível nessa zona. O problema pode estar em um desses pontos — ou na atualização da página — e adicionar uma tarifa às cegas pode fazer a loja aceitar pedidos que não consegue entregar.
Este é um diagnóstico para uma loja já configurada. Se você ainda precisa montar zonas e métodos, consulte o guia de configuração de frete no WooCommerce. Não adote automaticamente um frete fixo para todo o Brasil: a cobertura e o preço precisam refletir a operação real.
Antes de testar: proteja a loja ativa
Tenha um produto físico (e a variação afetada, se houver), quantidade conhecida, dois endereços fictícios ou autorizados com país, estado, cidade e CEP — um atendido e outro que ajude a comparar — e o nome do método esperado. Registre o resultado sem divulgar dados de clientes. Faça mudanças e simulações em um ambiente de staging isolado, com pagamentos, e-mails, webhooks e outras automações reais impedidos de disparar.
Antes de alterar zonas, plugins, regras ou checkout, mantenha um backup restaurável de arquivos e banco de dados e anote a configuração anterior. Não restaure um banco de staging sobre a produção: pedidos, clientes e estoque criados depois da cópia podem ser perdidos. Se só houver produção disponível, limite-se primeiro a consultas sem alteração e envolva um responsável técnico para qualquer mudança comercial.
Checagem rápida: qual é o sintoma?
- No staging, adicione o mesmo produto e a mesma variação ao carrinho. Abra o checkout como visitante, preencha o endereço de teste e aguarde a atualização do cálculo. Repita com o segundo endereço.
- Não há seção de entrega? Veja se o carrinho contém item físico. Um carrinho só de produtos virtuais não precisa de envio; um carrinho misto ainda precisa calcular o frete dos itens físicos. Se o item é físico, compare a página personalizada com o checkout padrão no staging.
- Há aviso de que não existem opções para o endereço? Investigue cobertura da zona, método ativo e condições abaixo.
- O método aparece, mas o custo está errado? Esse é outro sintoma: confira cálculo, regras e classes, sem confundir preço inesperado com método ausente.
- O cálculo só não aparece antes do endereço? Consulte WooCommerce > Configurações > Envio > Configurações de envio e veja se a loja oculta custos até que o cliente informe um endereço. Em WooCommerce > Configurações > Geral, confira os locais para os quais a loja envia. Os nomes dos menus podem variar com tradução, versão e extensões (referência oficial das configurações).
Se a loja ainda não concluiu cadastro de produtos, páginas e destinos, veja primeiro o guia para criar uma loja virtual com WooCommerce.
1. O CEP corresponde à zona de entrega esperada?
Abra WooCommerce > Configurações > Envio > Zonas de entrega (ou rótulo equivalente). Compare país, estado e restrições por CEP com o endereço efetivamente usado para envio. Dependendo da configuração, o WooCommerce pode usar o endereço de cobrança como destino; não se baseie apenas no campo de CEP que você vê na tela. Confira também os locais permitidos para envio em Geral.
O WooCommerce aplica somente a primeira zona da lista que corresponde ao endereço. Exemplo: se uma zona “Brasil” aparece acima de uma zona mais específica para uma faixa de CEP e ambas correspondem ao teste, a zona específica não será utilizada. Confira a ordem e os padrões de CEP (inclusive caracteres e intervalos) antes de propor qualquer ajuste (documentação de zonas de entrega). Teste o impacto em outros destinos no staging.
Se nenhuma zona criada corresponder, entra a zona padrão “Resto do mundo”; ela pode não ter métodos cadastrados. Uma zona correspondente também pode estar vazia. Nenhum desses casos autoriza criar uma tarifa genérica: ofereça entrega apenas onde exista cobertura e preço validado.
2. A zona correspondente tem um método de envio disponível?
Abra a zona encontrada no teste, não apenas uma com nome parecido. Confirme se o método esperado está adicionado, habilitado e salvo ali; métodos de outras zonas não são herdados. Os métodos nativos incluem frete fixo, frete grátis e retirada local, mas a forma de configurar ou apresentar a retirada pode diferir entre checkout clássico e blocos (zonas e métodos no WooCommerce).
Frete grátis é a única opção?
Confira a condição definida: sem requisito, cupom que permite frete grátis, valor mínimo ou combinações de cupom e valor. Se o carrinho não atende à regra e não há outro método elegível, pode não aparecer opção de envio. Verifique se o valor mínimo considera o desconto do cupom antes ou depois, conforme a configuração (regras oficiais de frete grátis). Compare carrinhos de teste no staging; não reduza o mínimo na loja ativa para fazer um teste.
Classe, peso ou dimensões podem influenciar?
Confira a classe de envio do produto e, se for variável, da variação selecionada. Classe não cria tarifa por conta própria; ela só influencia um método que a utiliza (classes de envio). Peso, dimensões e limites de embalagem são relevantes quando o método ou a extensão instalada os exige. O frete fixo nativo não depende de medidas cadastradas em todo produto para oferecer uma opção. Não invente peso ou dimensões para forçar uma cotação.
3. O método depende de transportadora ou outra extensão?
Se a tarifa vem de um plugin de transportadora, agregador ou tabela, confira a documentação da extensão instalada: serviços habilitados para aquela zona, origem, cobertura de CEP, credenciais, regras de carrinho e dados obrigatórios de produto. Uma zona correta não garante que a API externa responda nem que a extensão funcione no tipo de checkout em uso. Não exponha chaves, endereços pessoais ou respostas completas da API em capturas ou chamados públicos.
No staging, se a operação permitir, compare com um método nativo apenas para diagnóstico, sem alterar o frete oferecido aos clientes. Se o método nativo aparece e o externo não, isso direciona a investigação para a integração, mas não prova indisponibilidade do fornecedor. Anote horário, produto, destino de teste e mensagem de erro; consulte WooCommerce > Status > Logs e logs próprios da extensão, quando existirem. O log padrão pode não registrar toda a comunicação externa (guia oficial de diagnóstico de frete).
4. A opção aparece no carrinho, mas some ou não atualiza no checkout?
Compare o carrinho e o checkout padrão do WooCommerce com as páginas personalizadas em staging, mantendo produto e endereço iguais. Plugins de campos, tema ou construtor podem interferir na atualização; registre erros do console e das requisições antes de pedir análise técnica. O artigo sobre personalizar o checkout do WooCommerce dá contexto para campos e layout, mas não retire CEP ou campos necessários à entrega por tentativa.
Para métodos nativos, o modo de depuração de envio, em WooCommerce > Configurações > Envio > Configurações de envio (rótulo sujeito à instalação), ignora o cache das tarifas. Na página clássica de carrinho, também pode mostrar um aviso com a zona correspondente. Não conte com esse aviso no checkout clássico, no carrinho/checkout em blocos nem em atualizações AJAX. Use somente no staging e desligue ao terminar, pois o aviso pode ficar visível aos visitantes. Se a tarifa demora a calcular ou o processo trava, confira também o guia de checkout WooCommerce lento: lentidão não prova ausência definitiva de método (documentação de depuração).
Valide a causa antes de corrigir
Depois de isolar a hipótese, faça uma alteração pequena por vez no staging. Repita os mesmos carrinhos e destinos: o método deve aparecer onde a loja atende, com preço correto, e continuar indisponível fora da cobertura quando essa for a política. Compare visitante e cliente logado, desktop e celular se esses cenários forem relevantes. Só teste a conclusão de um pedido com pagamento de teste e integrações reais bloqueadas.
Planeje a mudança mínima na loja ativa com backup, responsável e possibilidade de reversão. Refaça os testes após aplicar. Não desative frete, gateway ou plugin em produção para experimentar. Se você não consegue confirmar cobertura comercial, tarifa ou comportamento da extensão, mantenha a configuração atual e procure o suporte do fornecedor ou um desenvolvedor WooCommerce.
