Pular para o conteúdo principal

Pesquisa

Início / / / Contratos de Frete

Contratos de Frete

Suelen
Atualizado

1. Visão Geral

Contratos de Frete permitem que lojas que trabalham diretamente com transportadoras configurem suas próprias tabelas de cotação, definindo faixas de CEP, valores e prazos de entrega.

Para cadastrar uma tabela, é necessário criar um novo contrato de frete com o nome da transportadora e configurar os parâmetros desejados: peso, altura, peso cubado, valor mínimo, URL de rastreamento, entre outros. Depois, são adicionadas as faixas de CEP — manualmente ou via planilha de importação.

Lojas que utilizam ERP também podem inserir, consultar, ativar/desativar ou excluir um contrato de frete diretamente pela API.

2. Cadastrando um Contrato de Frete

Para adicionar um contrato de frete no Admin, acesse: Fretes >> Contratos de Frete >> Adicionar Contrato.

Preencha o formulário de "Configurações" e salve o contrato antes de seguir para os demais campos.

Campo Descrição
Nome Nome do contrato de frete exibido no painel administrativo.
Nome Exibição Nome que será exibido na loja, na etapa de seleção do frete.
Tempo mínimo de despacho (dias) Quantos dias, no mínimo, o contrato leva para despachar o pedido. Deixe 0 para assumir as configurações gerais.
Agendamento Agendamento vinculado à tabela de frete.
Centro de Distribuição CD(s) válidos que essa tabela de frete atende.
Clonar Tabela Cria uma cópia idêntica de um contrato já existente.

Após salvar as informações, é possível conferir os Centros de Distribuição vinculados a cada tabela.

Saiba mais sobre agendamento de exibição em Agendamento de Fretes. Para detalhes sobre prazo em horas e horário de corte, acesse Prazo de Cotação em Horas.

3. Faixas de CEP

As faixas de CEP definem regiões específicas atendidas por um contrato de frete, permitindo configurar valores e prazos diferentes por localidade.

3.1 Acessando a Tela de Faixas de CEP

No painel administrativo, acesse Configurações >> Faixas de CEP. Essa tela permite visualizar, pesquisar e modificar os registros de CEP cadastrados. As ações disponíveis são:

  • Adicionar Faixa de CEP: cadastra uma nova faixa.
  • Alterar Valores e Prazo: abre um modal para alterar em massa os campos Valor Frete e Prazo Entrega, com notificação de conclusão após o processamento.
  • Importar Faixas de CEP: abre um modal para importar uma planilha com faixas de CEP.
  • Exportar Faixas de CEP: exporta uma planilha com as faixas existentes, ou um modelo vazio.
  • Limpar Faixas de CEP: remove todas as faixas de CEP cadastradas.

3.2 Campos da Faixa de CEP

Campo Descrição
Código Identificador único da faixa (preenchido automaticamente).
CEP Inicial * Primeiro CEP do intervalo configurado.
CEP Final * Último CEP do intervalo.
Peso Inicial * Peso mínimo aceito para essa faixa.
Peso Final * Peso máximo aceito para essa faixa.
Valor do Frete Custo básico do frete para essa faixa de CEP.
Valor do Preço Percentual aplicado sobre o valor do produto.
Valor do Peso Custo adicional por peso excedente.
Prazo de Entrega * Tempo estimado de entrega para essa faixa.
Ações Botões para salvar ou excluir a configuração.

* Campos obrigatórios.

3.3 Adicionando uma Nova Faixa de CEP

  1. Clique no botão "Adicionar Faixas de CEP".
  2. Preencha os campos obrigatórios: CEP Inicial, CEP Final, Peso Inicial, Peso Final e Valor do Frete.
  3. Se necessário, defina o Valor do Preço e/ou o Valor do Peso, conforme a política de precificação da transportadora.
  4. Informe o Prazo de Entrega estimado para a região cadastrada.
  5. Clique em "Salvar" para concluir.

3.4 Importação e Exportação em Massa

  • Importar Faixas de CEP: carrega um arquivo com múltiplas faixas de uma só vez. Ao passar o mouse sobre o botão (sem clicar), é exibida a opção de exportar um modelo de importação.
  • Após o envio, o processamento é iniciado e você é notificado quando concluído. Em caso de erro, uma planilha detalhada com os problemas encontrados é disponibilizada para revisão.
  • Exportar Faixas de CEP: gera um arquivo com todas as faixas cadastradas no sistema, facilitando o gerenciamento e a análise.
Importante: O arquivo importado não pode ultrapassar 50 MB. Caso sua planilha seja maior, divida as informações em arquivos menores e importe separadamente.

4. Cálculo de Frete: Valor Preço vs. Valor Peso

Dois fatores podem ser aplicados para compor o valor final do frete: o Valor Preço e o Valor Peso.

  • Valor Preço: percentual adicionado sobre o valor do produto.
  • Valor Peso: valor adicionado ao frete para cada grama que exceder o peso inicial da faixa.

4.1 Exemplo Prático

Dados do cenário:

Dado Valor
Produto Smartphone 
Valor do produto R$ 1.285,00
Peso 201 gramas
Custo inicial da faixa de CEP R$ 5,50

Cenário com Valor Preço (1,50%)

Fórmula: Valor da Faixa + (Preço do Produto x Valor Preço)

R$ 5,50 + (R$ 1.285,00 x 1,50%) = R$ 5,50 + R$ 19,27

Frete cobrado: R$ 24,77

Cenário com Valor Peso (R$ 0,02/g excedente, faixa inicial 150g)

Fórmula: Valor da Faixa + (Gramas excedentes x Valor Peso)

R$ 5,50 + [(201g - 150g) x R$ 0,02] = R$ 5,50 + R$ 1,02

Frete cobrado: R$ 6,52

Enquanto o Valor Preço aumenta o custo do frete proporcionalmente ao valor do produto, o Valor Peso ajusta a cobrança de acordo com o peso excedente — ambos podem ser combinados na mesma faixa de CEP.

5. Base de Cálculo do Adicional de Frete em Pedidos com Múltiplos CDs

Para lojas que operam com múltiplos Centros de Distribuição (CDs) e utilizam o adicional de frete do tipo "Valor Preço" nas Faixas de CEP, é possível escolher qual valor serve de base para o cálculo do adicional: o valor total do carrinho ou o subtotal de cada CD individualmente.

No painel administrativo, acesse Fretes >> Configurações e pesquise pela configuração:

Configuração: "Base de Cálculo do Valor Adicional do Contrato de Frete (Valor Preço)"

No campo "Valor", informe:

Valor Comportamento
1 — Valor total do carrinho (padrão) O adicional é calculado sobre o valor total do pedido, somando todos os itens, independentemente do CD de origem.
2 — Valor por Centro de Distribuição (novo) O adicional é calculado sobre o subtotal dos itens atribuídos a cada CD do pedido, refletindo com mais precisão o custo de expedição de cada centro.

Exemplo com a opção "2 — Valor por Centro de Distribuição": em um pedido com itens divididos entre CD-A (R$ 200,00) e CD-B (R$ 500,00), o adicional do CD-A é calculado sobre R$ 200,00 e o do CD-B sobre R$ 500,00 — cada CD reflete exatamente o subtotal dos seus próprios itens.

Importante: Por padrão, todas as lojas têm o valor "1" configurado, para não impactar tabelas já calibradas. A alteração para "2" é opcional. Lojas com apenas um CD não sofrem nenhuma alteração de comportamento, independentemente do valor configurado.

 

6. Gerenciando Contratos e Tabelas de Frete

6.1 Ordenação na Tela de Serviços

Acesse: Fretes >> Serviços de Frete. As tabelas de frete são exibidas com ordenação automática, priorizando as tabelas ativas — as inativas aparecem ao final da lista.

6.2 Filtro na Tela de Contratos de Frete

Acesse: Fretes >> Contratos de Frete. Por padrão, apenas os contratos ativos são exibidos, facilitando a identificação. O filtro (ícone de lupa) pode ser ajustado para exibir todos os contratos, apenas ativos ou apenas inativos, com busca por nome, CD ou assinatura.

6.3 Duplicando uma Tabela de Frete Existente

Para agilizar a criação de novas tabelas, use a opção "Clonar Tabela", disponível em Fretes >> Serviços de Frete >> Tabela.

  1. Selecione a tabela desejada e clique em "Editar".
  2. Clique em "Clonar Tabela" e confirme a ação.
  3. A tabela será copiada rapidamente, mantendo as mesmas configurações.

6.4 Alterando Valores e Prazos em Massa

Em Fretes >> Serviço >> Tabela, selecione a tabela desejada e, na aba Faixas de CEP, clique em "Alterar Valores e Prazos". Informe o valor que deseja somar ou subtrair — o sistema aplica o ajuste automaticamente em todas as linhas da tabela.

Exemplo Resultado
Acréscimo de R$ 10,00 em uma linha com frete R$ 25,55 Novo valor: R$ 35,55
Acréscimo de 2 dias em uma linha com prazo de 2 dias Novo prazo: 4 dias
Redução de 2 dias em uma linha com prazo de 1 dia Novo prazo: 0 dias (não é possível prazo negativo)
Atenção: Para reduzir prazos ou valores, informe o sinal de subtração (-) antes do número.

 

7. Priorização da Tabela de Frete por Dimensões

É possível cadastrar as dimensões aceitas por cada transportadora. Essas dimensões são validadas no carrinho de compras no momento da cotação de um CEP.

O retorno de uma tabela depende da Priorização dos Centros de Distribuição. Caso a tabela possua limite de dimensão, o serviço de frete retorna a cotação do próximo CD da lista de priorização que atenda à dimensão do carrinho, se existir.

Para ativar esse comportamento, habilite a configuração "Priorização tabela de frete" em Configurações de Admin >> Configurações Gerais (pesquise pelo nome no campo de busca).

Importante: Com a configuração desativada, o CD prioritário é considerado na cotação e a tabela não é exibida no carrinho quando a dimensão não é atendida. O tempo de cache dessa configuração é de até 30 minutos.

 

8. Contratos de Frete via API

Permite o gerenciamento de contratos de frete de forma massiva e eficiente: criação, consulta, atualização e demais operações via integração.

Confira o conteúdo completo na documentação técnica: Inserindo um Novo Contrato de Frete.


 

Artigos relacionados

Comentários

0 comentário

Por favor, entre para comentar.