Ponto de Entrada
Descrição: | Permite customizar o valor do desconto no Item |
Localização: | Totvs PDV |
Eventos: | Este Ponto de Entrada é acionado no momento do registro do item, permite customizar o valor do desconto no item. Obs.: o PE não anula a execução da regra cadastrada no padrão, ou seja, acumula o desconto se for o caso. |
Programa Fonte: | STBRULESDISCOUNTITEM.PRW |
Função: | STBItemRlDi() |
Parâmetros | Nome | Tipo | Modo | Descrição |
---|
cExpC1 | Caractere | Somente Leitura | Código do item que será registrado | nExpN1 | Numérico | Somente Leitura | Valor total do item | nExpN2 | Numérico | Somente Leitura | Quantidade do item |
|
Retorno: | Nome | Tipo | Descrição | Obrigatório |
---|
aExp | Array | Array contendo duas posições: aExp[1] = Novo valor do item aExp[2] = Valor do desconto | S |
|
Exemplo:
#Include 'Protheus.ch'
//Exemplo fictício do uso do ponto de entrada, no exemplo sera aplicado o desconto de 5,00 para produtos com codigo = 1 e quantidade maior ou igual a 10
User function STItRlDisc()
//Recebe valores: Codigo do Item, Valor e desconto
Local cItemCode := PARAMIXB[1]
Local nValueItem := PARAMIXB[2]
Local nAmount := PARAMIXB[3]
Local aRet := {}
//Valida desconto para item com Codigo 1 e quantidade maior ou igual a 2
If AllTrim(cItemCode) == "1" .AND. nAmount >= 10
Aadd(aRet,nValueItem-5) //Define o novo valor do item
Aadd(aRet,5) //Para validacoes de consistencias, informa qual o valor do desconto aplicado
EndIf
Return aRet
Exemplos de cenários:
1- Exemplo de valor válido:
Total do Item antes do Ponto de Entrada : 100,00
Novo valor total do Item (após o Ponto de Entrada) : 95,00
Novo valor de desconto (após Ponto de Entrada) : 5,00
Cenário acima o valor confere.
2 - Exemplo de valor inválido:
Total do Item antes do Ponto de Entrada : 100,00
Novo valor total do Item (após o Ponto de Entrada) : 95,00
Novo valor de desconto (após Ponto de Entrada) : 2,00 //valor do desconto deveria ser 5,00
Cenário acima o valor não confere, existe uma diferença de 3,00 no novo valor de desconto.
Importante:
- PE não anula a execução da regra cadastrada no padrão, ou seja, acumula o desconto.
- É realizado consistência do retorno do PE, desconto só será aplicado se o total do item antes da execução do ponto de entrada for igual a soma do novo valor com o desconto aplicado
- Processo possui logs, para habilitar logs do varejo verifique: http://tdn.totvs.com.br/pages/viewpage.action?pageId=203764807