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.