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 >> Novo Contrato.
Acompanhe no resumo as informações que já foram preenchidas na tabela.
Detalhamento dos campos:
| Campo | Descrição |
| Nome | Nome do contrato de frete exibido no painel administrativo. |
| Nome de 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. Mais detalhes. |
| Horário de Corte | Horário limite para cumprir o prazo de envio. Ao ultrapassar o horário de corte, terá um prazo adicional. |
| Prazo Adicional | Tempo adicional para enviar o pedido após o horário de corte. |
| Tipo da Cotação | Define se a tabela será em dias ou em horas. Mais detalhes. |
Realizando os Vínculos
Detalhamento dos campos:
| Campo | Descrição |
| Centro de Distribuição | CD(s) que essa tabela de frete atende. |
| Grupos de Frete | Realiza o vínculo da tabela aos grupos de fretes. Mais detalhes. |
| Modal de Produto | Realiza o vínculo da tabela aos modais de produtos. Mais detalhes |
Após realizar as configurações, salve a tabela e continue com o cadastro das faixas de CEP.
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.
As ações disponíveis são:
- Adicionar Faixa de CEP: cadastre uma nova faixa.
- Alterar Valores e Prazo: abre um modal para alterar em massa os campos Valor Frete (percentual ou nominal) e Prazo Entrega.
- Exportar Faixas de CEP: exportar uma planilha com as faixas existentes.
- Importar Faixas de CEP: abre um modal para importar uma planilha com faixas de CEP.
- Dowload Modelo de Importação: exporta o modelo que a planilha deve ser preenchida.
-
Limpar Faixas de CEP: remove todas as faixas de CEP cadastradas.
3.1 Alterar Valores e Prazo:
| 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. |
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 (g) * | Peso mínimo aceito para essa faixa. |
| Peso Final (g) * | Peso máximo aceito para essa faixa. |
| Valor do Frete | Custo básico do frete para essa faixa de CEP. |
| % sobre o Produto | Percentual aplicado sobre o valor do produto. |
| R$ por grama excedente | Custo adicional por peso excedente. |
| Prazo de Entrega * | Tempo estimado de entrega para essa faixa. |
| Ações | Botões para editar ou excluir a faixa. |
* Campos obrigatórios.
3.3 Importação e Exportação em Massa
- Importar Faixas de CEP: carrega um arquivo com múltiplas faixas de uma só vez.
- 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.
| 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: % sobre o Produto (valor preço) vs. R$ por gr. excedente (valor peso)
Dois fatores podem ser aplicados para compor o valor final do frete.
- % sobre o Produto (Valor preço): percentual adicionado sobre o valor do produto.
- R$ por gr. excedente (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 % sobre o Produto (1,50%)
Fórmula: Valor da Faixa + (Preço do Produto x % sobre o produto)
R$ 5,50 + (R$ 1.285,00 x 1,50%) = R$ 5,50 + R$ 19,27
Frete cobrado: R$ 24,77
Cenário com R$ por g. excedente (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 % sobre o Produto aumenta o custo do frete proporcionalmente ao valor do produto, o R$ por g. excedente 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 % sobre o Produto (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. Limite de Dimensões e Peso
É possível cadastrar dimensões máximas, fator de cubagem, valor máximo / mínimo aceitas pelas transportadoras, entre outras regras. Essa validação ocorre automaticamente no carrinho de compras durante a cotação de frete.
O comportamento do cálculo varia conforme a opção "Priorização tabela de frete":
Desativada: O sistema considera apenas as transportadoras vinculadas ao CD priorizado. Se as dimensões dos produtos ultrapassarem o limite aceito por esse CD (ou se ele não tiver uma opção de frete válida), nenhuma opção dessa tabela é exibida no carrinho e o sistema não busca em outros CDs.
Ativada: O CD priorizado só é mantido no cálculo se ele retornar uma opção de frete válida para a cotação. Caso o CD priorizado não atenda aos requisitos (como o limite de dimensões do carrinho), o sistema busca automaticamente a cotação no próximo CD da lista de priorização que possua uma tabela válida.
Como configurar:
- Acesse Fretes > Configurações.
- No campo de busca, pesquise por Priorização tabela de frete e habilite ou desabilite a opção conforme a necessidade do seu negócio.
| Importante: O tempo de atualização dessa configuração na loja é de até 30 minutos (tempo de cache). |
7. Duplicando uma Tabela de Frete
Para agilizar a criação de novas tabelas, use a opção "Clonar Tabela", disponível na listagem de tabelas.
- A tabela será duplicada rapidamente, mantendo as mesmas configurações.
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.
Comentários
0 comentário
Por favor, entre para comentar.