Páginas filhas
  • Manual - Integração Marketplace

Projeto: Integração MarketPlace

Nome do Cliente: SENAI DN


A customização Marketplace permite estender o conjunto de funcionalidades disponíveis no escopo Oferta de Cursos Online. Com ela, é possível que o candidato inicie sua inscrição na plataforma MarketPlace e finalize no Portal de Processo Seletivo do SGE sem que redigite seus dados. As informações também são enviadas automaticamente para o contrato do candidato em forma de bolsa, com os possíveis cupons de descontos oferecidos pela plataforma MarketPlace.


Atenção

A partir da versão 12.1.27 o endereço de acesso ao Processo Seletivo deve ser ajustado para considerar a nova rota. Exemplo:

http://nome_site/web/app/edu/PortalProcessoSeletivo/?c=numColigada&ps=numProcessoSeletivo&ai=numAreaInteresse#/es/inscricoeswizard/dados-basicos?key=...

As telas: Parâmetros, Bolsa Marketplace e Preenchimento/Atualização do Tipo Ingresso devem ser liberadas nas permissões de perfil dos usuarios para aparecerem nos seus respectivos lugares. Para mais detalhes de como liberar no perfil do usuario acesse o Manual de Instalação de Customizações na seção Liberando Acesso aos Menus.



É necessário realizar a parametrização entre o SGE e a plataforma MarketPlace através do menu "Customização|submenu MarketPlace | Parâmetros" informando os valores do token, endereço WebService, chave de criptografia do WebService e Tipo de ingresso.

IMPORTANTE: A customização MarketPlace + Processo Seletivo não possui funcionalidade para geração de token. As informações a serem parametrizadas abaixo deverão ser fornecidas pelo MarkePlace (DN).


Importante: Para todos os cursos independente se possuem gratuidade ou não será necessário o cadastro de um plano de pagamento para o correto funcionamento da customização. 

Para os cursos de gratuidade, o plano de pagamento poderá ser criado com valor zerado (sem vínculo de parcelas).


Validação de Voucher Marketplace

Atualmente para validação de voucher do Marketplace é utilizado o seguinte link: https://loja.mundosenai.com.br/rest/V1/saveOrder

Para Preencher todas as matrículas que possuírem o campo customizado Valor Final do Curso do MarketPlace preenchido, é necessário ter o parâmetro Tipo Ingresso preenchido. Então, basta acessar o menu "Sistema Industria | submenu MarketPlace | Parâmetros | processo Preenchimento/Atualização do Tipo Ingresso". Desta forma será preenchido/atualizado do Tipo Ingresso de todas as matrículas que possuírem o campo customizado Valor Final do Curso do MarketPlace preenchido.

Parâmetro - Utiliza Oferta MarketPlace:

Disponível em:  TOTVS Educacional | Processo Seletivo | Cadastro | Processo Seletivo | Aba Identificação, o parâmetro "Utiliza oferta MarketPlace" tem a finalidade de definir se o processo seletivo utilizará ou não a customização (SGE -TOTVS Educacional) referente ao MarketPlace.



Observações

  • Para o correto funcionamento do parâmetro é necessário que esteja marcada a opção "Utiliza Oferta Online de Curso". Não é possível marcar/desmarcar a flag "Utiliza Oferta MarketPlace" caso já exista algum candidato inscrito ou alguma área de interesse ofertada cadastrada.
  • Ao marcar a flag "Utiliza Oferta MarketPlace", será validado se existe algum curso parametrizado na Área de Interesse Ofertada | Aba Venda On-Line de Cursos | Acadêmico 


Bolsas MarketPlace:


São parametrizadas através do anexo Bolsa MarketPlace no cadastro nativo de bolsas do SGE (TOTVS Educacional | Financeiro/contábil | Bolsas | Anexos).


Obs: 

  • O campo desconto da bolsa deve ser do tipo tipo percentual e possuir o valor zerado conforme imagens acima
  • Somente é permitida a inclusão de uma bolsa MarketPlace por Coligada e nível de ensino. Uma bolsa cadastrada em uma filial terá seu cadastro compartilhado entre todas as filiais da mesma Coligada e mesmo Nível de ensino.
  • Não é permitido qualquer alteração no cadastro da bolsa parametrizada como "Oferta VTEX (anteriormente Marketplace)" conforme imagem abaixo:



O valor de desconto do cupom distribuído pela plataforma MarketPlace é aplicados ao contrato do aluno automaticamente via inserção da bolsa MarketPlace. A bolsa será aplicada em todos os serviços existes no contrato do aluno conforme pode ser observado nas imagens abaixo:



As parcelas do contrato são geradas automaticamente e cabe ao regional, caso necessário, realizar a manutenção nas datas de vencimento das parcelas.


Cadastro de Plano de Pagamento no SGE e parametrização na Área de Interesse do Processo Seletivo:


Para todos os cursos independente se possuem gratuidade ou não será necessário o cadastro de um plano de pagamento para o correto funcionamento da customização. Os planos de pagamento deverão ser cadastrados de forma nativa através do TOTVS Educacional | Financeiro/Contábil | Planos de Pagamento. Para os cursos de gratuidade, o plano de pagamento poderá ser criado com valor zerado (sem vínculo de parcelas).



O plano de pagamento deverá ser informado no cadastro da área de interesse ofertada do processo seletivo. Todos os processos seletivos que estiverem com o campo Utiliza MarketPlace marcado terão a funcionalidade: Cadastrar o contrato marcada como padrão. Caso queira descartar o contrato a ser gerado para uma determinada área de interesse ofertada, deverá ser marcada a opção Descartar Contrato.



Obs: Será apresentado a mensagem de validação na tela para o usuário apenas uma vez a cada edição de tela caso a Área de Interesse Ofertada esteja desativada ou possua a turma de interesse inativa  ou inexistente.


Anexo Tipo de Financiamento na Área de Interesse Ofertada do Processo Seletivo:


Disponível no cadastro de Área de Interesse Ofertada do Processo Seletivo, o Anexo Tipos de financiamento tem o objetivo de cadastrar os vários tipos de financiamentos que poderão ser utilizados irão compor o cadastro do aluno no campo Complementar Condição do Aluno no Cursos/Habilitações e Matrículas no Período Letivo.

O usuário poderá inserir diversos itens, conforme imagens abaixo:



O valor utilizado no momento da matrícula será enviado de forma transparente ao usuário pelo Marketplace, e deverá estar cadastrado no anexo acima para poder ser utilizado nos campos complementares.


Da mesma forma, quando o tipo do cupom do candidato for proveniente de CNPJ é preenchido automaticamente o campo complementar CNPJ da Empresa presente no menu Currículo e Oferta | Aluno | Anexos | Cursos/Habilitações | aba Campos Complementares| CNPJ da Empresa com o numero do CNPJ.


Nota

O cadastro do campo é obrigatório para prosseguimento da inscrição no Processo Seletivo:


Anexo Turmas na Área de Interesse Ofertada do Processo Seletivo:


Disponível no cadastro de Área de Interesse Ofertada do Processo Seletivo, o Anexo Turmas da Área de Interesse tem o objetivo de informar as turmas que poderão ser utilizados para escolha do candidato no momento da inscrição no processo seletivo. Para que as turmas sejam exibidas no portal, é necessário que o usuário adicione e ative as turmas no anexo.

O usuário poderá inserir diversos itens, conforme imagens abaixo:

 Por padrão o campo Ativo ao adicionar a turma sempre será apresentado marcado, sendo necessário o usuário desmarca manualmente, caso deseja que a turma esteja desativada.

Ao acessar a tela de inscrição as turmas ativas serão exibidas para seleção.


Obs: Mais informações como por exemplo: ativar/desativar turmas na área de interesse, acesse o manual do Oferta Online de Cursos.


Parametrização nativa Código da Turma - Não Utilizar:


A parametrização nativa Código da turma existente no cadastro da Área de Interesse Ofertada do Processo Seletivo, só deverá ser preenchida se o regional não utilizar a customização de Oferta Online de cursos e  MarketPlace. Para regionais que utilizam as customizações, a forma correta de parametrização de turmas é a indicada no tópico acima: Anexo Turmas na Área de Interesse Ofertada do Processo Seletivo.



Obs: Caso o regional Utilize  a customização de Oferta Online de cursos e  MarketPlace, e informar  a turma em Venda online de de Cursos | Acadêmico, ao salvar será apresentada uma mensagem impedindo com que a turma seja cadastrada, informando o local correto para que a turma seja informada. 

Matricula do aluno gerada no SGE:


Finalizada a inscrição no processo seletivo, no SGE é gerada a matricula do aluno. Para as inscrições que possuírem cupons distribuídos pela plataforma MarketPlace, foram criados três campos não editáveis  no menu Currículo e Oferta | Aluno | Anexos | Cursos/Habilitações | aba Ingresso que armazenam os código do cupom, percentual de desconto e valor final do curso provenientes do MarketPlace conforme imagem abaixo. O Campo Tipo de ingresso também é preenchido automaticamente, com base no Parâmetro Tipo de Ingresso do MarketPlace



Importante:

  • Esses campos são meramente informativos e não possuem funcionalidade de inclusão, edição e/ou exclusão.


    Caso o campo complementar não esteja visível, siga o roteiro de ativação dos campos complementares.


Inscrição de candidatos:


Novas inscrições nos processos seletivos:


O candidato interessado em participar de algum curso ofertado pelos regionais poderá realizar uma pré-inscrição na Plataforma MarketPlace. O redirecionamento é feito para a página de inscrição do 

Portal de Inscrição do Processo Seletivo Oferta Online do SGE (Totvs Educacional), e os dados abaixo, são carregados automaticamente para os campos correspondentes:


CampoObrigatório?Campo nativo ou criado pela customização?Editável?Observação
Nome SimNativoSim
Email SimNativoSim
CPF SimNativoSim
Curso(Área de interesse)SimNativoNão
Turma SimNativoNão
Plano de PagamentoSimNativoNãoSerá considerado o Plano de pagamento enviado na URL do MarketPlace.
Indica Gratuidade RegimentalNãoCustomizadoNão
  • Quando gratuidade regimental, ao finalizar a inscrição, a customização não criará o contrato no SGE.


  • Os códigos de cupons de gratuidade regimental serão distribuídos apenas pelo Departamento Nacional, serão cupons com percentual de 100% (cem) de desconto. A plataforma MarketPlace será responsável por identificar os códigos de cupons que possuem gratuidade regimental
Código do cupom de descontoNãoCustomizadoNão
Valor final do cursoNãoCustomizadoNão
RuaNãoNativoSim
NúmeroNãoNativoSim
BairroNãoNativoSim
CidadeNãoNativoSim
EstadoNãoNativoSim
CEPNãoNativoSim


Observação: os campos Tipo da Rua, Tipo do Bairro e País, virão com os valores fixos "Rua", "Bairro e "Brasil" preenchidos para cada campo, respectivamente.


Ex:



Candidatos já inscritos em algum processo:


Caso o candidato já tenha realizado alguma inscrição em algum processo seletivo (ou até no mesmo processo seletivo), é redirecionado  para a tela de login da Central do Candidato. As informações recebidas

via URL são carregadas automaticamente, posterior é direcionado para o Formulário de Inscrição.





Obs: Os campos preenchidos via plataforma MarketPlace e recebidos via URL no portal de inscrição, não podem ser editados.


Aviso

O indicativo se a matricula corresponde a uma gratuidade regimental consta como um campo checkbox na forma de pagamento da inscrição no Processo Seletivo:



Por fim, ao finalizar a inscrição no portal Processo Seletivo, será gerada a matricula no período letivo do candidato no SGE. Ao efetivar a matricula do candidato, ocorrerá as seguintes validações pelo SGE:

  • Quando gratuidade regimental: Ao finalizar a inscrição, não haverá geração de contrato para o aluno no SGE. Será feito o preenchimento automático do campo Condição do aluno com o código enviado pelo MarketPlace através da URL correspondente ao tipo de financiamento, onde o valor esta voltado para a tabela dinâmica TIPOGRAT. Este campo está disponível nos menus:

  TOTVS Educacional | Educacional | Currículo e Oferta | Aluno | Anexos | Cursos/Habilitações | aba Campos Complementares| Condição do aluno;

  TOTVS Educacional | Educacional | Matrícula e Avaliação | Matrículas | Anexos | Condição do aluno.



  • Quando não gratuidade regimental: Será aplicado ao contrato do aluno uma bolsa com percentual igual ao valor do voucher (cupom) quando distribuído pela plataforma MarketPlace.

Finalizada a inscrição no processo seletivo, no SGE é gerada a matricula do aluno. Para as inscrições que possuírem cupons distribuídos pela plataforma MarketPlace, foram criados três campos não editáveis  no menu Currículo e Oferta | Aluno | Anexos | Cursos/Habilitações | aba Ingresso que armazenam os código do cupom, percentual de desconto e valor final do curso provenientes do MarketPlace conforme imagem abaixo.



Importante:

  • Esses campos são meramente informativos e não possuem funcionalidade de inclusão, edição e/ou exclusão.


Atenção:


Atenção

A partir da versão 12.1.27 o endereço de acesso ao Processo Seletivo deve ser ajustado para considerar a nova rota. Exemplo:

http://nome_site/web/app/edu/PortalProcessoSeletivo/?c=numColigada&ps=numProcessoSeletivo&ai=numAreaInteresse#/es/inscricoeswizard/dados-basicos?key=...



Utilização do WebService Genérico de consulta SQL - Para acessar a página do serviço, clique aqui.

Processo Seletivo com uso de Marketplace


Se o processo seletivo utilizar Marketplace, somente será possível prosseguir a inscrição pelo portal utilizando o link de acesso, que possui as informações para carregamento dos dados da turma.



Caso seja acessada tela de inscrição sem o link de inscrição será apresentada a mensagem de erro e não será possível prosseguir com a inscrição.




Turma do link não encontrada

Caso seja acessada a tela de inscrição com o link de inscrição, porém, neste link constar uma turma não existente, será apresentada a mensagem de erro e não será possível prosseguir com a inscrição.




Utilização da Oferta Online sem Marketplace


Utilização apenas do recurso de Venda Online (não obrigatório uso de link de acesso)



Deve ser verificado se existe turma da área de interesse associada. Se não houver turma associada, a turma não aparecerá para seleção no portal.





Para que o campo seja carregado deve-se marcar o campo complementar da turma (se já estiver marcado, realize alguma alteração na turma, para que o processo de integração com o PS seja realizado).




Ao acessar a tela de inscrição a turma será exibida para seleção.