{"section":"tutorials","requestedLocale":"pt","requestedSlug":"planilha-de-frete","locale":"pt","slug":"planilha-de-frete","path":"docs/pt/tutorials/envio/estratégia-de-envio/planilha-de-frete.md","branch":"main","content":"A planilha de frete é uma maneira de cadastrar os preços de envio que serão oferecidos aos seus clientes. Ela contém informações como os intervalos de código postal, o peso aceito e o valor do serviço cobrado pela empresa que realizará a entrega.\n\nAs informações da planilha de frete devem ser preenchidas de acordo com o contrato do serviço de entrega que sua loja possui com transportadoras ou entregadores. \n\nPara cadastrar preços de envio pela planilha de frete é necessário:\n\n1. [Preencher os campos da planilha](#preencher-os-campos-da-planilha)\n2. [Enviar o arquivo pelo Admin VTEX](#enviar-o-arquivo-pelo-admin-vtex)\n\n> ℹ️ Há também como cadastrar preços de envio pelo módulo [Tarifas de Envio](/pt/docs/tutorials/gerenciar-tarifas-de-envio). Recomendamos utilizar a [Planilha de frete](/pt/docs/tutorials/planilha-de-frete) ao incluir vários intervalos de código postal, e utilizar Tarifas de Envio para gerenciar os preços de frete já cadastrados e para cadastrar cada intervalo de código postal individualmente.\n\n## Preencher os campos da planilha\n\nPara o preenchimento dos campos da planilha é preciso certificar-se dos termos acordados com a empresa responsável pela entrega dos produtos da sua loja. É a partir do contrato realizado que os campos da planilha serão preenchidos.\n\nPara auxiliar no preenchimento, baixe e utilize a planilha modelo disponível em **Envio > Estratégia de envio > Políticas de envio > Criar política de envio**, clicando em `Download de planilha modelo` na seção **Upload de tarifas de envio**.\n\nDe forma geral, você deve preencher as colunas considerando que para cada localidade há: \n\n* Um intervalo de código postal associado (ou um polígono de geolocalização)\n* Faixas de peso aceitáveis\n* Valores fixos e adicionais para realização da entrega\n* Volume máximo para as entregas.\n\nConfira a tabela a seguir para entender cada campo detalhadamente.\n\n| **Coluna** | **Descrição** | **Observações** |\n|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `ZipCodeStart` | O início do intervalo de faixa do código postal (CEP). | O preenchimento dos intervalos de código postal deverá ser feito apenas se o campo **PolygonName** não for preenchido, pois são dados de função equivalente.
Os campos devem conter até 8 dígitos. Não se deve usar caracteres especiais, somente números e letras.
O preenchimento deve obedecer a seguinte regra:
- Para intervalos apenas numéricos, o limite aceito é de `0000000` até `99999999`.
- Para intervalos apenas alfabéticos, o limite aceito é de `AAAAAAAA` até `ZZZZZZZZ`.
- Para intervalos que utilizam letras e números, o limite final aceito é `ZZZZZZZZ`. |\n| `ZipCodeEnd` | O final do intervalo de faixa do código postal (CEP). | |\n| `PolygonName` | Identificação do polígono definido na função de [geolocalização](/pt/docs/tutorials/gerenciar-geolocalizacao/). | Para usar a geolocalização, após preencher a coluna **PolygonName** com os valores desejados, preencha as colunas **ZipCodeStart** e **ZipCodeEnd** com o valor `0`.
Este campo deverá ser preenchido somente se os campos **ZipCodeStart** e **ZipCodeEnd** não forem usados, pois são dados de função equivalente. |\n| `WeightStart` | Limite inicial do intervalo de peso aceito, em número decimal. | Considere que a unidade de peso é a mesma do [preenchimento de campos de cadastro de SKU](/pt/docs/tutorials/adicionar-ou-editar-sku).
Por exemplo, se ao cadastrar os SKUs você utilizou gramas, esse será o padrão utilizado em **WeightStart** e **WeightEnd**. |\n| `WeightEnd` | Limite final do intervalo de peso aceito, em número decimal. | |\n| `AbsoluteMoneyCost` | O valor fixo de frete que deverá ser cobrado, em número decimal. | Caso haja valores adicionais, o preço final cobrado será o valor fixo acrescido do valor adicional. |\n| `PricePercent` | [Adicional por preço](/pt/docs/tutorials/adicionais-de-frete), calculado em número decimal de acordo com o preço dos produtos no carrinho. Para o preenchimento da tabela, utilize o valor em porcentagem. Por exemplo: para um adicional de 10% preencha a tabela com 10. | Utilize o campo nos casos em que exista um adicional de preço para a entrega.
Os [adicionais de frete](/pt/docs/tutorials/adicionais-de-frete) são somados ao valor fixo. |\n| `PriceByExtraWeight` | [Adicional por peso](/pt/docs/tutorials/adicionais-de-frete), calculado de acordo com o peso do carrinho, em número decimal. | Utilize o campo nos casos em que exista um adicional de preço para a entrega.
Os [adicionais de frete](/pt/docs/tutorials/adicionais-de-frete) são somados ao valor fixo.
Considere que a unidade de peso está relacionada às mesmas utilizadas no [preenchimento de campos de cadastro de SKU](/pt/docs/tutorials/adicionar-ou-editar-sku) (por exemplo: grama, quilograma e oz). |\n| `MaxVolume` | Volume máximo aceito, em número decimal. | Considere que a unidade de volume está relacionada às dimensões cadastradas no [preenchimento de campos de cadastro de SKU](/pt/docs/tutorials/adicionar-ou-editar-sku).
Por exemplo, se as arestas (altura, largura e comprimento) estiverem em centímetros, o campo de **MaxVolume** deve estar em cm³. |\n| `TimeCost` | Tempo de entrega do pedido pela transportadora, no formato **DD.HH:MM:SS**. | Por exemplo: se o tempo para a realização da entrega é de 4 dias e meio, o campo deve ser preenchido da seguinte forma: 04.12:00:00. |\n| `Country` | País onde a entrega será realizada, preenchido com o código ISO de 3 dígitos. | Para consultar o código ISO do país, acesse [Country Codes](https://countrycode.org/). |\n| `MinimumValueInsurance` | [Valor adicional de seguro](/pt/docs/tutorials/adicionais-de-frete), configurado com um valor absoluto, em número decimal. | O valor cadastrado no campo é adicionado ao frete.
No entanto, só será adicionado quando o [Adicional por preço](/pt/docs/tutorials/adicionais-de-frete) for menor que o campo *MinimumValueInsurance*.
Veja em [Para que serve o campo Minimum Value Insurance?](/pt/docs/tutorials/para-que-serve-o-campo-na-tabela-de-frete-minimum-value-insurance). |\n\n> ℹ️ Para fins de usabilidade de termos, utilizamos em nossa documentação o termo \"peso\" ao invés de \"massa\".\n\nVeja abaixo um exemplo de preenchimento dos campos, considerando o formato aceito em cada coluna. \n\n\n\n## Enviar o arquivo pelo Admin VTEX\n\nA planilha é um arquivo enviado pelo Admin VTEX que deverá ser enviado no formato de **.xls** ou no formato compactado **.zip**. Após preencher os campos, envie o arquivo pela plataforma.\n\nO envio da planilha é feito no cadastro ou na edição de **Política de Envio.** Para isso:\n\n1. No Admin VTEX, acesse **Envio > Estratégia de Envio > Políticas de Envio** ou digite *Estratégia de envio* na barra de busca no topo da página. \n2. Clique no botão `Criar política de envio` caso queira utilizar uma nova Política de Envio ou clique no ícone de lápis ao lado de uma Política de Envio existente.\n3. Após fazer download da planilha modelo e [preencher os campos](#preencher-os-campos-da-planilha), faça upload do arquivo na seção Upload de tarifas de envio.\n4. Ao finalizar, clique em `Salvar Alterações`.\n\n\n\n> ⚠️ Para cadastrar uma **nova** Política de Envio, é preciso preencher outros campos além da Planilha de frete. Entenda como criar, editar e preencher todos os campos necessários no artigo [Política de Envio](/pt/docs/tutorials/politica-de-envio).\n\n> ❗ Cada aba dentro da planilha não pode ultrapassar 65.536 linhas. É possível criar várias abas na mesma planilha, respeitando o limite de linhas. Não há limite de abas dentro do arquivo, no entanto o arquivo total não pode exceder 10Mb. Se preciso, compacte o arquivo em formato **.zip**. Se ainda não for suficiente, divida em dois arquivos e cadastre outra política de envio para fazer upload do segundo arquivo criado.\n\nCaso exista algum problema no preenchimento dos campos do arquivo enviado, você receberá um email informando o erro. Não esqueça de verificar o preenchimento correto antes de realizar uma nova tentativa de envio.\n\nÉ possível que o upload e a confirmação de cadastro de planilha demore um pouco, pois o processamento do arquivo pode não ocorrer de imediato, pelo volume de informações."}