O aplicativo Tabela de Frete Personalizada calcula as opções de envio no checkout a partir de uma planilha com as suas regras de frete por faixa de CEP e peso. Neste artigo, você vê o formato que a planilha deve ter, o que informar em cada coluna e como a plataforma escolhe a linha usada na cotação.
Helpjuice Success Callout Title
O aplicativo Tabela de Frete Personalizada é exclusivo do plano Next.
Se você ainda não instalou ou configurou o aplicativo, comece por como configurar a Tabela de Frete Personalizada na minha loja.
Formato da planilha
A planilha deve estar no formato .xlsx. A primeira linha precisa conter exatamente os nomes das colunas listados na próxima seção, em inglês e sem espaços. A partir da segunda linha, entram os dados.
A forma mais segura de começar é baixando o modelo oficial no formulário do meio de envio. Para obter a planilha com todas as colunas no formato correto, seguir pelo caminho: "Painel administrador > Configurações > Meios de envio > Tabela de frete personalizada > Editar > + Adicionar meio de envio > Baixar modelo".
Helpjuice Success Callout Title
A plataforma não valida se existem faixas de CEP sem cobertura. Se o CEP de destino de um cliente não estiver em nenhuma linha da planilha, esse meio de envio simplesmente não aparece no checkout, sem mensagem de erro. Revisar a planilha com cuidado antes de importar.
Como preencher as colunas da planilha
São 11 colunas, agrupadas abaixo por tipo de informação. Clicar em cada grupo para ver o detalhe e um exemplo de preenchimento.
Cobertura de CEP: ZipCodeStart e ZipCodeEnd
Coluna |
O que informar |
Exemplo |
|---|---|---|
| ZipCodeStart | Primeiro CEP da faixa coberta por essa linha. Apenas dígitos, sem letras nem hífen, com zeros à esquerda se necessário. A quantidade de dígitos varia conforme o país informado em Country. | 01310000 |
| ZipCodeEnd | Último CEP da faixa. Todos os CEPs entre o início e o fim recebem essa cotação. Deve ser maior ou igual ao ZipCodeStart e ter a mesma quantidade de dígitos. | 01599999 |
Faixas de peso e volume: WeightStart, WeightEnd, PriceByExtraWeight e MaxVolume
Coluna |
O que informar |
Exemplo |
|---|---|---|
| WeightStart | Peso mínimo do pacote, em gramas, para essa faixa de preço valer. Usar 0 para começar do zero; para "acima de 1 kg", usar 1001. | 0 |
| WeightEnd | Limite superior da faixa, em gramas (1000 = até 1 kg; 5000 = até 5 kg). Pacotes mais pesados não são excluídos: a linha continua candidata e o excedente é cobrado pelo PriceByExtraWeight. | 1000 |
| PriceByExtraWeight | Valor cobrado por cada grama que ultrapassar o limite da faixa. Se não usar, preencher 0. | 0 |
| MaxVolume | Volume máximo do pacote, em cm³. Se não houver limite, usar um valor alto, como 10000000. | 10000000 |
Preço do frete: AbsoluteMoneyCost e PricePercent
Coluna |
O que informar |
Exemplo |
|---|---|---|
| AbsoluteMoneyCost | Valor fixo do frete, em reais, para essa combinação de CEP e peso. Usar ponto como separador decimal, sem "R$" nem vírgula. | 25.90 |
| PricePercent | Percentual aplicado sobre o valor do pedido (ad valorem), geralmente usado como cobertura de seguro da transportadora. Se não cobrar, usar 0. Exemplo: 0.66 equivale a 0,66%. | 0.66 |
As duas colunas podem ser usadas na mesma linha: o valor fixo e o percentual são somados na cotação.
Prazo e destino: TimeCost, Currency e Country
Coluna |
O que informar |
Exemplo |
|---|---|---|
| TimeCost | Prazo de entrega em dias de trânsito. Apenas números inteiros; frações de dia não são aceitas. | 3 |
| Currency | Código da moeda da cotação. Deve corresponder ao país informado em Country. | BRL |
| Country | Código do país de destino. Define a moeda esperada e a quantidade exata de dígitos do CEP. | BR |
País |
Código (Country) |
Moeda (Currency) |
Dígitos do CEP |
|---|---|---|---|
| Argentina | AR | ARS | 4 |
| Brasil | BR | BRL | 8 |
| Chile | CL | CLP | 7 |
| Colômbia | CO | COP | 6 |
| México | MX | MXN | 5 |
Helpjuice Info Callout Title
Para cada faixa de CEP, repetir as linhas com as diferentes faixas de peso. A plataforma identifica automaticamente a linha que corresponde ao CEP e ao peso do pedido no checkout.
Como a plataforma escolhe a cotação?
No checkout, a plataforma procura as linhas cujo intervalo de CEP inclui o destino e cujo intervalo de peso inclui o pacote. Quando mais de uma linha atende, a escolha segue a ordem abaixo:
1. Vence a faixa com o maior peso inicial, por ser a mais específica. Exemplo: com uma faixa de 1 a 20 kg e outra de 5 a 10 kg, um pacote de 7 kg é cotado pela segunda.
2. Se duas faixas têm o mesmo peso inicial para o mesmo CEP, vence a mais barata.
3. Se o preço também empatar, vence a de menor prazo.
Essas regras valem tanto para linhas de uma mesma planilha quanto para linhas de arquivos diferentes enviados ao mesmo meio de envio, já que todos são combinados em uma única tabela.
Perguntas frequentes
Como enviar planilhas grandes ou em outro formato?
Não há limite de linhas por planilha; o limite é de 50 MB por arquivo. Quando a cobertura de CEPs ultrapassa cerca de 65.000 linhas ou o arquivo passa desse tamanho, dividir em planilhas menores e importar todas juntas: a plataforma une as coberturas automaticamente. Também é possível enviar um único .zip com várias planilhas .xlsx dentro.
Se a sua planilha está em .xls, converter para .xlsx antes de importar:
- Excel: "Arquivo > Salvar como > Pasta de Trabalho do Excel (.xlsx)".
- Google Sheets: "Arquivo > Fazer download > Microsoft Excel (.xlsx)".
- LibreOffice Calc: "Arquivo > Salvar como" e escolher o formato .xlsx.
Para substituir uma tabela já importada, basta fazer um novo upload no mesmo meio de envio: a plataforma cria uma nova versão, passa a usá-la imediatamente e mantém a anterior apenas no histórico.
Consigo cobrar um frete diferente conforme o valor do carrinho?
Não pela planilha. Ela permite combinar um valor fixo (AbsoluteMoneyCost) com um percentual sobre o pedido (PricePercent), mas não permite preços diferentes por faixa de valor do carrinho. O que existe é a opção de exibir ou ocultar um meio de envio por faixa de valor da compra, no painel "Configurar restrição da loja". Saiba mais em como configurar restrições na Tabela de Frete Personalizada.
Consigo cobrar por quilômetro percorrido ou por raio de distância?
Não. A planilha não tem campo de distância: o formato usa as faixas de CEP como referência geográfica. Para precificar por proximidade, montar faixas de CEP ao redor do centro de distribuição com preços escalonados. O painel de restrições tem uma opção de raio em km a partir do CD, mas ela serve apenas para exibir ou ocultar o meio de envio, não para definir o preço.
Como vejo as planilhas que já estão cadastradas em um meio de envio?
Na tabela principal do aplicativo, clicar no ícone de download (seta para baixo) na coluna "Ações" do meio de envio. Os arquivos importados são baixados para o seu computador, e você pode revisá-los, ajustar e reimportar.
Pronto!
Agora você já sabe como montar a planilha da Tabela de Frete Personalizada, o que informar em cada coluna e como a plataforma escolhe a cotação exibida no checkout.
Depois de importar a planilha, use o simulador de envio para testar CEPs e dimensões antes de oferecer o frete aos seus clientes. O passo a passo está em como configurar a Tabela de Frete Personalizada na minha loja.