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 como objetivo encapsular regras específica que serão regras específicas programadas pelo cliente para determinar o real valor do desconto do tipo percentual ou do tipo valor da bolsa de forma customizada durante a geração do lançamento financeiro.Por exemplo,

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 (SBOLSAALUNO)

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.

Image Added

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. 

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.

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 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 (SBOLSAALUNO)

Exemplo:

IDHABILITACAOFILIAL

• MOCK:

• Simula um valor para

• as funções de fórmula "VLRDESCONTOANT" ou "VALORPARCELA".

Para utilizar a função MOCK e obter o valor simulado gerado por ela, é necessário chamar utilizar a função "VLRDESCONTOANT" ou "VALORPARCELA" que irá retornar para obter o valor simulado , já que a gerado pela função MOCK não apresenta retorno por si só. 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(); 

IDHABILITACAOFILIAL: retorna o IDHABILITACAOFILIAL do contrato do aluno no qual a bolsa que será  processada esta associada.

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 . 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. No cadastro de bolsa do contrato deve 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. 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 1Por exemplo:

A Bolsa “X” de 20% está vinculada para o aluno,

porém nesta bolsa temos a

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