...
Nome do Cliente: Confederação Nacional da Indústria - SENAIObjetivo
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
...
| Expandir |
|---|
|
O objetivo deste projeto é realizar a integração dos Cursos e Turmas disponíveis no TOTVS Educacional SGE para realização de compras na plataforma VTEX. |
...
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.
...
Após a compra, será retornado pelo VTEX através de URL, os dados inseridos na compra para que a inscrição/matrícula do candidato seja incluída no TOTVS Educacional (SGE). Para garantir uma experiência única para o usuário, a página nativa de inscrição do Processo Seletivo foi ajustada, para que o layout apresentado esteja com as cores e design do SENAI. A página permanece com os serviços nativos e exibirá ao candidato todos os campos parametrizados no Processo Seletivo.
Após a inscrição/ Matrícula, a customização retornará ao VTEX, através de chamada de API, o status de matrícula do aluno para que seja apresentado na área do cliente após a compra.
Todas as regras para realização da matrícula existentes no escopo FS008228 (A50.301) – Integração MarketPlace não serão alteradas.
A integração acontece para vendas B2C e B2B: B2C: Do termo em inglês “Business to Consumer”, que significa “negócios para consumidores”. Aqui, as vendas são direcionadas para pessoas físicas. B2B: Do termo em inglês “Business to Business”, que significa “negócios para negócios”. Aqui, as vendas são direcionadas para pessoas Jurídicas é o tipo de empresa que vende para outras empresas.
O escopo conta com o complemento de projetos adicionais que podem ser acessados nos manuais abaixo:
|
| Expandir |
|---|
|
O fluxo abaixo segue a regra geral do integração.  Image Added
| Aviso |
|---|
O fluxo acima pode divergir devido as customizações financeiras específicas de cada regional. |
|
| Expandir |
|---|
|
| Expandir |
|---|
| title | Parâmetros da Integração |
|---|
| Será necessário informar alguns dados 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.  Image Added
- Aba: Dados Integração - Produto/SKU
Nesta aba são parametrizados os dados de conta específicos para o processo de exportação de Produto/SKU na VTEX (Cursos e Turmas). Esses dados são únicos e valem para todos os regionais.  Image Added
- Aba: Dados Integração Geral
Nesta aba são parametrizados os dados de conta específicos de cada regional para realizar as demais funcionalidades na VTEX, como por exemplo: Consulta de Pedidos, Preço, Estoque etc..  Image Added
Nesta aba o usuário deverá parametrizar o número máximo de tentativas de reenvio para itens com erros no monitor de log.  Image Added
Nesta aba serão definidos o código da forma de pagamento que será utilizada no processamento de baixa automática (FS008537 - Integração VTEX - Informações Financeiras). Esse cadastro é realizado por Filial.  Image Added
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 ((FS008537 - Integração VTEX - Informações Financeiras).  Image Added
| 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.
Maiores informações sobre essa aba no Manual Integração VTEX - Informações Financeiras. |
|
| 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.  Image Added
- Aba: Dados Integração - Produto/SKU
Nesta aba são parametrizados os dados de conta específicos para o processo de exportação de Produto/SKU na VTEX (Cursos e Turmas). Esses dados são únicos e valem para todos os regionais.  Image Added
- Aba: Dados Integração Geral
Nesta aba são parametrizados os dados de conta específicos de cada regional para realizar as demais funcionalidades na VTEX, como por exemplo: Consulta de Pedidos, Preço, Estoque etc..  Image Added
|
|
|
...
O objetivo deste projeto é realizar a integração dos Cursos e Turmas disponíveis no TOTVS Educacional SGE para realização de compras na plataforma VTEX.
Após a compra, será retornado pelo VTEX através de URL, os dados inseridos na compra para que a inscrição/matrícula do candidato seja incluída no TOTVS Educacional (SGE). Para garantir uma experiência única para o usuário, a página nativa de inscrição do Processo Seletivo foi ajustada, para que o layout apresentado esteja com as cores e design do SENAI. A página permanece com os serviços nativos e exibirá ao candidato todos os campos parametrizados no Processo Seletivo.
Após a inscrição/ Matrícula, a customização retornará ao VTEX, através de chamada de API, o status de matrícula do aluno para que seja apresentado na área do cliente após a compra.
Todas as regras para realização da matrícula existentes no escopo FS008228 (A50.301) – Integração MarketPlace não serão alteradas.
A integração acontece para vendas B2C e B2B:
B2C: Do termo em inglês “Business to Consumer”, que significa “negócios para consumidores”. Aqui, as vendas são direcionadas para pessoas físicas.
B2B: Do termo em inglês “Business to Business”, que significa “negócios para negócios”. Aqui, as vendas são direcionadas para pessoas Jurídicas é o tipo de empresa que vende para outras empresas.
O escopo conta com o complemento de projetos adicionais que podem ser acessados nos manuais abaixo:
| Expandir |
|---|
|
O fluxo abaixo segue a regra geral do integração. Image Removed | Aviso |
|---|
O fluxo acima, pode divergir de customizações financeiras especificas de cada regional. |
|
| Expandir |
|---|
|
| Expandir |
|---|
| title | Parâmetros da Integração |
|---|
| Será necessário informar alguns dados 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. Image Removed - 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. Image Removed Esses dados valem para todos os regionais, por se tratar da utilização da loja VTEX Nacional para venda de cursos, sendo B2C e/ou B2B. - 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).  Image Removed
Nesta aba o usuário deverá parametrizar o número máximo de tentativas de Reenvio para itens com erros. Image Removed Nesta aba serão definidos o código da forma de pagamento que será utilizada no processamento de baixa. Esse cadastro é realizado por Filial. Image Removed Aba: E-mailNesta 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.de e-mail de confirmação de compra de cursos exclusivos B2B (para empresas).  Image Added
|
| 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. Lembrando que, esse parâmetro define que os cursos serão exportados apenas para a loja B2B. Processos seletivos que não estejam com o parâmetro marcado, são enviados de forma padrão para as duas lojas: B2B e B2C.  Image Added
| 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 e Oferta VTEX |
|
Image Removed | 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:no SGE, conforme demonstração abaixo:  Image Added
| Aviso |
|---|
O SENAI DN contratou um script padrão para cadastro de algumas modalidades e áreas. Ao instalar a customização, essa tela será preenchida com alguns registros templates. O regional poderá editar e/ou inserir novos registros. |
Image Removed 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:  Image Modified
|
| 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 semana que serão consideramos na alocação de turmas (dias da semana nos quais terão aulas), conforme imagem abaixo:  Image Removed
. As informações do Processo processo serão gravadas no anexo Disponibilidade semanalSemanal, descrito abaixo. Image Added
| 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 processo citado acima). Encontra-se disponível na tela nativa de Turmas: TOTVS Educacional | Currículo e Oferta | Turmas | Anexo | Disponibilidade Semanal. As informações são armazenadas por Coligada, Filial e Nível de Ensino. 
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 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.exclusivamente pelo processo. |
|
| Expandir |
|---|
| title | Parâmetros no do 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:  Image Modified
| 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. |
- Criação das Áreas de Interesse Ofertadas
Após a criação do Processo Seletivo será necessário vincular as Áreas de Interesse Ofertadas. Esses registros serão exportados e darão origem aos cursos que o usuário poderá comprar no VTEX. - 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.  Image Modified
 Image Modified
As turmas 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ículaserão as opções de compras dentro dos cursos na plataforma.
- 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.
 Image Modified
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.  Image Modified
Dados Adicionais: Nesta aba o usuário poderá incluir informações adicionais, as Empresas que indicam e os Parceiros.  Image Modified
Mídias Digitais: Nesta aba o usuário informa as URLs que correspondem a Imagemimagem, 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. Image Removed
Devemos também vincular as áreas ofertadas que irão utilizar os dados desse anexo, através do anexo Áreas Ofertadas  Image Removed
Todos esses dados serão utilizados para criação do produto/sku na VTEX. | Dica |
|---|
| |  Image Removed
|
| Expandir |
|---|
| title | Parametrizações -Processos Seletivos exclusivos para Empresas (B2B) |
|---|
|
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 e deverá estar pública. Image Added - Anexo Dados Integração VTEX - Áreas Ofertadas
Devemos também vincular as áreas ofertadas que irão utilizar os dados desse anexo, através do anexo Áreas Ofertadas. Será exibido no filtro para seleção, todas as áreas de interesse cadastradas no processo seletivo utilizado. O anexo e os dados parametrizados serão exibidos para todas as filiais existentes na coligada, independentemente se o parâmetro nativo ‘Visível para todas as filiais’ estiver marcado. A mesma área de interesse poderá ser vinculada apenas uma vez por PS. Caso o processo seletivo seja parametrizado para utilizar em várias filiais, o registro do anexo será compartilhado entre as filiais, visto que, esses dados refletem em um card e produto único na VTEX. Image Added  Image Added
Será possível inserir uma área ofertada para apenas UM registro de dados integração VTEX, caso o usuário tente inserir a mesma área de interesse para mais de um registro, será exibido a mensagem abaixo impedindo salvar o registro.  Image Added
Ao salvar o processo seletivo será validado se existe alguma área de interesse vinculada ao Processo Seletivo que não esteja relacionada a um registro de dados integração VTEX. Caso seja identificado, será exibido a mensagem de alerta ao usuário.  Image Added
- Anexo Dados Integração VTEX - Tipo de Financiamento
Deverá ser vinculado também os dados do Tipo de Financiamento que será utilizado. Será exibido no filtro para seleção a lista da tabela dinâmica (TIPOGRAT) já existente, disponibilizada e utilizada no template do SGE.  Image Added
| Dica |
|---|
|
Image Added |
|
| 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. Image Removed - 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: Image Removed - 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). Image Removed 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). Image Removed |
| 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: Image Removed | 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 :
|
...
