Histórico da Página

Pré-requisitos

Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Integração Loja FIEP Digital.  Disponível em: Serviços Globais | Perfil | Educacional | Customização | Integração Loja FIEP 

Image Added

Para mais detalhes de como liberar no perfil dos usuários, acesse o Manual de Instalação de Customizações na seção Liberando Acesso aos Menus.

Detalhamento do processo

O objetivo deste processo é detalhar como o TOTVS Educacional (SGE) realizará a integração com a Loja FIEP Digital de acordo com os Dados de Conexão –WS, Parâmetros Gerais e Situação de Matrícula Inicial.

Para isso foi criada uma parametrização onde o usuário definirá os valores utilizados pela integração; A interface customizada estará disponível em: TOTVS Educacional | Customizações | Integração Loja FIEP| Parâmetros.

Image Added

Ao clicar no menu de acesso será aberta a tela de parâmetros que possui seis abas de configurações: Dados de Conexão – WS, Parâmetros Gerais e Parâmetros Por Nível de Ensino, conforme descrição abaixo. 

Na Aba Dados de Conexão – WS, deve ser informado os dados:

Image Added

• Endereço Webservice Loja: neste campo  o usuário deverá informar o endereço de acesso ao Webservice disponibilizado pela Loja FIEP Digital (E commerce).

• Token Webservice Key: neste campo o usuário deverá informar o Token de acesso ao Webservice disponibilizado pela Loja FIEP Digital (E commerce).

• Token Webservice Secret: neste campo o usuário deverá informar o Token de acesso ao Webservice disponibilizado pela Loja FIEP Digital (E commerce).

Na Aba Parâmetros Gerais

Pré-requisitos

Os anexos de retorno devem ser liberados nas permissões de perfil dos usuários para aparecerem nos seus respectivos lugares. Para mais detalhes de como liberar no perfil dos usuários acesse o Manual de Instalação de Customizações na seção Liberando Acesso aos Menus.

Descrição do processo

Este requisito detalha os parâmetros necessários para a Integração de dados entre o TOTVS Educacional (SGE) e o Moodle.

Detalhamento do processo

A tela de parâmetros estará disponível em TOTVS Educacional | Customizações | Integração Moodle| Parâmetros.

Image RemovedAo clicar no menu de acesso será aberta a tela de parâmetros que possui seis abas de configurações: Dados de Conexão – WS, Parâmetros Gerais, Status de matrícula- Matricula, Status de Matricula- Inativar Matrículas, Disciplinas – Elegíveis (sendo está aba disponível apenas para o SESI) e Modalidades de Cursos, conforme descrição abaixo.Essa parametrização será realizada por coligada e Nível de Ensino.Image RemovedNa Aba Dados de Conexão – WS, deve ser informado os dados: 

Image Added

• Usuário da Integração: neste campo o  usuário informará o código do  usuário padrão Loja Moodle que será criado pela FIEP, para identificar o cadastro oriundos da Loja FIEP Digital, que  deverão ser enviados ao TOTVS Educacional (SGE). 
• Visão - Consulta de Turmas elegíveis para exportação da Loja: neste campo
• Endereço WebService: Neste parâmetro o usuário deverá informar o Endereço de acesso ao WebService disponibilizado pelo Moodle.
• Usuário: Neste parâmetro o usuário deverá informar o Usuário de acesso ao WebService disponibilizado pelo Moodle.
• Senha: Neste parâmetro o usuário deverá informar a senha de acesso ao WebService disponibilizado pelo Moodle.
• Token acesso (Auto Login): O Token será valor fixo utilizado na autenticação do Moodle através do link externo que será disponibilizado no Portal do Aluno e no Portal do Professor.
• Token acesso (Integração): O Token será valor fixo utilizado na autenticação da Integração com WebService do Moodle
• nome da view (visão de banco de dados) criada pela FIEP para selecionar as turmas do SGE que serão exportadas para a Loja FIEP Digital.
• Status do pedido para efetivar matrícula:  neste campo o usuário deverá informar o status do pedido de venda da Loja,  que a  integração deverá considerar para efetivar a matrícula no SGE. 
• Status de Sucesso: neste campo o usuário deverá informar o status, que o SGE deverá retornar quando a Matrícula foi  efetivada com sucesso.
  
• Status de Erro: neste campo o usuário deverá informar o status, que o SGE deverá retornar quando a Matrícula foi  efetivada com erro.
• Status de inscrição/pagamento pendente: neste campo o usuário deverá informar o status do pedido de venda da Loja, que a integração deverá considerar, quando a matrícula estiver pendente de pagamento,  para descontar vaga na turma no SGE.

Na Aba Parâmetros Por Nível de EnsinoNa Aba Parâmetros Gerais, deve ser informado os dados:Image Removed

• Quantidade dias Envio - Oferta: Neste campo o usuário deverá informar a quantidade de dias, anteriores a Data de Início da Turma/Disciplina no SGE, para a integração enviar a Sala de oferta no Moodle. Esta informação vai definir quantos dias antes do início da turma, a mesma será enviada para o Moodle dando acesso para Alunos e Professores.
• ID Papel Professor: Neste campo o usuário deverá informar o ID do Papel do Professor no Moodle, para a integração enviar o código informado neste parâmetro ao Moodle. Esta informação irá definir qual será o Papel do Professor (Professor não Editor) e poderá ser alterado de acordo com a necessidade da FIEP.
• ID Papel Aluno: Neste campo o usuário deverá informar o ID do Papel do Aluno no Moodle. Essa informação será enviada pela integração do SGE para o Moodle no envio da matrícula/inscrição do aluno e irá definir qual será o Papel do Aluno no Moodle. O valor poderá ser alterado de acordo com a necessidade da FIEP.

• Número tentativas de reenvio: Neste campo o usuário deverá informar o número máximo de tentativas que a customização deverá tentar realizar a integração com Moodle dos registros com status de erro.
• Endereço de e-mail – Inativação de acesso: Definir o e-mail (ou grupo) que deverá receber uma notificação quando algum acesso no Mooddle for suspenso pelo processo de Exportação de Cancelamento e Transferência de matrículas. Para informar mais de um e-mail, basta separá-los por ponto e vírgula (.

Image Removed

Image Removed

Image Removed

Na Aba Disciplinas- Elegíveis, será exibida uma visão onde o usuário deverá informar a (s) disciplinas Elegíveis ao Portal Oficinas, que deverão ser exportadas para o Moodle para gerando uma sala para cada Oficina. Essa situação é específica para o SESI.
Ao clicar em incluir, o campo exibido será do tipo lookup e ficará a cargo do usuário selecionar as disciplinas do cadastro (SDISCIPLINA).

Image Removed

Image Removed

• Modalidade: será do tipo lookup e ficará a cargo do usuário selecionar a modalidade do cadastro nativo (SMODALIDADECURSO) para o qual deseja informar quantidade de dias para suspensão do usuário, de acordo com prazo final de cada Modalidade, definido pela FIEP.
• Qtde. Dias – Suspensão (Usuário): campo do tipo texto onde o usuário deverá informar a quantidade de dias de acordo com a Modalidade do Curso, que serão somadas à data final da Turma/ Disciplina. Esse resultado será enviado como data fim do acesso do usuário (aluno/professor) em determinado curso/sala e seu acesso será suspenso no Moodle.

Image Added

• Status de Matrícula: neste campo  o usuário informará o código de Situação de Matrícula, que será considerado no processo de importação de matrícula,  para matricular o aluno no SGE. Ao clicar em incluir, o campo exibido será do tipo lookup que a selecionar a customização retornará todos os Status de matrícula (SSTATUS) cadastrados para aquele Nível de Ensino.
• Modelo de Contrato: neste campo o usuário informará o código do Modelo de Contrato (Pessoa Física) que será  apresentado no processo customizado de integração do contrato.

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.

Image Added

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.

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.

Image Added

Image Added

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

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

O Contrato só será gerado automaticamente, para os  registro de matrículas importadas com sucesso e o vinculo do Responsável Financeiro, será realizado no cadastro do aluno e não no contrato. 

Detalhamento do processo

O objetivo deste processo  é detalhar a integração das matrículas do TOTVS Educacional, com os contratos financeiros no sistema ERP.

Ao finalizar o processo de Importação de Matrícula a customização irá executar automaticamente o processo customizado Integração de Contrato com Sistema ERP, para gerar o contrato financeiro do aluno. O usuário não terá que preencher os dados de forma manual dentro do SGE, localizado no menu Matrícula e Avaliação | Matrículas | Processos | Integração de Contrato com sistema ERP. Sendo validada as seguintes regras, para calcular valor do contrato e gerar as  parcelas:

Cálculo de Valor:

A informação do valor total do período (Valor Bruto), estará informado na loja, este valor será recebido pelo SGE e será utilizado como base no cálculo dos valores a pagar. 

O preço da primeira parcela para ser cobrado na loja, também será cadastrado manualmente na Loja FIEP Digital, esta informação será o valor do produto selecionado no ato da compra, pelo aluno.

O valor a ser passado como valor do contrato para o ERP será: Valor Bruto (-) menos (%) de desconto concedido no cupom.

Valores das parcelas:

O valor da primeira parcela a ser passada para o ERP deverá ser o valor efetivamente recebido pela Loja FIEP Digital. O valor das demais parcelas, caso ainda haja saldo a pagar, deverá ser calculado com base em: Valor bruto (-) menos (%) de desconto concedido no cupom (caso possua desconto) (-) menos o valor pago da primeira parcela na Loja ( / ) dividido pelo número de parcelas restantes.

Observação: Para as matrículas oriundas do SGE, o valor referência da Matriz Aplicada não terá alteração na regra existente. Já para as matrículas importadas da Loja FIEP Digital para o SGE, o valor será diferente do valor referência da Matriz Aplicada, pois acatará o valor enviado pela Loja (Valor Estadual).

Cálculo de Datas:

Serão mantidas as mesmas regras da customização existente, onde são enviadas para o ERP três conjuntos de datas, citados abaixo:

• Datas de vigência do Contrato AX: data  financeira, as outras datas precisam estar dentro deste período.
• Datas da turma: usada para faturamento (apropriação da receita).
• Data de cada parcela: caso haja saldo a pagar.

Número de parcelas: 

Para calcular o número de parcelas e a data de vencimento das parcelas restantes, a customização deverá considerar uma parcela por mês até o mês em que termina a turma.

A customização deverá manter a regra  existente para tratar as datas finais, para que todo o faturamento e o financeiro estejam dentro da vigência do contrato. 

Caso a data final da turma seja após a data calculada para a última parcela, a customização deverá informar a data final da turma, como data final de vigência do contrato.

Caso a data final da turma seja antes da data calculada para a última parcela, a customização deverá informar a data da última parcela como data final de vigência do contrato.

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

Image Added

Aba Endereço

Image Added

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

Image Added

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.

Image Added

Image Added

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 Moodlea Loja FIEP Digital.
Os históricos das exportações de dados para o Moodle a Loja FIEP serão registrados e poderão ser visualizadas no menu TOTVS Educacional | Customização | Integração Moodle Loja FIEP | Monitor de Log.

Image AddedImage Removed

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

Image RemovedImage Added

• 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 Moodle).
• 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:
Image Removed
Image Added

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