Depois que você sobe o CSV, o plugin precisa saber qual coluna do seu arquivo corresponde a CEP inicial, custo, prazo e por aí vai. Esse vínculo é o mapeamento.
Colunas suportadas
O plugin reconhece 8 campos:
| Campo | Obrigatório | Descrição |
|---|---|---|
| CEP inicial | Sim | Primeiro CEP da faixa |
| CEP final | Sim | Último CEP da faixa |
| Custo | Sim | Custo do frete |
| Prazo de entrega | Sim | Dias úteis estimados |
| Peso inicial | Não | Menor peso da faixa (deixe -1 se não usar) |
| Peso final | Não | Maior peso da faixa |
| Nome | Não | Nome do método (vira {name} no título) |
| Frete grátis | Não | Mínimo de compra pra essa linha sair grátis |
Os 4 obrigatórios precisam estar mapeados pra que o método funcione. Os opcionais podem ficar como -1.
Como funciona o mapeamento
Após o upload do CSV, o plugin lê o cabeçalho e tenta combinar automaticamente — se sua coluna chama "CEP Inicial" ou "cep_inicial" ou "Postcode From", ele acerta sozinho.
Se acertar tudo, ótimo: salve e siga.
Se errar (ou se sua tabela usa nomes só dela), você ajusta manualmente: pra cada campo do plugin, escolhe a coluna correta do CSV no select correspondente.
O plugin não detecta inversão (mapear CEP final como peso, por exemplo). Ele só vai retornar cálculos errados. Confira sempre antes de salvar.
Auto-detecção
A auto-detecção compara nomes de cabeçalho com palavras-chave conhecidas, em pt-br e en. Algumas variações reconhecidas pra cada campo:
| Campo | Reconhece |
|---|---|
| CEP inicial | cep, cepinicial, cep_inicial, postcode, from |
| CEP final | cepfinal, cep_final, to |
| Peso inicial | pesoinicial, peso_inicial, peso de |
| Peso final | pesofinal, peso_final, peso até |
| Custo | custo, valor, cost, price |
| Prazo | prazo, prazoentrega, tempo, delivery |
| Nome | nome, metodo, label, name |
| Frete grátis | gratis, freteGratis, free, freeshipping |
Se sua tabela usa uma variação que não está reconhecida, é mais simples renomear o cabeçalho do CSV do que ajustar manualmente toda vez que reimportar.
Quando o mapeamento aparece
A tela de mapeamento só aparece depois que o CSV é enviado. Se você abrir o método antes de subir uma tabela, vai ver só o uploader.
Reimportar mantendo o mapeamento
Se você atualiza a tabela mas mantém os mesmos nomes de coluna, o mapeamento continua válido. Basta subir o novo arquivo no mesmo lugar.
Se trocar os nomes, refaça o mapeamento.
Modificar via código
Devs podem adicionar/remover colunas mapeáveis com filters. Ver:
wcts_mapping_columns— adiciona campos novoswcts_default_column_values— modifica os valores reconhecidos pela auto-detecção