Nesta documentação

Operação

Tabelas de frete

Como montar o CSV de faixas de CEP, em que unidade informar os valores e como testar o custo de um CEP.

A tabela de frete diz quanto custa entregar em cada faixa de CEP. Sem ela, o checkout não sabe cobrar entrega. A tela fica em Tabelas de Frete, e cada clube aponta para uma tabela.

O formato do CSV

O arquivo precisa ter exatamente estas três colunas, nesta ordem, com estes nomes:

zip_from,zip_to,shipping_fee
01000-000,01999-999,1200
02000-000,09999-999,1850
ColunaO que é
zip_fromo CEP inicial da faixa, no formato 00000-000
zip_too CEP final da faixa, no mesmo formato
shipping_feeo valor do frete em centavos

A importação também recusa o arquivo quando: algum valor de frete é zero ou negativo, algum campo está vazio, ou o CEP inicial é maior que o final. As mensagens de erro dizem quantas linhas falharam e quais são, para você corrigir de uma vez.

Valores mensais, sempre

Este é o ponto que mais gera confusão na hora de conferir uma cobrança.

Você informa sempre o valor mensal do frete. A plataforma multiplica sozinha conforme a frequência de cobrança da assinatura:

Frequência de cobrançaMultiplicadorExemplo com frete de R$ 10,00
MensalR$ 10,00 por cobrança, 12 cobranças no ano
SemestralR$ 60,00 por cobrança, 2 cobranças no ano
Anual12×R$ 120,00 em uma cobrança

Importando e conferindo

  1. Monte o CSV. A tela oferece um arquivo de exemplo para baixar.

  2. Faça o upload na tabela de frete. A plataforma valida tudo antes de salvar: ou o arquivo entra inteiro, ou nada muda.

  3. Confira as regras importadas na própria tela. Tabelas grandes carregam sob demanda, com um botão para ver todas as regras.

  4. Use Testar custo para CEP para conferir alguns CEPs reais: um da capital, um do interior, um de outra região.

A data da Última Importação fica visível, o que ajuda a saber se a tabela ainda reflete o contrato atual com a transportadora.

Como uma faixa é escolhida

A plataforma percorre as regras e usa a primeira faixa que contém o CEP. Se duas faixas se sobrepõem, quem estiver primeiro no arquivo ganha. Se nenhuma contém, o CEP é tratado como sem cobertura, e o checkout avisa que não há entrega para aquele endereço.

frete, CEP, CSV, importação, entrega