VL_MINFRETE — Valor Frete Mínimo

Tela de configuração: TFA075 — Parâmetros de Preço de Frete
Localização: Aba Frete → campo Valor Frete Mínimo
Tabela: PARMPRECOFRETE.VL_MINFRETE
Tipo de controle: edtVL_MINFRETE (edit numérico, 15,5 decimais)
Valor padrão: NULL (zero quando não informado)

Resumo

O campo Valor Frete Mínimo (VL_MINFRETE) define um piso (valor mínimo) para o frete calculado. Quando o cálculo de frete resultar em um valor inferior ao informado aqui, o sistema aplica o valor mínimo como piso, garantindo que a transportadora nunca receba um frete abaixo desse limiar para a regra de preço configurada.

Telas impactadas

Tela	Descrição
TFA075	Cadastro de parâmetros de preço de frete.
Faturamento (faturamento automático / cálculo de frete)	Rotinas que executam CALCULA_FRETE e suas sub-procedures.
Formação de preço de venda	Rotinas que calculam preço de venda com frete embutido.

Campos envolvidos

• PARMPRECOFRETE.VL_MINFRETE — Valor mínimo de frete cadastrado para a regra.
• Campos relacionados na mesma tabela que frequentemente interagem com o piso:
  • PRF.PC_ADVALOR / PRF.TP_CALCULOADVALOR — Percentual/modo de ad valorem.
  • PRF.VL_CTEPESO, PRF.VL_CTEVOLUME, PRF.VL_VOLUMEFRETE, PRF.VL_PORPESO — Componentes de cálculo base.
  • PRF.VL_TRTMINIMO, PRF.PC_FATORTRT, PRF.VL_TDEMINIMO, PRF.PC_FATORTDE, PRF.VL_TAS — Parâmetros de TRT e TDE.
  • PRF.PS_MINIMOFRETE, PRF.VL_FRETEEXCEDENTE, PRF.VL_PESOEXCEDENTE — Faixas de peso/excedente.

Comportamento

O que faz: Define o valor mínimo que o frete calculado (ou base de cálculo de TRT/TDE) pode assumir.
Editável: Sim (campo edit numérico).
Obrigatório: Não. Quando vazio ou zero, o piso é zero e o frete assume o valor bruto calculado.
Restrição: Deve ser um valor numérico positivo. Não há validadores de tela adicionais.

Regra de aplicação resumida

O valor de VL_MINFRETE entra em jogo após o cálculo bruto do frete (por peso, por volume/cx ou por excedente). O motor de cálculo compara o resultado bruto com outros componentes (ad valorem, seguro, gris, pedágio etc.) e estabelece o seguinte piso:

Frete Final = MAX(Frete Calculado, Ad Valorem, VL_MINFRETE)

Importante: A forma exata de comparação varia conforme a modalidade de cálculo (normal peso, normal caixa, geral, TRT, TDE etc.), conforme detalhado nas procedures abaixo.

Simulação passo a passo

1. Acesse o programa TFA075 — Parâmetros de Preço de Frete.
2. Localize ou cadastre uma regra de preço (PARMPRECOFRETE) vinculada a uma transportadora e região comercial.
3. Na aba Frete, preencha os campos de cálculo base (Valor por Peso, Valor por Volume, CTE Peso, CTE Volume etc.).
4. No campo Valor Frete Mínimo, informe o piso desejado.

   Exemplo: Digite R$ 50,00 (ou 50.00 dependendo da máscara numérica).

5. Preencha os demais campos necessários (Ad Valorem, Gris, Pedágio, TRT, TDE conforme seu cenário).
6. Salve o registro (Ctrl+S ou botão Gravar).
7. Para validar, emita uma nota fiscal ou execute o cálculo de frete em uma tela que utilize essa regra (ex.: faturamento de pedido).
   • Calcule um frete cujo valor bruto seja R$ 30,00.
   • Resultado esperado: O sistema exibirá o frete final como R$ 50,00 (o valor mínimo prevalece sobre o cálculo bruto).

Exceção / Importante:

• Se o frete calculado já for superior ao valor mínimo informado (ex.: R$ 80,00), o frete permanece R$ 80,00 sem alteração.
• Se o parâmetro de ad valorem (PC_ADVALOR / TP_CALCULOADVALOR, configurado na mesma aba e tabela PARMPRECOFRETE) gerar um valor maior que o frete bruto e maior que VL_MINFRETE, o ad valorem poderá prevalecer como base, dependendo da modalidade TP_CALCULOFRETE/TP_CALCULOFRETEFINAL.
• Em rotinas de TRT e TDE, o VL_MINFRETE pode compor a base de cálculo (sendo somado a gris, pedágio, adicionais e depois multiplicado pelo fator), e não simplesmente substituir o frete final. Verifique a coluna Modo de uso na tabela de procedures.
• O campo ST_CONSIDERAADVALOR (configurado em TFA075, aba Frete, tabela PARMPRECOFRETE) influencia se o ad valorem entra na disputa com o valor mínimo.

Procedures impactadas

Referência direta ao campo VL_MINFRETE

Procedure	Arquivo	Linha	Modo de uso
CALCULA_FRETEGERAL	Scripts/CALCULA_FRETEGERAL.sql	46, 71, 92, 192, 197, 199	Define o maior valor entre frete calculado, ad valorem e VL_MINFRETE. Se VL_MINFRETE for o maior, atribui ao frete final.
CALCULA_FRETENORMALCAIXA	Scripts/CALCULA_FRETENORMALCAIXA.sql	11, 15, 18, 28, 29	Calcula frete por volume/caixa. Se O_VL_FRETE (frete de saída) for menor que V_VL_MINFRETE, atribui o piso V_VL_MINFRETE.
CALCULA_FRETENORMALPESO	Scripts/CALCULA_FRETENORMALPESO.sql	18, 22, 26, 78, 79	Calcula frete normal por peso. Se O_VL_FRETE (frete de saída) for menor que V_VL_MINFRETE, atribui o piso V_VL_MINFRETE.
CALCULA_FRETEPESOEXCEDENTETAB	Scripts/CALCULA_FRETEPESOEXCEDENTETAB.sql	27	Seleciona VL_MINFRETE e VL_VOLUMEFRETE para composição do frete excedente por faixa de peso.
CALCULA_TDE	Scripts/CALCULA_TDE.sql	21, 32, 36, 53, 56, 59	Determina o maior valor entre V_VL_ITEM, V_VL_ADVALOR e V_VL_MINFRETE para definir a base do TDE.
CALCULA_TRTMAIORVALORBASE	Scripts/CALCULA_TRTMAIORVALORBASE.sql	19, 27, 30, 44, 45, 47, 50	Escolhe o maior valor entre V_VL_FRETE, V_VL_ADVALOR e V_VL_MINFRETE como base do TRT.
CALCULA_TRTSOMBASEXMINIMO	Scripts/CALCULA_TRTSOMBASEXMINIMO.sql	19, 29, 32, 51	Soma V_VL_MINFRETE com pedágio, gris e adicionais, aplicando depois o fator percentual de TRT (PC_FATORTRT).

Candidatas por uso da tabela PARMPRECOFRETE (referência indireta)

As procedures/views abaixo recebem NR_SEQUENCIAPARMPRECOFRETE como parâmetro de entrada e acessam a tabela PARMPRECOFRETE, mas não citam o campo VL_MINFRETE literalmente nos trechos analisados. O impacto funcional direto não pode ser confirmado sem revisão do corpo completo das procedures:

• AJUSTE_FORMACAOPRECOVENDA
• CALCULA_CARGAFECHADA
• CALCULA_FORMACAOPRECOVENDA
• CALCULA_FRETE
• CALCULA_FRETEMINIMOTABELACAIXA
• CALCULA_FRETEMINIMOTABELAMAIOR
• CALCULA_FRETEMINIMOTABELAPESO
• CALCULA_GRIS
• CALCULA_PEDAGIO
• CALCULA_PESOADICIONAL
• CALCULA_TAXAADVALOR
• CALCULA_TRT
• CALCULA_VALORADICIONALNOTA
• RETORNA_CARGAFECHADA

Tabela Comparativa Resumida

Cenário / Efeito	Como funciona
Frete Normal por Peso	Após cálculo quantidade × vl_porpeso (+ cte), aplica piso VL_MINFRETE.
Frete Normal por Caixa	Após cálculo quantidade × vl_volumefrete (+ cteVolume), aplica piso VL_MINFRETE.
Frete Geral / Integração	O frete final é o maior entre: frete bruto, ad valorem e VL_MINFRETE.
TRT — Maior Valor Base	A base para aplicação do percentual de TRT é o maior entre frete, ad valorem e VL_MINFRETE.
TRT — Soma Base × Mínimo	VL_MINFRETE é somado a pedágio, gris e adicionais, e o total é multiplicado por % Fator TRT.
TDE — Maior Valor Base	Define a maior base entre item, ad valorem e VL_MINFRETE para cálculo de TDE.
Frete Excedente (tabela por faixa)	VL_MINFRETE é lido como componente da regra, podendo influenciar o piso da faixa excedente.

Nota: O campo VL_MINFRETE não possui opções discreta (combo). Seu comportamento é puramente numérico: quanto maior o valor informado, mais frequente será a ativação do piso no cálculo final do frete.