Como preencher a planilha da Tabela de Frete Personalizada para lojas Next na Nuvemshop?
Entenda o formato da planilha .xlsx da Tabela de Frete Personalizada da Nuvemshop: as colunas obrigatórias (faixa de CEP, peso, preço, prazo, moeda e país), exemplos de preenchimento, regras de prioridade entre faixas e como dividir arquivos grandes.
Última atualização: 26/09/2026
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.
Dica
O aplicativo Tabela de Frete Personalizada é exclusivo do plano Next.
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".
Dica
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.
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
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
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.
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
Observação
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
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.
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.
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.
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.
