VL_MAXIMOPEDAGIO - Teto Máximo do Pedágio

Tela de configuração: TFA075 – Parâmetros de Preço de Frete (Tabela de Frete)
Localização: Aba Gris/Pedágio/Ad Nota/Ad Valor → campo Valor por 100 Kg
Tabela: PARMPRECOFRETE
Valor padrão: 0 (sem teto)

---

Resumo do comportamento

O campo VL_MAXIMOPEDAGIO define o valor máximo (teto) que o pedágio pode atingir para uma tabela de frete específica.
Durante o cálculo do frete, o sistema primeiro computa o pedágio proporcional ao peso ou m³ do item (VL_KGPEDAGIO), obtendo um valor provisório. Em seguida compara esse valor com o teto configurado:

• Se o teto for maior que zero e o pedágio calculado for superior ao teto, o sistema retorna o teto como valor final do pedágio.
• Se o teto for maior que zero e o pedágio calculado for inferior ao teto, o sistema retorna o valor calculado normalmente.
• Se o teto for zero (ou não preenchido), o pedágio é sempre o valor calculado, sem limitação.

O cálculo é executado pela procedure CALCULA_PEDAGIO considerando também:

• TP_CALCULOPEDAGIO (configurado em TFA075, mesma aba) – regra adotada para base de cálculo (P = peso, K = cubagem, outro = maior entre cubagem e peso).
• PS_M3PEDAGIO (configurado em TFA075, mesma aba) – peso de conversão por m³ ou fator de cubagem.
• VL_KGPEDAGIO (configurado em TFA075, mesma aba) – valor cobrado a cada 100 kg (ou fração proporcional).

---

Telas impactadas

• TFA075 – cadastro/edição do valor teto em cada tabela de frete.
• Telas que disparam cálculo automático de frete (ex.: emissão de notas fiscais, cotações, carga fechada) – o teto será aplicado indiretamente quando chamarem a rotina CALCULA_PEDAGIO.

---

Campos envolvidos

Campo	Tabela	Descrição
VL_MAXIMOPEDAGIO	PARMPRECOFRETE	Valor máximo permitido para o pedágio (NUMERIC 15,5)
TP_CALCULOPEDAGIO	PARMPRECOFRETE	Tipo de base de cálculo do pedágio (P, K ou híbrido)
PS_M3PEDAGIO	PARMPRECOFRETE	Fator de cubagem/peso para pedágio
VL_KGPEDAGIO	PARMPRECOFRETE	Valor por 100 kg para pedágio

---

Opções disponíveis

Por se tratar de um campo numérico editável, não existem opções fixas (como em uma combo). O comportamento varia conforme o valor informado:

Valor > 0 – Aplica teto máximo ao pedágio

O que faz	Detalhe
Limita o valor do pedágio	Quando o pedágio calculado ultrapassar o valor informado, o sistema trava no teto.

Simulação passo a passo

1. Acesse TFA075 – Parâmetros de Preço de Frete.
2. Abra a tabela de frete desejada (por transportador e região comercial).
3. Na aba Gris/Pedágio/Ad Nota/Ad Valor, localize o campo Valor por 100 Kg referente ao pedágio (VL_KGPEDAGIO) e informe, por exemplo, R$ 5,00.
4. No campo de teto (próximo na mesma aba), digite R$ 150,00 como Valor Máximo (VL_MAXIMOPEDAGIO).
5. Certifique-se de que TP_CALCULOPEDAGIO esteja configurado conforme a regra desejada (ex.: P para peso).
6. Salve o registro.
7. Na tela de emissão de nota fiscal ou carga fechada, lance um item cujo pedágio calculado seria R$ 200,00 (por exemplo, 5.000 kg × R$ 5,00 / 100 = R$ 250,00).
8. Calcule o frete.

Resultado esperado: O pedágio apresentado será R$ 150,00, pois atingiu o teto máximo configurado.

Exceção / Importante: O teto só é avaliado quando VL_MAXIMOPEDAGIO > 0. Se o valor calculado for menor que o teto (ex.: R$ 100,00), o sistema mantém o valor calculado sem alteração.

---

Valor = 0 (ou vazio) – Sem teto máximo

O que faz	Detalhe
Não limita o pedágio	O sistema retorna sempre o valor integral calculado sobre a base de peso/cubagem.

Simulação passo a passo

1. Acesse TFA075 – Parâmetros de Preço de Frete.
2. Abra a tabela de frete desejada.
3. Na aba Gris/Pedágio/Ad Nota/Ad Valor, deixe o campo de teto (VL_MAXIMOPEDAGIO) zerado ou em branco.
4. Informe VL_KGPEDAGIO = R$ 10,00 e mantenha TP_CALCULOPEDAGIO = 'P'.
5. Salve o registro.
6. Na tela de emissão de nota fiscal, lance 1.000 unidades de um produto com peso embalado de 2 kg (totalizando 2.000 kg).
7. Calcule o frete.

Resultado esperado: O pedágio será R$ 200,00 (2.000 kg / 100 × R$ 10,00), sem nenhum corte por teto.

Exceção / Importante: Deixar o teto zerado é a forma de garantir que grandes volumes sempre paguem pedágio proporcional integral. Use com cautela em tabelas de frete para transportadoras que não possuem limitação contratual.

---

Procedures impactadas

Referência direta ao campo

Procedure / View	Arquivo	Linha	Evidência
CALCULA_PEDAGIO	Scripts/CALCULA_PEDAGIO.sql	14, 22, 75-80	Declaração de variável V_VL_MAXIMOPEDAGIO, leitura do registro da tabela PARMPRECOFRETE e lógica condicional que aplica o teto ao valor calculado.

Candidatas por uso da tabela PARMPRECOFRETE

As procedures abaixo recebem NR_SEQUENCIAPARMPRECOFRETE como parâmetro e leem a tabela PARMPRECOFRETE, mas não fazem referência literal ao campo VL_MAXIMOPEDAGIO. Não foi identificada referência direta ao campo nos scripts delas, portanto seu impacto sobre este parâmetro específico é indireto (podem compor o valor total de frete sem alterar a lógica do pedágio):

Procedure / View	Arquivo
AJUSTE_FORMACAOPRECOVENDA	Scripts/AJUSTE_FORMACAOPRECOVENDA.sql
CALCULA_CARGAFECHADA	Scripts/CALCULA_CARGAFECHADA.sql
CALCULA_FORMACAOPRECOVENDA	Scripts/CALCULA_FORMACAOPRECOVENDA.sql
CALCULA_FRETE	Scripts/CALCULA_FRETE.sql
CALCULA_FRETEGERAL	Scripts/CALCULA_FRETEGERAL.sql
CALCULA_FRETEMINIMOTABELACAIXA	Scripts/CALCULA_FRETEMINIMOTABELACAIXA.sql
CALCULA_FRETEMINIMOTABELAMAIOR	Scripts/CALCULA_FRETEMINIMOTABELAMAIOR.sql
CALCULA_FRETEMINIMOTABELAPESO	Scripts/CALCULA_FRETEMINIMOTABELAPESO.sql
CALCULA_FRETENORMALCAIXA	Scripts/CALCULA_FRETENORMALCAIXA.sql
CALCULA_FRETENORMALPESO	Scripts/CALCULA_FRETENORMALPESO.sql
CALCULA_FRETEPESOEXCEDENTETAB	Scripts/CALCULA_FRETEPESOEXCEDENTETAB.sql
CALCULA_GRIS	Scripts/CALCULA_GRIS.sql
CALCULA_PESOADICIONAL	Scripts/CALCULA_PESOADICIONAL.sql
CALCULA_TAXAADVALOR	Scripts/CALCULA_TAXAADVALOR.sql
CALCULA_TDE	Scripts/CALCULA_TDE.sql
CALCULA_TRT	Scripts/CALCULA_TRT.sql
CALCULA_TRTMAIORVALORBASE	Scripts/CALCULA_TRTMAIORVALORBASE.sql
CALCULA_TRTSOMBASEXMINIMO	Scripts/CALCULA_TRTSOMBASEXMINIMO.sql
CALCULA_VALORADICIONALNOTA	Scripts/CALCULA_VALORADICIONALNOTA.sql
RETORNA_CARGAFECHADA	Scripts/RETORNA_CARGAFECHADA.sql

---

Tabela Comparativa Resumida

Valor informado	Pedágio calculado < teto	Pedágio calculado ≥ teto	Fechamento do Pedágio
> 0	Usa valor calculado	Usa teto (VL_MAXIMOPEDAGIO)	Limitado
0 (ou vazio)	Usa valor calculado	Usa valor calculado	Ilimitado