Páginas filhas
  • Manual Operacional da Customização - Integração VTEX Kit de Cursos SENAI

Projeto: FS008629 (AAEBUS) - Integração SGE com VTEX - Parte 2

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



O objetivo deste projeto é realizar a criação de funcionalidades que possibilitem a integração de várias ofertas de cursos disponíveis no TOTVS Educacional SGE,  para realização de compras na plataforma VTEX em forma de Kit de Curso. 

A Integração Kit de cursos para VTEX, permite  uma  montagem de oferta de mais de um curso e a integração com a plataforma VTEX.

Liberação dos anexos customizados na árvore de perfil:
Os anexos da customização - Integração VTEX devem ser liberados nas permissões de perfil dos usuários para aparecerem nos seus respectivos lugares. Para mais detalhes de como liberar no perfil dos usuários acesse o Manual de Instalação de Customizações na seção: Liberando Acesso aos Menus.


O Kit de Cursos possibilita a estruturação de oferta com mais de um curso (produto), para que sejam disponibilizados à venda a partir da Integração TOTVS Educacional (SGE) e a plataforma VTEX.
O acesso para cadastro de um Kit de Cursos está disponível em: TOTVS Educacional | Sistema Indústria | Integração VTEX l Kit de Cursos.



Este processo deve ser executado manualmente, para que sejam relacionados os cursos que irão compor os kits de cursos a serem integrados à plataforma VTEX.
Na tela inicial, deverão ser configurados os dados do kit e dados do curso, conforme:

Dados do Kit

  • Kit: Deverá ser informado o nome do kit de curso;
  • Processo Seletivo: Neste campo serão listados os processos seletivos ativos que utilizam a Integração VTEX e que possuem áreas de interesse ativas e vinculadas aos mesmos, para que seja vinculado o processo seletivo correspondente às ofertas de curso que irão compor o kit de curso que está sendo criado.
  • Dados do Curso
  • Área de interesse: Irá exibir as áreas de interesse vinculadas ao processo selecionado anteriormente, agrupadas pela matriz curricular*  e que já foram exportadas para o VTEX.


Após registrar os campos kit e processo seletivo, ao clicar em: Adicionar será exibido na tela a configuração do kit de curso conforme a opção selecionada pelo usuário.
Nesta tela também estará disponível a opção: Limpar, que permite a exclusão da configuração criada para o kit de curso da tela de processo.



Atenção:

Caso a área de interesse tenha mais de uma Turma vinculada, será exibida a listagem das Turmas. No entanto, será permitida apenas a inclusão de uma única Turma por kit.

Após configurar o kit de curso, através dos ícones: , o usuário poderá adicionar o kit de curso configurado para execução do processo, como também excluir um kit de curso configurado, quando desejar que o mesmo não seja incluído no processo a ser executado.

Validadas as informações, ao clicar em: Avançar, o usuário será redirecionado à etapa seguinte do processo para que sejam configuradas as informações complementares/específicas do kit de cursos que está sendo criado.



Na etapa seguinte do processo, devem ser configuradas as informações complementares/específicas relacionadas ao kit de curso, tais como:

Aba Dados Gerais:

  • Descrição do Kit: Neste campo deverá ser registra a descrição do kit de curso que está sendo criado;
  • Descrição do Curso Google: Neste campo deverá ser registra a descrição que aparecerá para o usuário quando fizer uma pesquisa do curso no Google;

Aba Mídias Digitais:

  • Vídeo: Neste campo, se desejado pelo usuário, poderá ser vinculada a URL (já publicada) referente ao link do vídeo relacionado ao kit de curso/área de interesse, conforme o exemplo de URL aplicado ao campo;
  • Imagem: Neste campo, deve ser obrigatoriamente vinculada a URL (já publicada) referente ao link da imagem relacionada ao kit de curso/área de interesse, conforme o exemplo de URL aplicado ao campo;

Aba Financeiro:

  • % Desconto do Kit: Neste campo deverá ser registrado (em números) o percentual de desconto que será aplicado no valor total do kit de curso (quando houver).


Vinculadas as informações complementares/específicas do kit de curso, ao clicar em: Avançar, o usuário será redirecionado à etapa seguinte do processo para visualização da estrutura criada para o kit de curso, conforme os vínculos/registros associados nas etapas anteriores.

Será possível Expandir, Recolher e Remover os registros apresentados.



Ao clicar em: Executar, será processada a criação do kit de curso e os dados serão gravados no 'Anexo - Kit de Cursos' descrito abaixo.


A visualização da vinculação de um processo seletivo a um kit de curso, estará disponível em: TOTVS Educacional Processo Seletivo l Cadastro l  Processo Seletivo l Anexos: Kit de Curso.
Assim, a partir da seleção de um cadastro de processo seletivo, ao selecionar: Anexos → Kit de Curso, será apresentada a listagem do(s) kit(s) de curso(s) associado(s) ao mesmo.



Os registros serão apresentados com as seguintes informações:

  • Kit/Produto: ID do Kit no VTEX;
  • Descrição do Kit: Texto, onde será informado a descrição do Kit;
  • Processo Seletivo: Nome do Processo Seletivo;
  • Data e hora: Data e hora de inclusão do registro;
  • Usuário: Usuário que executou o processo.



Ao clicar sobre um registro, o usuário terá acesso às demais informações associadas ao kit de curso, sendo elas:

  • Kit/Produto: ID e descrição do Kit no VTEX;
  • Processo Seletivo: ID e descrição do Processo Seletivo;
  • Valor do Desconto: Desconto aplicado;
  • Descrição do Kit: Texto, onde será informado a descrição do Kit;
  • Descrição do Curso Google: Texto que parecerá para o usuário quando fizer uma pesquisa do curso no Google;
  • URL do Vídeo: A URL do vídeo que ficará vinculada ao Kit;
  • URL da Imagem: A URL da imagem ficará vinculada ao Kit;
  • Data e hora: Data e hora de inclusão do registro;
  • Usuário: Usuário que executou o processo;
  • Operação: Campo que registrará se o registro foi incluído ou alterado;
  • Ativo: Representa de o Kit está ativo. Esse campo será desabilitado apenas pelo processo 'Processo para Inativação de Kit de Cursos'.


Importante:

Apenas os campos Descrição do Kit, URL do Vídeo e URL da imagem estarão disponíveis para edição. Caso sejam alterados, a alteração será replicada para todos os registros que sejam do mesmo Kit e Processo Seletivo. 


Ao abrir o registro, estará disponível o Anexo: Cursos, que lista todos os cursos (áreas de interesse) vinculadas ao kit de cursos e demais informações, sendo:

  • ID Kit: ID do Kit no VTEX;
  • Cursos: Nome da Área de interesse vinculada ao processo;
  • Processo Seletivo: ID do Processo Seletivo.

Ao abrir o registro de áreas de interesse, estará disponível o Anexo: Turmas, que lista todas as turmas vinculadas aos cursos (áreas de interesse) do kit de cursos e demais informações, sendo:

  • ID Kit: ID do Kit no VTEX;
  • Processo Seletivo: ID do Processo Seletivo;
  • Turmas: Código da Turma vinculada a área de interesse.


A inativação de kit de cursos já exportados à plataforma VTEX se aplica a todos os cursos que compõem o mesmo, desde que não tenham matrículas e/ou pagamentos realizados ou pendentes.

O processo para inativação está disponível em: TOTVS Educacional l Processo Seletivo l Cadastro l Processo Seletivo l Anexos: Kit de Cursos l Kit de Cursos l Processos: Inativação do Kit de Cursos.



Após selecionar o processo seletivo, em: Anexos: Kit de Cursos, selecione o(s) kit(s) de curso(s) que se deseja realizar a inativação. Em seguida, selecione: Processos: Inativação de Kit de Cursos. Na etapa seguinte, será apresentada a tela para registro do motivo pelo qual o processo de inativação de kit de cursos será executado, acompanhado da mensagem padrão de informação: "Ao executar o processo de Inativação, o Kit selecionado e os demais produtos vinculados a ele serão desativados para exibição no ambiente VTEX, sem possibilidade de reativação. Deseja executar o processo? ".
Para execução, após vincular o motivo, clique em: Executar.



Importante:

O processo de inativação de kit de curso se aplica a todos produtos/cursos vinculados ao mesmo.
Realizado o processo de inativação do kit de cursos, o kit de curso não poderá ser reativado. Assim, caso o usuário desejar realizar novamente a inclusão do kit de cursos, deverá ser executado o processo: Integração VTEX - Kit de Cursos, demonstrado neste manual.

A matrícula do aluno nos cursos que compõem o kit de cursos será disponibilizada por produto/curso, e, desta forma, realizada separadamente.

Para cada curso relacionado ao kit de curso, será associado um botão de matrícula que, uma vez selecionado, direciona  o aluno à tela seguinte para registro das informações necessárias à matrícula.

Após finalizar a matrícula, o botão de matrícula será desativado.

Importante: Não haverá mudança no fluxo padrão de matrícula para o Kit de Cursos. Todo processo ocorre conforme descrito no Manual Operacional da Customização - Integração VTEX TOTVS Educacional (SGE).



Além disso, ao Curso/Habilitação do aluno, será automaticamente preenchida a flag: Kit de cursos, disponível em: TOTVS Educacional | Alunos | Curso/Habilitação. Este campo não será passível de edição/alteração e será preenchido apenas pela customização.


Importante:

Será adicionado pela VTEX na URL de matrícula, o campo ‘iskit’. Neste campo, a VTEX irá identificar se aquela matrícula pertence a um KIT e enviar a informação para a integração. 
Para Matrículas oriundas de um KIT, será enviada a informação iskit=true;
Para Matrículas oriundas de um SKU sem KIT, será enviada a informação iskit=false.

A aplicação de desconto ao kit de cursos é realizada sobre o valor total da somatória de todos os valores/parcelas dos cursos que compõem o kit de cursos.

Será enviado ao VTEX como preço, a soma do valor das parcelas dos planos de pagamentos vinculados a cada área de interesse existente no Kit, menos o valor do desconto informado no campo ‘Desconto' do cadastro de Kit.

A visualização da aplicação de desconto ao kit de cursos (quando concedido), estará disponível em: TOTVS Educacional | Sistema Indústria | Integração VTEX l Monitor de Vendas.

Importante:

Para atender a regra aplicada no Desconto do Kit:

  • Será responsabilidade da VTEX identificar o preço original do SKU de cada item do pedido + o % de desconto aplicado no kit e enviar os valores separadamente na URL nos campos já previstos inicialmente no projeto, sendo eles: ‘Valor Total do Curso’ e ‘Percentual de Desconto’. 
  • Será responsabilidade da VTEX identificar se o pedido possui mais de um desconto aplicado, realizar a somatória dos percentuais e enviar nos campos descritos acima.