Customização do percentual ou valor da bolsa por fórmula

Características do Requisito

Descrição

O objetivo do recurso de customização do percentual ou valor da bolsa por fórmula permite vincular uma fórmula no cadastro da bolsa que tem regras específicas programadas pelo cliente para determinar o valor do desconto do tipo percentual ou do tipo valor da bolsa de forma customizada durante a geração do lançamento financeiro.

Exemplo:

Na matrícula o aluno ganha uma bolsa de 5% com um desconto progressivo, e em que a cada mês será acrescido a bolsa do aluno 1%.

Como será?

- Cadastra uma bolsa “Bolsa desconto progressivo" do tipo de desconto igual a percentual com valor percentual de desconto de 5%.

- Para essa bolsa iremos associar uma fórmula que tem como função acrescentar o 1% conforme o mês da parcela.

Cadastro de Bolsa

No cadastro de bolsa foram adicionados dois novos campos para que seja possível vincular as fórmulas que serão responsáveis em customizar o percentual ou valor.Image Removed

Image Added

Fórmula

Foram disponibilizadas funções de fórmula específicas para serem utilizadas na criação das formulas que serão associadas a bolsa.

• CAMPOSBOLSAALUNO: Retorna a informação de qualquer campo da tabela SBOLSAALUNO durante a geração de lançamento financeiro.

Esta função de fórmula possibilita ter acesso também aos campos abaixo:

SBOLSA.CODCFO,

SBOLSA.CODCOLCFO,

SBOLSA.NOME,

SBOLSA.CODTIPOCURSO,

SBOLSA.VALIDADELIMITADA,

SBOLSA.TIPOSAC, SBOLSA.FIES,

SCLASSIFICACAOBOLSA.CODCLASSIFICACAO,

SCLASSIFICACAOBOLSA.TIPOBOLSA,

ORDEMBOLSACLASSIFICACAO

campo ORDEMBOLSA da SCLASSIFICACAOBOLSA

Essa fórmula pode ser utiliza fora da geração de lançamento financeiro, porém o contexto deve ser em cima do cadastro de bolsa do contrato (SBolsaAlunoSBOLSAALUNO)

Exemplo:

CAMPOSBOLSAALUNO('CODSERVICO','S')

CAMPOSBOLSAALUNO('NOME','S')

• VLRDESCONTOANT: Retorna o valor do desconto por antecipação considerado para a parcela durante a geração de lançamento financeiro.

O valor retornado é o valor calculado do desconto por antecipação durante a geração do lançamento. Desta forma, será necessário o sistema está configurado para calcular o desconto por antecipação. E observar se no cadastro da bolsa do contrato do aluno o campo "Aplicar desconto por antecipação" tem o valor "Depois do cálculo da bolsa" isso indica que o desconto por antecipação será calculado depois do valor da bolsa.Observação: Se

Exemplo:

VLRDESCONTOANT

• PERCENTUALDESCANT: Retorna o percentual do desconto por antecipação considerado para a parcela durante a geração de lançamento financeiro.

O valor retornado é o valor calculado do desconto por antecipação durante a geração do lançamento. Desta forma, será necessário o sistema está configurado para calcular o desconto por antecipação. E observar se no cadastro da bolsa do contrato do aluno o campo "Aplicar desconto por antecipação" tem o valor "Depois do cálculo da bolsa" isso indica que o desconto por antecipação será calculado depois do valor da bolsa.Observação: Se  

Exemplo:

PERCENTUALDESCANT

• VALORPARCELA: Retorna o valor da parcela durante a geração de lançamento financeiro.

O valor retornado é o valor calculado para parcela na geração de lançamento. Se a parcela estiver configurada para valor calculado pelo número de créditos, o sistema deverá está configurado corretamente para realizar o cálculo da parcela.

Exemplo:

VALORPARCELA

• MODIFICAPERCENTUALDESCANT ou MODIFICAVALORDESCANT: Permite modificar em memória o valor ou percentual do desconto por antecipação durante a geração de lançamento financeiro. 

Vale ressaltar, O valor modificado vai refletir na formula VLRDESCONTOANT e PERCENTUALDESCANT, ou seja se estas formulas forem executadas durante o processamento das bolsas para o mesmo aluno o sistema vai retorna o valor modificado.Observação:

Exemplo:

MODIFICAVALORDESCANT(100), modifica o valor do desconto por antecipação para R$100,00. Vale ressaltar, que com a modificação do desconto por antecipação o seu percentual será ajustado.

MODIFICAPERCENTUALDESCANT(23), modifica o percentual do desconto por antecipação para 23%. Vale ressaltar, que com a modificação do desconto por antecipação o seu valor será ajustado.

• IDHABILITACAOFILIAL: Retorna o IDHABILITACAOFILIAL do contrato do aluno no qual a bolsa que será processada esta associada vinculada à bolsa durante a geração de lançamento financeiro.

Essa fórmula pode ser utiliza fora da geração de lançamento financeiro, porém o contexto deve ser em cima do cadastro de bolsa do contrato (SBolsaAlunoSBOLSAALUNO)

Exemplo:

IDHABILITACAOFILIAL

• MOCK: Simula um valor para as funções de fórmula "VLRDESCONTOANT" ou "VALORPARCELA".

Para utilizar a função MOCK, é necessário utilizar a função "VLRDESCONTOANT" ou "VALORPARCELA" para obter o valor simulado gerado pela função MOCK. Em seguida, essa fórmula deve ser chamada para obter o valor simulado gerado pela função MOCK.

Após o término dos testes, a função MOCK deve ser removida para garantir a precisão dos resultados.

Exemplos:

Para simular o valor da parcela durante a execução dos testes, utiliza-se a fórmula MOCK('VALORPARCELA', 1000);

Para obter o valor simulado da parcela, utiliza-se a fórmula VALORPARCELA() que retorna o valor 1000;

Para simular o valor do desconto durante a execução dos testes, utiliza-se a fórmula MOCK('VLRDESCONTOANT', 1500);

Para obter o valor simulado do desconto, utiliza-se a fórmula VLRDESCONTOANT() que retorna o valor 1500.

MOCK('VALORPARCELA',1000); 
VALORPARCELA();
ou
MOCK('VLRDESCONTOANT',1500); 
VLRDESCONTOANT(); 

Geração de Lançamento

Durante a geração do lançamento financeiro o sistema realiza o cálculos das bolsas vinculadas para o aluno considerando as parametrizações (ordem da bolsa, cascata, somar bolsa, e etc ).

Antes do cálculo das bolsas, o sistema vai identificar as bolsas que possuem fórmula associada e executá-las. O resultado desta fórmula será considerado para “percentual” ou “valor” a ser considerado no cálculo da bolsa.

A identificação será feita pelo tipo de desconto da bolsa no contrato do aluno. Isso é:

• Para o cálculo do valor da bolsa via fórmula para o valor. A bolsa no . No cadastro de bolsa do contrato deve ter o ser do tipo de desconto igual a valor. Assim o sistema vai identificar se no cadastro da bolsa tem uma fórmula informada no campo "Fórmula para valor". 
• Para o cálculo do percentual da bolsa via fórmula para o percentual. A bolsa no . No cadastro de bolsa do contrato deve ter o tipo de desconto igual a percentual. Assim o sistema vai identificar se no cadastro da bolsa tem uma fórmula informada no campo "Fórmula para percentual"

Exemplo 1:

A Bolsa “X” de 20% está vinculada para o aluno, porem porém nesta bolsa temos a formula fórmula “XPTO” que acrescenta 1%.

A fórmula XPTO retornará o percentual de 21%, logo o sistema considerará para o cálculo da bolsa os 21%.

Exemplo 2:

O valor da bolsa será 20% do valor do desconto por antecipação. No cadastro da bolsa no contrato o campo "Aplicar desconto por antecipação" tem o valor "Antes do cálculo da bolsa".

O valor da parcela é de R$ 1000,00 com data de vencimento para 15/09/2024

O percentual do desconto por antecipação é de 30% até o dia 14/09/2024

Desta forma teremos os seguintes valores:

Valor da parcela: R$ 1000,00

Valor do desconto por antecipação até o dia 14/09/2024 é de 20%: R$ 1000,00 * 0,20 = R$ 200,00

A fórmula XPTO1 é: VLRDESCONTOANT * 0,30 = R$ 200,00 * 0,30 = R$ 60,00