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

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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.

...

Expandir
titlePré-Requisitos para o MarketPlace

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.


Image Added


É 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 e a 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 (ExablackDN).


Image Modified

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


Informações
titleValidação de Voucher Marketplace

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

Expandir
titlePreenchimento de Tipo Ingresso

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.

Image Added

Expandir
titleParametrizações MarketPlace no SGE (Totvs Educacional)

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.


Obs: Para


Informações
titleObservaçõ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.
  • Bolsas do tipo MarketPlace não poderão ser associadas e nem removidas manualmente de nenhum contrato, 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 deverão utilizar obrigatoriamente as funcionalidadesterão a funcionalidade: Cadastrar o contrato, Código do Plano de pagamento, Permitir alterar plano de pagamento no Portal e Responsável Financeiro do Aluno. A obrigatoriedade da funcionalidade Permite alterar o Plano de Pagamento no Portal será necessária para habilitar na página de inscrição do Processo Seletivo o menu Forma de Pagamento. Mesmo com essa funcionalidade selecionada, não será permitido o candidato alterar o plano de pagamento no Portal Inscrições, a customização irá considerar o plano de pagamento enviado pelo MarketPlace.

Obs: Para os processos seletivos MarketPlace, os campos Cadastrar contrato e Permite alterar plano de pagamento no Portal, possuem validação customizada e não é possível salvar o registro de área de interesse, caso não esteja preenchidos.

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.


Image Added


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.

Image AddedImage Removed


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
titleNota

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 exibir 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 anexoportal, é necessário que o usuário tenha marcado o campo complementar Disponível para divulgação existente no cadastro das turmas (TOTVS Educacional | Currículo e Oferta | Turmas).Image Removedadicione e ative as turmas no anexo.

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

Image Added

 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 a turma será exibida 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. 

Image Added

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


Image AddedImage Removed


Importante:

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


    Dica

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


Expandir
titlePlataforma MarketPlace -> Portal Processo Seletivo Oferta Online (Inscrição Candidato)

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 PagamentoParametrizávelSimCustomizadoNativoNãoCaso obrigatório, o candidato deverá selecionar o plano de pagamento no formulário de inscrição do candidatoSerá 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.


Nota
titleAviso

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:

Image Added



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


Image Added


  • Quando não gratuidade regimental, será : 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.


Image Added


Importante:

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


Atenção:


Aviso
titleAtençã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=...



Expandir
titleWebService de Consulta - MarketPlace

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

Cloak

Swagger

Foi desenvolvido um WebService de consulta que retorna os dados referente a curso oferta, o mesmo esta disponível no swagger com o nome CstCursoOferta.

Todos os serviços disponíveis no RM são agrupados e listados nessa ferramenta, que visa auxiliar na manutenção e documentação de APIs REST.

Para acessar o Swagger, é necessário acessar o link no seguinte formato "http://<servidor>:<portaFrameHTML>/swagger/ui/index" ou "http://<servidor>/FRAMEHTML/swagger/ui/index" (12.1.32) (Exemplo: http://localhost:8080/swagger/ui/index http://localhost/FRAMEHTML/swagger/ui/index).



O serviço da customização de consulta de curso e oferta esta disponível no método CstCursoOferta,  que é do tipo GET.


Detalhamento do processo

O método não recebe nenhum objeto como parâmetro no corpo da requisição. Tratado internamente pelo RM  existe um parâmetro que filtra a coligada SENAI, deste modo para correto funcionamento da API é necessário realizar a parametrização informando qual é a coligada SENAI no seguinte caminho Totvs Educacional | Gestão CNI | Parâmetros Gerais | Coligada SENAI.

Obs: É necessário preencher com a coligada SENAI referente ao seu regional.

image2020-11-18_10-17-39.png

Expandir
titleInformações úteis

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.



...