Esta versão do sistema foi descontinuada e não recebe atualizações e novas implementações. Acesse a documentação da versão 5.10.3 aqui

Identificador de Regra

COM-170VLFRE01

Módulo: COM - Comercial.

Finalidade: Alterar o valor do frete na tela de contratação de transporte, pedido ou nota fiscal. Chamado ao passar pelo campo Tabela de Preço de Frete no caso das telas de contração de coletas, ou ao recalcular ou fechar um pedido ou nota fiscal.

Características: A partir da versão 5.3.2.5 foram feitas as seguintes modificações:

A variável VSOrigem representa a rotina que chama o identificador de regras.

A variável VSNumero continuará recebendo os mesmo valores que recebia antes da versão 5.3.2.5, ou seja, quando a rotina for pedido, tanto a variável VSNumero, como a variável VSNumPed receberão o número do pedido.

Em notas fiscais normais (não via pedido ou pré-fatura) a variável VSNumero receberá o número da nota fiscal e os demais campos estarão zerados.

Caso a nota fiscal estiver sendo feita via pedido, a variável VSNumero receberá o número da nota fiscal, as variáveis VSFilPed e VSNumPed receberão respectivamente a filial e o número do pedido.

Caso a nota fiscal estiver sendo feita via pré-fatura as variáveis VSNumAne e VSNumPfa receberão respectivamente o número da análise e da pré-fatura.

Outro detalhes seguem abaixo:

A variável VSNúmero pode não receber o número da nota fiscal de venda na geração de nota via pré-fatura, pois esse número será gerado apenas no momento da gravação na base de dados devido a rotina de controle para multi-usuários.

As variáveis VSFilPed, VSNumPed, VSNumAne e VSNumPfa quando a chamada tiver como origem "NFV", carregam apenas o valor do primeiro Pedido/Pré-Fatura da nota fiscal. Caso o nota fiscal estiver ligada a mais de um pedido (itens de produto de vários pedidos), na chamada do identificador pela nota fiscal, apenas será exibido as chaves (Filial e Número) pedido do primeiro item de produto. Sendo necessário alterar/visualizar todos os pedidos, o usuário tem a opção de gerar um cursor na regra.

No fechamento da nota fiscal, o sistema chama primeiramente o identificador para a nota fiscal e durante o fechamento, é necessário atualizar o pedido o que consequentemente obriga a recalcular o mesmo. Desa forma, o identificador é novamente chamado, mas dessa para o pedido e caso exista alteração no valor líquido do pedido e tambem exista ativo o identificador 170VLFRE01 durante o recálculo, esse identificador de regras será chamado pela segunda vez.

5.6.4:
VSVLRMOT: variável que tem por objetivo alterar o valor de frete de compra (motorista).

5.6.5.9
VSVlrFrd: variável que tem por objetivo alterar o valor de frete destacado.

Transação: Não se aplica.

Regra:

@ EXEMPLO @

DEFINIR ALFA VSOrigem;
DEFINIR NUMERO VSCodEmp;
DEFINIR NUMERO VSCodFil;
DEFINIR ALFA VSCodSnf;
DEFINIR NUMERO VSNumero;
DEFINIR NUMERO VSFilPed;
DEFINIR NUMERO VSNumPed;
DEFINIR NUMERO VSNumAne;
DEFINIR NUMERO VSNumPfa;
DEFINIR NUMERO VSNumCol;
DEFINIR ALFA VSCodTab;
DEFINIR NUMERO VSCodTra;
DEFINIR DATA VSDatBas;
DEFINIR DATA VSDatIni;
DEFINIR DATA VSDatFim;
DEFINIR NUMERO VSDisBas;
DEFINIR NUMERO VSPesBas;
DEFINIR NUMERO VSVlrBas;
DEFINIR NUMERO VSVolBas;
DEFINIR NUMERO VSCepIni;
DEFINIR ALFA VSSigUfs;
DEFINIR NUMERO VSVlrLiq;
DEFINIR NUMERO VSVlrMin;
DEFINIR NUMERO VSVlrDes;
DEFINIR NUMERO VSSecCat;
DEFINIR NUMERO VSVlrOut;
DEFINIR NUMERO VSVlrDis;
DEFINIR NUMERO VSVlrPes;
DEFINIR NUMERO VSVlrVlr;
DEFINIR NUMERO VSVlrVol;
DEFINIR NUMERO VSVlrEst;
DEFINIR NUMERO VSPerDis;
DEFINIR NUMERO VSPerPes;
DEFINIR NUMERO VSPerVlr;
DEFINIR NUMERO VSPerVol;
DEFINIR NUMERO VSPerEst;
DEFINIR NUMERO VSVlrFre;
DEFINIR NUMERO VSPerFre;
DEFINIR NUMERO VSPesBru;
DEFINIR ALFA VSSomFre;
DEFINIR ALFA VSCifFob;
DEFINIR ALFA VSCodVia;
DEFINIR NUMERO VSVlrMot;

SE (VSVlrMot = 0)
VSVlrMot = VSVlrFre;

Variáveis Disponibilizadas:

Nome Tipo Observações Retorna Valor
VSCODEMP NÚMERO Código da Empresa N
VSCODFIL NÚMERO Código da Filial N
VSCODSNF ALFA Série da Nota Fiscal N
VSNUMERO NÚMERO Número do Pedido ou da Nota Fiscal N
VSNUMCOL NÚMERO Número da Coleta N
VSCODTAB ALFA Tabela de preço de frete N
VSCODTRA NÚMERO Código da Transportadora (Pedido e Nota Fiscal) N
VSDATBAS DATA Data da Coleta N
VSDATINI DATA Data de início da Validade da tabela de preço N
VSDATFIM DATA Data de fim da Validade da tabela de preço N
VSDISBAS NÚMERO Distância em Km da rota da coleta N
VSPESBAS NÚMERO Peso Líquido das mercadorias da coleta N
VSVLRBAS NÚMERO Valor das mercadorias da coleta N
VSVOLBAS NÚMERO Quantidade de volumes da coleta N
VSCEPINI NÚMERO CEP Inicial da Cidade N
VSSIGUFS ALFA Sigla da Unidade de Federação N
VSVLRLIQ NÚMERO Soma do Valor Líquido dos Itens (Pedido e Nota Fiscal) N
VSVLRMIN NÚMERO Valor mínimo do frete (tabela) N
VSVLRDES NÚMERO Valor de desconto do frete N
VSSECCAT NÚMERO Valor de Sec/Cat N
VSVLROUT NÚMERO Valor de outros N
VSVLRDIS NÚMERO Valor do Frete retornado da Pasta Distância da Tabela N
VSVLRPES NÚMERO Valor do Frete retornado da Pasta Peso da Tabela N
VSVLRVLR NÚMERO Valor do Frete retornado da Pasta Valor da Tabela N
VSVLRVOL NÚMERO Valor do Frete retornado da Pasta Volume da Tabela N
VSVLREST NÚMERO Percentual do Frete retornado da Pasta Estado/Cidade da Tabela N
VSPERDIS NÚMERO Percentual do Frete retornado da Pasta Distância da Tabela N
VSPERPES NÚMERO Percentual do Frete retornado da Pasta Peso da Tabela N
VSPERVLR NÚMERO Percentual do Frete retornado da Pasta Valor da Tabela N
VSPERVOL NÚMERO Percentual do Frete retornado da Pasta Volume da Tabela N
VSPEREST NÚMERO Percentual do Frete retornado da Pasta Estado/Cidade da Tabela N
VSPERFRE NÚMERO Percentual do Frete N
VSFilPed NÚMERO Código da Filial do Pedido N
VSNumPed NÚMERO Número do Pedido N
VSNumAne NÚMERO Número da Análise N
VSNumPfa NÚMERO Número da Pré-Fatura N
VSOrigem ALFA Origem da chamada (NFV, PEDIDO, PFA ou OUTRO) N
VSPesBru NÚMERO Peso Bruto dos Produtos N
VSSomFre ALFA Indicativo se o valor do frete soma no valor líquido N
VSCifFob ALFA Indicativo do tipo de Frete N
VSCodVia ALFA Código da via de transporte do veículo N
VSVlrPdg NÚMERO Valor do pedágio N
VSVLRFRE NÚMERO Valor do Frete S
VSVlrMot NÚMERO Valor de Frete de Compra S
VSVlrFrd NÚMERO Valor de Frete Destacado S

Atenção

Caso o parâmetro global LisVarReg esteja habilitado, a variável ListaVariaveis estará disponível em todos os identificadores de regras do sistema. O conteúdo desta variável lista os campos disponibilizados no identificador de regras em questão.

Não é aconselhada a ativação desse parâmetro global para o uso cotidiano. Esse recurso de listagem dos campos de identificadores auxilia a construção de regras e o Suporte para, por exemplo, depuração ou quando não houver acesso à documentação dos identificadores de regras.

Este artigo ajudou você?