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 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).
Para isso, será apresentada uma visão prática da solução desenvolvida, explorando os conceitos utilizados e as funcionalidades do Sistema. O material descreve as etapas da compra e inscrição/matricula, destacando a pagina customizada disponível no Iframe, 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 da Customização ,da área Educacional através da Customização existente – Integração MarketPlace FS008228. 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 detalhe.
Expandir |
---|
|
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.
|
Expandir |
---|
|
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: - Acessar o arquivo "edups-constantes.global.config.js", que fica localizado na pasta "C:\TOTVS\CorporeRM\FrameHTML\Web\App\Edu\PortalProcessoSeletivo\js".
- Alterar o conteúdo da tag "EDUPS_CONST_GLOBAL_CUSTOM_CSS" para true, conforme imagem abaixo:

|
Expandir |
---|
title | Inscrição unificada TOTVS Processo x MarketPlace |
---|
|
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: 



Aviso |
---|
| A etapa de pagamento ocorre somente nas lojas que possuem gateway de pagamento implantado no Marketplace. |
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:
- 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óximoitem – Envio de dados para o MarketPlace.
Informações |
---|
| - Caso o aluno seja regresso, será mantido o mesmo fluxo nativo de recuperação de dados. A customização irá exibir na página customizada chamada pelo MarketPlace (Iframe), os mesmos serviços existentes atualmente no produto padrão.
|
FLUXO:

|
Expandir |
---|
title | Envio de dados para o Marketplace |
---|
|
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 }
Nota |
---|
| A integração será de via única (TOTVS Processo Seletivo e Educacional para o MarketPlace), não haverá retorno e atualização de dados. |
|