PC_NOTAEXCEDENTE — Percentual Adicional sobre Nota Excedente

Tela de configuração: TFA075 — Parâmetros de Preço de Frete
Tabela: PARMPRECOFRETE.PC_NOTAEXCEDENTE
Tipo de controle: Campo numérico editável (TDBEdit)
Formato: Percentual com 2 decimais (NUMERIC(15,2))
Valor padrão: nulo (aceita vazio)

Descrição

Campo que define o percentual (%) adicional a ser aplicado sobre o valor excedente da nota fiscal quando o total dos produtos ultrapassa o limite informado em VL_NOTAEXCEDENTE.
É utilizado no cálculo do frete para cobrar um acréscimo proporcional apenas sobre a parcela do valor da nota que exceder o patamar configurado.

Campos envolvidos

Campo na tela	Nome técnico	Tipo	Obrigatório	Descrição
Valor Excedente	VL_NOTAEXCEDENTE	NUMERIC(15,5)	Não	Patamar monetário (R$). Quando o valor total dos produtos na nota ultrapassar este valor, o percentual de PC_NOTAEXCEDENTE entra em vigor.
Fator Sobre Excedente	PC_NOTAEXCEDENTE	NUMERIC(15,2)	Não	Percentual aplicado somente sobre a diferença (Valor Total da Nota - Valor Excedente). Exemplo: 10,00 representa 10 %.

Importante: Os dois campos trabalham em conjunto. Se VL_NOTAEXCEDENTE estiver zerado ou nulo, o sistema nunca atinge a condição de excedente e PC_NOTAEXCEDENTE não produz efeito. Se PC_NOTAEXCEDENTE estiver zerado, mesmo havendo excedente o adicional será zero.

Telas impactadas

• TFA075 — Parâmetros de Preço de Frete (cadastro/manutenção)
• Telas que executam o cálculo de frete e invocam o procedimento CALCULA_VALORADICIONALNOTA (ex.: emissão de nota fiscal, cotação de frete, simulação de preço de venda).

Regra de utilização / Simulação passo a passo

Configuração do percentual de excedente

O que faz	Detalhe
Define o fator (%) sobre excedente	Editável; aceita valores decimais; deve ser informado junto com VL_NOTAEXCEDENTE.

Simulação passo a passo

1. Acesse Faturamento → Tabelas → Parâmetros de Preço de Frete (tela TFA075).
2. Selecione ou cadastre uma configuração de preço de frete (transportador + região comercial).
3. No grupo de campos de Nota Excedente, preencha:
   • Valor Excedente (VL_NOTAEXCEDENTE): R$ 1.000,00.
   • Fator Sobre Excedente (PC_NOTAEXCEDENTE): 5,00.
4. Salve o registro (<F2>).

Resultado esperado: A partir deste momento, toda nota fiscal que utilizar essa configuração de frete e cujo valor total dos produtos ultrapasse R$ 1.000,00 terá um adicional calculado sobre o excedente a 5 %.

Exceção / Importante:

• Se o valor total dos produtos na nota for menor ou igual a VL_NOTAEXCEDENTE, o adicional é zero, independentemente do valor preenchido em PC_NOTAEXCEDENTE.
• O valor é convertido internamente para fração (percentual ÷ 100) antes da multiplicação. Informar 5,00 resulta no fator 0,05.

Procedures impactadas

Referências diretas ao campo

Procedure	Arquivo	Tipo de uso
CALCULA_VALORADICIONALNOTA	Scripts/CALCULA_VALORADICIONALNOTA.sql	Leitura direta do campo (COALESCE(PPF.PC_NOTAEXCEDENTE, 0)). O valor é usado para calcular o adicional quando ocorre excedente.

Candidatas por uso da tabela (sem referência direta ao campo)

As rotinas abaixo recebem o parâmetro I_NR_SEQUENCIAPARMPRECOFRETE e leem diversos campos de PARMPRECOFRETE, mas não citam PC_NOTAEXCEDENTE literalmente. Elas podem carregar o registro inteiro da tabela; no entanto, não há evidência de que utilizem este campo específico.

Procedure	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_PEDAGIO	Scripts/CALCULA_PEDAGIO.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
RETORNA_CARGAFECHADA	Scripts/RETORNA_CARGAFECHADA.sql

Cálculo interno (resumo)

O procedimento CALCULA_VALORADICIONALNOTA realiza o seguinte fluxo lógico:

1. Obtém VL_NOTAEXCEDENTE e PC_NOTAEXCEDENTE pela chave NR_SEQUENCIA.
2. Calcula o valor total do produto na nota (V_VL_PRODUTONOTA).
3. Se V_VL_PRODUTONOTA > VL_NOTAEXCEDENTE e PC_NOTAEXCEDENTE > 0:
   • V_VL_EXCEDENTE = V_VL_PRODUTONOTA - VL_NOTAEXCEDENTE
   • O_VL_ADICIONALNOTA = V_VL_EXCEDENTE * (PC_NOTAEXCEDENTE / 100)
4. Caso contrário, o adicional retornado é zero.

Exemplo numérico

Situação	Valor Total Produto na Nota	Valor Excedente	% Fator	Cálculo	Adicional
Sem excedente	R$ 800,00	R$ 1.000,00	5,00	—	R$ 0,00
Com excedente	R$ 4.500,00	R$ 1.000,00	5,00	(4.500 - 1.000) * 0,05	R$ 175,00

Nota: O resultado deste procedimento (O_VL_ADICIONALNOTA) é incorporado ao valor total do frete conforme a composição de cálculo da transportadora.