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.
| Expandir |
|---|
|
O fluxo abaixo segue a regra geral do integração. 
| Aviso |
|---|
O fluxo acima, pode divergir de customizações financeiras especificas do Regional. |
|
| Expandir |
|---|
|
| Expandir |
|---|
| title | Parâmetros da Integração |
|---|
| 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). 
Nesta aba o usuário deverá parametrizar o número máximo de tentativas de Reenvio para itens com erros. 
Nesta aba serão definidos o código da forma de pagamento que será utilizada no processamento de baixa. Esse cadastro é realizado por Filial. 
Nesta aba é possível parametrizar todos os dados necessários para o usuário definir um textão padrão do envio automático de e-mail (para o responsável do curso) , nos casos em que o número de vagas disponíveis para a oferta de curso tenha se esgotado e existam candidatos/inscritos com pendência de matrícula. 
| Aviso |
|---|
O SGE não garante o recebimento do e-mail, já que não é possível saber se o endereço do destinatário existe ou se a caixa está cheia, impedindo o recebimento. Será possível mapear apenas o envio. |
|
| Expandir |
|---|
| title | Cadastros: DE I PARA |
|---|
|
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:
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:
|
| Expandir |
|---|
| title | Processo - Alocação de Turmas |
|---|
| 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. | Aviso |
|---|
| 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. |
| Expandir |
|---|
| title | Anexo - Disponibilidade Semanal |
|---|
| 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. |
|
| Expandir |
|---|
| title | Parâmetros no Processo Seletivo |
|---|
| Ao criar um Processo Seletivo que utilizará integração Vtex é necessário informar os seguintes parâmetros: 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: 
| Aviso |
|---|
| Tanto para Processo Seletivos para pessoa física ou para pessoa Jurídica, 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: Nesta aba o usuário informa as URLs que correspondem a Imagem, vídeo e Degustação do Curso, que serão enviadas para a Plataforma VTEX. Atenção para a URL Imagem, que é de envio obrigatório nesta integração. 
Devemos também vincular as áreas ofertadas que irão utilizar os dados desse anexo, através do anexo Áreas Ofertadas 
Todos esses dados serão utilizados para criação do produto/sku na VTEX.
| Dica |
|---|
|
|
|
|
| Expandir |
|---|
| title | Parametrizações -Processos Seletivos exclusivos para Empresas (B2B) |
|---|
|
| Expandir |
|---|
| title | Parâmetros da Integração |
|---|
| Além das parametrizações citadas anteriormente neste documento, para Oferta para Empresas é necessário informar dados específicos para possibilitar a 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
Para realizar ofertas exclusivas para Empresas (B2B), é necessário informar os mesmos parâmetros das ofertas para Pessoa Física. Para isso foi incluído na parametrização, campos exclusivos para B2B, conforme imagem abaixo: 
- Aba: Dados Integração Geral
Nesta aba também devem ser informados os dados para as movimentações de Pedidos de Pessoa Jurídica (Pedidos B2B). 
Nesta aba é possível parametrizar todos os dados necessários para o usuário definir um textão padrão do envio de e-mail de confirmação de compra de cursos exclusivos B2B (para empresas). 
|
| Expandir |
|---|
| title | Parâmetros no Processo Seletivo |
|---|
| Para Processos Seletivos de cursos exclusivos para Empresas (B2B) é necessário informar que a Oferta é exclusiva B2B, conforme imagem abaixo: 
| Aviso |
|---|
Tanto para Processo Seletivos para pessoa física ou para pessoa Jurídica, para que o campo fiquei parametrizado é necessário marcar primeiramente o campo: Utiliza venda online de cursos. |
|
|
| Expandir |
|---|
|
Segue configurações necessárias para que Produto (Curso) e SKU (Turma) sejam criado na VTEX :
|
| Expandir |
|---|
| title | Processo Exportação de Dados 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 
|
| Expandir |
|---|
| title | Processo Exportação de Dados VTEX -Para Empresas (B2B) |
|---|
|
Após finalizados todas as parametrizações e cadastros específicos para Processos B2B, o usuário deverá executar o processo de exportação de dados padrão. Através desse processo que os Produtos e SKUs serão criados na VTEX no ambiente: PARA EMPRESA. 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. |
| Expandir |
|---|
| title | De I Para SGE x VTEX (visualização) |
|---|
|
Abaixo exemplos de visualização dos campos no SGE e na VTEX. 
- Modalidade (Categoria do Curso):
- Descrição Principal do Curso:
- Área (Subcategoria do Curso):
- Matriz Curricular: Presencial/ Semipresencial/ À Distância
- Matriz Curricular: Carga horária
- Matriz Curricular: Informações do Curso
- Turma e Turma Disciplina: Data inicial e final
- Turma e Turma Disciplina: Dias da Semana
- Turma e Turma Disciplina: Turno
- Turma e Turma Disciplina: Período de Matrícula
| Nota |
|---|
Caso o Período de matrícula no Portal, do cadastro da turma/disciplina estiver em branco, será enviado o Período de inscrição do Processo Seletivo. Conforme modelo abaixo. |
- Processo Seletivo: Período das Inscrições
- Plano de pagamento vinculado no Processo Seletivo:
- Processo Seletivo Anexo - Dados de Integração VTEX:
Valor do Curso 
Descrição Curso Google: 
Informações Adicionais / Empresas que indicam / Parceiros: 
URL da Imagem: 
URL do Vídeo: 
URL da Degustação do Curso: 
|
| Expandir |
|---|
| title | Compra - Plataforma VTEX |
|---|
|
Após finalizado a exportação de dados, quando os Produtos (Cursos) e SKUs (Turmas) já estiverem disponíveis na plataforma VTEX; o cliente/aluno poderá acessar a página para realizar sua compra. Abaixo um passo a passo do fluxo de compra / Matrícula da VTEX. Iniciado pela seleção do Produto (Curso): 
É necessário informar o estado ofertante do Curso e adicionar o produto ao carrinho de compras: 
| Informações |
|---|
| title | Informações Financeiras / Pagamentos |
|---|
| As informações sobre a realização da compra, geração e baixa de lançamento financeiro com base nas informações de venda e pagamento, estão detalhadas no Manual - Integração VTEX Informações financeiras. Para acessa-lo, clique aqui. |
Para cursos pagos, após a identificação dados pessoais do aluno/cliente e o pagamento realizado, será disponibilizado o acesso a Matrícula, conforme imagem abaixo: 
|
| Expandir |
|---|
| title | Consulta de pagamentos- SGE |
|---|
|
O processo de Consulta de Pagamentos VTEX, busca as informações de vendas de pedidos realizados pela loja, armazena os dados no Monitor de vendas (e cria o cadastro do Cliente/Fornecedor, com os dados do comprador do pedido. Um destaque para o campo Canal de venda, onde será informado se a oferta é B2B ou B2C:
A descrição de todo o Processo Financeiro está no Manual Integração VTEX - Informações Financeiras. |
| Expandir |
|---|
| title | Processo Envio de e-mail - Exclusivo para Empresas (B2B) |
|---|
|
Processo customizado para envio ou reenvio de e-mail de confirmação de compras de cursos exclusivos para empresa (B2B) para o cliente, com opção de informar outros e-mails alternativos como destinatário. O usuário deverá selecionar um item do Pedido VTEX para a execução do processo. O processo está disponível da tela do Monitor de vendas: TOTVS Educacional, menu Sistema Indústria | Integração VTEX | Monitor de Vendas | Processos | Envio de E-mail 
Ao acessar será exibida interface com uma caixa de texto, onde o usuário informará a lista de destinatários para os quais deseja enviar o e-mail de confirmação de compra. 
| Aviso |
|---|
O SGE não garante o recebimento do e-mail, já que não é possível saber se o endereço do destinatário existe ou se a caixa está cheia, impedindo o recebimento. Será possível mapear apenas o envio. |
|
| Expandir |
|---|
|
Ao clicar em realizar matrícula (descrito acima), o usuário é direcionado para a tela de cadastro do Processo Seletivo. As configurações e processamentos da inscrição/matrícula continuarão a ser executados através dos serviços nativos do produto educacional. Os dados de cadastro do Aluno, assim como opção do Curso já virão preenchidos da VTEX.
A página do Processo Seletivo foi customizada, sendo assim, ela seguirá os padrões de cores, fontes e estilos existentes atualmente na plataforma VTEX. Assim como acontece com o produto nativo, as inscrições/matriculas feitas pelo Processo Seletivo, são registradas no SGE. Além das informações referentes a matrícula, na tela de cadastro do Cursos/Habilitações, estarão disponíveis os dados referentes a Cupom, Percentual de Desconto e Valor final do curso.
Quando uma matrícula é realizada, a plataforma VTEX entende que esse Pedido foi entregue, alterando seu status, conforme imagem abaixo:
|
| Expandir |
|---|
| title | Matrícula para Pedidos de Empresas (B2B) |
|---|
|
O processo de matrícula do aluno para os cursos B2B será realizado pela secretaria da escola manualmente no SGE. De acordo com as definições do SENAI e VTEX, a opção de realizar matrícula pelo VTEX só fica disponível na área Para você (B2C), onde é o usuário final (aluno) que realiza a compra. No momento da matrícula no SGE, caso a secretaria identifique que as vagas da turma estão esgotadas, ficará a cargo da secretaria decidir pelo aumento de vagas ou criação de nova turma. Não está previsto processo customizado para controle de vagas ao realizar a matrícula. |
| Expandir |
|---|
|
A integração Kit de Cursos, permite a montagem de oferta que contempla mais de Curso. Para maiores informações, acesse o Manual especifico para o Kit de curso, disponível neste Link. |
