Objetivo
Este documento foi elaborado para informar aos usuários-chave da área Educacional do SENAI DN (Template Digital) sobre as funcionalidades que possibilitarão que o  aluno receba por e-mail a declaração de matrícula e segunda via de certificado solicitados por atendimento através do módulo TOTVS Aprovações e Atendimento, após a finalização das assinaturas dos responsáveis.

Para isso, serão apresentados os requisitos referentes à customização da integração já existente FS008375 (AAAKH4) - Integração TOTVS Educacional x TOTVS Assinatura Eletrônica. Será apresentada uma visão prática do processo e cadastros educacionais, explorando os conceitos utilizados e as funcionalidades do sistema. O material orienta a execução das atividades para garantir que todo o processo educacional mapeado durante o projeto seja contemplado.


Público Alvo
Este manual é destinado aos colaboradores selecionados como usuários-chave para o Template Digital, SENAI DN.


Metodologia
Este material tem como base a visão prática e completa do processo customizado da área Educacional através da customização existente – FS008375 (AAAKH4) - Integração TOTVS Educacional x TOTVS Assinatura Eletrônica. A metodologia utilizada tem como ponto de partida o mapeamento completo do respectivo processo, relacionado com as interfaces no Sistema TOTVS Educacional. Sempre que houver alguma atividade a ser realizada no sistema, as suas funcionalidades e rotinas serão explicadas com detalhes.


Este manual detalha as tratativas customizadas durante as solicitações de documentos feitos pelos alunos através do Portal Educacional, para possibilitar que o aluno receba por e-mail a declaração de matrícula e segunda via de certificado solicitados por atendimento através do módulo TOTVS Aprovações e Atendimento,  após a finalização das assinaturas dos responsáveis.


A customização identificará os atendimentos de solicitação de documentos que estejam parametrizados e disponíveis na fila do módulo TOTVS Aprovações e Atendimento com o status igual a 'Em andamento' e analisará:

  • Se aquele documento já foi solicitado em algum momento pelo aluno e encontra- se assinado no TOTVS Assinatura Eletrônica: Para documentos já assinados e dentro do prazo de validade, será feito o download do PDF e enviado para o e-mail do aluno.
  • Se aquele documento nunca foi solicitado e/ou está fora da data de validade: Será identificado o responsável pela unidade (filial), o documento será enviado para assinaturas e após estar 100% assinado, será feito o download do PDF e enviado para o e-mail do aluno.


  1. Liberação dos anexos customizados na árvore de perfil:

Os anexos de Histórico Matricula retorno devem ser liberadas nas permissões de perfil dos usuários para aparecerem nos seus respectivos lugares. Para mais detalhes de como liberar no perfil dos usuários acesse o Manual de Instalação de Customizações na seção Liberando Acesso aos Menus.






       2.  Cadastros das Turmas aptas para o retorno - Oferta permanente:

É necessário cadastrar Turmas e Turmas/Disciplinas aptas para o retorno, através do menu:
TOTVS EDUCACIONAL I ATIVIDADES ACADÊMICAS I ASSISTENTES I CADASTRO DE TURMA e TURMA/DISCIPLINA.


Será necessário realizar a criação de alguns registros de Turmas/Disciplinas para cada curso ofertado no processo seletivo, para serem utilizadas na matrícula do aluno que esteja retornando para o mesmo Curso e Período Letivo.

       3. Vínculo da Turma ao Processo Seletivo:

  A Turma deverá será vinculada ao Processo Seletivo Oferta Online (Integração TOTVS Educacional x MarketPlace), através do anexo da área de interesse:



4. Inscrição/Matrícula no Processo Seletivo:

A primeira inscrição é iniciada na loja do MarketPlace e redirecionada para o Portal do Processo Seletivo. Na inscrição estará visível a Turma que foi vinculada no anexo da área de interesse.

O serviço segue o fluxo nativo, com etapas já definidas na Integração com o MarketPlace, sem interferências da customização da Matrícula Digital - Retorno.








A matricula é inserida na Turma informada no anexo da área de interesse do Processo Seletivo.




Será necessário informar alguns dados para possibilitar as tratativas de Matrícula Retorno no Processo Seletivo Oferta Online. Para isso, foram acrescentados parâmetros customizados na interface já existente da Integração TOTVS Educacional x MarketPlace.

A interface estará disponível em: TOTVS Educacional | Customizações | MarketPlace | Parâmetros.

Na interface de Parâmetros o usuário deverá efetuar as seguintes parametrizações. Estes parâmetros serão armazenados por contexto (Coligada, Filial e Nível de Ensino):

  • Modalidades – Matricula Retorno: Neste item o usuário deverá informar as Modalidades de Cursos que serão consideradas na Matricula em Disciplinas –Retorno. Será possível informar N opções.
  • Motivo da Alteração de Situação de Matricula Retorno: Neste parâmetro será informado o motivo da alteração da situação de matricula. Será possível informar apenas uma opção no parâmetro.
  • Tipo de Matrícula Retorno: Parâmetro que define o tipo de matricula que será considerado. Será possível informar apenas uma opção.


Pré - Requisitos:

Para o correto funcionamento do processo, todas as orientações/parametrizações descritas nos itens acima deverão estar finalizadas.

SENAI DN utiliza a integração do TOTVS Educacional x MarketPlace para receber novas matrículas e também matrículas de alunos que retornam para fazer outros cursos na instituição dentro do mesmo Período Letivo ou até mesmo refazer um curso na mesma Turma.

O aluno realizará a inscrição conforme ocorre atualmente. Não haverá mudança nos fluxos de inscrição/matrícula.

No momento em que o usuário clicar para confirmar a inscrição/matrícula, a customização irá realizar as seguintes ações:

 1. Modalidade da inscrição: 

     Validar se a modalidade do curso para qual o aluno esteja se inscrevendo está parametrizada.

     Os itens abaixo só serão executados para  modalidades cadastradas.

 2. Inscrição no Processo Seletivo:

Validar no Processo Seletivo se aquele aluno/candidato (CPF) já possui inscrição. Caso afirmativo, será realizada a atualização dos dados da inscrição existente sem tentativa de inserir nova inscrição. Além da atualização dos dados cadastrais, a data de inscrição do candidato será alterada  (SPSINSCRICAOAREAOFERTADA.DATAINSCRICAO) e o registro será gravado no histórico customizado Histórico de Matrícula Retorno - Candidato

TOTVS Processo Seletivo | Cadastros | Candidatos Inscritos | Inscrição do candidato| Anexos| Histórico de Matricula Retorno - Candidato



Caso o aluno não possua inscrição no processo seletivo, a customização irá incluir o registro de inscrição do aluno e todos os vínculos nativos.


3. Identificar se a inscrição/matrícula se trata de um retorno: 

Validar no TOTVS Educacional através do CPF informado na inscrição se aquela pessoa já é aluno e possui matrícula no Período Letivo e Curso Habilitação relacionados à Turma selecionada no formulário de inscrição.

Caso negativo, seguirá o fluxo de matrícula já existente atualmente.


4. Identificar Oferta: 

Para identificação da oferta, será analisado histórico de matrícula de aluno (TOTVS Educacional | Matrícula no Período Letivo | Histórico de alteração de Matrícula). A customização verificará se aquele aluno já cursou em algum momento a mesma Turma selecionada no formulário de inscrição do processo seletivo.

  • Caso o aluno esteja retornando para o mesmo Curso/Habilitação, Período Letivo e Turma, será considerado oferta permanente;
  • Caso o aluno esteja retornando para o mesmo Curso/Habilitação, Período Letivo , porém para Turma diferente, será considerado oferta recorrente.


5. Identificar Turmas/Disciplinas para Matrícula de Retorno:

  • Oferta Permanente: 

Será considerado como filtro para busca: 

O código das disciplinas vinculadas à Turma informada na inscrição (STURMADISC.CODDISC) no mesmo  Período letivo (STURMADISC.IDPERLET) e Matriz Aplicada (SHABILITACAOFILIAL) vinculado à Turma informada na inscrição, com menor ID existente. Pelo menor ID será possível identificar a ordem de cadastros das Turmas/Disciplinas. A customização irá desconsiderar o ID da turma/disciplina que já existe na atual matrícula do aluno e buscar o próximo registro com menor ID. 

Exemplo:

O aluno está, atualmente, registrado na turma APP0282RI.01.01.0521 (destaque em vermelho), concluiu, recebeu o certificado, ok! Tempos depois o aluno deseja realizar o mesmo curso novamente, neste caso a customização irá verificar se há turma, no mesmo período letivo, matriz aplicada, e irá considerar o menor IDTURMADISC e prosseguir com a matrícula. No exemplo abaixo, seria a turma/disciplina destacada em verde.

  • Oferta Recorrente:

Validar se o aluno já teve matrícula no mesmo Curso, Período Letivo, Turma e Turmas/Disciplinas selecionadas no formulário de inscrição do Processo Seletivo. Para isso, será analisado o histórico nativo de alteração de matrícula no período letivo. Caso o aluno esteja retornando para uma turma que ainda não tenha cursado, a customização irá considerar para matrícula a Turma e Turmas/ Disciplinas selecionadas no formulário de inscrição do processo seletivo.

Importante:

Caso não sejam encontradas Turmas Disciplinas Aptas para matrícula retorno, a customização irá exibir uma mensagem ao usuário e impedir a continuidade do processo. Conforme imagem abaixo:


6. Alterar Situação de Matrícula no Curso/Habilitação:

A customização irá alterar o valor existente no campo SHABILITACAOALUNO.CODSTATUS, incluindo a situação de matrícula informada no parâmetro 'Situação de matrícula no curso’ existente na área de interesse ofertada do processo seletivo que o aluno está se inscrevendo (SPSPARAMETROSAREAOFERTADA.CODSTATUSMATRICCURSO) e o motivo de alteração informado no parâmetro Motivo de Alteração de Situação de Matrícula Retorno (Item Parâmetros).





O histórico dessa alteração será gravado no anexo customizado Histórico de Matrícula Retorno, disponível na tela de Curso Habilitação do TOTVS Educacional:  TOTVS Educacional | Aluno | Curso/Habilitação | Anexos | Histórico de Matricula Retorno.




7. Atualizar Matrícula no Período Letivo:

  • Tipo de Matrícula:

A customização irá alterar o valor existente no campo SMATRICPL.CODTIPOMAT. Será alterado para o valor informado no parâmetro Tipo de matrícula Retorno e o o motivo de alteração informado no parâmetro Motivo de Alteração de Situação de Matrícula Retorno (Item Parâmetros).

O histórico dessa alteração será gravado no anexo customizado Histórico de Matrícula Retorno, disponível na tela de Curso Habilitação do TOTVS Educacional: TOTVS Educacional | Matricula e Avaliação| Matriculas | Anexos | Histórico de Matricula Retorno – Período Letivo.

  • Situação de Matrícula do Período Letivo:

A customização irá alterar o valor existente no campo SMATRICPL.CODSTATUS, incluindo a situação de matrícula informada no parâmetro 'Situação de matrícula no período letivo’ existente na área de interesse ofertada do processo seletivo que o aluno está se inscrevendo (SPSPARAMETROSAREAOFERTADA.CODSTATUSMATRICPERIODOLETIVO) e o motivo de alteração informado no parâmetro Motivo de Alteração de Situação de Matrícula Retorno. As alterações continuarão a ser gravadas no fluxo nativo de Histórico de Alteração de Matrícula no Período Letivo (SLOGPLETIVO).

  • Alterar data de Matrícula do Período Letivo:

A customização irá alterar o valor existente no campo SMATRICPL.DTMATRICULA, incluindo a nova data de matrícula (dia que o processo está sendo realizado) e motivo de alteração informado no parâmetro ‘Motivo de Alteração de Situação de Matrícula Retorno’. As alterações continuarão a ser gravadas no fluxo nativo de Histórico de Alteração de Matrícula no Período Letivo (SLOGPLETIVO).

  • Alterar Situação de Matrícula do Resultado Final do Período Letivo:

A customização irá limpar o valor existente no campo SMATRICPL.CODSTATUSRES, o campo ficará em branco e será incluído o motivo de alteração informado no parâmetro Motivo de Alteração de Situação de Matrícula Retorno. As alterações continuarão a ser gravadas no fluxo nativo de Histórico de Alteração de Matrícula no Período Letivo (SLOGPLETIVO).




8. Matricular aluno:

A customização chamará o serviço nativo do produto para matricular o aluno somente nas disciplinas (SMATRICULA) e realizará a matrícula considerando as Turmas/Disciplinas encontradas no item 5.

Será considerado para matrícula em disciplinas, a situação de matrícula informada no parâmetro 'Situação de matrícula nas disciplinas’ existente na área de interesse ofertada do processo seletivo que o aluno está se inscrevendo (SPSPARAMETROSAREAOFERTADA.CODSTATUSMATRICDISCIPLINAS).

Importante: 

  • Haverá modificação na Turma da matrícula no período letivo (SMATRICPL.CODTURMA), será gravado a Turma vinculada a Turma/Disciplina encontrada. 
  • As novas matrículas em disciplinas continuarão a ser gravadas no fluxo nativo de Histórico de Alteração de Matrícula (SLOGMATRICULA).

Será incluída a nova matrícula, mantendo os registros da matrícula anterior.




9. Criar novo contrato:

A customização chamará o serviço nativo do produto para criar um novo contrato para o aluno, considerando as parametrizações existentes na aba Financeiro da área de Interesse Ofertada do Processo Seletivo que o aluno está se inscrevendo (SPSPARAMETROSAREAOFERTADA).
Os dados do novo contrato continuarão a ser gravados no fluxo nativo de Histórico de Alteração de Contrato (SLOGCONTRATO).