A tabela é um arquivo CSV onde cada linha é uma regra de frete — uma combinação de faixa de CEP, faixa de peso e o custo correspondente.
Não há tabela padrão. Você usa a sua, fornecida pela transportadora ou montada manualmente.
Estrutura mínima
Você precisa, no mínimo, das colunas que mapeiam pros campos obrigatórios:
| Coluna | Tipo | Descrição |
|---|---|---|
| CEP inicial | Inteiro | Primeiro CEP da faixa, sem hífen (ex: 01000000) |
| CEP final | Inteiro | Último CEP da faixa |
| Custo | Decimal | Custo do frete na moeda da loja |
| Prazo de entrega | Inteiro | Dias úteis estimados |
E pelo menos uma das duas colunas opcionais a seguir, se o cálculo for sensível a peso:
| Coluna | Tipo | Descrição |
|---|---|---|
| Peso inicial | Decimal | Menor peso da faixa |
| Peso final | Decimal | Maior peso da faixa |
| Nome | Texto | Nome do método (substitui {name} no título) |
| Frete grátis | Decimal | Mínimo de compra pra esta linha sair grátis |
Exemplo
CEPInicial,CEPFinal,PesoInicial,PesoFinal,Custo,Prazo,Nome,FreteGratis
01000000,19999999,0,1,15.50,5,Express,
01000000,19999999,1,5,20.00,5,Express,
20000000,29999999,0,1,25.00,7,Padrão,200
20000000,29999999,1,5,30.00,7,Padrão,200
Nas configurações do plugin há um CSV de exemplo pronto pra baixar e adaptar.
Regras de formatação
- CEPs: apenas números (sem hífen) ou com hífen — o plugin remove automaticamente. 8 dígitos.
- Custo: ponto como separador decimal, sem símbolo (
15.50, nãoR$ 15,50). - Prazo: número inteiro de dias úteis.
- Peso: decimal na unidade que você indicar nas configurações (gramas ou kg). Pode ficar vazio se a regra não depende de peso.
- Frete grátis: decimal com o mínimo de compra. Vazio = não aplica frete grátis nessa linha.
Valores especiais
| Valor | Significado |
|---|---|
-1 em Custo |
Frete grátis nessa linha (sem mínimo) |
-1 em Prazo |
Não exibir prazo |
| Vazio em Peso inicial/final | Linha vale para qualquer peso |
Conversão de outros formatos
O plugin aceita somente CSV (e TXT). Se sua tabela está em XLS, XLSX ou outro:
- Suba pro Google Drive e baixe como CSV — o Drive sempre formata bem.
- Ou use um conversor online tipo convertio.co.
Excel em pt-br costuma usar ponto-e-vírgula como separador. Se a sua tabela está nesse formato, mude o Delimitador de colunas nas configurações em vez de reformatar o arquivo.
Tabela quebrada no Excel?
Se ao abrir no Excel sua tabela aparece com tudo numa coluna só (CEP,CEPFinal,... em A1), é configuração regional do Excel. Soluções:
- Abrir no Google Drive — formata correto.
- Importar via "Dados → Texto pra colunas" no Excel.
- Trocar a configuração regional pra US no momento de abrir.
Próximos passos
- Mapeamento de colunas — como apontar pro plugin o que é cada coluna
- Configurar frete grátis — usando a coluna FreteGratis ou o campo global