VL_TAXASEGURANCABALSA — Valor da Taxa de Segurança / Balsa

Tela de configuração: TFA075 — Parâmetros de Preço de Frete
Localização: Aba Taxas
Tabela: PARMPRECOFRETE.VL_TAXASEGURANCABALSA
Tipo: Campo numérico editável (DOM_NUMERIC15_5)
Componente: edtVL_TAXASEGURANCABALSA (TDBEdit)
Label na tela: Valor Taxa Descarga
Valor padrão: Nulo (tratado como 0 nas rotinas de cálculo)

Telas impactadas

Tela	Descrição
TFA075 — Parâmetros de Preço de Frete	Tela de cadastro/manutenção onde o valor é informado e persistido na tabela PARMPRECOFRETE.

Campos envolvidos

Campo / Coluna	Tipo	Origem
VL_TAXASEGURANCABALSA	NUMERIC(15,5)	Coluna da tabela PARMPRECOFRETE
edtVL_TAXASEGURANCABALSA	TDBEdit	Campo visual ligado a dmTFA075.dsPARMPRECOFRETE

Opções disponíveis

Este parâmetro não possui opções fixas. Trata-se de um campo de entrada monetária livre.

O que faz	Detalhe
Cadastra valor fixo de taxa	Campo editável na aba Taxas. Aceita vazio (nulo), zero, ou qualquer valor monetário.

Simulação passo a passo

1. Acesse TFA075 — Parâmetros de Preço de Frete.
2. Localize o registro do parâmetro de frete desejado (Transportador e Região Comercial).
3. Clique na aba Taxas.
4. No campo Valor Taxa Descarga (VL_TAXASEGURANCABALSA), digite o valor desejado (exemplo: R$ 25,00).
5. Pressione `F8` ou clique em Salvar para gravar o registro.
6. Verifique que o valor foi persistido no cadastro.

Resultado esperado: O valor informado é armazenado em PARMPRECOFRETE.VL_TAXASEGURANCABALSA e, nas rotinas de cálculo de frete que utilizam CALCULA_FRETEGERAL, será recuperado via COALESCE(PPF.VL_TAXASEGURANCABALSA, 0) e somado ao custo total do frete.

Exceção / Importante: Em determinadas condições do cálculo geral de frete, o valor poderá ser zerado automaticamente caso uma flag de controle desative essa taxa para a operação. Se o valor cadastrado não estiver sendo aplicado, revise as configurações do processo de cálculo de frete.

Regra Geral de Autorização

Sem regra de autorização específica identificada para este campo. O acesso à edição obedece às permissões de tela definidas em ADM004 — Acesso.

Procedures impactadas

Referências diretas ao campo

Procedure	Arquivo	Descrição do uso
CALCULA_FRETEGERAL	Scripts/CALCULA_FRETEGERAL.sql	Leitura do campo em PARMPRECOFRETE para inclusão no cálculo do frete geral.

Detalhamento do uso em CALCULA_FRETEGERAL:

• O valor é selecionado da tabela PARMPRECOFRETE (alias PPF) com COALESCE(PPF.VL_TAXASEGURANCABALSA, 0).
• Antes da leitura, a variável interna é inicializada em 0.
• O valor final é adicionado à expressão de custo total do frete, junto com VL_TAS, VL_SEGUROFLUVIAL, VL_SUFRAMA e VL_TAXADESCARGA.
• Em determinadas condições, o valor pode ser zerado (ex: quando o controle de aplicação da taxa indica que não deve ser cobrado).

Candidatas por uso da tabela PARMPRECOFRETE

As procedures/views abaixo recebem o identificador (NR_SEQUENCIA) da tabela PARMPRECOFRETE, porém não referenciam o campo VL_TAXASEGURANCABALSA diretamente:

• AJUSTE_FORMACAOPRECOVENDA
• CALCULA_CARGAFECHADA
• CALCULA_FORMACAOPRECOVENDA
• CALCULA_FRETE
• CALCULA_FRETEMINIMOTABELACAIXA
• CALCULA_FRETEMINIMOTABELAMAIOR
• CALCULA_FRETEMINIMOTABELAPESO
• CALCULA_FRETENORMALCAIXA
• CALCULA_FRETENORMALPESO
• CALCULA_FRETEPESOEXCEDENTETAB
• CALCULA_GRIS
• CALCULA_PEDAGIO
• CALCULA_PESOADICIONAL
• CALCULA_TAXAADVALOR
• CALCULA_TDE
• CALCULA_TRT
• CALCULA_TRTMAIORVALORBASE
• CALCULA_TRTSOMBASEXMINIMO
• CALCULA_VALORADICIONALNOTA
• RETORNA_CARGAFECHADA

Tabela Comparativa Resumida

Aspecto	Descrição
Tipo de dado	NUMERIC(15,5)
Controle	TDBEdit (edição livre)
Obrigatoriedade	Não (aceita nulo / zero)
Uso principal	Soma no cálculo do frete geral via CALCULA_FRETEGERAL
Impacto direto em tabelas	PARMPRECOFRETE