Histórico da Página

...

Expandir

title	Macro Fluxo

O fluxo abaixo segue a regra geral do integração.

Aviso
O fluxo acima pode divergir devido as customizações financeiras específicas de cada regional.

Image Modified

Expandir

title	Parâmetros

Expandir

title	Parâmetros da Integração

A Integração VTEX foi desenvolvida com parâmetros customizados para o registro de informações de dados específicos e necessários para a operação.

A interface para configuração desses parâmetros está disponível em: TOTVS Educacional | Sistema Indústria | Integração VTEX | Parâmetros.

Image Modified

Parâmetros Integração VTEX / 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).

Os dados configurados aqui são aplicáveis a todos os regionais.

Campos a serem preenchidos:

Nome da Conta;
APPToken;
APPKey;
Ambiente;
[B2B] - Nome da Conta;
[B2B] - APPToken;
[B2B] - APPKey;
[B2B] - Ambiente.

Image Modified

Parâmetros Integração VTEX / Aba: Dados Integração Geral

Esta aba é destinada à parametrização dos dados de conta específicos para cada regional de modo que os regionais possam aplicar as demais funcionalidades na VTEX conforme as suas necessidades, como por exemplo: Consulta de Pedidos, Preço, Estoque etc.

Campos a serem preenchidos:

Nome da Conta;
APPToken;
APPKey;
Ambiente;
[B2B] - Nome da Conta;
[B2B] - APPToken;
[B2B] - APPKey;
[B2B] - Ambiente.

Image Modified

Parâmetros Integração VTEX / 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.

Campo a ser preenchido:

Número de tentativas de reenvio.

Image Modified

Parâmetros Integração VTEX / Aba: Dados Financeiros

Nesta aba será definido o código da forma de pagamento a ser utilizada no processamento de baixa automática (FS008537 - Integração VTEX - Informações Financeiras). Este cadastro deve ser realizado por filial e inclui as seguintes formas de pagamento:

Boleto;
Cartão de Crédito;
Cartão de Débito;
Pix.

Image Modified

Informações
Para mais detalhes, consulte o Manual Integração VTEX - Informações Financeiras.

Parâmetros Integração VTEX / 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).

Nesta aba, é possível configurar todos os dados necessários para configuração de texto padrão e envio automático de e-mails para o responsável pelo curso, especialmente quando 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).

Campos a serem preenchidos:

E-mail do remetente;
Assunto do e-mail;
Tag's Disponíveis;
Teste de e-mail personalizado;
Nome do Remetente;
Tipo de e-mail (HTML/TXT);
E-mail destinatário.

Image Modified

Aviso

O SGE não garante o recebimento do e-mail, apenas o envio. Não é possível verificar se o endereço do destinatário está correto ou se a caixa está cheia.

Para mais informações, consulte o Manual Integração VTEX - Informações Financeiras.

Aba: E-mail B2B

Para informações sobre a configuração de e-mail exclusivo para empresas (B2B), consulte o 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 Modified

Para incluir uma situação de matrícula, o usuário deverá seguir os seguinte passos:

Clique no botão NOVO para incluir uma nova situação de matrícula.
Selecione a situação desejada a partir do lookup que lista todas as situações de matrícula disponíveis, consultando a tabela SSTATUS.
Após, clique em: Salvar.

Campos a serem preenchidos:

Status Indica:

Vaga ocupada: Situações de matrícula com este status serão subtraídas do número de vagas disponíveis.

Vaga disponível: Situações de matrícula com este status serão incluídas no cálculo das vagas disponíveis.

Image Modified

É possível registrar vários status de matrícula, mas apenas um status pode ser selecionado por vez.

Informações
Para mais detalhes sobre o controle de vagas, consulte o 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 Indústria | Integração VTEX | Parâmetros.

Aba: Dados Integração - Produto/SKU

Nesta aba, são parametrizados os dados de conta necessários para o processo de exportação de Produto/SKU para a VTEX, abrangendo cursos e turmas. Esses dados são únicos e essenciais para o correto funcionamento da exportação de produtos sendo aplicáveis a todos os regionais.

Campos a serem preenchidos:

[B2B] - Ambiente;
[B2B] - APPKey;
[B2B] - APPToken;
[B2B] - Nome da Conta.

Image Modified

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

Campos a serem preenchidos:

[B2B] - Ambiente;
[B2B] - APPKey;
[B2B] - APPToken;
[B2B] - Nome da Conta.

Image Modified

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

E-mail do remetente,
Assunto do e-mail,
Tipo de e-mail: HTML / TXT

Após, personalize o texto de e-mail, utilizando as Tag's Disponíveis,

Image Modified

Expandir

title	Parâmetros no Processo Seletivo

Para Processos Seletivos de cursos exclusivos para Empresas (B2B) é necessário informar que a Oferta é exclusiva B2B, através da seleção do Parâmetro: Oferta B2B, disponível na aba: Identificação do Processo Seletivo.em: TOTVS Educacional l Processo Seletivo l Aba: Identificação l Parâmetro: Oferta B2B.

Esta configuração garante que os cursos serão exportados apenas para a loja B2B, enquanto processos seletivos não marcados como B2B serão enviados para ambas as lojas: B2B e B2C.

Image Modified

Aviso

Tanto para Processo Seletivos para pessoa física ou para pessoa Jurídica, para que o campo possa ser parametrizado, proceda a configuração necessária:

Marque o campo: "Utiliza venda online de cursos e Oferta VTEX"
Defina a oferta como exclusiva B2B para garantir que os cursos sejam exportados corretamente.

Aviso

title	Validação manual de documentos

A validação manual de documentos obrigatórios do candidato não é permitida em um Processo Seletivo VTEX, uma vez que a matrícula é realizada de forma automática. Certifique-se de que todos os processos estejam configurados para permitir a matrícula automática sem necessidade de validação manual de documentos.

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 Indústria | Integração VTEX | De I Para Integração VTEX.

Ao acessar o menu, serão apresentadas três abas específicas para realizar a correlação do De l Para de cada uma, sendo:

Modalidade

,

.
Área

e

.
Filial.

Image Modified

DE I PARA De I Para da Integração VTEX - Modalidade e Área

Nesta aba, o usuário realiza a correlação entre as Modalidades e Áreas no VTEX e no TOTVS Educacional (SGE).

Passos para Cadastro

Selecionar Modalidade/Área do VTEX:
- No grid do lado esquerdo, escolha a Modalidade ou Área do VTEX que será parametrizada.
Selecionar Modalidade/Área do SGE:
- No grid do lado direito, escolha as Modalidades ou Áreas correspondentes no SGE.

Image Modified

Aviso

A partir da versão12.1.2402.021, não haverá mais preenchimento automático ao instalar a Customização . A responsabilidade pela parametrização inicial será dos regionais, que deverão realizar essa configuração manualmente.

O DE | PARA é um pré-requisito para que as exportações funcionem corretamente

O SENAI DN contratou um script padrão para cadastro de algumas modalidades e áreas.

Após a instalação da customização, a tela será preenchida com registros templates.

Os regionais poderão editar e/ou inserir novos registros conforme necessário.

Certifique-se de verificar todas as correlações após a configuração inicial para garantir que os dados estão corretamente alinhados entre o VTEX e o SGE.

DE I PARA De I Para da Integração VTEX - Filial

Nesta aba, o usuário realiza a correlação entre as Unidades do VTEX e as Filiais do TOTVS Educacional (SGE).

Passos para Cadastro

Selecionar Unidade do VTEX:
- No grid do lado esquerdo, escolha a Unidade do VTEX que será parametrizada.
Selecionar Filial do SGE:
- No grid do lado direito, escolha a Filial correspondente no SGE.

Image Modified

Expandir

title	Processo - Alocação de Turmas

Foi criado na O processo de Alocação de Turma, disponível em: TOTVS sEducacional | Currículo e Oferta | Turmas | Processos l Alocação de Turmas a interface de Turmas, um processo que possibilita o ao usuário parametrizar quais dias da semana as turmas no SGE terão aulas na sua programação, garantindo uma programação eficiente e organizada .O Processo Customizado, está disponível em: TOTVS Educacional | Currículo e Oferta | Turmas | Processos l Alocação de Turmas e poderá e poderá ser executado para uma ou mais Turmas turmas em cada execução.

Image Modified

Passos para Configuração

Acesso à Interface:
- Navegue até o menu indicado e acesse o Processo para Alocação de Turmas.
Seleção das Turmas:
- Você pode executar o processo para uma ou mais turmas em cada execução.
Parametrização dos Dias da Semana:
- Ao iniciar o processo, selecione os dias da semana em que as turmas terão aulas.

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

Image Modified

Aviso

title	Atenção

Se o processo for executado para dias da semana que já possuem registros no anexo Disponibilidade Semanal de uma execução anterior, esses registros não serão alterados.
Somente os dias da semana que ainda não estão disponíveis no anexo serão adicionados.
Após a execução do processo, revise as configurações para garantir que todos os dias da semana desejados foram corretamente alocados às turmas.

Expandir

title	Anexo - Disponibilidade Semanal

O anexo Disponibilidade Semanal, disponível na tela nativa de Turmas: TOTVS Educacional | Currículo e Oferta | Turmas | Anexo | Disponibilidade Semanal, permite permite ao usuário a visualização dos dias da semana alocados para aulas de turmas específicas, conforme configurado no processo de alocação de turmas, apresentado no tópico anterior.

O anexo: Disponibilidade Semanal está 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.

Image Modified

A tela exibirá o texto completo para cada dia da semana, sem abreviações.
Os dias disponíveis serão listados em linhas separadas.
É possível excluir entradas específicas, se necessário.

Image Modified

Aviso

title	Atenção

Inclusões de novos dias não são permitidas diretamente no anexo; estas devem ser realizadas exclusivamente pelo processo de alocação de turmas mencionado anteriormente.

Verifique regularmente o anexo para assegurar que a disponibilidade semanal está atualizada conforme as necessidades da turma.

Expandir

title	Parâmetros do Processo Seletivo

Ao criar um Processo Seletivo que utilizará integração com a Plataforma VTEX, é necessário informar os seguintes parâmetros:

Parâmetro: Utiliza Oferta VTEX

Na aba: Identificação, marcar a flag: "Utiliza Oferta VTEX" para indicar que o

O parâmetro: Utiliza Oferta VTEX, disponível em: TOTVS Educacional l Processo Seletivo l Aba: Identificação deverá ser selecionado para indicar que o processo seletivo utilizará a integração com a plataforma VTEX.

Image Modified

Aviso

title	Aviso

Tanto para Processo Seletivos para pessoa física ou para pessoa Jurídica, para que o campo "Utiliza Oferta VTEX" fique parametrizado, é necessário também marcar o campo "Utiliza venda online de cursos".

Criação das Áreas de Interesse Ofertadas

Após a criação do Processo Seletivo,

vincule

as Áreas de Interesse Ofertadas deverão ser vinculadas. Esses registros serão exportados e darão origem aos cursos que estarão disponíveis para compra na plataforma VTEX.

O acesso para realização do vínculo está disponível em: TOTVS Educacional l Processo Seletivo l Anexos: Área de Interesse Ofertada.

Turmas da Área de Interesse

Após a criação do Processo Seletivo e da Área de Interesse Ofertada,

o anexo Turmas da Área de Interesse para registrar

deverão ser vinculadas as turmas disponíveis da oferta de curso.

O acesso para realização do vínculo está disponível em: TOTVS Educacional l Processo Seletivo l Anexos: Área de Interesse Ofertada l Anexos: Turmas da Área de Interesse.

Image Modified

Aviso

title	Atenção

As turmas cadastradas serão exportadas como SKUs para a VTEX, representando as opções de compra dentro dos cursos na plataforma.

Anexo Dados Integração VTEX

Em seguida,

deverá ser parametrizado o anexo

deverão ser configurados os Dados Integração VTEX, que

está disponível nos Anexos da tela do cadastro do Processo Seletivo

estão disponíveis em: TOTVS Educacional l Processo Seletivo l Anexos: Dados da Integração VTEX.

Image Modified

A tela de cadastro dos Dados VTEX,

contém 3

contempla três abas:

Dados do

curso

Curso: Informe a quantidade e valor das parcelas e a Descrição Curso Google.

Image Modified

Aviso
O campo ‘ Valor do curso’, que era apresentado nesta aba, foi excluído do anexo e não será considerado para 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, Empresas que Indicam e os Parceiros.

Image Modified

Mídias Digitais: Nesta aba, informe as

URLs

URL's que correspondem a imagem, vídeo e degustação do curso, que serão enviadas para a Plataforma VTEX.

Image Modified

Aviso

title	Atenção

A URL da imagem é de envio obrigatório e deve 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.

Considerações de Vinculação:

A área de interesse pode ser vinculada apenas uma vez por Processo Seletivo. Se o processo seletivo for configurado para várias filiais, o registro será compartilhado entre as filiais visto que, esses dados refletem em um card e produto único na VTEX.

Image Modified

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á exibida uma mensagem de notificação para o impedimento do registro.

Image Modified

Ao salvar o processo seletivo, será verificado se todas as áreas de interesse estão corretamente vinculadas a um registro de dados integração VTEX. Caso contrário, uma mensagem de alerta será exibida ao usuário.

Image Modified

Anexo Dados Integração VTEX - Tipo de Financiamento

Deverá ser vinculado também os dados do Tipo de Financiamento que será utilizado.

Vincule os dados do Tipo de Financiamento utilizado através do anexo Dados Integração VTEX - Tipo de Financiamento.
O filtro de seleção exibirá a lista da tabela dinâmica (TIPOGRAT) já existente e utilizada no template do SGE.

Image Modified

Dica

title	Passo a Passo

Expandir

title	Cadastros - Produtos e SKU

Configurações necessárias para a criação de Produtos (Cursos) e SKUs (Turmas) na plataforma VTEX.

Produto (Curso)

SKU (Turma)

•Nome ou segundo nome do Curso;

•Área do Curso;
•Modalidade do Curso;
•Presencial/Distância do Curso;
•Descrição do Campos Complementares do Curso;
•Carga horária da Grade;
•Carga Horária A Distância do Campos Complementares da Grade;
•Carga Horária Presencial do Campos Complementares da Grade;
•Conteúdo do Campos Complementares da Grade;
•Público Alvo do Campos Complementares da Grade;
•Requisitos do Campos Complementares da Grade;
•Início das inscrições do Processo Seletivo;
•Término das inscrições do Processo Seletivo;
•Descrição Curso Google do anexo do processo seletivo Dados Integração VTEX;
•Informações Adicionais do anexo do processo seletivo Dados Integração VTEX;
•Empresas que Indicam do anexo do processo seletivo Dados Integração VTEX;
•Parceiros do anexo do processo seletivo Dados Integração VTEX;
•URL da Degustação do Curso do anexo do processo seletivo Dados Integração VTEX;
•Valor Curso do anexo do processo seletivo Dados Integração VTEX;
•Valor da Parcela do Plano de Pagamento vinculado a área Ofertada do processo seletivo.

• Nome da Turma;
• Data Inicial da Turma;
• Data Final da Turma;
• Data fim do período de matrícula da 1º Turma/Disciplina vinculada a Turma;
• Turno da 1º Turma/Disciplina vinculada a Turma;
• URL Vídeo do anexo do processo seletivo Dados Integração VTEX;
• URL da Imagem do anexo do processo seletivo Dados Integração VTEX;
• Disponibilidade Semanal - Anexo da Turma;
• Plano de Pagamento na Aba Venda online de cursos da Área de Interesse ofertada do Processo Seletivo;
• Número máximo de alunos da Turma.

Expandir

title	Processo Exportação de Dados VTEX

Após concluir todas as parametrizações e cadastros necessários, é essencial executar o processo de exportação de dados para criar Produtos e SKUs na VTEX. Este processo pode ser agendado ou executado manualmente.

Para Exportar Dados, acesse o Menu: TOTVS Educacional | Sistema Industria | Integração VTEX | Exportar Dados.

O processo exportará todos os Produtos e SKUs, conforme a política comercial B2B e/ou B2C., compreendendo as entidades:

Produto (Agrupamento de Áreas de Interesse Ofertada de um mesmo Processo Seletivo/Matriz Curricular);
SKU (Turmas vinculadas as Áreas de Interesse Ofertada no anexo Turmas da Área de Interesse);
Controle de Vagas;
Preço.

Clique em: Executar para iniciar o processo de exportação.

Image Modified

Para cursos exclusivos B2B, onde o parâmetro “Oferta Exclusiva B2B” está ativado, a exportação enviará a informação de política comercial B2B (na área VTEX : Para empresas) e o preço específico. 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

title	Turma Ativa ou Inativa na VTEX

Regras de Ativação e Inativação:

Conforme definido no Projeto FS008862 - Integração VTEX - Disponibilidade de Turma, a ativação ou inativação de turmas na VTEX é controlada pelo campo complementar “Disponível para Divulgação”, conforme:

O campo complementar Disponível para divulgação (STURMARCOMPL.DISPDIVULG) determinará se a turma exportada será considerada Ativa ou inativa:

Sempre que o processo de Exportação de dados VTEX (SKU) for executado, a customização verificará o campo complementar disponível para divulgação.

Campo complementar Disponível para divulgação marcado: A customização enviará o comando de turma (SKU) ativa na VTEX. Sendo assim, todas as funcionalidades já existentes na integração VTEX permanecem inalteradas.
Campo complementar Disponível para divulgação desmarcado: A customização enviará o comando de turma (SKU) inativa na VTEX.

Uma turma inativa na VTEX permite que o aluno que já tenha adquirido um curso (pedido realizado), possa efetivar sua matrícula normalmente. Para os clientes que ainda não realizaram algum pedido, o SKU não estará disponível para compra.

Aviso

title	Envio da condição comercial

A condição comercial enviada à VTEX segue as regras fixas especificadas abaixo:

Modalidades de Cursos Técnicos e Pós-graduação: Será enviada a informação fixa = 2.
Demais Modalidades: Será enviada a informação default = 1, conforme o escopo atual.

Como essa condição é realizada diretamente no código, não será disponibilizado parâmetros para informar outras modalidades.

...

Expandir

title	Controle de vagas

A Gestão do Controle de Vagas disponibilizadas na plataforma VTEX é realizado diretamente no SGE, a partir das informações relacionadas aos campos:

Número máximo de alunos da turma (Número de enviadas para VTEX): Será consultado o campo ‘Nº máximo de alunos’ (STURMA.MAXALUNOS).
Pedidos reservados na VTEX (pedidos sem matrícula): Será consultado no Monitor de vendas , os pedidos vinculados a essa turma (SKU), que ainda não tiveram a matrícula efetivada.
Alunos matriculados na turma: Identificado pelo campo “alunos matriculados” no cadastro da Turma.

Assim temos o cálculo:

Nº Número Máximo de Alunos da Turma: 50

Subtraído pelo Nº pelo Número de Pedidos Reservados na VTEX/Pedidos de Matrícula: 5

Subtraído pelo Nº Número de Alunos Matriculados na Turma: 35

Totalizando Número de Vagas Disponíveis: 10

As informações relacionadas ao registro do envio das vagas e o cálculo, são gravadas em:

Turma

Disponível através do menu: TOTVS Educacional l Currículo e Oferta l Turmas l Anexos: Consulta Vagas - VTEX

Integração VTEX / Consulta de Vagas - VTEX

Disponível através do menu: TOTVS Educacional l Sistema Indústria l Integração VTEX l Consulta Vagas - VTEX.

No grid, são apresentados os dados que também estão disponíveis no anexo da turma, incluindo a indicação de status da turma na plataforma VTEX (Ativo/Inativo).

Todos os campos da interface ficarão bloqueados para inclusão, edição, ou exclusão.

Ao acessar um registro, seja ele apresentado na Turma ou na Integração VTEX, são apresentadas os detalhes do registro, incluindo:

Dados da Exportação VTEX: Última Atualização (Data/Horário) e Número de Vagas Exportadas.
Dados Atuais no SGE: Total de Vagas da Turma, Total de Alunos Matriculados, Total de Pedidos Reservados, Total de Vagas Disponíveis.

No exemplo acima, observamos que na última exportação de dados foram encaminhadas 50 vagas para a VTEX.

Desde essa exportação, houve algumas atualizações:

Número de vagas exportadas para o VTEX: 50
Número total de vagas reduzido para: 35
Matrículas efetivadas: 22
Pedidos reservados: 2
Vagas Disponíveis: 11

Sendo assim, a atualização para o novo total de vagas disponíveis (11 vagas) ocorrerá na próxima exportação de dados.

No entanto, caso o usuário deseje atualizar o número imediatamente, essa atualização pode ser feita através dos processos descritos no tópico abaixo.

Expandir

title	Atualização do número de vagas

Para que a VTEX tenha o número exato de vagas disponíveis, foi incorporado à exportação de dados já existente o envio das informações sobre as vagas, levando em consideração esse cálculo.

Como cada Regional tem a liberdade de definir a periodicidade da execução do Processo de Exportação de dados, o intervalo escolhido pode não ser suficiente para garantir a atualização em tempo real das vagas disponíveis.

Diante disso, disponibilizamos um processo para que o usuário possa atualizar as vagas sempre que considerar necessário.

Esse processo está acessível tanto no menu principal da integração quanto no cadastro da turma.

Turma

Disponível através do menu: TOTVS Educacional l Currículo e Oferta l Turmas l Anexos: Consulta Vagas - VTEX l Processos l Atualização de Vagas - VTEX.

O processo pode ser aplicado a mais de uma turma.

Image RemovedImage Added

Integração VTEX / Consulta de Vagas - VTEX

Disponível através do menu: TOTVS Educacional l Sistema Indústria l Integração VTEX l Consulta Vagas - VTEX l Processos l Atualização de Vagas.

Ao ser executado, o processo calcula as vagas disponíveis, envia o resultado para a VTEX e registra os dados no anexo "Consulta de Vagas".

Esse processo pode ser realizado sempre que necessário.

A seguir, apresentamos alguns exemplos de atualização após a execução do processo:

Cenário I - Vagas Disponíveis na Turma:

Número máximo de alunos na turma = 50

Pedidos reservados na VTEX(sem matrícula) = 5

Número de alunos matriculados na turma = 12

Número de vagas disponíveis na VTEX = 33

+ 3 matrículas realizadas (VTEX) >

Estado

colour	Green
title	Atualizado

:

Número máximo de alunos na turma = 50

Pedidos reservados na VTEX(sem matrícula) = 5

Número de alunos matriculados na turma = 15

Número de vagas disponíveis na VTEX = 30

1 matrícula cancelada (SGE) >

Estado

colour	Green
title	Atualizado

:

Número máximo de alunos na turma = 50

Pedidos reservados na VTEX(sem matrícula) = 5

Número de alunos matriculados na turma = 14

Número de vagas disponíveis na VTEX = 31

+ 1 matrículas realizadas (via SGE) >

Estado

colour	Green
title	Atualizado

:

Número máximo de alunos na turma = 50

Pedidos reservados na VTEX(sem matrícula) = 5

Número de alunos matriculados na turma = 15

Número de vagas disponíveis na VTEX = 30

Aviso

Caso o número máximo de alunos seja alterado no cadastro da turma, será necessário executar novamente o processo para atualização das vagas no VTEX. Não estão previstos bloqueios nesta operação.
Caso aconteça um cancelamento de matrícula, após a inativação da turma na VTEX, o Regional deverá, ativar novamente a turma, conforme regra atual e executar novamente o processo de atualização de vagas. O controle de vaga, não terá ações na ativação da turma.
Se houver alteração/inclusão no parâmetro (da integração ) da aba “Situação de matrícula’’, será necessário executar novamente o processo para atualização das vagas no VTEX.

Cenário II - Vagas Indisponíveis na Turma:

Número máximo de alunos na turma = 50

Pedidos reservados na VTEX(sem matrícula) = 5

Número de alunos matriculados na turma = 45

Número de vagas disponíveis na VTEX = 0

No cenário acimadescrito, caso se o usuário tente tentar incluir uma matricula matrícula ou alterar uma a situação de uma matrícula , para um status que indique que a vaga está ocupada, a customização bloqueará bloqueará a ação e apresentará . Nesse caso, será exibida uma mensagem , informando ao usuário que a turma não possui mais possui mais vagas disponíveis.

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.

Image Removed

Image Added

Na tela de Parâmetros da Integração VTEX, através da aba: E-mail B2B, informe:

E-mail do remetente,
Assunto do e-mail,
Tipo de e-mail: HTML / TXT

Após, personalize o texto de e-mail, utilizando as Tag's Disponíveis,

Image Added

O envio de e-mail será síncrono, ou sejaO 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.

Image RemovedImage Added

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.

Image Modified

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.

Expandir

title	Monitor de Log e Reenvio

O Monitor de log armazena informações de Log registra informações sobre os dados exportados para a plataforma VTEX, com incluindo detalhes dos sobre os dados enviados, dados recebidos, status e datas de processamento. O Monitor de log também será a referência do usuário para identificar casos que tenham necessidade

Os dados apresentados nesta interface serão armazenados em uma tabela personalizada por filial.

Além disso, o Monitor de Log servirá como referência para os usuários identificarem casos que necessitem de reenvio de dados.

A interface estará pode está disponível em: TOTVS Educacional | Sistema Industria Indústria | Integração VTEX | Monitor de Log.

Os dados informados nesta interface serão armazenados em tabela customizada por Filial.

Image AddedImage Removed

Na tela de log estarão disponíveis os seguintes campos:

Id Log: Identificador sequencial de Log.

Campos Chave: Descrição dos campos utilizados para gerar o registro integrado.
Valores Chave: Chave primária do registro integrado.
Status: Situação da Integração (Sucesso ou Erro).
Funcionalidade: Tipo de Processo que está sendo feito (Por exemplo: Exportação de Dados).
Data de Criação: Data de Criação do registro.
Data da última alteração: Data da última alteração do registro.
Número de tentativas de Reenvio: Quantidade de vezes que um registro já foi reenviado.
Criador por: Usuário responsável pela inclusão do registro.
Alterado Por: Usuário responsável pela alteração do registro.
Módulo: Funcionalidades existentes no escopo.

Será apresentada ao usuário uma visão com relação a registros exportados. Não será possível incluir, editar ou excluir informações através dessa interface.

Image RemovedImage Added

Na tela de log, ao acessar um registro, será possível visualizar todos os registros relacionados ao cadastro integrado selecionando a opção Item de Log. Estarão disponíveis os seguintes campos:

Id. Item Log: Identificador sequencial de log.
Id. Log: Identificador sequencial de log.
Mensagem: Mensagem com o status da integração do item.
Status: Situação da integração do item selecionado.
Dados Enviados: Relação dos dados enviados para integração.
Dados Recebidos: Relação dos dados recebidos.
Data de Criação: Data de criação do registro.
Data da última Alteração: Data da última alteração do registro.

Image RemovedImage Added

Informações
Para informações sobre Alteração Status Logs com Erro e o processo de Exclusão de Logs no monitor, acesse o Manual Operacional da Customização - LIB DN

Expandir

title	Reenvio de Dados

O Processo O processo de reenvio de dados permite o envio dos de registros que não foram exportados com sucesso. Esse processo poderá procedimento pode ser executado realizado manualmente ou poderá ser agendado pelo por meio do menu de "Processos de Monitor de Log, ".

O reenvio pode ser feito por registro (, seja ele com status de erro ou pendente) , e a integração efetuará realizará a exportação dos desses registros novamente.

Image RemovedImage Added

Será permitido o usuário selecionar um ou vários registros com o status de Erro ou Cancelado e poderá ser executado manualmente. Caso o usuário não selecione nenhum registro na visão, o processo de reenvio é executado para todos os registros com status de Erro, e neste caso, pode ser agendado.

Ao ser acionado o processo customizado de reenvio de dados, a customização tentará realizar novamente o envio dos dados. Caso seja processado corretamente, o status do registro passará para Sucesso.

O reenvio automático será executado até atingir o número máximo de tentativas parametrizados (Item 'Parâmetros' deste documento) 'Número de Tentativas de Reenvio'. Caso o parâmetro esteja vazio a customização não realizará nenhuma tentativa de reenvio automaticamente.

Quando o número máximo de tentativas de reenvio for atingido e em nenhuma das tentativas tenha retornado sucesso, a customização passará o status do registro para Cancelado.

Dependendo do erro ocorrido, o usuário precisará acessar o Monitor de log e analisar os logs, corrigir os registros (caso necessário) e então acionar o processo de reenvio.

...

Expandir

title	FAQ

Expandir

title	Monitor de Vendas - Inconsistências nos campos

O Monitor de Vendas, disponível através do menu: TOTVS Educacional l Sistema Indústria | Integração VTEX | Monitor de Vendas l Aba: Dados Cliente. permite a verificação dos dados relacionados ao cliente.

Image Added

Nas situações em que forem verificados no Monitor de Vendas/ Dados do Cliente que os campos: Nome Caso os campos Nome e CPF/CNPJ ficarem estejam em branco após a execução da integração, e o campo Tipo de Documento estar sendo estiver preenchido com "CNPJ" mesmo para pessoas físicas, siga os seguintes passos :

Image Removed

físicas após a execução da integração, é necessário realizar as seguintes verificações:

Aplicação das Chaves AppKey e AppToken nos Parâmetros da Integração VTEX, disponível em: TOTVS Educacional | Sistema Industria | Integração VTEX | Parâmetros l Aba Dados da Integração - Produto/SKU,
Execução da consulta de pagamentos.

Deck of Cards

id	ETAPASINCONSISTENCIACAMPOS

Card

id	PASSO1ETAPAINCOSISTENCIA
label	Passo 1 - Parâmetros Integração VTEX

Verifique no cadastro de Parâmetros da Integração VTEX, disponível em: TOTVS Educacional | Sistema Industria | Integração VTEX | Parâmetros l Aba Dados da Integração - Produto/SKU se as chaves (AppKey, AppToken, Nome da Conta) estão preenchidos corretamente para as contas B2B e B2C.

Image Removed

Image Added

Card

id	PASSO2ETAPAINCOSISTENCIA
label	Passo 2 - Executação Consulta de Pagamentos

Antes de executar o processo de consulta de pagamentos, insira um comentário no pedido feito no VTEX para que o mesmo

volte para o Feed de pedidos (isso irá atualizar o registro);Execute

retorne ao Feed de Pedidos.

Esta ação fará com que o registro seja atualizado.

Em seguida, execute o processo de consulta pagamentos

para atualização do registro

.

Image Modified

Card

id	PASSO3ETAPAINCOSISTENCIA
label	Passo 3 - Consultar Monitor de Vendas

Uma vez realizado este procedimento

Realizado o processo de consulta de pagamentos, verifique novamente

no log

se

o problema foi resolvido

a correção foi aplicada ao registro dos dados do cliente.

Image Removed

Image Added

Expandir

title	Tempo de indexação

Exportar o processo e os produtos e SKUs terem um tempo para aparecer na loja;

Expandir

title	Botão de matrícula não está habilitado

Deve ser acionado o time da VTEX, não se trata de um controle do SGE.

Expandir

title	Anexo Matrículas do item do pedido não foi atualizado

Conferir no anexo 'Dados de Pagamento' do contrato se a baixa do lançamento já foi feita. Esses dois registros 'andam juntos'.

Expandir

title	Exclusão de Matrícula no SGE não liberou vaga no VTEX

Atualmente não existe essa regra na customização, o controle de estoque é feito pelo número de vagas definido na Turma (pegar tabela certinho).

Expandir

title	Não foi possível localizar os dados de Inscrição

"Não foi possível localizar os dados de inscrição para o IdDadosIns (numero da inscrição)" é um erro que ocorre pelo fato da Turma em questão não ter sido Exportada para o VTEX.
Após realizada a Exportação, os dados da Inscrição serão preenchidos e o erro ira parar de aparecer.

...

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 139

Nova versão 143

Chave

Passos para Cadastro

Passos para Cadastro

Passos para Configuração