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.

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:

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

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

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

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

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.