Versões comparadas

Chave

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

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

Características do Requisito

Linha de Produto:

RM

Segmento:

Educacional

Módulo:

TOTVS Gestão Educacional

Rotina:

Rotina

Nome Técnico

Cadastro de Bolsa

Cadastro de Bolsa



Rotina(s) envolvida(s)

Nome Técnico

Geração de Lançamento

Geração de Lançamento

 


Cadastros Iniciais:

N/A

Parâmetro(s):

N/A

Ponto de Entrada:

N/A

Tickets relacionados

N/A

Requisito/Story/Issue (informe o requisito relacionado):

DEDUINTEGRACOES-2286

País(es):

N/A

Banco(s) de Dados:

N/A

Tabelas Utilizadas:

SBolsa

Sistema(s) Operacional(is):

N/A

Descrição

O 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 especifica específica que serão programadas pelo cliente para determinar o real percentual ou valor da bolsa durante a geração do lançamento financeiro.

Por exemplo,

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

Como será?

- Cadastra uma bolsa “Bolsa desconto progressivo | Tipo de desconto: Percentual | Desconto: 5%.

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

Aviso

Este recurso estará disponível oficialmente a parti da versão 12.1.21, porem o mesmo poderá ser antecipado juntamente com o recurso do desconto por antecipação a partir da versão 12.1.19, neste caso será necessário executar scripts específicos.

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.

Informações
titleInformação

Deverá ser associado as formulas de forma separada, ou seja, uma formula para percentual e outra para valor.

O campo de fórmula não será bloqueado conforme o tipo de desconto da bolsa, pois a bolsa poderá ser cadastrada com o tipo de desconto “Percentual” e essa mesma bolsa poderá estar a associada no aluno e com o tipo de desconto igual a “Valor”.

Para este cenário se houver necessidade de customizar os dois tipos de descontos será necessário preencher os dois campos de fórmula.

Fórmula

Foram disponibilizadas funções de fórmula especificas 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.VALORBASECALCULOBOLSA

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

VLRDESCONTOANT: retorna o valor do desconto por antecipação considerado para a parcela.

PERCENTUALDESCANT: retorna o percentual do desconto por antecipação considerado para a parcela.

VALORPARCELA: Valor valor da parcela

MODIFICAPERCENTUALDESCANT ou MODIFICAVALORDESCANT: permite modificar em memoria memória o valor ou percentual do desconto por antecipação.

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.

MOCK – simula : simula um valor para a função de fórmula "VLRDESCONTOANT" ou "VALORPARCELA".

Esta função tem apenas o objetivo de auxiliar quem está desenvolvendo a fórmula no RM e precisa testar a fórmula pelo executor. Após finalizar a codificação da fórmula 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.

ExemploExemplos:

  • 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.
Bloco de código
languagesql
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‘VLRDESCONTOANT’,1000) => indica que durante o teste de execução da fórmula o valor do desconto é de 1000.

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 .... ).

Antes do cálculo das bolsas, o sistema vai identificar as bolsas que possuem formula 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.

Por exemplo:

A Bolsa “X” de 20% está vinculada para o aluno, porem nesta bolsa temos a formula “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%.

Informações
titleInformações

Com objetivo de ter o histórico da informação para saber se o cálculo do percentual ou valor foi processado por uma fórmula serão gravados dois campos na tabela SBOLSALAN.

Campo “EXECUTOUFORMULA”:

0 - Não executou

1 – Executou fórmula para customizar o percentual

2 – Executou fórmula para customizar o valor

Campo ”PERCENTCALCFORMULA”:

Identifica o percentual retornado pela fórmula.