Encomendas - Tabelas de Frete

O que é

Esta tela reúne as tabelas de frete das encomendas: são elas que dizem quanto cobrar do seu cliente para transportar cada pacote. Uma tabela pode calcular o preço por faixa de peso, pelo número de quilômetros rodados, por uma rota fixa de origem e destino (zona), ou misturar mais de um desses critérios na mesma tabela.

Você normalmente chega aqui depois de configurar o módulo de Encomendas, ao decidir como o frete vai ser precificado, ou quando precisa ajustar valores que já estão em uso — subir uma faixa de peso, criar uma rota nova, ou desativar temporariamente uma forma de cobrança.

Como usar

1. No menu do painel, entre em Módulos > Transporte de Encomendas > Configurações e clique no botão Tabelas de frete.
2. Clique em Nova Tabela, no canto superior direito da tela. Abre a janela de cadastro.
3. Preencha Nome (como a tabela vai aparecer na lista) e Tipo: Por peso, Por quilometragem, Por zona (origem x destino) ou Mista. O tipo escolhido não trava quais campos você pode preencher — todos ficam disponíveis —, mas indica qual critério a tabela usa na prática.
4. Preencha os valores que se aplicam ao seu caso:
   • Taxa mínima (R$) - valor cobrado em qualquer entrega, independente do resto do cálculo.
   • Valor por km (R$) - usado quando o cálculo leva a distância em conta.
   • Fator cubagem (kg/m³) - entre 50 e 1000. Deixe em branco para usar o valor padrão definido em Configurações do módulo.
   • Ad valorem (% do valor declarado) - percentual cobrado sobre o valor que o cliente declara para a encomenda.
   • Seguro / taxa de risco (%) - percentual para cobrir o risco do transporte.
   • Adicionais (R$) - valores extras para Coleta na porta, Entrega na porta, Embalagem e Urgência; preencha só os serviços que você oferece.
   • Faixas de peso - clique em Adicionar faixa para cada faixa, e preencha até quantos quilos vale cada preço (ex: até 5 kg = R$ 20,00).
5. Clique em Salvar. A tabela já entra na lista e pode ser usada no cálculo do frete de novas encomendas.

Para tabelas do tipo Por zona ou Mista, depois de criadas você ainda cadastra as rotas: abra Zonas (origem para destino) dentro do card da tabela e preencha Origem, Destino, Preço (R$) e Prazo (em dias) no formulário que aparece embaixo da lista de rotas.

O que você precisa saber antes

• O tipo escolhido não limita os campos preenchíveis. Mesmo numa tabela "Por peso", nada impede de preencher Valor por km ou Ad valorem — o sistema guarda tudo o que você preencher no cálculo. O tipo serve mais como identificação do critério principal da tabela do que como uma trava do formulário.
• Editar ou excluir uma tabela não muda o preço de encomendas já emitidas. O valor do frete é calculado e guardado no momento em que a encomenda é registrada; mudanças na tabela só valem para as próximas.
• Excluir uma tabela apaga junto todas as zonas (rotas) cadastradas nela. A confirmação de exclusão avisa isso antes de você confirmar, e não há como desfazer.
• Desativar não é o mesmo que excluir. Na edição da tabela aparece a opção Tabela ativa (esse campo só existe ao editar, não ao criar); desmarcá-la tira a tabela do cálculo sem apagar nada, e ela continua na lista com o selo "Inativa".
• Deixar o Fator de cubagem em branco não significa zero — o cálculo usa o fator padrão configurado em Configurações do módulo de Encomendas.
• Os campos em reais aceitam o formato brasileiro (1.234,56) e são convertidos automaticamente; não é preciso se preocupar com ponto ou vírgula.

Casos especiais

Nenhuma tabela cadastrada ainda

Quando não há nenhuma tabela, a tela mostra um aviso explicando que as tabelas definem como o frete é calculado (peso, km, zona ou combinação), com um botão Criar primeira tabela que abre a mesma janela de cadastro.

Tabela do tipo zona ou mista sem nenhuma rota

Se a tabela é do tipo Por zona ou Mista mas ainda não tem nenhuma rota cadastrada, o bloco Zonas (origem para destino) aparece com a mensagem "Nenhuma zona cadastrada". Sem ao menos uma rota, esse critério de cálculo simplesmente não tem o que aplicar; o formulário para adicionar a primeira rota já fica logo abaixo.

Remover uma rota específica

Dentro do bloco de zonas, cada rota cadastrada tem um X ao lado. Clicar nele remove só aquela rota, sem afetar as demais nem o resto da tabela.

Erros comuns e como resolver

• O formulário não salva e destaca Nome ou Tipo - Causa: Nome e Tipo são os únicos campos obrigatórios da tabela. Solução: preencha os dois antes de salvar.
• A rota (zona) não é adicionada - Causa: Origem, Destino e Preço são obrigatórios no formulário de rota; Prazo é opcional. Solução: confira se os três campos obrigatórios foram preenchidos.
• Os botões Editar e Excluir não aparecem em nenhum card - Causa: seu usuário não tem a permissão para configurar Encomendas. Solução: peça a um Proprietário ou Gerente para liberar a permissão, ou peça para que ele faça a alteração.

Onde encontrar

• URL: /admin/encomendas/tabelas-frete
• Caminho no menu: Módulos > Transporte de Encomendas > Configurações > Tabelas de frete
• Permissão necessária: encomendas.config
• Addon necessário: Transporte de Encomendas

Veja também

• Encomendas - Configurações - tela central de ajustes do módulo, de onde se chega às Tabelas de frete
• Encomendas - Linhas Próprias - rotas de transporte que usam os valores definidos nas tabelas de frete