Projeto: FS008599 - Integração TOTVS Educacional x VTEX
Nome do Cliente: Confederação Nacional da Indústria - SENAI
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 VTEX acontece para os tipos de 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 no final da página deste documento.
O fluxo abaixo segue a regra geral do integração.
O fluxo acima pode divergir devido as customizações financeiras específicas de cada regional.
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.
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:
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:
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:
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:
Para mais detalhes, consulte o Manual Integração VTEX - Informações Financeiras.
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:
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.
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)
Nesta aba são definidos o 'status indica' de cada situação de matrícula, para controle de vagas.
Para incluir uma situação de matrícula, o usuário deverá seguir os seguinte passos:
Campos a serem preenchidos:
É possível registrar vários status de matrícula, mas apenas um status pode ser selecionado por vez.
Para mais detalhes sobre o controle de vagas, consulte o tópico- Controle de vagas.
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.
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.
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..
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).
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.
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.
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.
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:
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:
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.
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:
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.
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.
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.
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:
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.
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.
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.
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.
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.
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.
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.
Passo a Passo
Segue configurações necessárias para que Produto (Curso) e SKU (Turma) sejam criado na VTEX:
Após finalizados todas as parametrizações e cadastros, o usuário deverá executar o processo de exportação de dados. Através desse processo que os Produtos e SKUs serão criados na VTEX.
O processo pode ser agendado ou executado através do Menu: TOTVS Educacional | Sistema Industria | Integração VTEX | Exportar Dados
O processo fará a exportação de todos os Produtos e SKUs sendo da política comercial B2B e/ou B2C.
Para os cursos exclusivos B2B, onde o novo parâmetro (Oferta Exclusiva B2B) do processo seletivo estiver marcado, será enviada a informação política comercial B2B (na área VTEX : Para empresas) e seu 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.
Turma Ativa ou Inativa na VTEX
Abaixo as regras de ativação ou inativação de turma na VTEX, Conforme definido no Projeto FS008862 -Integração VTEX - Disponibilidade de Turma:
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.
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.
Envio da condição comercial
A condição comercial é enviada a VTEX, de forma fixa seguindo as regras:
Como essa condição é realizada diretamente no código, não será disponibilizado parâmetros para informar outras modalidades.
Abaixo exemplos de visualização dos campos no SGE e na VTEX.
O estoque de um curso (apresentado na VTEX ) é definido no SGE pelo campo Número máximo de alunos, no cadastro da turma.
Atenção
Para cursos que sejam identificados como 100% EAD, este campo será preenchido com o texto 'EAD'.
É considerado sempre a Turma Disciplina de menor IDTURMADISC.
Para cursos que sejam identificados como 100% EAD, este campo será preenchido com o texto 'EAD'.
É considerado sempre a Turma Disciplina de menor IDTURMADISC.
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.
- A regra de parcelamento é configurado diretamente na loja VTEX e será responsabilidade de cada regional.
- 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 |
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.
Bolsas- Modalidade Técnico e Pós Graduação
Para os casos em que o aluno tenha Bolsa, será incluído a bolsa apenas na primeira parcela, desde que, vinculados aos cursos das Modalidades Técnico e/ou Pós graduação.
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.
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:
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:
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.
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.
No SGE é possível realizar a Gestão das vagas disponibilizadas na VTEX.
O controle de vagas disponíveis considera o seguinte cálculo/exemplo:
As informações para chegar no Nº de vagas disponíveis, são consultadas no SGE:
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.
Esse cálculo e o registro do envio das vagas, são gravados no anexo da turma e também no Menu principal da integração, conforme imagens abaixo:
*No grid, além dos dados que também estão disponíveis no anexo da turma, tem a informação se a turma está ativa ou inativa na VTEX.
Em ambas telas, ao abri o registro é apresentado os detalhes das informações, dentre elas a data/hora da última exportação para VTEX.
Todos os campos da interface ficarão bloqueados para inclusão, edição, ou exclusão.
No exemplo acima, é possível notar que na última exportação de dados foi encaminhado para VTEX o numero de 50 vagas.
Após essa exportação tivemos atualizações no Número de vagas (35) , tivemos matrículas efetivadas (22)e dos pedidos reservados (2).
A Atualização para o número de vagas disponíveis (11 vagas), acontecerá na próxima exportação de dados ou caso o usuário deseje atualizar imediatamente o número, a atualização pode acontecer via processos (descrito no tópico abaixo).
Para que a VTEX tenha o número exato das vagas disponíveis, foi incluído na Exportação de dados (já existente) o envio de vagas, considerando esse cálculo.
Como cada Regional é livre para definir a periodicidade da execução do Processo de Exportação de dados, o tempo definido para a execução pode não cobrir a atualização das vagas disponíveis.
Diante disso, foi disponibilizado um processo, para que o Usuário realize a atualização das vagas, sempre que julgar necessário.
O Processo está disponível no Menu principal da integração e também no cadastro da turma.
Neste Menu, é possível selecionar várias turmas para execução do processo. cadastro da turma.
Ao ser executado, o processo realizada o cálculo das vagas disponíveis, envia para a VTEX o resultado do cálculo e grava os dados no anexo Consulta de vagas.
O processo pode ser executado sempre que for necessário.
Abaixo alguns exemplos de atualização após execução do processo:
Cenário inicial:
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) > 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) > 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) > 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
Cenário : Quando não houver 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 = 45
Número de vagas disponíveis na VTEX = 0
No cenário acima, caso o usuário tente incluir uma matricula ou alterar uma situação de matrícula, para um status que indique vaga ocupada, a customização bloqueará a ação e apresentará uma mensagem, informando ao usuário que a turma não possui mais vagas.
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.
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.
O Monitor de log armazena informações de dados exportados para a plataforma VTEX, com detalhes dos 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 de reenvio de dados.
A interface estará disponível em: TOTVS Educacional | Sistema Industria | Integração VTEX | Monitor de Log.
Os dados informados nesta interface serão armazenados em tabela customizada por Filial.
Na tela de log estarão disponíveis os seguintes campos:
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.
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:
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
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.
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.
O objetivo deste projeto é possibilitar 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 cursos.
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.
Para maiores informações, acesse o Manual Operacional da Customização - Integração VTEX Kit de Cursos SENAI.
O objetivo deste projeto é permitir a integração das vendas realizadas através da plataforma VTEX com o SGE. Com o objetivo de possibilitar a realização da matrícula do aluno e a geração da baixa de lançamento financeiro com base nas informações da venda e pagamento.
Para maiores informações, acesse o Manual Operacional da Customização - Integração VTEX Informações Financeiras SENAI.
No VTEX, será possível oferecer para o Aluno a visualização dos produtos similares (cursos) na página inicial do produto/curso, exibir os últimos cursos cadastrados (lançamentos) e a quantidade vendida de cada produto.
Além disso, a customização possibilita a curadoria de depoimentos de alunos para serem publicados na plataforma VTEX.
Para maiores informações, acesse o Manual Operacional Template Digital II - Sugestão de Curso / Compra Fácil.
A funcionalidade permite realizar o cancelamento de pedidos por ChargeBack. Esse tipo de cancelamento ocorre quando o cliente solicita o cancelamento e reembolso de uma transação direto na operadora do cartão, alegando desconhecer a compra.
Para maiores informações, acesse o Manual Operacional da Customização- Cancelamento por Chargeback.
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 :
Verifique no cadastro de Parâmetros se as chaves (AppKey, AppToken, Nome da Conta) estão preenchidos corretamente para as contas B2B e B2C.
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.
Uma vez realizado este procedimento, verifique novamente no log se o problema foi resolvido.
Exportar o processo e os produtos e SKUs terem um tempo para aparecer na loja;
Deve ser acionado o time da VTEX, não se trata de um controle do SGE.
Conferir no anexo 'Dados de Pagamento' do contrato se a baixa do lançamento já foi feita. Esses dois registros 'andam juntos'.
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).
"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.