Linha RM

Atalhos

Páginas filhas
  • DEDUINTEGRACOES-6618 DT Funções de Fórmula para o Processamento do Valor Auxiliar

Versões comparadas

Versão antiga 29

changes.mady.by.user Darlan Alvysson Alves

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Darlan Alvysson Alves

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Expandir
titleFunções para valor auxiliar aplicados em “Bolsa” ou “Desconto por Antecipação”

As funções de fórmula abaixo poderão ser utilizadas em ambos contexto, seja para processamento do valor auxiliar de bolsa ou desconto por antecipação.

Todas as funções abaixo  abaixo terão como contexto a informação de processamento corrente da tabela SBOLSALAN (para bolsas) ou SLANDESPONTUAL (para descontos por antecipação) processada para a parcela do contrato do aluno.


NomeDescriçãoParâmetrosExemplo
VAUXTABCONTRATO

Tem como objetivo retornar o conteúdo de um determinado campo do contrato do aluno (tabela: SCONTRATO).

  • Nome do campo.
  • Tipo: Tipo do valor do campo informado. 
    • "V": Valor
    • "I": Inteiro
    • "D": Data
    • "S": Texto
VAUXTABCONTRATO('IDHABILITACAOFILIAL','I')
VAUXTABPARCELA

Tem como objetivo retornar o conteúdo de um determinado campo da parcela do contrato do aluno (tabela: SPARCELA).

  • Nome do campo.
  • Tipo: Tipo do valor do campo informado. 
    • "V": Valor
    • "I": Inteiro
    • "D": Data
    • "S": Texto
VAUXTABPARCELA('DTVENCIMENTO','D')
VAUXTABFLANTem como objetivo retornar o conteúdo de um determinado campo do lançamento financeiro vinculado a parcela do contrato do aluno (tabela: FLAN).
  • Nome do campo.
  • Tipo: Tipo do valor do campo informado. 
    • "V": Valor
    • "I": Inteiro
    • "D": Data
    • "S": Texto
VAUXTABFLAN('VALORORIGINAL','V')
VAUXVLRINTEGRACAOLAN

Tem como objetivo retornar o valor de integração processado para o lançamento financeiro vinculado a parcela do contrato do aluno.

  • Identificador do campo do valor de integração.

VAUXVLRINTEGRACAOLAN(45)

45 corresponde ao id. do campo do valor de integração cadastrado no TOTVS Gestão Financeira. 

VAUXVALORBOLSA

Tem como objetivo retornar o valor processado para a bolsa.

Importante:

Quando existir desconto por antecipação processado para o contrato o sistema executará a fórmula vinculada ao valor auxiliar para cada vencimento do desconto por antecipação, neste caso, o valor da bolsa retornado por esta função será o valor da bolsa processado para o dia do vencimento do desconto por antecipação.

  • Código da Bolas

Exemplo 1:

VAUXVALORBOLSA('45')


Exemplo 2:

VAUXVALORBOLSA('')

Se o “Código da bolsa” for passado vazio (conforme o exemplo acima), será considerado a bolsa do contexto de execução da fórmula (Registro da SBOLSALAN).

VALORBASECALCULOBOLSA

Tem como objetivo retornar o valor base de cálculo utilizado para calcular a bolsa.

Importante:

Quando existir desconto por antecipação processado para o contrato o sistema executará a fórmula vinculada ao valor auxiliar para cada vencimento do desconto por antecipação, neste caso, o valor base de cálculo retornado por esta função será o valor processado para o dia do vencimento do desconto por antecipação.


VALORBASECALCULOBOLSA()



Expandir
titleFunções especificas para valor auxiliar aplicados em na “Bolsa”

As funções de fórmula abaixo poderão ser utilizadas especificamente para processar valores auxiliares do aplicados em bolsa.

O contexto  para processamento da fórmula corresponde aos dados da gravados na tabela SBOLSALAN que serão gerados durante a criação do lançamento financeiro processado  para a parcela do contrato do aluno.

Informações
titleExemplo

Se a parcela do contrato do aluno possuir a "BOLSA A" e "BOLSA B" internamente ao gerar o lançamento financeiro o sistema vai incluir dois registros na tabela SBOLSALAN e consequentemente para cada registo será processada a fórmula vinculada ao valor auxiliar.

NomeDescriçãoParâmetrosExemploVAUXTABBOLSALANRetorna

NomeDescriçãoParâmetrosExemplo
VAUXTABBOLSALANTem como objetivo retornar o conteúdo de um determinado campo da tabela SBOLSALAN
Campo:
  • Nome do
campo que deseja pesquisa na tabela SBOLSALAN.
  • Campo
  • Tipo: Tipo do valor do campo informado. 
    • "V": Valor
    • "I": Inteiro
    • "D": Data
    • "S": Texto
VAUXTABBOLSALAN('VALOR', 'V')
VAUXTABBOLSARetorna
VAUXTABBOLSATem como objetivo retorna o conteúdo de um determinado campo do cadastro da bolsa (tabela: SBOLSA)
Campo:
  • Nome do campo
que deseja pesquisa na tabela SBOLSA.
  • :
  • Tipo: Tipo do valor do campo informado. 
    • "V": Valor
    • "I": Inteiro
    • "D": Data
    • "S": Texto
VAUXTABBOLSA('CODBOLSA', 'S')
VAUXTABBOLSACOMPLRetorna
VAUXTABBOLSACOMPLTem como objetivo retornar o conteúdo de um determinado campo
da tabela de campos complementares
complementar do cadastro da bolsa (tabela:SBOLSACOMPL)
Campo:
  • Nome do campo
que deseja pesquisa na tabela SBOLSACOMPL
  • complementar.
  • Tipo: Tipo do valor do campo informado. 
    • "V": Valor
    • "I": Inteiro
    • "D": Data
    • "S": Texto
VAUXTABBOLSACOMPL('TIPOX', 'S')
VAUXDESCPARCELABOLSALAN
Retorna Obs

Tem como objetivo retornar o valor de desconto da parcela

referente ao contexto do lançamento gerado pela aplicação de uma bolsa. (SBOLSALAN)

vinculada a bolsa processada.

Obs.

.: Caso tenhamos uma parcela com mais de um responsável financeiro será

retorno

retornado o desconto aplicado ao lançamento do contexto corrente

e não

da

parcela

bolsa processada.

  • Tipo valor: Tipo do valor de retorno (V=Valor/ P=Percentual)
VAUXDESCPARCELABOLSALAN('V')
VAUXVALORAUXBOLSA
Retorna

Tem como objetivo retornar o conteúdo do valor auxiliar já processado para a bolsa . 

Se o código da bolsa não for informado será considerado a bolsa

processada no

do contexto corrente da SBOLSALAN.

  • Código do valor auxiliar
  • Código da bolsa
VAUXVALORAUXBOLSA('CODAUX001', 'BOLSAX
')VAUXTOTALBOLSASPORCAMPOCOMPLRetorna
')



Dica
titleVAUXVALORAUXBOLSA

Quando utilizar esta função de fórmula recomendamos que ao cadastrar o valor auxiliar o campo "Ordem de processamento" seja preenchido estabelecendo um critério de ordem de processamento.

Exemplo:

Valor auxiliar: VAUX001 - Ordem 1

Valor auxiliar: VAUX002 - Ordem 2

Desta forma posso na fórmula do valor auxiliar "VAUX002" utilizar a função VAUXVALORAUXBOLSA('VAUX001', 'BOLSAXPTO') , pois o valor auxiliar "VAUX001" já vai ter processado.

VAUXTOTALBOLSASPORCAMPOCOMPLTem como objetivo retornar o somatório dos valores das bolsas conforme conteúdo do campo complementar informado.
  • Nome do campo complementar da bolsa;
  • Conteúdo do campo complementar que se deseja filtrar;
  • Tipo valor: Tipo de valor de retorno  (V =Valor/ P= Percentual)
VAUXTOTALBOLSASPORCAMPOCOMPL('FIES', 'T', 'P')
Deck of Cards
idFuncoesFormuma



Dica
titleVAUXTOTALBOLSASPORCAMPOCOMPL

Exemplo:

Bolsa 1 | Campo Complementar: Classificação = A | Valor da Bolsa R$ 100,00

Bolsa 2 | Campo Complementar: Classificação = A | Valor da Bolsa R$ 100,00

Bolsa 3 | Campo Complementar: Classificação = B | Valor da Bolsa R$ 100,00


Baseado no exemplo acima poderíamos utilizar a função de fórmula assim: VAUXTOTALBOLSASPORCAMPOCOMPL('Classificação', 'A','V')

O resultado da execução será de R$ 200,00

Discriminamos abaixo as funções de fórmulas que poderão ser utilizadas somente na construção de fórmula para valor auxiliar de bolsa, neste caso estas fórmulas serão executadas sobre o contexto das informações da tabela SBOLSALAN.

Campo: Nome do campo que deseja pesquisa na tabela SBOLSACOMPL.
Expandir
titleFunções especificas para valor auxiliar aplicados no “Desconto por antecipação”

As funções de fórmula abaixo poderão ser utilizadas especificamente para processar valores auxiliares do aplicados n desconto por antecipação.

O contexto  para processamento da fórmula corresponde aos dados gravados na tabela SLANDESCPONTUAL que serão gerados durante a criação do lançamento financeiro processado  para a parcela do contrato do aluno.

Informações
titleExemplo

Considerando que o contrato do aluno possui o desconto por antecipação abaixo:

1º Desconto por antecipação - Vencimento 05 - 10 %

2º Desconto por antecipação - Vencimento 10 - 7 %

3º Desconto por antecipação - Vencimento 20 - 5 %

4º Desconto por antecipação - Vencimento 30 - 2 %

Durante a geração de lançamento o sistema irá executar para cada linha do desconto apresentado acima ( cada vencimento ) a fórmula associada ao valor auxiliar.

Obs.. As informações dos desconto por antecipação processados para a parcela são gravadas na tabela SLANDESCPONTUAL.

NomeDescriçãoParâmetrosExemplo
VAUXTABLANDESCPONTUAL

Tem como objetivo retornar uma informação do desconto por antecipação processados para a parcela do aluno (Tabela: SLANDESCPONTUAL). 

  • Nome do Campo
Card
idBOLSA
labelFunções para Valor Auxiliar de Bolsa
NomeDescriçãoParâmetrosExemplo
VAUXTABBOLSALANRetorna o conteúdo de um determinado campo da tabela SBOLSALAN
  • Campo: Nome do campo que deseja pesquisa na tabela SBOLSALAN.
  • Tipo: Tipo do valor do campo informado. 
    • "V": Valor
    • "I": Inteiro
    • "D": Data
    • "S": Texto
VAUXTABBOLSALAN('VALOR', 'V')
VAUXTABBOLSARetorna o conteúdo de um determinado campo da tabela SBOLSA
  • Campo: Nome do campo que deseja pesquisa na tabela SBOLSA.
  • Tipo: Tipo do valor do campo informado. 
    • "V": Valor
    • "I": Inteiro
    • "D": Data
    • "S": Texto
VAUXTABBOLSA('CODBOLSA', 'S')
VAUXTABBOLSACOMPLRetorna o conteúdo de um determinado campo da tabela de campos complementares da bolsa (SBOLSACOMPL)
  • Tipo: Tipo do valor do campo informado. 
    • "V": Valor
    • "I": Inteiro
    • "D": Data
    • "S": Texto
VAUXTABBOLSACOMPL
VAUXTABLANDESCPONTUAL('
TIPOX
VALORDESCONTOCALCULADO', '
S
V')
VAUXDESCPARCELABOLSALAN
VAUXDESCANTECIPACAOLANDESCPONTUAL

Tem como objetivo retornar

Retorna Tipo valor: Tipo do valor de retorno

o valor

de desconto da parcela referente ao contexto do lançamento gerado pela aplicação de uma bolsa. (SBOLSALAN)

Obs.: Caso tenhamos uma parcela com mais de um responsável financeiro será retorno o desconto aplicado ao lançamento do contexto corrente e não da parcela.

do desconto por antecipação processado.

  • Tipo: Tipo de retorno do valor do desconto por antecipação. 
  • (V =Valor/ P=Percentual)
  • Nº vencimento: Número do vencimento que deseja recuperar a informação.

    Exemplo:


    1º Vencimento (Até o dia 5)

VAUXDESCPARCELABOLSALAN('V')

  •    => Vencimento = 1
    2º Vencimento (Até o dia 10) => Vencimento = 2
    3º Vencimento (Até o dia 15) => Vencimento = 3
    4º Vencimento (Até o dia 20) => Vencimento = 4

Se o nº do vencimento não for informado, por exemplo, VAUXDESCANTECIPACAOLANDESCPONTUAL('V', '') , será considerado o valor do desconto por antecipação que esta sendo processado para o contexto de execução da fórmula.



Exemplo 1:

Valor do desconto por antecipação aplicado no vencimento 3 (Até o dia 15)

VAUXDESCANTECIPACAOLANDESCPONTUAL('V', '3')


Exemplo 2:

Considerando que a fórmula está sendo executada para o 2º vencimento, e não foi informado na função de fórmula o dia do vencimento.

VAUXDESCANTECIPACAOLANDESCPONTUAL('V', '')

Para este exemplo será retornado o valor do desconto por antecipação aplicado no 2º vencimento.

VAUXVALORAUXDESCANTECIPACAO

Tem como objetivo retornar

VAUXVALORAUXBOLSA

Retorna o conteúdo do valor auxiliar já processado para a bolsa . 

Se o código da bolsa não for informado será considerado a bolsa processada no contexto corrente da SBOLSALAN.

  • Código do valor auxiliar
  • Código da bolsa
VAUXVALORAUXBOLSA('CODAUX001', 'BOLSAX')VAUXTOTALBOLSASPORCAMPOCOMPLRetorna o somatório dos valores das bolsas conforme conteúdo do campo complementar informado.
  • Nome do campo complementar da bolsa;
  • Conteúdo do campo complementar que se deseja filtrar;
  • Tipo valor: Tipo de valor de retorno  (V =Valor/ P= Percentual)
VAUXTOTALBOLSASPORCAMPOCOMPL('FIES', 'T', 'P') Card
idDESCONTOPORANTECIPACAO
labelFunções para Valor Auxiliar de Desconto por Antecipação

Discriminamos abaixo as funções de fórmulas que poderão ser utilizadas somente na construção de fórmula para valor auxiliar de desconto por antecipação, neste caso estas fórmulas serão executadas sobre o contexto das informações da tabela SLANDESCPONTUAL.

NomeDescriçãoParâmetrosExemploVAUXTABLANDESCPONTUALRetorna o conteúdo de um determinado campo da tabela SLANDESCPONTUAL
  • campo: Nome do campo que deseja pesquisa na tabela SLANDESCPONTUAL.
  • Tipo: Tipo do valor do campo informado. 
    • "V": Valor
    • "I": Inteiro
    • "D": Data
    • "S": Texto
VAUXTABLANDESCPONTUAL('VALORDESCONTOCALCULADO', 'V')VAUXDESCANTECIPACAOLANDESCPONTUAL

Retorna o valor do desconto por antecipação do contexto corrente

(SLANDESCPONTUAL).

  • Tipo: Tipo de retorno do valor do desconto por antecipação.

(V =Valor/ P=Percentual)

VAUXDESCANTECIPACAOLANDESCPONTUAL('V')VAUXVALORAUXDESCANTECIPACAORetorna

o conteúdo do valor auxiliar já processado para o desconto por antecipação conforme o número de vencimento informado.

Caso seja informado o número de vencimento com valor "0" (Zero) será retornado o valor do valor auxiliar do desconto por antecipação do contexto corrente.

Exemplo:

1º Vencimento (Até o dia 5)   => Vencimento = 1
2º Vencimento (Até o dia 10) => Vencimento = 2
3º Vencimento (Até o dia 15) => Vencimento = 3
4º Vencimento (Até o dia 20) => Vencimento = 4

  • Código do valor auxiliar.
  • Nº vencimento: Número do vencimento que deseja recuperar a informação.

VAUXVALORAUXDESCANTECIPACAO('CODAUX005', 3)

...


Dica
titleVAUXVALORAUXDESCANTECIPACAO

Exemplo:

Considerando que já temos os seguintes valores auxiliares processados para os vencimentos do desconto por antecipação:

1º Desconto por antecipação -  VAUX001 - R$ 50,00

2º Desconto por antecipação -  VAUX001 - R$ 25,00

3º Desconto por antecipação -  VAUX001 - R$ 15,00

4º Desconto por antecipação -  VAUX001 - R$ 5,00

Para recuperar o valor auxiliar do 3º vencimento utilizamos VAUXVALORAUXDESCANTECIPACAO('VAUX001', 3), o resultado será R$ 15,00.


Card documentos
InformacaoRecomendamos priorizar a utilização das funções de fórmula que relatamos anteriormente ao invés de carregar as informações através de consulta SQL, pois as funções de fórmula utilizam mecanismo de cache que tem como objetivo melhorar a performance da execução.
TituloIMPORTANTE!

...