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 

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.

PrintImage 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. Print

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, deve ser informado os dados: (ajustar print) 

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 o usuário deverá informar o 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. Visão - Consulta de Turmas elegíveis para exportação da Loja: neste campo o usuário deverá informar o 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.

Na Aba Parâmetros Por Nível de Ensino, deve ser informado os dados:

PrintImage 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

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.

Print Tela 

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  é  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

Print tela 

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.