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
titleGestão de Estoque Loja FIEP

Em desenvolvimento

Expandir
titleExportacao de Oferta de Turma

Pré-requisitos

Realizar carga inicial através da view (visão de banco de dados) que será responsável por selecionar as turmas do SGE que serão exportadas para a Loja FIEP Digital.

Detalhamento do processo

O processo de exportação deverá ser executado em: TOTVS Educacional| Customizações | Integração Loja FIEP Digital | Processos | Exportação de Ofertas, que acionará um método do webservice da Loja FIEP Digital, realizando o envio dos dados de oferta das Turmas cadastradas no SGE, para controlar a oferta de vagas (produtos) na Loja FIEP Digital.

Ao acionar o processo, a customização deverá verificar as seguintes regras para atualização dos dados da loja:

Carga Inicial:
O produto da loja, que corresponde ao Curso/Matriz Curricular do SGE, deverá estar previamente cadastrado na loja virtual, de forma manual (FIEP). A identificação deste produto é dada através do SKU.

Será enviado pelo SGE atualizações dos atributos do produto, que irão compor uma oferta, que serão a Filial, o Turno, a Data de início da Turma e a quantidade de vagas. 

A FIEP irá criar uma view (visão de banco de dados) que será responsável por selecionar as turmas do SGE que serão exportadas para a Loja FIEP Digital. 

A view será responsável por definir toda regra de negócio para seleção das turmas, portanto todos os dados da turma necessários para atualização das informações na loja deverão estar disponíveis na view.

Exclusão de Turmas/Ofertas:

 Após uma turma ser exportada na carga inicial, ela pode deixar de fazer parte da oferta da Loja por não atender mais algum critério da view. Neste caso, o SGE precisa identificar a turma/oferta e enviar a atualização de estoque zerado para a loja, concretizando assim a exclusão da oferta/turma na loja. Caso a turma volte a fazer parte da oferta, ela será enquadrada no item de carga inicial.

Na carga inicial, o SGE irá gravar em tabelas de integração/controle o identificador da oferta (SKU e SKU da variação). Desta forma, será possível identificar os dados da oferta que deixarão de existir na loja. Importante:

Informações

É de responsabilidade da FIEP manter a view atualizada com as turmas que precisam fazer parte da oferta.

Expandir
titleMatrícula do Aluno - Verificação e Atualização de Vagas

Pré-requisitos

Serão consideradas no cálculo do SGE as inscrições efetuadas na loja com status on hold (usuário emitiu o boleto, mas ainda não ocorreu confirmação do pagamento na loja). 


Detalhamento do processo

No momento da matrícula dos alunos diretamente no SGE (via secretaria ou processo seletivo) em turmas que também são ofertadas pela Loja FIEP Digital, serão executadas duas funcionalidades customizadas.

Os processos estão descritos abaixo:

1- Avaliar disponibilidade de vagas (consulta inscrições pendentes de pagamento na Loja):

No momento em que for realizada a matrícula do aluno no SGE, a customização terá que consultar a quantidade de inscrições realizadas na Loja, que ainda não foram integradas (através de webservice da loja), para apurar o total de vagas disponíveis. Caso já tenha atingido a quantidade máxima de alunos a matrícula não poderá ser realizada. 


2- Enviar atualização de vagas disponíveis para a loja:

No momento da matrícula, a customização deverá calcular a quantidade de vagas e atualizar o estoque de vagas da turma na Loja, através da API disponibilizada (mesma API citada acima).

O SGE deverá atualizar a quantidade de vagas na loja baseada no número de alunos matriculados na turma do SGE, através da API da Loja disponibilizada. O valor enviado será calculado utilizando as regras nativas do SGE (interface de aluno, campo Alunos Matriculados).

Para o cálculo, o SGE poderá consultar as vagas atuais da turma e decrementar com a matrícula que ocorreu no SGE .

Expandir
titleAtualização de Vagas - Alterações na Turma

Detalhamento do processo

No momento em que ocorrerem atualizações no cadastro da Turma (ofertada pela Loja), através da interface do SGE, a customização terá que enviar para a Loja a atualização da oferta nas seguintes situações: 

1- Atualização da quantidade de vagas: 

Quando a informação do campo Número máximo de alunos no cadastro da Turma no SGE (STURMA.MAXALUNOS) for atualizada, a customização deverá chamar o Webservice disponibilizado pela Loja FIEP Digital para enviar esse valor, atualizando essa informação na Loja. A quantidade de vagas no SGE será controlada por Turma/Unidade e a Loja FIEP Digital deverá receber a quantidade de vagas de todas as turmas (SKU) vinculadas a uma Matriz Aplicada agrupadas por Período Letivo e Unidade que está realizando a oferta. A Loja FIEP trabalha com a quantidade de vagas/estoque de determinada turma/produto e não armazena a quantidade máxima de alunos por turma. Portanto, a customização deverá calcular a quantidade de vagas disponíveis, considerando as matrículas existentes no SGE e inscrições pendentes na loja e atualizar o campo com a quantidade do estoque de vagas da loja.

Para o cálculo, o SGE poderá consultar as vagas atuais da turma e incrementar ou decrementar com a diferença de vagas que foi ajustada no SGE. Ou ainda, abater do valor informado no campo Máximo de alunos, as matrículas existentes no SGE e as inscrições pendentes de pagamento na loja (status onhold).


Informações

Exemplo: 

Turma 1 SGE - Máximo de alunos = 100 

Loja: 10 inscrições não confirmadas 

SGE: 50 matrículas confirmadas

Vagas disponíveis: 40

Se o máximo de alunos da Turma 1 for ajustado para 150 no SGE, a quantidade de vagas disponíveis na loja deverá ser atualizada para 90. 

Máximo original: 100, novo máximo: 150. Diferença: 50

Vagas atualizadas: 40 (atual) + 50 (diferença) = 90

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.


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.

...