Manual - Inscrição Única

Síntese

Atualmente o SENAI DN utiliza a Integração do TOTVS Educacional x MarketPlace para receber matrículas, porém, a estrutura do processo está dividido em dois ambientes:

• Informações do Cursos e pagamento: Plataforma MarketPlace;
• Inscrição/Matrícula: Portal TOTVS Processo Seletivo

Serão abordados os requisitos referentes às tratativas customizadas durante a inscrição do aluno via processo seletivo Oferta Online (Integração TOTVS Educacional x MarketPlace), para possibilitar que o aluno visualize as informações do curso e realize a matrícula em uma única tela (visão), sem que ocorra o redirecionamento para o Portal do Processo Seletivo TOTVS.

Premissas

Além das configurações já existentes para o MarktePlace (clique aqui), para que essa customização funcione corretamente, é necessário preencher os seguintes parâmetros:

• Endereço Webservice Retorno Matrícula
• Token Retorno Matrícula

IMPORTANTE: As informações citadas acima deverão ser fornecidas pelo MarkePlace (DN).

Habilitar layout customizado Inscrição Única

Para que o layout do Mundo Senai seja aplicado corretamente, é necessário realizar a seguinte configuração no Portal Processo Seletivo:

1. Acessar o arquivo "edups-constantes.global.config.js", que fica localizado na pasta "C:\TOTVS\CorporeRM\FrameHTML\Web\App\Edu\PortalProcessoSeletivo\js".
2. Alterar o conteúdo da tag "EDUPS_CONST_GLOBAL_CUSTOM_CSS" para true, conforme imagem abaixo:

Foi desenvolvida uma solução que permita ao aluno a visualização e execução da compra e inscrição/matricula sem que ocorra troca de Plataformas (Informações do Cursos e pagamento: Plataforma MarketPlace; Inscrição/Matrícula: Portal TOTVS Processo Seletivo).

A solução consiste em uma página customizada, disponível dentro de um Iframe, onde estão disponíveis todos os campos necessários para inscrição/matrícula. As configurações e processamentos da inscrição/matrícula continuarão a ser executados através dos serviços nativos do produto educacional. 

As etapas de compra e inscrição/matricula serão apresentadas conforme telas abaixo:

Após ser realizado o pagamento/finalização, o usuário é direcionado para uma próxima etapa. Nessa nova etapa, utilizamos um redirecionamento que realizará a chamada da página customizada.

A página customizada seguirá os padrões de cores, fontes e estilos de site existentes atualmente no MarketPlace:

No momento em que o MarketPlace acionar a página customizada, serão realizadas as seguintes ações:

• Receber dados via URL: A customização continuará recebendo do MarketPlace via URL todas as informações da Integração MarketPlace. Essas informações serão carregadas automaticamente no passo abaixo.
• Exibir campos de Inscrição: A customização irá chamar os métodos nativos existentes no processo de inscrição no Processo Seletivo TOTVS e irá exibir dinamicamente na página customizada todos os campos parametrizados no processo seletivo e área de interesse referente à inscrição do aluno, por exemplo:
  1. Aba Dados Básicos - Aba Responsáveis - Aba Pagamentos (caso esteja parametrizado) - Aba Dados do Curso -Envio de Documentos - Termo de Aceite - Login para regressos etc..

As informações recebidas pelo MarketPlace via URL serão preenchidas automaticamente no formulário de inscrição.

• Realizar Inscrição do Candidato: A customização chamará os serviços nativos já existentes no processo de inscrição do candidato ao Processo Seletivo Oferta Online para realizar o cadastro do usuário e inserir a sua inscrição na área ofertada, realizando todas as validações e vínculos já existentes, como por exemplo: Validação de documentos, preenchimento de campos obrigatórios, quantidade de vagas etc.
• Realizar Matrícula do Aluno: A customização chamará os serviços nativos já existentes no processo de matrícula do aluno no TOTVS Educacional para realizar a matrícula do aluno e todas as validações e vínculos já existentes, como por exemplo: criação de contrato, parcelas, etc. 

Será exibido para o aluno todas as mensagens e validações retornadas dos serviços nativos de matrícula do TOTVS Educacional.

• Exibir comprovante de Inscrição: A customização chamará os serviços nativos já existentes no processo seletivo para exibir ao aluno o comprovante de inscrição na central do candidato.
• Enviar dados para o MarketPlace: A customização irá consumir um método que será criado pelo MarketPlace para enviar os status do processamento da inscrição/matrícula. Esses dados serão utilizados para gestão do MarketPlace e exibição na área do cliente. Essa exibição será de responsabilidade exclusiva do MarketPlace, sendo a TOTVS responsável apenas por enviar os status na integração descrita no próximo item – Envio de dados para o MarketPlace.

FLUXO:

Será enviada ao Marketplace as informações do Status do processamento da inscrição/matrícula, para possibilitar que o Marketplace exiba o status da jornada para o aluno na área do cliente.

O serviço customizado (plugin) fará o acompanhamento do processo de inscrição/matricula do aluno enviará ao MarketPlace  o status do processamento através de chamada de WebService. Será considerado para integração, as parametrizações já existentes no projeto FS008228 (A50301) - Integração MarketPlace, sendo elas:

• Parâmetro ‘Chave Criptografia’ (ZTEMPLATEPARAMETROVALOR.SECURITYKEY);
• Parâmetro ‘Token WebService ’(ZTEMPLATEPARAMETROVALOR.TOKEN);
• Parâmetro ‘Endereço WebService’ (ZTEMPLATEPARAMETROVALOR.URLWS).

O serviço customizado irá acompanhar o processo de inscrição/matrícula disponível nos menus do Processo Seletivo TOTVS: Dados Básicos, Responsáveis, Pagamento e  Dados do Curso. Consumirá método que será criado pelo MarketPlace e enviará as informações abaixo:

CPF: CPF informado pelo aluno na inscrição;

Status: Status da inscrição/Matrícula, sendo eles:

0 - não iniciado;

 1-  Erro;

2-  Sucesso.

Mensagem: Mensagem retornada durante o processo de inscrição/matrícula. Seja pelo TOTVS Processo Seletivo, TOTVS Educacional ou Customização.

Id. Etapa: Etapa referente ao processo de inscrição/matrícula, sendo elas:

 1 - Matrícula: Qualquer erro/ retorno que ocorrer durante o processo de inscrição no processo seletivo e matrícula no TOTVS Educacional;

 2 - Pagamento: Qualquer erro/ retorno que ocorrer durante o processo de pagamento feito no TOTVS Processo Seletivo para lojas que não possuem gateway de pagamento implantado no Marketplace;

 3 - Customização: Qualquer erro/ retorno que ocorrer durante o processo de inscrição/ matrícula no TOTVS processo seletivo e TOTVS Educacional que tenham referência a customização existente no projeto FS008228 (A50301) - Integração MarketPlace.

Exemplo de envio em formato JSON:

"Inscricao" : {

"CPF" : "01650289630 ",

"Status": 1 

"Mensagem": "Erro ao finalizar matrícula, não existem vagas disponíveis para Turma informada."

"IdEtapa" : 3  

}