Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Expandir
titleControle 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úmero Máximo de Alunos da Turma: 50

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

Subtraído pelo  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:
  • 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
titleAtualizaçã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
colourGreen
titleAtualizado
:

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
colourGreen
titleAtualizado
:

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
colourGreen
titleAtualizado
:

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
titleProcesso 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 AddedImage Removed


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 Vendasem: TOTVS Educacional , menu | Sistema Indústria Industria | Integração VTEX | Monitor de Vendas | Processos | Envio de E-mail

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
titleMonitor 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 Removed

Image Added

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
titleReenvio de Dados

 O O Processo de reenvio de dados permite o envio dos registros que não foram exportados com sucesso. Esse processo poderá ser executado manualmente ou poderá ser agendado pelo menu de Processos de Monitor de Log, por registro (com status de erro ou pendente) e a integração efetuará a exportação dos registros novamente.

A funcionalidade estará disponível em: TOTVS Educacional | Sistema Indústria | Integração VTEX   | Monitor de Log | Processos | Reenvio de Dados.

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
titleFAQ
Expandir
titleMonitor de Vendas - Inconsistências nos campos

Caso os campos Nome e CPF/CNPJ ficarem em branco após a execução da integração, e o campo Tipo de Documento estar sendo preenchido com "CNPJ" mesmo para pessoas físicas, siga os seguintes passos :

Image Removed

Image Added


Deck of Cards
idETAPASINCONSISTENCIACAMPOS
Card
idPASSO1ETAPAINCOSISTENCIA
labelPasso 1 - Parâmetros Integração VTEX

Verifique no cadastro de Parâmetros se as chaves (AppKey, AppToken, Nome da Conta) estão preenchidos corretamente para as contas B2B e B2C.

Card
idPASSO2ETAPAINCOSISTENCIA
labelPasso 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 o processo de consulta pagamentos para atualização do registro.

 

Card
idPASSO3ETAPAINCOSISTENCIA
labelPasso 3 - Consultar Monitor de Vendas

Uma vez realizado este procedimento, verifique novamente no log se o problema foi resolvido.


Expandir
titleTempo de indexação

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

Expandir
titleBotã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
titleAnexo 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
titleExclusã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
titleNã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. 

...