FernandoAcosta.Netdocs

Métodos de envio não aparecem

3 min de leituraAtualizado há 5 dias

Quando o método de envio não aparece no checkout, há quatro causas mais comuns. Confira nesta ordem.

1. Áreas de entrega sobrepostas

O WooCommerce avalia áreas de entrega de cima pra baixo e usa apenas a primeira que combina com o endereço do cliente. As outras são ignoradas.

Vá em WooCommerce → Configurações → Entrega e veja a ordem das áreas:

  • Se há uma área "Brasil" com PAC e, abaixo, uma área "Brasil" com Frete Offline, a segunda nunca é considerada.
  • Áreas mais específicas (estados, cidades, faixas de CEP) precisam vir acima das mais amplas (país inteiro).

Reordene arrastando até que a área que contém o frete offline seja a primeira a casar com o destino que você está testando.

2. Mapeamento de colunas incorreto

Depois de subir o CSV, o plugin precisa que cada coluna esteja apontada pro campo certo (CEP inicial, custo, peso, etc).

Se o mapeamento está errado, o plugin tenta validar com base em dados invertidos e nada bate.

  • Volte na tela de configuração do método.
  • Confira cada campo do mapeamento (especialmente CEP inicial vs CEP final, peso inicial vs peso final).
  • Ajuste e salve.
Mapeamento errado é silencioso

O plugin não detecta inversões. Confira sempre que reimportar o CSV.

3. Unidade de medida divergente

A unidade de medida nas configurações refere-se à tabela, não ao site.

Se sua tabela tem peso em gramas (1, 50, 500, 1000) e você marcou Kilos, o plugin compara errado:

  • Carrinho com 800g → plugin acha que tem 0.8 kg.
  • Tabela tem linhas pra 500 e 1000 (entendido como 500 kg e 1000 kg).
  • Nada bate. Método some.

Vá nas configurações do método e marque a unidade correta.

4. Faixas que não cobrem o cenário

Em Detalhes do método, ao lado do uploader da tabela, há um link com o nome do arquivo (algo como tabela.txt). Clique nele.

Vai abrir a tabela bruta. Confira:

  • O CEP do cliente está dentro de alguma faixa (CEP inicial ≤ CEP cliente ≤ CEP final)?
  • O peso do carrinho está dentro da faixa de peso da mesma linha?

Os dois precisam bater na mesma linha. Não basta haver uma linha pro CEP e outra pro peso isoladamente.

Causas comuns:

  • Cliente em CEP fora da cobertura da tabela.
  • Carrinho mais pesado do que o limite máximo da tabela.
  • Carrinho com peso zero (produtos virtuais ou sem peso configurado).

5. Classe de entrega filtrando

Se você definiu uma Classe de entrega no método, o método só aparece pra carrinhos que combinam com essa classe (e a regra de validação que você escolheu — "todos" ou "pelo menos um").

Se nenhum produto do carrinho tem a classe, o método some.

Veja Classe de entrega pra detalhes.

Diagnóstico avançado: Debug Log

Se nenhum dos pontos acima resolveu, ative Debug Log nas configurações do método e simule um checkout. O log fica em:

wp-content/uploads/wc-logs/wc-table-shipping-*.log

Lá você vê em detalhe quais linhas o plugin tentou validar e por que rejeitou cada uma.

Desative o log depois — em produção, gera arquivos grandes rapidamente.

Continua sem aparecer?

Pegue o Relatório do sistema do método (link nas configurações), copie e cole em snippets.fernandoacosta.net e envie ao suporte. Junto, mande:

  • CEP usado no teste.
  • Link do produto.
  • Imagem das configurações de peso do produto.
Foi útil?