Central de Ajuda

Perguntas frequentes, tutoriais e os canais para falar com a gente.

Frete por distância da rota

Como configurar o Frete por Distância da Rota

Cadastre valores de entrega de acordo com a distância da rota entre sua loja e o endereço do cliente.

Antes de começar: o Frete por Distância utiliza a Routes API da Google Maps Platform. Para usar o recurso, é necessário ter um projeto do Google Cloud com faturamento habilitado e uma chave de API.

1 Crie e configure a chave da Google Maps Platform

Se você ainda não possui uma chave, siga estes passos:

  1. Acesse a página oficial da Google Maps Platform e entre com sua conta Google. Se for o primeiro acesso, siga a configuração inicial da plataforma. Abrir Google Maps Platform.
  2. Acesse o Google Cloud Console, crie um novo projeto ou selecione um projeto existente e vincule-o a uma conta de faturamento. Abrir Google Cloud Console.
  3. No projeto selecionado, acesse APIs e serviços > Biblioteca, pesquise por Routes API e clique em Ativar.
  4. Depois, acesse APIs e serviços > Credenciais e clique em Criar credenciais > Chave de API. Copie a chave criada.
  5. Edite a chave e, em Restrições de API, escolha Restringir chave e permita somente a Routes API. Não utilize restrição por site/referenciador HTTP, pois as consultas do frete são realizadas pelo servidor da plataforma.
Importante: o Google exige faturamento habilitado para utilizar a Routes API. O uso poderá gerar cobranças diretamente na sua conta Google. Consulte os preços e limites vigentes antes de utilizar o serviço.
Guia oficial da Routes API Preços e faturamento

2 Informe a chave da API

No painel da loja, acesse Loja > Dados, localize Frete por distância da rota, cole a chave da API do Google Maps e clique em Salvar. Depois, utilize Testar para confirmar se a integração está configurada corretamente.

Campo para informar e salvar a chave da API do Google Maps
Informe a chave da API e salve a configuração.

3 Cadastre as faixas de distância

Clique em Cadastrar faixas. Você pode criar várias faixas de distância de uma só vez.

Se quiser que essa modalidade apareça junto com os outros fretes da loja, mantenha marcada a opção Exibir frete por distância com os demais fretes.

Botão Cadastrar faixas e opção para exibir o frete por distância com os demais fretes
Clique em “Cadastrar faixas” para informar as regras do frete.

4 Preencha os valores e salve

Informe os dados de cada faixa:

  • Nome da faixa: nome que será apresentado ao cliente.
  • KM inicial e KM final: distância atendida pela faixa.
  • Ilimitado: marque quando a faixa não possuir distância máxima.
  • Peso mínimo e máximo: opcionais. Preencha caso deseje inserir faixa de peso no frete.
  • Frete: valor cobrado pela entrega.
  • Pedido mínimo: opcional. Preencha caso deseje estipular um valor mínimo de pedido para esse frete.
  • Prazo: prazo de entrega em dias.
Exemplo: 0 a 10 km = R$ 15,00  •  10,01 a 30 km = R$ 25,00  •  acima de 30 km = marque Ilimitado.
Tela de cadastro de várias faixas de distância e valores de frete
Adicione quantas linhas precisar clicando em "adicionar linha" e clique em “Salvar faixas”.

Faça um teste na loja

Depois de salvar, acesse a loja como cliente e faça uma simulação de frete. O sistema calculará a distância da rota e exibirá a faixa correspondente às regras cadastradas.

Mantenha o endereço da loja (menu Loja > Dados aba "Endereço") completo e atualizado, pois ele será utilizado como ponto de origem do cálculo.