Histórico da Página

...

Expandir

title	Parâmetros

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.

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.

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

Aba: Parâmetros Gerais

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

Aba: Dados Financeiros

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.

Informações
Maiores informações sobre essa aba no Manual Integração VTEX - Informações Financeiras.

Aba: E-mail

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

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.

Aba: E-mail B2B

Descrição dessa aba, no tópico - Processo Envio de E-mail - Exclusivo para Empresas (B2B)

Aba: Situação de matrícula

Nesta aba são definidos o 'status indica' de cada situação de matrícula, para controle de vagas.

Image Added

Ao incluir uma situação de matrícula, o usuário deverá acessar o botão NOVO.

Será apresentada uma tela de seleção, com um lookup que lista todas as situações de matrícula do contexto selecionado, através da tabela SSTATUS.

Image Added

Campo ‘Status Indica’:

- ‘Vaga ocupada’: Indica as situações de matrícula registradas com esse status, serão subtraídas do número de vagas disponíveis.
- ‘Vaga disponível’: Indica as situações de matrícula registradas com esse status, serão consideradas na no somatório de vagas disponíveis.

É possível selecionar um status de por vez, mas poderão ser registrados vários status de matrícula neste cadastro.

Maiores informações sobre controle de vagas, no tópico - Controle de vagas.

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

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.

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

Aba: E-mail 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.

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.

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.

Aviso

title	Validação manual de documentos

A validação manual de entrega dos arquivos de documentos obrigatórios do candidato não pode ser utilizado em um Processo Seletivo VTEX, já que a matrícula é realizada de forma automática.

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 no SGE, conforme demonstração abaixo:

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.

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:

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

title	Atenção

Se o processo for executado para dias da semana onde já existam registros inseridos no anexo 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. 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 está disponível apenas para visualização e exclusão, as inclusões serão feitas exclusivamente pelo processo.

Expandir

title	Parâmetros do Processo Seletivo

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:

Aviso

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

As Turmas cadastradas nessa tela serão exportadas como um SKU para a VTEX, ou seja, serã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.

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

Dados do curso: onde deve ser informado quantidade e valor das parcelas e também e a Descrição Curso Google.

Aviso
O campo ‘ Valor do curso’, que era apresentado nesta aba, foi excluído do anexo e não será considerado no envio para VTEX (independente da modalidade)., a partir do Projeto FS008892 - Integração VTEX - Condição Comercial/ Pagamentos - Parte 2.

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 e deverá estar pública.

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.

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.

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.

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.

Dica

title	Passo a Passo

...

Expandir

title	De I Para SGE x VTEX (visualização)

Abaixo exemplos de visualização dos campos no SGE e na VTEX.

Nome do Curso:

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: Número máximo de alunos (estoque VTEX)

O estoque de um curso (apresentado na VTEX ) é definido no SGE pelo campo Número máximo de alunos, no cadastro da turma.

Image Added

Nota

title	Atenção

Quando o numero de máximo de alunos, informado no campo é atingido e haja a necessidade de liberar mais estoque na VTEX; é necessário aumentar o valor informado no campo. Matrículas excluídas não liberam vagas no estoque.
O Regional é responsável por manter o número máxima de alunos na turma, igual ao número de vagas no cadastro da

turma.

área de interesse. Não é realizada a sincronização automática desses campos. (Atenção: o número de vagas enviadas para VTEX, é o correspondente ao número máximo de alunos na turma).
Para maiores informações sobre a gestão de vagas consultar o Tópico: "controle de vagas" deste manual

Image Removed

Nota

title	Atenção

Quando o numero de máximo de alunos, informado no campo é atingido e haja a necessidade de liberar mais estoque na VTEX; é necessário aumentar o valor informado no campo. Matrículas excluídas não liberam vagas no estoque

.

Turma e Turma Disciplina: Data Inicial e Final

Turma e Turma Disciplina: Dias da Semana

Para cursos que sejam identificados como 100% EAD, este campo será preenchido com o texto 'EAD'.

Turma e Turma Disciplina: Turno

É considerado sempre a Turma Disciplina de menor IDTURMADISC.

Para cursos que sejam identificados como 100% EAD, este campo será preenchido com o texto 'EAD'.

Turma e Turma Disciplina: Período de Matrícula

É considerado sempre a Turma Disciplina de menor IDTURMADISC.

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:

- A regra de parcelamento é configurado diretamente na loja VTEX e será responsabilidade de cada regional.

Plano de pagamento vinculado no Processo Seletivo:

- Para cursos gratuitos deverão ser vinculados planos de pagamentos sem parcelas. A customização irá validar se o plano não possui parcelas e o curso será considerado gratuito, com isso, será enviado o preço de R$0,01 ao VTEX.

- Para processos seletivos VTEX, será permitido o vínculo de planos de pagamento que possuam mais de uma parcela, apenas para cursos que a modalidade seja:

Categoria VTEX	Modalidade SGE
Cursos Técnicos	31 - Técnico de Nível Médio
Cursos Técnicos	32 - Técnico de Nível Médio - Itinerário V Ensino Médio
Pós Graduação e MBA	91 - Pós Graduação ‘Lato - Sensu’ - Especialização
	92 - Pós Graduação ‘Stricto - Sensu’ - Mestrado
	93 - Mestrado

- Para processos seletivos que os cursos estejam vinculados as demais modalidades, o plano de pagamento só poderá ter uma parcela.

Caso o usuário tente inserir um plano de pagamento com mais de uma parcela para os cursos que não sejam das modalidades de Cursos Técnicos, Pós Graduação e MBA, será exibido uma mensagem na tela ao salvar o registro de área de interesse.

Informações

title	Cursos - Modalidade Graduação

Para cursos de Graduação, será enviado o preço de R$0,02 ao VTEX. Conforme regra definida pelo DN, a cobrança dos cursos de Graduação, não será realizada na VTEX.

Processo Seletivo Anexo - Dados de Integração VTEX:

Quantidade e valor das parcelas 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:

Cadastro da Filial

Texto Fixo:

Expandir

title	Compra/ Matrícula - 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 do VTEX.

Iniciado pela seleção do Produto (Curso):

É necessário informar o estado ofertante do Curso e adicionar o produto ao carrinho de compras:

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.

Ao clicar em realizar matrícula, o usuário será redirecionado para a tela de cadastro do Processo Seletivo, que foi customizada para manter a mesma identidade visual do Mundo Senai. Os dados de cadastro do aluno, assim como opção do curso já virão preenchidos da VTEX. As configurações e processamentos da inscrição/matrícula continuarão a ser executados através dos serviços nativos, seguindo as regras já existentes no projeto FS008228 (A50.301) – Integração MarketPlace.

A página do processo nativo de inscrição/ matrícula do portal do Processo Seletivo, foi customizada para ocultar as informações de pagamento, visto que, o pagamento já foi feito na plataforma VTEX. Sendo elas:

A página final do processo nativo de inscrição/ matrícula do portal do Processo Seletivo também foi customizada para ocultar as informações de pagamento, conforme imagem abaixo:

- Texto ‘Matrícula aguardando pagamento para efetivação. Utilize as opções abaixo para realizar o pagamento da matrícula’;
- Botão 'Pagamento com cartão de crédito'.

Central do Candidato:

- Pagamento: Texto ‘Matrícula aguardando pagamento para efetivação’;
- Data de vencimento da parcela;
- Botão 'Pagamento com cartão de crédito'.

Quando uma matrícula é realizada no SGE, a customização aciona a plataforma VTEX e altera o status do pedido para 'entregue', conforme imagem abaixo:

Informações

title	Importante

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, Matrículas Pendentes por Erros, criação de Responsável Financeiro, Controle de Matrícula em Turma com Vagas Esgotadas... estão detalhadas no Manual - Integração VTEX Informações Financeiras.

Informações

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

title	Controle de vagas

No SGE é possível realizar a Gestão das vagas disponibilizadas na VTEX.

O controle de vagas disponíveis considera o seguinte cálculo:

Nº máximo de alunos da turma - Pedidos reservados (pedidos sem matrícula) - Nº de matriculados na turma = Número de vagas disponíveis na VTEX

Expandir

title	Processo Envio de E-mail - Exclusivo para Empresas (B2B)

No escopo B2B, ao realizar uma compra na plataforma VTEX será enviado um e-mail de confirmação de compra para o cliente Pessoa Jurídica (e-mail utilizado no pedido), conforme dados parametrizados na aba 'E-mail B2B'. A interface estará disponível em: TOTVS Educacional | Sistema Industria | Integração VTEX | Parâmetros.

O envio de e-mail será síncrono, ou seja, o SGE ficará aguardando o retorno para verificar se foi enviado com sucesso (falha no servidor, por exemplo). Caso ocorra erro, será gravado na interface de log existente na integração VTEX, funcionalidade Envio de E-mail - VTEX B2B.

Após envio no momento da compra, o usuário pode optar por reenviar o e-mail e acrescentar destinatários. Para isso, foi criado o processo customizado para envio ou reenvio de e-mail de confirmação de compras de cursos exclusivos para empresa (B2B), com opção de informar outros e-mails alternativos como destinatário. O processo deverá ser executado de forma manual, sem possibilidade de agendamento.

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

Ao executar o processo, os e-mails serão enviados considerando o texto definido nos parâmetros. Caso ocorra algum erro durante o envio, os dados serão exibidos para o usuário na tela de finalização do processo. Esses dados não serão gravados no monitor de log.

Aviso
A customização 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.

...

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 123

Nova versão 124

Chave