Manual - Matrícula Digital Retorno

Este manual detalha as tratativas customizadas durante a matrícula via processo seletivo Oferta Online para possibilitar que o aluno egresso realize o mesmo Curso mais de uma vez no mesmo Período Letivo no TOTVS Educacional. Essas regras já são realizadas atualmente de forma manual pelo CNI, o objetivo da customização é automatizar o processo.

A customização identificará as matrículas de retorno vindas do Processo Seletivo Oferta Online (Integração TOTVS Educacional x MarketPlace), ou seja, alunos que desejam refazer o mesmo Curso no mesmo Período Letivo e realizará algumas tratativas para esses casos, sendo elas:

Matricular o aluno somente nas disciplinas da Turma, mantendo a mesma estrutura de Curso/Habilitação e Matrícula no Período Letivo já existente. Criar um novo contrato financeiro e atribuir a matrícula no Período Letivo existente.

Neste projeto serão tratados dois tipos de matrículas retorno:

• Oferta Permanente: 

Se tratando de um cenário 100% digital, alguns cursos utilizam uma única Turma (com longa duração) vinculada ao cadastro do Processo Seletivo que é disponibilizada no Portal de Inscrições do Processo Seletivo Oferta Online para matrícula do aluno.

• Oferta Recorrente: 

Processos seletivos criados com recorrência, onde não utilizam uma única Turma com longa duração. Neste cenário, temos ofertas distintas com Turmas distintas.

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.

É 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:

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

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