Primeira configuração

A configuração do plugin acontece como qualquer outro método de envio do WooCommerce: dentro de uma área de entrega.

1. Adicione o método à área de entrega

Vá em WooCommerce → Configurações → Entrega, abra a área onde quer aplicar (ou crie uma nova) e adicione um método do tipo Frete Offline com tabela.

2. Configure o método

Clique pra editar o método recém-adicionado. Vai aparecer um formulário com várias opções. Em quase todos os campos você pode passar o mouse no ? pra ver a descrição completa.

Campos essenciais

• Title — nome exibido no checkout. Aceita placeholders: {name} (nome mapeado da tabela) e {delivery_time} (prazo). O padrão é {name} (entrega em até {delivery_time} dias úteis).
• Unidade de medida — unidade da tabela, não do site. Se sua loja usa kg mas a tabela está em gramas, marque "Gramas" aqui.
• Mínimo para frete grátis — valor mínimo de pedido pra liberar frete grátis em toda a tabela. Veja Frete grátis pra opções por linha.

Campos opcionais (mas comuns)

• Additional Days — soma X dias úteis ao prazo de cada linha.
• Peso extra em kg — peso adicional no pacote (embalagem, isolamento térmico). Vem com o sufixo da unidade de peso da loja.
• Taxa de manuseio — taxa fixa ou percentual sobre o custo de envio. Aceita 2.50 ou 5%.
• Taxa do carrinho — taxa fixa ou percentual sobre o subtotal do carrinho. Aceita 3.00 ou 2%.

Veja Taxas de manuseio e carrinho pra detalhes.

Visibilidade e classe

• Always visible — exibe esse método mesmo se outros métodos também combinem. Se desmarcado, só aparece quando nenhum outro casa.
• Limitar resultados — exibe apenas a primeira linha que combinar (útil quando há linhas sobrepostas e você quer só a mais barata).
• Classe de entrega + Validação da classe de entrega — restringe a método a produtos com classe específica. Ver Classe de entrega.

Avançado

• Delimitador de colunas — vírgula (padrão) ou ponto-e-vírgula. Use ponto-e-vírgula se sua tabela vem do Excel BR sem reformatação.
• Prazo de entrega separado — exibe o prazo numa linha abaixo do nome do método em vez de junto. Se ativar, edite o Title removendo o {delivery_time}.
• Debug Log — grava cálculos detalhados em wp-content/uploads/wc-logs/wc-table-shipping-*.log. Use durante diagnóstico, desligue depois.

3. Envie a tabela CSV

Role até Detalhes do método. Clique em Selecione a tabela (ou similar) e suba o arquivo CSV. Veja Modelo de tabela CSV pro formato.

4. Mapeie as colunas

Após o upload o plugin tenta detectar as colunas automaticamente (CEP inicial, CEP final, custo, etc).

Confira o mapeamento — se a tabela usar nomes diferentes do padrão, ajuste manualmente.

5. Salve e teste

Salve o método e teste no checkout com vários CEPs e pesos. Se nada aparecer, veja Métodos não aparecem.