Histórico da Página

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 possibilita ao aluno 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., a visualização de produtos (Cursos) similares, lançamentos e os produtos mais vendidos.

Esse documento tem como base a integração SGE x VTEX, que visa garantir ao usuário uma experiência única e rápida de acesso (compra) aos produtos (cursos) do SENAI e parceiros.

Para isso, será apresentada uma visão prática da solução desenvolvida, explorando os conceitos utilizados e as funcionalidades do Sistema.O O material descreve as etapas da compra e inscrição/matricula, destacando a pagina customizada disponível no frame, algumas etapas referentes a visualização de produtos, compras realizadas e depoimentos dos alunos, 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

...

Expandir

title	Síntese

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 possibilita a curadoria de depoimentos de alunos para serem publicados na plataforma VTEX.

Tipo de Participação

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

Image Removed

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

Expandir

title	Parâmetros

Para você lembrar

Neste parâmetro o usuário deve informar:

A quantidade de dias em que um produto será considerado como lançamento;
E o tipo de participação, para identificar o usuário responsável pela aprovação de depoimentos.

Image Added

O período de lançamento

irá consultar

consulta a data inicial do calendário no Processo Seletivo, no período de inscrições

. Após esse período a marcação de lançamento será retirada deste produto.

Image AddedExemplificando

Expandir

title	Parâmetros - Integração VTEX

Será necessário informar Foi incluído na parametrização da integração VTEX, 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:

novas funcionalidades.

O usuário deverá acessar o menu de parâmetros da Integração VTEX, disponível em: TOTVS Educacional | Processo Seletivo| Sistema Indústria | Integração VTEX |Aba Parâmetros Gerais.

Image Removed

Informações

title

Data da inscrição do Processo SeletivoData da inscrição do Processo Seletivo	Período de lançamento (dias)	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.

Aviso

title	Aviso

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

Expandir

title	Tipo de Participação

Expandir

title	Alteração no processo de Exportação de Curso - Escopo VTEX

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

tipo de participação, considera o cadastro realizado na tela da Comissão Coordenadora, conforme detalhado abaixo:

Comissão Coordenadora - Aba Identificação:

Nesta aba o usuário define e/ou seleciona qual será a pessoa que será vinculada ao tipo de participação definido no parâmetro.

Image Added

Comissão Coordenadora - Aba Tipo de Participação:

Nesta aba, o usuário vincula a pessoa ao tipo de participação definido no parâmetro.

Image Added

Só será permitida aprovação de depoimentos, por usuários cadastrados na Comissão Coordenadora que estejam vinculados ao tipo de participação parametrizado.

Informações

title	Importante

Os dados informados nos parâmetros, serão exportados pelo Processo da integração VTEX: Exportar Dados

Image Added

Maiores informações sobre o processo de Exportação de dados no Manual - Integração VTEX.

Expandir

title	Processo de Atualização de Curso (lançamento)

Um produto (curso) será considerado como lançamento, de acordo com a data informada no parâmetro 'período de lançamento’, citado anteriormente.

Uma das funcionalidades do processo customizado de Exportar Dados - VTEX, é informar a plataforma 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.

Image Added

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 retirando o lançamento na plataforma VTEX.

O processo 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
Período de lançamento (dias): 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 será excluído da lista de lançamentos.

Expandir

title	Sugestões de Cursos (Produtos similares)

Para que a plataforma VTEX exiba sugestões de cursos na hora da compra, é necessário configurar o anexo 'Compre Junto', no cadastro de Área de interesse ofertada do Processo Seletivo.

Image Added

Ao clicar em incluir, é exibido a lista de áreas de interesse já vinculadas em Processo Seletivos VTEX, para inclusão no anexo

➔ Área de Interesse: O usuário selecionará a área de interesse ofertada que será associada.

Image Added

Informações
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. O anexo permite tanto a inclusão quanto a exclusão de um registro.

Image Added

Assim, após o vínculo das sugestões de áreas de interesse no anexo do SGE, essa lista de sugestões de cursos, será exibida na plataforma VTEX conforme imagem abaixo;

Image Added

Aviso
Quando acontecer uma atualização do anexo que afete turmas já exportadas, será necessário disparar a atualização dos produtos similares no VTEX, usando o processo de exportação detalhado no próximo item.

Expandir

title	Processo de Exportação de Produto Similares

Quando acontecer uma atualização neste anexo que afete turmas já exportadas, será necessário realizar a atualização dos produtos similares no VTEX.

Uma das funcionalidades do processo customizado de Exportar Dados - VTEX é enviar e atualizar na VTEX, os Produtos similares, que foram cadastrados no anexo Compre Junto (conforme já descrito neste manual). Este processo poderá ser executado manualmente ou agendado pelo usuário.

A sugestão de cursos de Compre Junto do VTEX é montada com base nos cursos das áreas de interesse vinculadas como Compre Junto no anexo customizado

Na loja os cursos similares serão exibidos conforme imagem abaixo;

Image Added

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

Image Added

Área de interesse original	Turma Original	SKU Turma Original	Turma Similar	SKU Turma Sugestão	Sugestão exibida para o usuário na VTEX como Compre junto
Técnico em Mecânica	Turma A	TEC.MEC.A	Turma 1*	TEC.AUTO.01	Técnico em automação industrial
Técnico em Mecânica	Turma B	TEC.MEC.B	Turma 1*	TEC.AUTO.01	Técnico em automação industrial

Nesse exemplo, para as Turmas A e B, será exibido card do curso Técnico de Automação Industrial como produto similar no VTEX.

O Processo tratar as seguintes situações:

Envio de Produto similar:

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:

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 as alterações citadas acima, para então enviar a atualização da lista de produtos similares para o VTEX.

Número de Compras Realizadas - Compra Fácil

Expandir

title	Número de Compras Realizadas

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:

Image Added

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.

Aviso

title	Aviso!

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).
Matriculas canceladas posteriormente, não refletem no número de vendas enviado.

Expandir

title	Processo de Atualização de Curso - Exclusão de Lançamento

Expandir

title	Anexo customizado Compre Junto -VTEX

Expandir

title	Processo de Exportação de Produto Similares - SKU-Turma

Expandir

title

Expandir

title	Importar Depoimento aluno do VTEX para o SGE

A realização da importação de depoimento de aluno 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.plataforma VTEX, permite que o aluno avalie um produto (curso), registrando um depoimento na loja. Para que Regional tenha acesso ao depoimento, o usuário responsável pode fazer a importação para o SGE.

Para isso é necessário executar o processo 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 AlunoDepoimentos.

Image Added

Ao executar o processo a customização busca todos os depoimentos registrados na plataforma VTEX e grava os dados no SGE, para que o mesmo passe por uma aprovação.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 das avaliações obtidas serão armazenadas em tabela customizada tela customizada (detalhada no Próximo item, 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 descrito no Req.09, 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.pelas aprovações, receberá uma notificação por e-mail informando que há depoimentos pendentes e que é necessário realizar a aprovação* para publicação ou a reprovação do depoimento.

Dica

title	Exemplo de mensagem do e-mail

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*Aprovação e/ou reprovação de depoimentos descritos no item final deste manual.

Expandir

title	Interface Depoimentos VTEX)-SGE

A lista dos depoimentos obtidos no processo de importação (item anterior) ficam registrados no SGE no menu A interface customizada Depoimentos VTEX, esta 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.| Depoimentos:

Image Added

Image AddedImage Removed

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

Image AddedImage Removed

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.

➔ Identificador do Depoimento: preenchido com o ID do depoimento 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.

Informações

Aviso

title	Aviso!

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..
Os campos Usuário aprovador, Data de Aprovação/Reprovação e Status da publicação, São preenchidos após a execução do processo de Aprovação/Reprovação de Depoimento.

No próximo item veremos o processo de aprovação de depoimentos.

Expandir

title	Processo customizado - Aprovação/Reprovação de Depoimento VTEX

Sempre que um aluno realizar uma avaliação na plataforma, ela é importada ao SGE e ficará com o status pendente aprovação.

O usuário responsável pelas aprovações, recebe uma notificação por e-mail informando que há depoimentos pendentes.

Para realizar a 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.

um depoimento, o usuário deverá o Menu de Depoimentos e selecionar os registros que serão Aprovados ou Reprovados.

Image AddedImage Removed

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;

Image Removed

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.

Image Removed

Aviso

title	Atenção

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 a analise dos depoimentos, o usuário poderá acessar um ou mais registros e acessar o processo Aprovação de depoimentos VTEX, conforme imagem abaixo:

Image Added

A tela seguinte compreende os parâmetros necessários para definir se os depoimentos selecionados serão aprovados ou reprovados.

Selecione o status de Aprovado para Publicação ou Reprovado, conforme a análise do registro realizada.

Image Added

Ao final do processo, será gerado log no monitor de log da Integração VTEX.

Aviso

title	Importante

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

o status 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 responsável pela curadoria/aprovação deverá estar parametrizado no cadastro da Matriz Aplicada, Anexo comissão coordenadora dentro do TOTVS Educacional, com o tipo da participação informado (conforme descrito no item parâmetros) . Para demais usuários, não será permitida a aprovação ou reprovação do depoimento.

Somente após a aprovação que o depoimento fica de forma pública na Loja e são exibidas

Aviso

title	Importante

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;

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 11

Nova versão Atual

Chave