Projeto: Integração MarketPlace
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:
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
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 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:
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.
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:
Caso o campo complementar não esteja visível, siga o roteiro de ativação dos campos complementares.
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:
Campo | Obrigatório? | Campo nativo ou criado pela customização? | Editável? | Observação |
---|---|---|---|---|
Nome | Sim | Nativo | Sim | |
Sim | Nativo | Sim | ||
CPF | Sim | Nativo | Sim | |
Curso(Área de interesse) | Sim | Nativo | Não | |
Turma | Sim | Nativo | Não | |
Plano de Pagamento | Sim | Nativo | Não | Será considerado o Plano de pagamento enviado na URL do MarketPlace. |
Indica Gratuidade Regimental | Não | Customizado | Não |
|
Código do cupom de desconto | Não | Customizado | Não | |
Valor final do curso | Não | Customizado | Não | |
Rua | Não | Nativo | Sim | |
Número | Não | Nativo | Sim | |
Bairro | Não | Nativo | Sim | |
Cidade | Não | Nativo | Sim | |
Estado | Não | Nativo | Sim | |
CEP | Não | Nativo | Sim |
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:
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:
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.
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:
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:
Utilização do WebService Genérico de consulta SQL - Para acessar a página do serviço, clique aqui.
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.
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.