Páginas filhas
  • Manual Operacional - Integração VTEX - Envio de Matrícula para ACE

Versões comparadas

Chave

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

...

Expandir
titleExportação de Contratos VTEX para ACE

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. 


Image RemovedImage Added

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.

Ajuste de Matrícula Após Início da Turma

Durante a execução do processo de Exportação de Contratos VTEX para ACE o processo irá considerar as matrículas que foram efetivadas pelo portal do processo seletivo (VTEX) e fazer o seguinte ajuste:

  • O processamento identifica as turmas iniciadas e verifica as datas iniciais e finais das turmas/disciplinas.
  • Para a turma disciplina onde a pré-matrícula foi realizada após a data de início da turma/disciplina, a disciplina referente à essa turma/disciplina será excluída na matrícula do aluno e o valor do contrato será recalculado considerando apenas as disciplinas matriculadas (mantidas na grade do aluno). 


Nota
titleDetalhamento da Regra de Exclusão das Disciplinas
  • Se a data da matrícula for menor que a data de início da turma (turma não iniciada), o processo irá seguir conforme escopo FS009084 - Integração VTEX - Envio de Matrícula para ACE sem a exclusão das disciplinas.
  • Se a data da matrícula for maior que a da turma (turma iniciada), as disciplinas serão verificadas para remover e recalcular o valor do contrato. Os passos seguintes serão executados:
    • Excluir as matrículas nas turmas / disciplinas em que a data de matrícula é maior que a data de início da turma/disciplina somado à quantidade de dias informado no parâmetro, ou se data de matrícula somada à quantidade de dias informado no parâmetro for maior que data final da turma/disciplina.

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.

Aviso
titleAviso

Uma mesma venda/pedido no VTEX pode ter mais de um curso associado. Cada curso corresponde a um item do mesmo pedido. As matrículas e os contratos serão gerados no SGE por curso (uma matrícula para cada item do pedido). Portanto, para cada matrícula identificada, será realizado o envio para o ACE das informações relacionadas ao item do pedido referente à matrícula. 

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á: 

  • Alterar a situação de matrícula do aluno para matriculado, conforme status de matrícula definido em: Customização | ERP | Parâmetros | Aba Status de Matriculado.
    • Este processo irá disparar automaticamente o envio para o CRM, que será alterado para enviar também o canal de vendas. 
  • Incluir o contrato gerado no ERP no Anexo Contrato ERP da matrícula no período letivo (tabela ZCONTRATOAX).


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

Aviso
titleImportante

Será de responsabilidade da FIEP criar os planos de pagamentos para vincular no processo seletivo VTEX e manter as datas de vencimento das parcelas atualizadas conforme necessidade. Esta é uma premissa do processo atual da Integração VTEX e Processo Seletivo. As informações do plano serão disponibilizadas no processo de compra do aluno no VTEX. Deverão ser utilizados os recursos nativos para a gestão dos planos, já que não está prevista nenhuma customização para tratamento de datas de vencimento (no plano ou no envio dos dados para o ACE). 

Nota
titleRecalcular Parcelas Contrato

Durante o processo de envio dos contratos VTEX para o ACE, ajustes são realizados no sistema RM (Ajuste de Matrícula Após Início da Turma). Nesta etapa, o valor do contrato será recalculado com base na carga horária das disciplinas em que o aluno permanecerá pré-matriculado.

O novo valor será proporcional à carga horária das disciplinas da matrícula.

Aviso
titleRegra Calculo

A quantidade de parcelas será recalculada de acordo com as seguintes regras:

  • A primeira parcela não será alterada, pois corresponde ao valor pago no VTEX.
  • A partir da data de matrícula, serão identificadas e excluídas do contrato as parcelas com vencimento anterior ou no mês da matrícula.
  • O novo valor será redistribuído entre as parcelas restantes a vencer do contrato.

Após a atualização das parcelas com os novos valores, as alterações serão registradas na tela de Histórico de Parcelas Ajustadas.

...