...
Projeto:FS009084 - Integração VTEX - Envio de Matrícula para ACE
Nome do cliente: FIEP
Objetivo
Este manual visa demonstrar as funcionalidades implementadas e as regras aplicadas a elas, para possibilitar a Integração do TOTVS Educacional SGE VTEX x ACE x ERP.
Público Alvo
Este manual é destinado aos colaboradores selecionados como multiplicadores e usuários chave para o Programa SGE.
Expandir | |
---|---|
|
...
| |
Pré-requisitos Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Integração VTEX - Envio de Matrícula para ACE. Disponível em: Serviços Globais | Perfil | Educacional | Customização | Integração VTEX (ACE) | Parâmetros Após serem liberados nas permissões de perfil dos usuários teremos acesso as customizações no módulo Educacional através do caminho: TOTVS Educacional| Customização | Integração VTEX (ACE) | Parâmetros Identificação |
...
|
Expandir | ||
---|---|---|
| ||
Detalhamento do processo O Processo Seletivo VTEX, criado pela FIEP, não permitirá a manipulação da flag nativa Gerar lançamento, encontrada em: TOTVS Educacional | Processo Seletivo | Cadastros | Processo Seletivo/Venda Online de Cursos | Anexos | Área de Interesse Ofertada | Venda Online de Cursos | Financeiro | Gerar Lançamento. Essa opção permanecerá desabilitada, pois uma vez que as matrículas sejam efetivadas na VTEX, não serão gerados lançamentos financeiros durante a inclusão do contrato no SGE. A geração dos lançamentos e a sua baixa ocorrerão posteriormente no ERP, após o envio dos dados por meio da API do ACE. |
Expandir | ||
---|---|---|
| ||
Pré-requisitos Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Integração VTEX (ACE) - |
...
Exportação de |
...
Contratos VTEX para ACE. Disponível em: Serviços Globais | Perfil | Educacional | Customização | Integração VTEX (ACE) | Exportação de Contratos VTEX para ACE |
...
Detalhamento do processo Foi |
...
criado um processo customizado, disponível em Educacional > Customização > Integração VTEX (ACE) > Exportação de Contratos VTEX para ACE, para o envio dos contratos de matriculas vindas do VTEX para o ERP através do ACE. O processo de compra do curso e pagamento será realizado pelo aluno através da plataforma VTEX. Após concluir o preenchimento dos dados do processo seletivo no portal do SGE, o aluno será automaticamente "pré-matriculado" no SGE, de acordo com o processo atual de integração do VTEX e seus parâmetros definidos. Durante a execução do processo de Exportação de Contratos VTEX para ACE, a customização acionará uma API do ACE para envio dos dados correspondentes. Após receber os dados de matrícula, o ACE enviará automaticamente para o ERP as informações necessárias para gerar e efetivar o contrato, seus lançamentos e boletos. O ERP retornará os dados do contrato criado para o ACE, que deverá retornar para o SGE, na própria requisição, se a efetivação do contrato foi realizada com sucesso ou erro. Neste momento, o SGE deverá criar o contrato (Anexo Contrato ERP/AX) e alterar a situação de matrícula do aluno para Matriculado.
Para as vendas originadas de processo seletivo VTEX, é obrigatória a criação de um contrato no SGE, com plano de pagamento (parcela única ou várias parcelas) para ter o controle das parcelas que deverão ser pagas. Apenas para modalidades do tipo Técnico e Pós-Graduação é permitido mais de uma parcela no plano de pagamento. No VTEX, o aluno pode pagar a primeira mensalidade do curso (modalidade Técnico e Pós-Graduação) ou o valor total do curso (demais modalidades). Em ambos os casos, é considerada uma parcela única no VTEX, independentemente da forma de pagamento. Por este cenário, será enviada sempre uma única parcela paga para o ACE, e as parcelas (mensalidades) que precisam ser pagas, quando o curso não foi pago totalmente (modalidade Técnico e Pós-Graduação). Para identificação das parcelas pendentes de pagamento, será utilizado contrato gerado pelo processo nativo, associado à matrícula (SCONTRATO). Ele possui todas as parcelas previstas para o aluno, com seus respectivos valores e vencimentos. Após envio dos dados para o ACE, ele deverá retornar para o SGE, em caso de sucesso, os dados do contrato gerado. Neste momento, a customização deverá:
Ao final do processamento, os registros de log serão gravados e disponibilizados no Monitor de log (Educacional > Customização > Integração VTEX (ACE) > Monitor de Log).
|
Expandir | |||||
---|---|---|---|---|---|
| |||||
Detalhamento do processo O processo atual de Integração de Contrato ERP foi alterado para tratar as matrículas originadas no Processo Seletivo/VTEX. Foi criado um novo tipo de contrato chamado “Contrato VTEX”, que ao acionar o processo para uma matrícula do VTEX, o tipo de contrato VTEX será selecionado automaticamente e todos outros tipos e campos ficarão desabilitados na interface. Ao clicar em Avançar, a customização irá acionar novamente ou pela primeira vez o processo para enviar as informações do Contrato para o ERP através do ACE, para os os registros que não foram integrados corretamente através do processo "Exportação de Contratos VTEX para ACE (Customização > Integração VTEX (ACE))". O status da execução (sucesso ou erro) será registrada no Monitor de Log.
Para todos os demais contratos, que não são originados do VTEX, o processo de efetivação do contrato não sofreram nenhuma alteração. |
Expandir | |||||
---|---|---|---|---|---|
| |||||
Detalhamento do processo Atualmente, quando um aluno tem sua situação de matrícula alterada para Matriculado, a customização de Integração com o CRM envia os dados da matricula do aluno para o CRM. Este processo foi alterado para, além dos campos enviados, enviar a informação do canal de vendas, do parametro dentro de Customização > Integração VTEX (ACE) > Parâmetros, para o campo SistemasExterno do XML do CRM. O novo campo só será preenchido para matrículas de compras do VTEX. Para as demais matrículas enviadas para o CRM, o campo ficará em branco.
|
...
Expandir | ||
---|---|---|
| ||
Pré-requisitos Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Integração VTEX - Envio de Matrícula para ACE. Disponível em: Serviços Globais | Perfil | Educacional | Customização | Integração VTEX (ACE) | Monitor de Log Detalhamento do processo Foi criada uma interface de Log para armazenar informações e status dos dados que foram exportados do SGE VTEX para o ACE, referentes a exportação de contrato de matrículas. O histórico das exportação de dados para o ACE serão registrados e poderão ser acessados pelo caminho:
Será apresentada ao usuário uma visão com a relação de registros exportados.
Ao acessar o anexo de um registro será possível o usuário visualizar todos os registros relacionados ao cadastro integrado selecionando a opção Item de Log. Estarão disponíveis os seguintes campos:
Foi criada a seguinte funcionalidade no Monitor:
|