Páginas filhas
  • Manual Operacional da Customização - Integração Loja FIEP Digital x SGE (SESI-SENAI-IEL)

Versões comparadas

Chave

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

...

Expandir
titleProcesso de Importação de Matrículas

Pré-requisitos

Para que o registro de matrícula do aluno seja criado no TOTVS  Educacional (SGE), a Loja FIEP Digital deverá enviar os dados do pedido de venda com status  igual a: processing.

Detalhamento do processo

O objetivo deste processo é detalhar como as informações de inscrições/matrículas (vendas) de alunos realizadas na Loja FIEP Digital (E-commerce), serão importadas para o TOTVS Educacional (SGE) como Matrículas.

Para isso, a FIEP irá disponibilizar no site da Loja as ofertas de Cursos SESI, SENAI e IEL , onde o aluno deverá acessar e selecionar um ou mais de um curso do seu interesse e efetuar a compra.



Para os casos onde o aluno poderá comprar mais de um curso na Loja FIEP Digital, como por exemplo um curso no SENAI e outro no IEL, será enviado pela Loja apenas uma venda com dois produtos  de matrícula/venda de uma única vez, para o SGE efetuar a matrícula e geração do contrato do aluno para cada curso selecionado. 

Após receber os dados de venda da Loja, será executada a funcionalidade nativa do TOTVS Educacional (SGE), para  efetuar a criação do registro de matrícula do aluno, sendo validadas todas as regras de negócio padrão do SGE.  Será executada as seguintes operações: 

  • Cadastrar Dados Básicos do Aluno
  • Cadastrar Dados Básicos do Responsável Financeiro
  • Preencher Dados de Matrícula
      •  Curso/Habilitação,  Matrícula no Período letivo, Matrícula nas Disciplinas e Gerar Contrato.

Inserir Print tela


Ao ser executado o processo de Importação de Matrícula a customização deverá efetivar a matrícula dos alunos, realizando as seguintes regras de validação, nas situações abaixo:

  • Se for um aluno novo no curso, deverão ser efetuados os três passos acima: matricular no curso/habilitação, período letivo e matrícula em  disciplinas.
  • Se for um aluno que está retornando para o mesmo curso (matrícula de retorno), em outro período letivo (vigente), ele será matriculado no novo período letivo e matrícula em disciplinas. 
  • Se o aluno já tiver realizado o curso/habilitação no mesmo período letivo, será realizada apenas a matrícula em disciplinas. 
  • Para o SESI, não se aplica a matrícula no curso/habilitação, matricula-se diretamente no período letivo, vinculando o curso, série e disciplinas. Já para o SENAI , matricula-se primeiramente no curso/habilitação, e posteriormente no período letivo e disciplinas.


Na Loja FIEP Digital não será realizada a validação de pendência financeira, porém será criada as seguintes regras para a customização realizar a validação de pendência financeira no SGE sendo elas:

  • Validação de pendências financeiras, para Cursos Rápidos: para os cursos de curta duração como por exemplo: Iniciação Profissional,  Qualificação Profissional, Educação Continuada e etc, não será realizada consulta financeira, devendo integrar a matrícula do aluno mesmo com mensagem de alerta. 
  • Validação de pendências financeiras, para Cursos de Longa Duração: para os cursos de longa duração como por exemplo: Técnico, Graduação e Pós Graduação, será realizada a consulta de pendências financeiras através da customização Validação de Inadimplência, porém a customização deverá integrar a matrícula do aluno mesmo com a mensagem de alerta, devendo retornar na funcionalidade do log  a pendência financeira quando existir.  


Após ser finalizado o registro de matrícula, o aluno conseguirá acessar o Portal do Aluno (SGE) com seu login de acesso (CPF), para  aluno estrangeiro seu login de acesso será gerado por (RA) e a senha será criada pelo processo com valor fixo (123456) para ambos. 

Através do novo Portal do Aluno será possível realizar o acesso ao Moodle, através do menu " Portal Moodle", que estará disponível no menu lateral esquerdo na visão inicial que o Aluno terá ao acessar o Portal Educacional.

Ao clicar no link o usuário terá acesso a página do Curso no Moodle na unidade que foi realizado o cadastro.

Aviso

Caso o aluno  realize o acesso diretamente no portal Moodle  seu  login de acesso será o (CPF) e a senha que será criada pelo processo com valor fixo (CPF), conforme regra da customização atual.

O envio dos alunos e matrículas para o Moodle ocorrerão pela integração existente entre SGE e Moodle.

A partir do momento que a matrícula do aluno for realizada no TOTVS Educacional (SGE), os alunos  serão tratados da mesma forma como tratamos os registros originados do SGE e enviados para o Moodle respeitando as parametrizações da customização atual.

...

Pré-requisitos
Expandir
titleAtualização de Dados do Aluno

Detalhamento do processo

O objetivo deste processo  é detalhar a atualização dos dados dos alunos, que  aconteceram na Loja FIEP Digital e que deverão ser replicadas para o TOTVS Educacional SGE.

Quando ocorrer alguma atualização de dados cadastrais no perfil do usuário na Loja FIEP Digital, seja para aluno ou responsável financeiro, será disparado um webservice da Loja para avisar ao SGE que ocorreu  atualização. 

Ao executar o processo,  a customização deverá buscar as informações da atualização que ocorreu na Loja FIEP Digital e irá identificar se a atualização precisa ser replicada para os cadastros do SGE de aluno e responsável financeiro.

Serão consideradas para o SGE as modificações nos campos do endereço, e-mail, telefone celular e residencial, do aluno e do responsável financeiro. 

Atualização Aluno disponível em: Totvs Educacional | Currículo e Oferta | Alunos | Aba Identificação

Aba Endereço


Atualização Responsável Financeiro disponível em: Totvs Educacional | Currículo e Oferta | Alunos | Aba Responsáveis | Dados Gerais | Identificação


Aviso
    • O processo customizado realizará apenas atualização dos dados básicos do perfil do usuário, conforme campos citados acima, se houver registro dos mesmos no SGE, os valores poderão ser sobrescritos. 
    • O e-mail do SGE é utilizado para integração do Moodle atual e não pode se repetir para usuários diferentes no Moodle. Quando um e-mail for atualizado na loja e enviado para o SGE, será disparada integração para atualização do e-mail no Moodle. Caso o e-mail informado já esteja associado a outro usuário no Moodle, a atualização não será efetuada e será gerado registro no log para verificação (comportamento já previsto na integração atual entre SGE e Moodle).
    • O campo Nome não poderá ser atualizado.
Expandir
titleCancelamento de Contrato

Pré-requisitos

Detalhamento do processo

O objetivo deste processo  é  exportar do SGE para a Loja FIEP Digital os dados de cancelamento de contrato, sempre que a situação de matrícula do aluno no período letivo for alterada para um status parametrizado (que exige alteração contratual e libere a vaga do aluno na turma). 

Portanto, quando o aluno decidir cancelar o Curso, ele precisará entrar em contato com a Unidade da FIEP e solicitar o cancelamento, para a Secretaria executar processo de alteração de situação de matrícula do aluno para “Cancelado/Desistente”. Neste momento, o SGE efetua consulta ao ERP para verificar se pode proceder com a alteração da situação de matrícula e cancelamento do contrato, alterando  automaticamente o contrato no ERP para o status "Rescindido".

Após alteração da situação de matrícula, será adicionado processo customizado para informar o cancelamento ocorrido no SGE, para que a loja faça a liberação da vaga e atualização dos dados de vendas (relatórios da loja). 

Para isso foi criado um processo customizado no menu customizado Integração Loja FIEP Digital, que pode ser executado (ou agendado) de acordo com necessidade do usuário, disponibilizado em: TOTVS Educacional | Customizações | Integração Loja FIEP Digital |Processos | Exportação de Cancelamento de Contrato, que irá acionar um método do webservice da Loja FIEP Digital, para informar o cancelamento de um contrato no SGE, oriundo de venda da Loja FIEP.


Print tela 

Aviso
  • O cancelamento será feito apenas pelo SGE, que enviará para a loja através deste processo.
  • Todo esse processo de cancelamento via SGE e financeiro da Unidade,  só será possível ser realizado em contratos vigentes, ou seja, para contratos fora da vigência o processo ocorrerá através de abertura de chamado via CSC Financeiro.
Expandir
titleMonitor de Log

Pré-requisitos

Não se aplica.


Descrição do processo

Este requisito detalha a funcionalidade de Monitor de Logs da Integração.


Detalhamento do processo

Nesta interface o usuário poderá consultar os LOGs das operações de exportação executadas pela integração do TOTVS Educacional com a Loja FIEP Digital.
Os históricos das exportações de dados para a Loja FIEP serão registrados e poderão ser visualizadas no menu TOTVS Educacional | Customização | Integração Loja FIEP | Monitor de Log.




Será apresentada ao usuário uma visão com a relação de registros importados e exportados.


  • 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.
  • Módulo: Tipo da integração que está sendo feita.
  • Data de Criação: Data de Criação do registro.
  • Data da última alteração: Data da última alteração do registro.



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:

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

*Não será possível incluir, editar ou excluir informações através dessa interface.

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


Informações
titleFuncionalidades

Segue um arquivo contendo a lista de todas as funcionalidades do log e os campos que compõem a chave:

Lista de Funcionalidades (ajustar)

Expandir
titleProcesso para Reenvio de Dados

Pré-requisitos

Não se aplica.


Descrição do processo

Este requisito detalha o processo de Reenvio de registros em caso de falha na integração.


Detalhamento do processo

O objetivo do Processo de reenvio de dados é permitir o envio para a Loja FIEP dos registros que não foram exportados corretamente. Esse processo poderá ser executado manualmente ou poderá ser agendado, por registro e a integração efetuará a exportação dos registros novamente.
A funcionalidade estará disponível na tela de Monitor de Logs, menu Processos | Reenvio de Log




Ao ser acionado o processo customizado de reenvio de dados a customização tentará realizar novamente o envio das informações ao Moodle, caso consiga o status do registro passará para Sucesso. O processo de reenvio automático será executado até atingir o número máximo de tentativas parametrizado (Parâmetros da integração – Parâmetros Gerais). Caso o parâmetro esteja vazio a customização não realizará nenhuma tentativa de reenvio automaticamente. Caso seja atingido o número máximo de tentativas de reenvio e em nenhuma das tentativas tenha retornado sucesso, a customização passará o status do registro para Cancelado, sendo o registro não integrado com o Moodle. 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.

...