Projeto: FS008599 - Integração TOTVS Educacional x  VTEX

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 dos cursos e turmas disponíveis 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 Iframe, 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 da funcionalidade Customizada. 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.



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 estará disponível em: TOTVS Educacional | Sistema Industria | Integração VTEX |Parâmetros.


  • Aba: Dados Integração - Produto/SKU

Nesta aba são parametrizados os dados específicos para exportação e criação do Produto/SKU na VTEX. 

Esses dados valem para todos os Regionais, por se tratar da utilização da loja VTEX Nacional para venda de cursos.


  • Aba: Dados Integração Geral

Nesta aba são parametrizados os dados para realizar as demais movimentações na VTEX e será especifico para cada Regional.

Nesta aba também devem ser informados os dados para as movimentações de Pedidos de Pessoa Jurídica (Pedidos B2B).


  • Aba: Parâmetros Gerais

Nesta aba o usuário deverá parametrizar o número máximo de tentativas de Reenvio para itens com erros.


  • Aba: Dados Financeiros


  • Aba: Email


  • Aba: Email B2B



Foi criada uma interface para possibilitar que o usuário realize as correlações (DE I PARA) entre o TOTVS Educacional e VTEX.

A interface está disponível no Menu: TOTVS Educacional | Sistema Industria | Integração VTEX | De I Para Integração VTEX

No Menu terá três abas, para  que o usuário realize a correlação de cada uma, sendo elas: Modalidade, Área e Filial.

Dentro de cada aba terá o processo para registro do DE I PARA:


  • DE I PARA Modalidade e Área

Ao executar o processo na tela de cadastro do De I Para, o usuário deverá selecionar, na grid do lado esquerdo, a Modalidade ou Área do VTEX que será parametrizada. E do lado direito, as modalidades e áreas correspondentes do SGE, conforme demonstração abaixo:



  • DE I PARA Filial

Ao executar o processo na tela de cadastro do De I Para, o usuário deverá selecionar, na grid a esquerda, a Unidade do VTEX que será parametrizada, e na grid da direita, a Filial do SGE, conforme demonstração abaixo:



Foi criado na interface de Turmas, um processo que possibilita o usuário parametrizar quais dias da semana as turmas no SGE terão aulas na sua programação.

O Processo Customizado, está disponível em: TOTVS Educacional | Currículo e Oferta | Turmas | Processo para alocação de Turmas. 

O processo poderá ser executado para uma ou mais Turmas em cada execução.



Ao executar o processo, o usuário deverá selecionar os dias da Semana que serão consideramos na alocação de turmas (dias da semana nos quais terão aulas), conforme imagem abaixo:


As informações do Processo serão gravadas no anexo Disponibilidade semanal, descrito abaixo.

Se o processo for executado para dias da semana onde já existam registros inseridos no anexo por  por uma execução anterior, os registros anteriores serão preservados e não sofrerão quaisquer alterações. Somente serão inseridos dias da semana que ainda não estejam disponíveis no anexo.

O anexo Disponibilidade Semanal, permite ao usuário a visualização da relação de dias da semana para aulas de determinada turma (definida no Processo citado acima). 

Encontra-se disponível na tela nativa de Turmas: TOTVS Educacional | Currículo e Oferta | Turmas | Anexo | Disponibilidade Semanal.

A visualização na tela do anexo será do texto completo na descrição do dia da semana, sem abreviações. Os dias disponíveis serão exibidos em linhas separadas conforme exemplo abaixo:

O Anexo está disponível apenas para visualização e exclusão, as inclusões serão feitas exclusivamente pelo Processo.

As informações são armazenadas por Coligada, Filial e Nível de Ensino.

Ao criar um Processo Seletivo que utilizará integração Vtex é necessário informar os seguintes parâmetros:

  • Utiliza Oferta Vtex

Marcar a flag indicando que o processo seletivo utilizará integração com o Vtex. O campo está disponível na aba Identificação do Processo Seletivo:

Para que o campo fiquei parametrizado é necessário marcar primeiramente o campo: Utiliza venda online de cursos.


  • Turmas da Área de Interesse

Após a criação do Processo Seletivo e da Área Ofertada, será necessário preencher o anexo Turmas da Área de Interesse.

As turmas cadastradas nessa tela serão exportadas como um SKU para a VTEX, ou seja, será o curso que o usuário poderá comprar e realizar a matrícula.


  • Anexo Dados Integração VTEX

Em seguida, deverá ser parametrizado o anexo  Dados Integração VTEX, que está disponível na tela do cadastro do Processo Seletivo.


A tela de cadastro dos Dados VTEX, contém 3 abas:

Dados do curso: onde deve ser informado o valor do Curso e a Descrição Curso Google.


Dados Adicionais: Nesta aba o usuário poderá incluir informações adicionais, as Empresas que indicam e os Parceiros.

Mídias Digitais: 

Esses dados serão utilizados para criação do produto/sku na VTEX.
Devemos também vincular as áreas ofertadas que irão utilizar os dados desse anexo, através do anexo Áreas Ofertadas