Manual Operacional da customização - Contratos


O manual a seguir visa detalhar as customizações realizadas neste projeto para atender as necessidades do módulo financeiro do TOTVS RM.


Pré-requisitos


Não se aplica.


Descrição do processo


Tela disponível no menu TOTVS Educacional | Customização | Parâmetros Contratos para que o usuário defina todos parâmetros para a customização de Contratos.


Detalhamento do processo


Ao acessar TOTVS Educacional | Customização | Parâmetros Contratos o usuário pode visualizar uma grid com todos os parâmetros listados para esta Customização. São eles:

  • Situação de Matrícula “Matriculado” Contrato PJ: parâmetro que o usuário define qual a situação de matrícula o aluno receberá no processo de vínculo de matrícula ao contrato PJ. Esta parametrização deve ser realizada por coligada e nível de ensino.


  • Situação de Matrícula “ Pré Matriculado” Contrato PJ: parâmetro que o usuário define qual a situação de matrícula o aluno receberá inicialmente na realização da matrícula que seja de contrato PJ. Esta parametrização deve ser realizada por coligada e nível de ensino.


  • Número de dias para vencimento (Parcela Processo Seletivo): Será um parâmetro do tipo campo livre para que o usuário informe o número de dias após a inscrição do candidato via processo seletivo que será considerado para gerar a data de vencimento da primeira parcela do contrato. Esta parametrização deve ser realizada por coligada, filial e nível de ensino.


  • Exibição de Cotas (Processo Criação de Parcelas): parâmetro que o usuário define (marcando o parâmetro) se o campo “Cotas” existente no processo de criação de parcelas do contrato será exibido na tela do processo. Esta parametrização deve ser realizada por coligada e nível de ensino.


  • Dia Fixo Vencimento (Processo Seletivo): parâmetro que o usuário informa a data de vencimento a ser considerada no processo automático de “Criação de Parcelas do Contrato” para geração da segunda parcela em diante para processos seletivos que não tenham valores de campanha definidos no anexo customizado. Deve ser parametrizado por coligada, filial e nível de ensino.


Pré-requisitos


  • O SGE deve estar parametrizado para gerar contrato zerado, sem vínculo de plano de pagamento.
  • O campo complementar “Contrato PJ” da matrícula no período letivo do aluno deve estar desabilitado.
  • Os campos abaixo devem estar preenchidos:


Descrição do processo


Ao realizar a matrícula do aluno, o contrato é criado de forma automática (a situação de matrícula utilizada no momento da matrícula deverá estar parametrizada como “exige contrato”. Parâmetro nativo do SGE localizado no cadastro da situação de matrícula.), porém com valor zerado (sem vínculo de plano de pagamento). Uma vez realizada a matrícula, o usuário deverá então acessar o menu disponibilizado no menu TOTVS Educacional | Financeiro/Contábil | Contratos |Processos | Criação de Parcelas do Contrato, para criar as parcelas do contrato de pessoa física (aluno) no SGE de acordo com valor retornado por uma consulta ao sistema corporativo FIRJAN. 


Detalhamento do processo


Ao executar o processo de “Criação de Parcelas do Contrato”, o usuário deve informar o dia de vencimento desejado para as parcelas, configurar o desconto de campanha e clicar em “Consultar”. Neste momento é realizado uma consulta ao WebService do sistema corporativo e os campos "Valor do Contrato", "Qtd. de Parcelas", "Valor da Parcela" e "Tipo de Ciente" são preenchidos automaticamente. 



Dia do Vencimento: opções 5, 10, 15, 20, 25 e 30;

Valor do Contrato: preenchido com valor retornado pelo sistema corporativo. Campo não disponível para edição;

Qtd. de Parcelas: apresenta o número de parcelas de acordo com o valor default:

  • Cursos Livres (SENAI e SESI nível de ensino “Educação Continuada”): apresenta o número de parcelas de acordo com o número de meses entre a data de início e fim da turma em que o aluno está matriculado.
  • SESI nível de ensino “Educação Básica”: apresenta o número de parcelas sugerido conforme retorno da consulta ao sistema corporativo.

Valor da Parcela: apresenta o cálculo realizado do valor do contrato dividido pelo número de parcelas. A parcela é gerada sempre com o valor cheio, isto é, sem desconto. Campo não disponível para edição;

Tipo de Cliente: preenchido com valor retornado pelo sistema corporativo. Campo não disponível para edição;

Serviço: preenchido por default com o serviço “Mensalidade”;

Tipo Parcela: preenchido por default com o tipo “Parcela do Plano”. Campo não disponível para edição;


Desconto de Campanha: flag que habilita/desabilita os campos da campanha;

Campanha: faz a leitura da lista de campanhas da tabela dinâmica CURSOSCAMP. As campanhas devem ser cadastrada no SGE com o mesmo código das campanhas existentes no sistema corporativo. Ao clicar em “Consultar” é enviado o código da campanha ao sistema corporativo, para que retorne o percentual de desconto da campanha e para qual parcela esse desconto será aplicado.

Parcela: caso seja consultado um valor de campanha, o campo é preenchido com o retorno da informação do sistema corporativo para qual parcela deve ser aplicado o desconto da campanha.

Desconto: caso seja consultado um valor de campanha, o campo é preenchido com o retorno da informação do sistema corporativo do percentual de desconto que deve ser aplicado sobre a Parcela retornada no campo “Parcela”. Quando a parcela for gerada, o tipo de desconto será preenchido = a “Valor”. 




Aplicar Cota: flag que habilita/desabilita os campos da cota;

Parcela: o usuário informa qual a parcela que deseja receber a modificação no número de cotas após clicar no botão “Aplicar”;

Nº de Cotas: indica o número de X registros (cotas) para parcela. O número de cotas por default é preenchido com o valor 1.

% Cota: o usuário deve informar % a ser pago em cada parcela da cota. A customização realiza o cálculo do valor original da parcela (campo “Valor Parcela”) e considera o percentual informado. Ao clicar em “Aplicar” o % definido é considerado para a parcela origem e as demais parcelas originadas daquela cota receberão o valor restante para que a soma dos valores seja igual ao valor total da parcela.



Qtd. de Parcelas: apresenta o número de parcelas de acordo com o número de meses entre a data de início e fim da turma em que o aluno está matriculado.


Qtd. de Parcelas: apresenta o número de parcelas sugerido conforme retorno da consulta ao sistema corporativo.

  • O usuário pode alterar o número de parcelas, desde que o novo número de parcelas seja menor ou igual ao número de parcelas sugerido por default.  

Pré-requisitos


Não se aplica.


Descrição do processo


Interferência customizada na alteração do campo Status (SGRADE.STATUS) do cadastro de Matriz Curricular.


Detalhamento do processo


Caso o status da Matriz Curricular seja modificado para Ativa ou Atual, assim que o usuário clicar em Salvar, a customização consome um Web Service do Gestor de Serviços cujo o método retorna se o Serviço vinculado à Matriz Curricular no Gestor de Serviços está finalizado. Se não estiver finalizado, a alteração ocorre normalmente no SGE. Porém se o Serviço estiver finalizado, a operação no SGE não é concluída e é emitida a mensagem retornada pelo Web Service.


Ao modificar o status para Inativa de uma Matriz Curricular não é realizada nenhuma ação customizada.

Pré-requisitos


Não se aplica.


Descrição do processo




Detalhamento do processo


Pré-requisitos


Não se aplica.


Descrição do processo


Interferência customizada na alteração do campo Data de Término (SGRADE.DTFIM) do cadastro de Matriz Curricular.


Detalhamento do processo


Ao modificar a Data de Término da Matriz Curricular para uma nova data ou nulo e o usuário clicar em Salvar, a customização consome um Web Service do Gestor de Serviços cujo o método modifica a data de validade do Serviço.

Pré-requisitos


Não se aplica.


Descrição do processo


Integração via Web Service capaz de retornar o Status da Matriz Curricular para o Gestor de Serviços.


Detalhamento do processo


O Gestor de Serviços poderá acionar um Web Service TOTVS capaz de retornar ao Gestor o Status da Matriz Curricular solicitada.


A consulta será realizada pelo Gestor de Serviços no momento que o mesmo realizar a finalização de um Serviço. Todavia, esta finalização só é concretizada caso o status da Matriz Curricular seja igual a Inativa.

Pré-requisitos


Não se aplica.


Descrição do processo


Interferência customizada na inclusão de uma Matriz Aplicada  para que estas informações sejam replicadas ao Gestor de Serviços.


Detalhamento do processo


Assim que o usuário clicar em Salvar quando estiver incluindo um novo registro de Matriz Aplicada, a customização valida se a Matriz Curricular vinculada possui Serviço associado (ZGESTORITEM e ZGESTORCONTA). Se houver, a customização permite que o registro seja salvo e aciona a integração via Web Service do Gestor de Serviços enviando os dados da nova Matriz Aplicada.

Pré-requisitos


Não se aplica.


Descrição do processo


Interferência customizada na exclusão de uma Matriz Aplicada para que estas informações sejam replicadas ao Gestor de Serviços.


Detalhamento do processo


Assim que o usuário clicar em Excluir do cadastro de Matriz Aplicada, se houver apenas uma Matriz Aplicada ativa para a Matriz Curricular vinculada na unidade (Filial), a customização aciona um Web Service do Gestor de Serviços. A exclusão só é concluída se o Gestor de Serviços permitir. Caso contrário, é emitida a mensagem retornada pelo Web Service e a exclusão é abortada.


Se houver mais de uma Matriz Aplicada ativa para a Matriz Curricular na unidade (Filial) a exclusão nativa é acionada normalmente.

Pré-requisitos


Não se aplica.


Descrição do processo


Interferência customizada na alteração do campo "Oferta Ativa "de uma Matriz Aplicada.


Detalhamento do processo


Caso a “Oferta” seja modificada para Ativa (S), assim que o usuário clicar em Salvar, a customização consome um Web Service do Gestor de Serviços cujo o método retorna se o Serviço da Matriz Curricular vinculada à Matriz Aplicada no sistema terceiro está finalizado. Se não estiver finalizado, a alteração ocorre normalmente no SGE. Porém, se o Serviço estiver finalizado a operação no SGE não é concluída e é emitida a mensagem retornada pelo Web Service.


Caso a “Oferta” seja modificada para Inativa (N), assim que o usuário clicar em Salvar, a customização verifica se existe outro registro de Matriz Aplicada para a mesma Matriz Curricular com “Oferta”  = Ativa. Se houver algum registro, a rotina nativa de alteração da Matriz Aplicada é concluída alterando o campo para “Inativa”. Todavia, se não houver mais nenhuma outra Matriz Aplicada para a mesma Matriz Curricular com “Oferta” = Ativa, a customização aciona um Web Service do Gestor de Serviços para que a mesma seja finalizada também no outro sistema. A desativação no SGE só é permitida caso o Gestor de Serviços permita. Caso contrário é emitida a mensagem retornada pelo Web Service e a rotina de alteração é abortada.