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

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

...