Projeto: FS008677 - Template Digital II - Sugestão de Curso/Compra Fácil

Nome do Cliente: Confederação Nacional da Indústria - SENAI


Objetivo
Este documento foi elaborado para informar aos usuários-chave da área Educacional do SENAI, a funcionalidade que realiza a integração na Sugestão de Curso/Compra Fácil no SGE para realização de compras na plataforma VTEX. Para garantir uma experiência única para o usuário, teremos uma pagina customizada de inscrição, onde estarão disponíveis os campos definidos no 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 frame, 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 do SENAI.


Metodologia

Este material tem como base a visão prática e completa do Processo Customizado da área Educacional através da Customização Template Digital II - Sugestão de Curso/Compra Fácil FS008677. 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.

Utilizar o Mundo SENAI (E-commerce) para venda de cursos utilizando a integração do SGE com loja do Marketplace (Futuro Digital VTEX), propondo uma experiência rápida em poucos cliques pelo cliente, além de gerar ofertas personalizadas. No VTEX, será possível oferecer para o Aluno a visualização dos produtos similares (cursos) na página inicial do produto/curso, exibir os últimos cursos cadastrados (lançamentos) e a quantidade vendida de cada produto. Além disso, a customização irá possibilitar a curadoria de depoimentos de alunos para serem publicados na plataforma VTEX.

Será necessário informar alguns dados para possibilitar as tratativas da Integração com a Plataforma VTEX.

Para isso, formam desenvolvidos parâmetros customizados. A interface da a integração do TOTVS Educacional (SGE) com a plataforma VTEX deverá acessar o seguinte caminho:

TOTVS Educacional | Processo Seletivo| Sistema Indústria | Integração VTEX |Aba Parâmetros Gerais.

O período de lançamento irá consultar a data inicial do calendário no Processo Seletivo, no período de inscrições

Data da inscrição do Processo Seletivo

Data da inscrição do Processo Seletivo

Será enviado como Lançamento até

15/10/2022

15

* 30/10/2022

O período de lançamento (dias) é um campo numérico e tem como objetivo permitir que o usuário definam a quantidade de dias em que uma oferta/produto seja considerada lançamento na plataforma VTEX, de acordo com o período de inscrição no processo seletivo.

Fique ligado, pois após esse período, será retirada a marcação de lançamento deste produto.







Tipo de Participação

Informar o tipo de participação que  o usuário responsável pela aprovação dos depoimentos terá.

Acesse o seguinte caminho: TOTVS Educacional | Matriz Curricular| Anexo | Matriz Aplicada |Anexo| Comissão Coordenadora |Aba Tipo de Participação

Só será possível cadastrar um tipo de participação por pessoa e só será permitida a aprovação por usuários da comissão coordenadora e vinculados ao tipo de participação parametrizado

Após finalizados todas as parametrizações e cadastros, o usuário deverá executar o processo de exportação de dados. Através desse processo que os Produtos e SKUs serão criados na VTEX.

O processo pode ser agendado ou executado através do Menu: TOTVS Educacional | Sistema Industria | Integração VTEX | Exportar Dados

Para os cursos exclusivos B2B, onde o novo parâmetro (Oferta Exclusiva B2B) do processo seletivo estiver marcado, será enviada a informação política comercial B2B (na área VTEX : Para empresas) e seu preço específico.


O processo customizado de Atualização de Cursos Lançamentos - VTEX tem como objetivo  informar ao VTEX quando um Curso atingiu a data considerada como lançamento no SGE, para que seja retirada a marcação de lançamento do Produto/Oferta disponível no menu: TOTVS Educacional | Sistema Indústria | Integração VTEX | Atualização Cursos Lançamentos.

Este processo poderá ser executado manualmente ou agendado pelo usuário. Ao ser executado, a customização deverá validar a data de inscrição do processo seletivo, a data corrente da execução e o número de dias limite informado pelo usuário no parâmetro, para enviar a atualização e limpar o campo de especificação do produto referente ao lançamento na plataforma VTEX.

O processo deverá identificar o produto/oferta para enviar a atualização dos lançamentos no VTEX, conforme regra:

Data da inscrição do Processo Seletivo: 10/01/2022

Não haver 15

Será enviado como Lançamento até: 25/01/2022 (data da inscrição do Processo Seletivo + dias do período). Após essa data, o produto/oferta deverá ser excluído da lista de lançamentos.

 O processo só deverá atualizar registros para excluir o lançamento, limpando o campo que possui essa marcação.




O anexo customizado Compre Junto - VTEX no cadastro nativo de Área de Interesse Ofertada do Processo Seletivo, foi criado para associar novas áreas de interesse com sugestões de cursos da área de interesse original disponível em: TOTVS Educacional | Processo Seletivo | Cadastros | Processo Seletivo | Anexo | Área de Interesse |Anexos | Compre Junto.

O Anexo irá exibir a lista de áreas de interesse já vinculadas, com opção de inclusão e exclusão. Ao clicar em incluir, será exibida tela de edição onde estará disponível o seguinte campo:

➔ Área de Interesse: O usuário selecionará a área de interesse ofertada que será associada. Só serão exibidas áreas de interesse ativas e já exportadas para o VTEX. A customização deverá exibir as áreas onde o campo Data fim de inscrição do processo seletivo seja menor que a data atual.

Para associar as sugestões de cursos, a partir do cadastro da Área de Interesse Ofertada, através do anexo personalizado, o usuário poderá vincular outras áreas de interesse (ativas e cujos cursos já tenham sido publicados na plataforma VTEX) correspondentes aos cursos que se deseja aplicar como sugestão.

Assim, após o vínculo, ao acessar uma oferta de curso que tenha as demais áreas de interesse anexadas, na plataforma VTEX serão também exibidos ao aluno uma lista de sugestão dos demais cursos para compra.

 Os dados informados nesta interface serão armazenados em tabela customizada por coligada, filial e nível de ensino.

Criação de novo processo customizado para enviar a lista de identificadores dos cursos de cada área de interesse informada como Compre Junto (produtos similares) no anexo customizado da área de interesse. Quando acontecer uma atualização do anexo que afete turmas já exportadas, será necessário disparar a atualização dos produtos similares no VTEX.

 Foi criado um processo customizado de Exportação de Produto Similares - SKU-Turma, disponível no menu: TOTVS Educacional | Processo Seletivo | Cadastros | Processo Seletivo | Anexo | Área de Interesse| Compre Junto | Processos.

Será possível executar o processo para uma área de interesse específica ou para todas. Será possível também agendar a execução recorrente, desde que não tenha sido selecionada nenhuma área de interesse.

 A sugestão de cursos de Compre Junto do VTEX será montada com base nos cursos das áreas de interesse vinculadas como Compre Junto no anexo customizado (req.04). O VTEX deverá exibir uma lista de produtos similares, na página principal do produto, contendo os cursos informados no anexo.

A associação de produtos similares no VTEX acontece entre SKUs, ou seja, para cada SK-turma é necessário enviar um SKU-turma como produto similar. No SGE, o vínculo de Compre Junto é entre cursos de áreas de interesse (produtos). Para cada área de interesse informada como anexo de Compre Junto, será necessário enviar pelo menos um SKU do curso da área de interesse, para possibilitar o vínculo. Todavia, o VTEX exibirá como sugestão de curso (produtos similares) o card dos cursos associados ao anexo Compre Junto (e não a turma desse curso).

Ao executar o processo, a customização deverá criar um complemento de SKU para envio dos produtos similares. A customização deverá identificar todas as turmas de cursos de áreas de interesse que possuem o anexo Compre Junto preenchido. Para todas as turmas, a customização enviará a informação de Compre Junto para o campo Similar (Produtos Similares) disponível no cadastro complemento de SKU .

A lista de produtos similares de cada SKU-Turma será montada pela customização, com base nas áreas de interesse informadas no anexo Compre Junto da área de interesse da Turma que está sendo exportada. O SKU do produto similar informado no anexo será enviado como complemento do SKU-Turma

Abaixo tela do SKU do produto similar.

image.png

Área de interesse original: TÉCNICO EM MECÂNICA

Turmas da Área de interesse:

  • TURMA A - SKU: TEC.MEC.A
  • TURMA B - SKU: TEC.MEC.B

Anexo Compre Junto: Área de interesse Cursos (Similares): TÉCNICO EM AUTOMAÇÃO INDUSTRIAL

  • TURMA 1 - SKU: TEC.AUT.01
  • TURMA 2 - SKU: TEC.AUT.02
  • TURMA 3 - SKU: TEC.AUT.03

Enviar no SKU das Turmas A e B, o SKU da turma 1 do curso TÉCNICO EM AUTOMAÇÃO INDUSTRIAL, para serem exibidas no VTEX. Para as Turmas A e B, será exibido card do curso Técnico de Automação Industrial como produto similar no VTEX.

*Necessário enviar apenas um SKU de turma da área de interesse similar.

A customização deverá tratar as seguintes situações:

 Envio de Produto similar (criação de complemento de SKU):

  • Ao cadastrar uma nova área de interesse no anexo Compre Junto.
  • Ao criar uma nova turma na área de interesse (original) que possua anexo Compre Junto preenchido, ela deverá ter a lista de produtos similares preenchida com os cursos das áreas de interesse vinculadas como sugestão de curso.

 Exclusão de Produto similar (exclusão de complemento de SKU):

  • Ao excluir uma área de interesse do anexo Compre Junto.
  • Ao desativar uma área de interesse do anexo Compre Junto (data final do processo seletivo for atingida).
  • O processo de exportação de SKU-Turmas deverá identificar as alterações citadas acima, para então enviar a atualização da lista de produtos similares para o VTEX.
Sempre que uma compra é realizada na VTEX e que a matrícula do aluno é efetivada no SGE, a quantidade vendida por produto é atualizada na VTEX. Essa atualização é a responsável pelo menu Mais vendidos disponível na loja, conforme imagem abaixo:

Dessa forma o Regional consegue acompanhar o número de comprar realizadas em cada produto e o usuário/aluno terá a visão dos Produtos mais vendidos da Loja.

Importante:

 A criação do campo Quantidade Vendida será a nível de produto (Curso) não de SKU (Turma).

A quantidade vendida não será atualizada para vendas realizadas Para Empresas (B2B).

A realização da importação de depoimento dos alunos referente à avaliação do produto/sku, inserida diretamente na plataforma VTEX, através de consulta de depoimentos na API do VTEX. Para avaliar o curso, o aluno deverá acessar a plataforma VTEX, na área destinada para essa finalidade. Após salvar o texto da avaliação, ela ficará disponível para que o SGE busque as informações através da API.

Portanto será criado no SGE um processo customizado, que poderá ser agendado ou executado manualmente, para buscar os dados das avaliações do VTEX, disponível no menu: TOTVS Educacional | Sistema Indústria | Integração VTEX | Importar Depoimento Aluno.

Incluir imagem atualizada

Ao executar o processo a customização irá buscar os depoimentos e avaliações dos cursos realizados na plataforma VTEX através de API, conforme detalhamento técnico. Os dados das avaliações obtidas serão armazenadas em tabela customizada para passarem por aprovação no SGE, antes de serem publicadas no VTEX.

 Os registros serão gravados na tabela de depoimentos da seguinte forma:

  • Informações da avaliação do VTEX- Nome do aluno; Classificação (nota);Título da avaliação; Texto da avaliação; Data que informou a avaliação Identificador da avaliação; Identificador do Produto; Identificador do SKU.
  • Código, Nome do Curso e Filial -Obtidos através do identificador do produto que veio na avaliação. Ver composição do campo para ver como achar o id.
  • Status-Valor inicial: Pendente Aprovação.

 No VTEX, a avaliação realizada pelo aluno precisa nascer com status pendente (necessita aprovação). A aprovação será realizada pelo processo customizado, que irá enviar para o VTEX a atualização do status da avaliação, tornando-a pública.

Ao final do processo de importação de depoimentos VTEX para o SGE, a customização irá disparar um e-mail de notificação para o usuário responsável pela curadoria/aprovação, sempre que um depoimento for importado. O e-mail tem a finalidade de avisar o responsável que ele precisa realizar a aprovação para publicação, ou reprovação do depoimento. O texto do e-mail será fixo e igual para todos os usuários.

Modelo mensagem do e-mail:

Prezado usuário(a), existem depoimentos de cursos pendentes de aprovação para publicação na plataforma VTEX.

Para avaliação do depoimento, acesse o menu: Sistema Indústria | Integração VTEX | Aprovação de Depoimentos VTEX.

Incluir imagem atualizada

 A interface customizada Depoimentos VTEX, estará disponível para que o usuário visualize a relação dos dados de depoimentos dos alunos respondidos através da plataforma VTEX  e ela estará  disponível em: TOTVS Educacional | Sistema Indústria | Integração VTEX, e nela serão exibas a lista dos alunos e depoimentos obtidos no processo de importação de depoimentos VTEX.

Os registros apresentados serão somente de alunos matriculados via plataforma VTEX que realizaram a avaliação do curso, para que os depoimentos sejam aprovados e publicados na página da VTEX, conforme processo de aprovação descrito abaixo.

Os campos do anexo estarão disponíveis para visualização do usuário as seguintes informações abaixo:

Identificador da Avaliação: preenchido com o ID da avaliação retornado no processo de importação de Depoimento VTEX.

Identificador do Produto: preenchido com o ID do produto retornado no processo de importação de Depoimento VTEX.

Cód. do curso: preenchido com o código do curso retornado no processo de importação de Depoimento VTEX.

Nome do Curso: preenchido com o nome do curso retornado no processo de importação de Depoimento VTEX.

Filial: preenchido com a filial retornada no processo de importação de Depoimento VTEX.

Identificador do SKU-Turma: preenchido com o SKU retornado no processo de importação de Depoimento VTEX.

Nome do aluno: preenchido com o nome do aluno retornado no processo de importação de Depoimento VTEX.

Data da inclusão do depoimento: preenchido com a data retornada no processo de importação de Depoimento VTEX.

Data da importação do registro: preenchido com a data retornada no processo de importação de Depoimento VTEX.

Título da Avaliação: preenchido com o texto retornado no processo de importação de Depoimento VTEX.

Texto da Avaliação do aluno: preenchido com o texto retornado no processo de importação de Depoimento VTEX.

Classificação (nota): preenchido com a nota retornada no processo de importação de Depoimento VTEX.

Status da Publicação: preenchido com o valor inicial pendente de aprovação.

Data da Aprovação/Reprovação: preenchida com a data corrente, da aprovação/reprovação do depoimento pelo SGE.

Usuário Aprovador: preenchido com o responsável, que realizou a aprovação do depoimento, pelo SGE.

Todos os campos da interface ficarão bloqueados para inclusão, edição, ou exclusão. Não será possível incluir novos registros através da interface.

O processo customizado para aprovação ou reprovação de depoimentos informados no VTEX, na interface de Depoimentos VTEX, para publicar o depoimento do aluno aprovado na
plataforma VTEX.

O processo será executado de forma manual pelo usuário, para acessar siga o seguinte caminho: TOTVS Educacional | Sistema Indústria | Integração VTEX|Depoimentos VTEX| Processos| Aprovação de Depoimentos VTEX

O usuário responsável pela aprovação deverá realizar a análise das avaliações recebidas e pendentes de aprovação, para publicar o depoimento do aluno na plataforma VTEX.

O processo deverá executar de forma manual, sendo listados todos os depoimentos dos alunos, podendo o usuario selecionar um ou vários depoimentos, realizar a aprovação e confirmar a execução do processo, para envio ao VTEX.

O usuário selecionará o(s) depoimento(s) que deseja publicar na plataforma VTEX;

Ao executar o processo de forma manual, serão listados todos os depoimentos de alunos ficando a cargo do usuário selecionar um ou vários depoimentos, realizar a aprovação e confirmar a execução do processo, para envio ao VTEX.

O processo manual não poderá ser agendado conforme recurso nativo de agendamento de job.

A seguir temos as regras que a customização seguirá quando o processo for executado:

  • Quando aprovada ou reprovada uma avaliação, o processo customizado irá preencher os campos usuário aprovador, data da aprovação e status (aprovado ou reprovado) na interface de Depoimentos VTEX.  As informações deverão ser enviadas para o VTEX através de API, para que o registro seja publicado, se aprovado, ou rejeitado, se reprovado. 
  •  Em caso de erro no envio das informações para o VTEX, os dados do depoimento no SGE não serão alterados e será exibida mensagem na interface.

  •  A pessoa responsável pela curadoria/aprovação deverá estar parametrizado no cadastro da Matriz Aplicada, Anexo comissão coordenadora dentro do TOTVS Educacional. Para demais usuários, não será permitida a aprovação ou reprovação do depoimento.

  • Além disso, será criado um tipo de participação na tabela ,por exemplo: Aprovadores de Depoimentos VTEX, específico para os usuários responsáveis pela curadoria/aprovação. Independente da função do usuário ele terá que ter o tipo específico vinculado ao seu cadastro. O tipo criado deverá ser parametrizado

  • Após aprovação ou reprovação, o ciclo da avaliação é encerrado no SGE. Porém, caso necessário, o usuário poderá alterar a avaliação do depoimento (aprovado ou reprovado), disparando assim a atualização do status de aprovação para o VTEX.

  • O processo permitirá a seleção de um ou vários registros, para aplicação da aprovação ou reprovação da publicação

  • Ao final do processo, será gerado log no monitor de log da Integração VTEX (atual). O processo permitirá a seleção de um ou vários registros, para aplicação da aprovação ou reprovação da publicação

O envio do depoimento do TOTVS Educacional para o VTEX depende da disponibilização da API por parte da VTEX.

As avaliações e depoimentos  aprovados no SGE serão exibas no  VTEX  conforme tela abaixo;

image.png