Manual Operacional da customização -

...

Integração Portal SESI

...

Objetivo

Este documento foi elaborado para informar aos usuários chave da área Educacional do SESI, sobre a Integração Portal SESI . A integração O manual a seguir visa detalhar a integração de alguns módulos da solução SGE com o Portal SESI Educaçãoé responsável pela sincronização de algumas entidades, facilitando assim a gestão e acesso aos participantes (alunos, professores, funcionários).

Público Alvo
Este manual é destinado aos colaboradores selecionados como usuários chave do SESI.

Metodologia

Este material tem como base a visão prática e completa do processo customizado da área Educacional através da Integração Portal SESI.

A metodologia utilizada tem como ponto de partida o mapeamento completo do respectivo processo, relacionado com as interfaces no Sistema TOTVS Educacional. Sempre que houver alguma atividade a ser realizada no Sistema, as suas funcionalidades e rotinas serão explicadas com detalhe.

Para utilização da Integração com o Portal SESI Educação é necessário observar alguns pontos:

1. FRAMEHTML configurado e publicado em zona publica e acessível à chamada do Portal SESI Educação;
2. A publicação do FRAMEHTML deve ser feito em DNS público e com certificado válido, disponibilizando em um site HTTPS;
3. As configurações de publicação de serviços customizados no FRAMEHTML devem ter sido realizadas com sucesso;
4. A Instalação Completa da customização, seguindo instruções apresentadas na Guia de instalação e Release Notes;
5. A configuração inicial, com as informações do WebService, Usuário, TOKEN, devem ser preenchidos e a customização ativada (não Habilitada);
6. Campo integrador preenchido (Cadastro de Filial: DFILIAL.CAMPOLIVRE1).
7. Alterar senha de todos os usuários que necessitam ser integrados com o Portal SESI (alunos, responsáveis acadêmicos, professores, funcionários);
8. Preencher

Observação importante: Somente informações relacionadas aos segmentos preenchidos na parametrização serão integrados.

Habilitar os Menus dando permissões aos perfis pertinentes no módulo Globais

Toggle Cloak

Parametrizações

1. todos os parâmetros de DE PARA (descrito neste manual).
   1. Atenção:

1. 1. Esta parametrização é realizada por coligada (SESI – Departamento Regional) e somente para o nível de ensino do SGE – Módulo Educacional Educação Básica (Ensino Básico)
2. Habilitar os menus, dando permissões aos perfis de usuários, conforme demostrado no Gif abaixo:

           Image Added

possui valores para as suas tabelas, campos, cadastros, tipos que

divergem com os valores atuais cadastrados no Portal SESI Educação.

Além das parametrizações descritas acima, é

Para a integração é necessário

ter valores equivalentes aos do Portal SESI Educação, antes de acionar o serviço que efetiva a integração. 

'Cadastro de DE/PARA' foi disponibilizada como um cadastro (ao invés de fixo, hardcore) de maneira a permitir que eventuais novos valores possam ser mapeados (criar o relacionamento, equivalência entre os sistemas) e/ou alterados sem a necessidade de novas codificações. 
No SGE – Módulo Educacional, menu customização, disponibilizamos o Cadastro DE/PARA e neste, o usuário (usualmente o administrador do sistema/integração) irá selecionar o registro (SGE – Módulo Educacional) a que se refere e informar o valor equivalente no sistema destino (Portal SESI Educação).

Deve ser selecionado o tipo de Entidade (Cadastro), que pode ser:

A funcionalidade 'Cadastro de DE/PARA' foi disponibilizada para criar esse relacionamento e equivalência entre os sistemas. 

O Cadastro está disponível no Menu:  TOTVS Educacional | Sistema Industria | Integradores | Portal SESI | DE/PARA da integração

Image Added

A tela de cadastro do DE I PARA é composta por 4 campos que devem ser preenchidos seguindo a ordem: 

1- Entidade (Cadastro): Lista com 6 entidades que devem ter equivalências com o Portal SESI informada. Sendo elas:

• • Curso/segmento,
  • Disciplina
  • Habilitação/Serie
  • Área - Grupo de complemento
  • Área Itinerário
  • Itinerário

Image Added

2- Curso: Lista com todos os cursos cadastrados na base. 

Image Added

3- Valor no TOTVS Educacional: Lista da Entidade e Curso selecionado anteriormente. (No exemplo acima, foi selecionado a Entidade: Disciplina e o Curso: EF II, neste caso o valor no TOTVS Educacional trará todas as disciplinas do EF II).

Image Added

4- Valor no Portal SESI Educação: Onde deve ser informado o código equivalente no Portal SESI Educação 

Nesta entidade devem ser preenchidos os campos:

(validar com responsável pelo portal).

Nesta entidade devem ser preenchidos os campos:

• "Curso" onde deve ser selecionado o Curso para a disciplina;
• "Valor do TOTVS Educacional" onde deve ser selecionada a Disciplina;
• "Valor no Portal SESI Educação" onde deve ser informado o código da disciplina equivalente no Portal SESI Educação (validar com responsável pelo portal) - Em caso de não equivalente o mesmo deve ser preenchido com 0.

Nesta entidade devem ser preenchidos os campos:

• "Curso" onde deve ser selecionado o Curso para a habilitação/serie;
• "Valor do TOTVS Educacional" onde deve ser selecionada a Habilitação/Serie;
• "Valor no Portal SESI Educação" onde deve ser informado o código da habilitação/serie equivalente no Portal SESI Educação (validar com responsável pelo portal).

Nesta entidade devem ser preenchidos os campos:

• "Curso" onde deve ser selecionado o Curso para "Área - Grupo de Complemento";
• "Valor do TOTVS Educacional" onde deve ser selecionada a "Área - Grupo de Complemento";
• "Valor no Portal SESI Educação" onde deve ser informado o código da "Área - Grupo de Complemento" equivalente no Portal SESI Educação (validar com responsável pelo portal) - Em caso de não equivalente o mesmo deve ser preenchido com 0.

[Novo!]

Nesta entidade devem ser preenchidos os campos:

• "Valor do TOTVS Educacional" onde deve ser selecionada a Curso que corresponderá uma área no Portal SESI Educação;
• "Valor no Portal SESI Educação" onde deve ser informado o código da área do itinerário no Portal SESI Educação (validar com responsável pelo portal).

[Novo!]

Nesta entidade devem ser preenchidos os campos:

• "Curso" onde deve ser selecionado o Curso para o Itinerário;
• "Valor do TOTVS Educacional" onde deve ser selecionada o Itinerário;
• "Valor no Portal SESI Educação" onde deve ser informado o código do Itinerário equivalente no Portal SESI Educação (validar com responsável pelo portal).

Ao salvar um novo cadastro de Turma, são realizadas as seguintes validações:

• Caso o campo complementar TURMASESIEDUCACAO não esteja preenchido é validado caracteres especiais no código da turma;

• Tendo preenchido o campo complementar TURMASESIEDUCACAO é validado para caracteres especiais no código ou descrição da Turma SESI preenchido.

• Quando existir log de integração do SGE x Portal SESI Educação no "Monitor de Log", identificando que já fora realizado alguma integração, o campo complementar TURMASESIEDUCACAO ficará bloqueado para edição.

Somente são validadas turmas que pertençam a Cursos parametrizados (parâmetro Curso/Segmento) e quando a integração estiver habilitada.

Ao enviar o Aluno ao Portal SESI Educação, são realizadas as seguintes validações:

1. Validação de email do Aluno (quando aluno não possui o email O365 (SALUNOCOMPL.EMAILO365 preenchido), utilizando serviço de validação de email, que deve ser parametrizado junto aos parâmetros da customização;
2. Validação de email do Responsável Acadêmico (quando preenchido), utilizando serviço de validação de email, que deve ser parametrizado junto aos parâmetros da customização.

Importante: Em caso de novo envio ao Portal SESI com email já tendo sido validado e não tenha sido alterado, é utilizado o ultimo resultado da validação.

Pré-Requisitos / Parametrizações

1. Realizar a parametrização da Integração e preenchimento De/Para;
2. Para envio dos dados do aluno enviamos ao PortalSESI um form-data que convertido em formato JSON são:

AlunoSGE {
    idred (string, obrigatório),
    regional (string, obrigatório),
    inep (string, obrigatório),
    codigointegrador (string, opcional),
    curso (string|AlunoItinerario, opcional),
    perfil (string, obrigatório),
    nome (string, obrigatório),
    codigoexterno (string, obrigatório),
    user_sen (string, opcional),
    sexo (string, obrigatório),
    nasc (DateTime, obrigatório),
    turno (string, opcional),
    segmento (string, obrigatório),
    serie (string, obrigatório),
    turma (string, obrigatório),
    respon_nome (string, opcional),
    respon_cpf (string, opcional),
    respon_email (string, opcional),
    respon_ra (string, opcional),
    respon_sen (string, opcional),
    status (string, obrigatório),
    cpf (string, opcional),
    email (string, opcional),
    emailcomplementar (string, opcional),
}
AlunoItinerario{
    area (string, obrigatório),
    itinerario (string, obrigatório)
}

Campo

Origem

Observações

Caso o GUSUARIO.STATUS for ativo, identificamos de acordo com os parâmetros de Situação de Matrícula correspondendo à Ativo | Inativo | Excluído

Senão enviamos Excluído

Detalhamento do Processo

A exportação de alunos possui a particularidade de exportar não apenas os dados básicos dos alunos, mas também outros dados, como curso (nível de ensino, segmento), turma, turno, série/habilitação (série) – e dados sobre seus responsáveis acadêmicos que estão vinculados ao cadastro do aluno.

Alteração na Integração de Aluno – Integrar somente Matrículas sem Resultado Final e de Períodos Letivos não encerrados

A integração de Aluno envia somente alunos com Matrículas (SMATRICPL) que ainda não possuem o Resultado Final (SMATRICPL.CODSTATUSRES) preenchido e que pertençam a Período Letivo (SPLETIVO) que não estão encerrados, desconsiderando os demais.

[Novo!]

Alteração na Integração de Aluno - Considerar Somente a matrícula mais recente (DTMATRICULA) de turma que já tenham iniciado

A Integração de Aluno considera somente a matrícula no Período Letivo mais recente, considerando assim a que tiver a maior Data de Matricula no período Letivo dentre os cursos parametrizados para integrar (em parâmetros Cursos/Segmentos) e que a turma já tenha iniciado (Data Inicial da turma menor ou igual hoje). Identificado a matrícula mais recente do Aluno, são verificadas as demais consistências para esta matrícula, bem como a verificação se a turma desta matrícula está vigente - Considerando como vigente a turma que a data corrente compreender entre a Data Inicial e Final da Turma.

[Novo!]

Alteração na Integração de Aluno - Desconsiderar matrículas com situação de matrícula indicada para "Não enviar ao Portal SESI"

A Integração de Aluno considera somente as matrículas cuja o status não corresponder a uma das situações de matrícula parametrizadas com o checkbox "Não enviar ao Portal SESI" marcado. De modo que se a matrícula mais recente for uma com uma destas situações de matrícula o sistema irá procurar a próxima mais recente para enviar ao Portal SESI.

Importante: Ao instalar a customização no ambiente de produção é necessário executar o processo de geração de usuário selecionando todos os alunos para que os mesmos realizem a troca de senhas ao fazer login no sistema.

Pré-Requisitos / Parametrizações

DocenteSGE {
    idred (string, obrigatório),
    regional (string, obrigatório),
    inep (string, obrigatório),
    codigointegrador (string, opcional),
    perfil (string, obrigatório),
    codigoexterno (string, obrigatório),
    cpf (string, opcional),
    nome (string, obrigatório),
    email (string, opcional),
    emailcomplementar (string, opcional),
    sexo (string, obrigatório),
    nasc (DateTime, obrigatório),
    status (string, obrigatório),
    aulas (array[Aula], obrigatório),
    user_sen (string, opcional)
}
Aula{
    area (string, obrigatório),
    segmento (string, obrigatório),
    turno (string, obrigatório),
    serie (string, obrigatório),
    turma (string, obrigatório),
    componente (string, obrigatório),
}

Campo

Origem

Observações

Caso o GUSUARIO.STATUS for ativo, enviamos Ativo

Senão enviamos Excluído

Turno

Detalhamento do Processo

A integração (ou exportação) de professores tem como base os registros de professores geridos pelo cadastro de professor "SGE – Módulo Educacional | Currículo e Oferta | Aluno e Professor | Professores" mantidos nas tabelas SPROFESSOR/PPESSOA (dados do professor e dados pessoais do professor) e, como é necessário exportar as disciplinas dos professores, um relacionamento é realizado através da funcionalidade "Turmas/Disciplinas do professor" (SGE – Módulo Educacional | Ofertas | Turmas/Disciplinas | <anexo> Professores) para recuperar suas disciplinas. Somente são exportados Professores cujas as Turmas pertençam a Períodos Letivos não encerrados.

Pré-Requisitos / Parametrizações

FuncionarioSGE {
    idred (string, obrigatório),
    regional (string, obrigatório),
    inep (string, obrigatório),
    codigointegrador (string, opcional),
    perfil (string, obrigatório),
    codigoexterno (string, obrigatório),
    cpf (string, opcional),
    nome (string, obrigatório),
    email (string, obrigatório),
    sexo (string, obrigatório),
    nasc (DateTime, obrigatório),
    status (string, obrigatório),
    user_sen (string, opcional)
}

Nome

Campo

Origem

Observações

Identificador SGE

FuncionarioSGE.idred

"7"

Enviado de forma fixa o valor '7'

Caso preenchido, é enviado o perfil parametrizado nos parâmetros de Funcionários (na parametrização da Integração Portal SESI Educação).

Os Funcionários que não parametrizados são enviados com o perfil padrão (Funcionário Administrativo).

Caso o GUSUARIO.STATUS for ativo, enviamos Ativo

Senão enviamos Excluído

Detalhamento do Processo

O termo 'funcionários' se refere às pessoas designadas a determinadas funções no SGE – Módulo Educacional (secretários escolares, membros da comissão coordenadora e diretores escolares).

Tais registros de 'funcionários' do SGE – Módulo Educacional são pessoas (PPESSOA) associados às funções através dos Menus:

• Filial | Dados Educacionais | <anexo> Diretores por Filial 
• Módulo Educacional | Currículo e Oferta | Estrutura Curricular | Matrizes curriculares | <anexo> Matriz aplicada | <anexo> Comissão Coordenadora'. 

Comissão Coordenadora:

Os membros da Comissão coordenadora devem estar cadastrados conforme abaixo:

Ao incluir uma pessoa no anexo de Comissão coordenadora, será necessário informar a função dessa pessoa na Comissão. Para esses membros temos as cinco funções:

• Coordenador,
• Vice- Coordenador,
• Assistente de coordenador,
• Conselho de coordenação,
• Coordenação pedagógica.

Diretores e secretários:

O cadastro dos Diretores e secretários, serão consultados com base nos dados informados em:

SGE - Módulo Fiscal | Filiais | Dados Educacionais | Diretores por Filial. 

Neste módulo são cadastrados os diretores e secretários.

• Os campos obrigatórios, as parametrizações e os e-mails dos funcionários (seja eles membros da comissão, diretores ou secretários) são validados e se estiverem corretos, são o enviados para o Portal SESI Educação, e seu retorno será gravado na tabela de Log.
• Para que um "funcionário seja exportado, no seu cadastro de pessoal ele deve ter um usuário vinculado, conforme imagem abaixo:

Pré-Requisitos / Parametrizações

Realizar a parametrização da Integração;

Detalhamento do Processo

A Inativação dos usuários de Alunos no Portal SESI Educação ocorre a partir da execução do Processo de Exportação de Inativação de Alunos. Este processo envia os usuários de Alunos a serem inativados no Portal SESI Educação dado o Fim da Vigência da Turma ou Status de resultado final preenchido.

  - É considerado somente a matrícula em Período Letivo mais recente (ultimo período letivo que tenha turma iniciada) para os Cursos/Segmentos parametrizados;
  - O Final da Vigência da turma é identificado quando a Data Corrente é maior que a Data Fim da Turma;
  - Tendo sido preenchido qualquer Situação na Situação de Resultado Final da Matrícula no Período Letivo o Aluno também é considerado para inativação;
  - São enviados somente os Alunos cujo a Data Matrícula mais recente tenha sido realizada após a "Data Referência" (configurada em parâmetros);

  - Não são enviadas inativação referente a matrículas em Filial inativa, sem o Código Integrador preenchido ou que tenha sido realizada antes da "Data Referência" (configurada em parâmetros);

O Processo pode ser agendado em ambientes de 3 camadas:

Importante: Os alunos que forem enviados para inativação, serão enviados apenas uma vez com sucesso para a matrícula, somente caso ocorra erro na inativação do Aluno que o mesmo será enviado novamente na próxima execução do processo. O Reenvio desta exportação se dá na própria execução do processo, não sendo possível enviar unitariamente.

Pré-Requisitos / Parametrizações

Detalhamento do Processo

A Inativação dos usuários de Funcionários no Portal SESI Educação ocorre a partir da inativação do usuário no cadastro do SGE.

Ao acessar o cadastro de um usuário que esteja integrado e ativo no Portal Sesi, desmarcando a flag Ativo será enviado o comando de inativação do usuário ao Portal Sesi Educação.

Pré-Requisitos / Parametrizações

Detalhamento do Processo

A exclusão dos usuários de Professores no Portal SESI Educação ocorre a partir da inativação do usuário no cadastro do SGE.

Para Excluir um professor do Portal SESI, acesse o cadastro do Professor e clique no Usuário, em seguida, desmarque a opção “Ativo” e clique em Salvar para desativar.

Logo após, edite alguma informação do cadastro do professor e clique em Salvar para a customização disparar o gatilho para a exclusão do usuário no Portal SESI:

Caso o professor que deseja excluir ministrava disciplinas que pertencem a um período letivo que esteja com a opção “Período letivo encerrado” marcada, o gatilho da customização não será disparado e não irá gerar log.

Pré-Requisitos / Parametrizações

1. Realizar a parametrização da Integração;

Detalhamento do Processo

O Registro dos usuários são criados apenas no SGE e ao realizar uma alteração nos dados eles são enviados ao Portal SESI Educação, no modelo síncrono, afim de manter os dados dos dois sistemas sincronizados.

Pré-Requisitos / Parametrizações

1. Realizar a parametrização da Integração e preenchimento De/Para;

Detalhamento do Processo

Foi criado um processo customizado no SGE – Módulo Educacional para realizar a integração entre o SGE e o Portal SESI Educação. O processo pode ser acionado via menu ou agendado para executar com periodicidade definida.

• Alunos (e responsáveis pelos alunos);
• Professores (Docentes);
• Funcionários (Diretores Escolares, Secretários Escolares, Orientadores, Coordenadores);
• Reenvio de dados.

Conforme imagem abaixo:

Pré-Requisitos / Parametrizações

1. Realizar a parametrização da Integração e preenchimento De/Para;

Detalhamento do Processo

Durante a exportação dos dados do SGE para o Portal SESI Educação, podem ocorrer erros de validações, por exemplo, impedindo o registro de ser integrado corretamente. Por esse motivo, toda a tentativa de exportação é salva no log customizado para posterior conferência/reenvio.

Uma visão customizada foi criada para que seja possível verificar os dados enviados durante as integrações realizadas. Para cada registro exportado, foi criado um Log nessa tabela contendo os parâmetros utilizados, a entidade integrada.

Observação: Todos os dados são apenas para visualização, não sendo possível a alteração, edição ou exclusão de registros do Log através dessa interface.

Foi desenvolvido um webservice customizado para realização de alteração de e-mail e senha dos usuários, recebendo como parâmetro o código do usuário, a nova senha e e-mail. O método está disponível para visualização no swagger.

Observação: a senha deverá ser informada na codificação Base64, conforme exemplos abaixo:

URL com os parâmetros adicionados: http://localhost:8080/rm/api/TOTVSCustomizacao/Usuario/SincronizarUsuario?codUsuario=lucianom&novaSenha=dG90dnM%3D&[email protected]

Envio da requisição via Postman:

O Método HTTP utilizado é o PUT. Quando a sincronização de usuário for realizada com sucesso, o campo "Sucess" será retornado como "true", e quando ocorrer um erro, será retornado como "false", e o campo "Message" irá detalhar o erro ocorrido, conforme no exemplo abaixo:

A Autenticação a ser utilizada é Basic utilizando usuário e senha do RM com devidas permissões para realização das ações:

Token Inválido

01

Usuário não encontrado

02

E-mail inválido

03

Inconsistências DataServer RM

04

Erro desconhecido

05

Erro ao conectar no RM

06

Foi desenvolvido um webservice customizado que realizará a troca de senha dos usuários, recebendo como parâmetro o código do usuário e a nova senha. O método está disponível para visualização no swagger.

Observação: a senha deverá ser informada na codificação Base64, conforme exemplos abaixo:

URL com os parâmetros adicionados: http://localhost:8080/rm/api/TOTVSCustomizacao/Usuario/SincronizarSenhaUsuario?codUsuario=lucianom&novaSenha=dG90dnM%3D

Envio da requisição via Postman:

O Método HTTP utilizado é o PUT. Quando a alteração de senha for realizada com sucesso, o campo "Sucess" será retornado como "true", e quando ocorrer um erro, será retornado como "false", e o campo "Message" irá detalhar o erro ocorrido, conforme no exemplo abaixo:

Pré-Requisitos / Parametrizações

1. Realizar a parametrização da Integração;

Foram desenvolvidos entry-points que serão executados durante alteração de cadastro de aluno e de matrícula, para exportação dos registros para o Portal SESI Educação. Serão exportados dados de professores e funcionários nos momentos de alterações cadastrais ou associação do professor à turma, do funcionário à comissão coordenadora ou direção da filial.

Detalhamento do Processo

Quando o usuário executar algum dos processos abaixo, o processo de integração será executado de forma síncrona, para o(s) registro(s) selecionado(s).

• Currículo e Oferta | Aluno | <processo> Matricular aluno;
• Currículo e Oferta | Aluno | <anexo> Matriculas no Período letivo | <processo> Alterar situação de matrícula;
• Currículo e Oferta | Aluno | <anexo> Matriculas no Período letivo | <processo> Matricular aluno nas disciplinas;
• Currículo e Oferta | Aluno | <anexo> Matriculas isolada | <processo> > Alterar situação de matrícula;
• Matrícula e Avaliação | Matrículas | <anexo> Matrículas em disciplinas | <processo> Alterar situação de matrícula;
• Matrícula e Avaliação | Matrículas | <anexo> Matrículas em turma mista | <processo> Alterar situação de matrícula;
• Matrícula e Avaliação | Matrícula | Matrículas | <processo> Alterar situação de matrícula;
• Matrícula e Avaliação | Matrícula | Matrículas | <processo> Matricular aluno nas disciplinas;
• Matrícula e Avaliação | Matrícula | Matrículas | <processo> Confirmação de matrícula por pagamento;
• Matrícula e Avaliação | Matrícula | Matrícula isolada | <processo> Alterar situação de matrícula;
• Matrícula e Avaliação | Matrícula | <processo> Rematrícula;
• Matrícula e Avaliação | Matrícula | Mais | <processo> Confirmação de matrícula por pagamento;
• Matrícula e Avaliação | Matrícula | Mais | <processo> Matricula de disciplinas em lote;
• Matrícula on-line;
• Cadastro de pessoas;
• Cadastro do aluno;
• Cadastro de matrículas;
• Estrutura Curricula | Matriz Curricular | Matriz Aplicada | Comissão Coordenadora;
• Cadastro de Filial | Dados Educacionais | Diretores por Filial;
• Currículo e Oferta | Professores;
• Currículo e Oferta | Oferta | Turma Disciplina | Professores;
• Cadastro de usuários (apenas alteração de e-mail/senha dispara a exportação).

• A obrigatoriedade de preenchimento do campo e-mail deverá respeitar a parametrização realizada observando o curso/segmento do aluno que se está processando (exemplos: curso onde o aluno está se matriculando/confirmando matrícula, ou quando alteração do cadastro de aluno, o curso onde está matriculado);

• Obrigatoriedade de responsável acadêmico para menores de 18 anos de acordo com a parametrização por curso/segmento relativo ao curso/segmento do contexto de execução do processo e/ou do curso/segmento relativo ao aluno que se está alterando.

Pré-Requisitos / Parametrizações

1. O código das competências (disciplinas) enviadas pelo Web Service deverão corresponder ao código das disciplinas cadastradas no SGE. Este cadastro é feito manualmente pelos usuários que devem ter atenção para que os dados sejam registrados igualmente entre os sistemas.
2. É necessário que o aluno esteja com apenas uma Matrícula no Período Letivo com situação de matrícula igual a "Reconhecimento de Saberes". As disciplinas FIC e quaisquer outras que estejam cadastradas com status "Matriculado" não são modificadas.
3. Só serão alteradas as informações caso o aluno possua matrícula referente a disciplina, caso contrário não será feita nenhuma alteração e nem gravará nada no log.

Descrição do Processo

O Portal SESI aciona um método customizado capaz de receber dados sobre do aluno e as disciplinas que o aluno já cursou. No momento que o Web Service for acionado a customização identifica para o código do usuário enviado a Matrícula do Período Letivo do aluno com status Reconhecimento de Saberes. O status Reconhecimento de Saberes é determinado pela informação contida no campo Status de Reconhecimento de Saberes dos parâmetros customizados.

Detalhamento do Processo

O Web Service será acionado pelo Portal SESI para alterar o status das matrículas em disciplinas e matrículas no período letivo para alunos com o status "Reconhecimento de Saberes". Para identificar a Matrícula do Período Letivo do aluno a ser alterada, o processo busca as matriculas em disciplinas com status Reconhecimento de Saberes (parametrizado no Req. 01), ou seja, verifica em qual Matrícula do Período Letivo existe uma competência (disciplina) que esteja com status de Reconhecimento de Saberes.

Ao término do processo de importação dos dados via Web Service a situação de Matrícula no Período Letivo será alterada de Reconhecimento de Saberes para Matriculado de acordo com o que foi definido no campo "Status de Matriculado" dos parâmetros automaticamente. 
Para cada disciplina, deverá ser informado um status correspondente a 1 ou 0.

0 = Competência não reconhecida;
1 = Competência reconhecida.

Código

Status

MAT-C1

1

MAT-C2

0

MAT-C3

1

MAT-C4

1

CNT-C1

0

CHT-C1

1

• MAT-C1: Competência Certificada
• MAT-C2: Pré-Matriculado
• MAT-C3: Competência Certificada
• MAT-C4: Competência Certificada
• CNT-C1: Pré-Matriculado
• CHT-C1: Competência Certificada

<div class="post">POST</div>

{
		"idred": 7,
		"regional": "AC",
		"codigoExterno": 1234567,
		"cpf": "862.873.376-05",
		"nome": "Adriano Duarte Cardoso",
		"nomeSocial": "",
		"email": "[email protected]",
		"dataNascimento": "22-04-2000",
		"naturalidade": 4110706,
		"nomeDaMae": "Ivone Duarte Cardoso"
	},
MensagemPSESI: {
		codigo (int, obrigatório),
		descricao (string, obrigatório)
}
RetornoPessoa: {
		iduser (int, obrigatório)
}

<div class="post">POST</div>

{
		"iduser": 9999999,
		"idred": 7,
		"regional": "MG",
		"codigoExterno": 7654321,
		"dadosCadastrais": {
			"nome": "Rafaela Ribeiro Bravo",
			"nomeSocial": "",
			"email": "[email protected]",
			"codigoExterno": 7654321,
			"codUsuario": "14139508922",
			"cpf": "141.395.089-22",
			"senha": "MDQxMTE5zY=",
			"emailcomplementar": null,
			"sexo": "feminino",
			"dataNascimento": "05-11-2010",
			"idRaca": "2",
			"raca": "Branca",
			"naturalidade": 4124103,
			"nomeDaMae": "Wanda Ribeiro Bravo"
		},
		responsavel: {
  		"iduser": 8888888,
  		"nome": "Wanda Ribeiro Bravo",
		"nomeSocial": "",
  		"cpf": "187.685.859-18",
  		"codUsuario": "18768585918",
  		"email": "[email protected]",
 		"sexo": "feminino",
  		"codigoExterno": 7654321,
 		"senha": "MDQxMTE5zY=",
  		"dataNascimento": "05-11-1970",
		"idRaca": "2",
		"raca": "Branca",
		"naturalidade": 4124103,
		"nomeDaMae": "Sônia Maria Bravo"
	}
}

<div class="put">PUT</div>

{
		"iduser": 9999999,
		"idred": 7,
		"regional": "MG",
		"codigoExterno": 7654321,
		"dadosCadastrais": {
			"nome": "Rafaela Ribeiro Bravo",
			"nomeSocial": "RAFAEL",
			"email": "[email protected]",
			"codigoExterno": 7654321,
			"codUsuario": "14139508922",
			"cpf": "141.395.089-22",
			"senha": "MDQxMTE5zY=",
			"emailcomplementar": null,
			"sexo": "feminino",
			"dataNascimento": "05-11-2010",
			"idRaca": "2",
			"raca": "Branca",
			"naturalidade": 4124103,
			"nomeDaMae": "Wanda Ribeiro Bravo"
		},
		responsavel: {
  		"iduser": 8888888,
  		"nome": "Wanda Ribeiro Bravo",
		"nomeSocial": "",
  		"cpf": "187.685.859-18",
  		"codUsuario": "18768585918",
  		"email": "[email protected]",
 		"sexo": "feminino",
  		"codigoExterno": 7654321,
 		"senha": "MDQxMTE5zY=",
  		"dataNascimento": "05-11-1970",
		"idRaca": "2",
		"raca": "Branca",
		"naturalidade": 4124103,
		"nomeDaMae": "Sônia Maria Bravo"
	}
}

<div class="post">POST</div>

{
		"iduser": 10012345,
		"idred": 7,
		"regional": "MG",
		"statusgeral": 1,
		"codigoExterno": 1919191,
		"escolas": [
			{
				"codigoIntegrador": "1234567",
				"ativo": 1
			}
		],
		"dadosCadastrais": {
			"nome": "Tiago Silva Salles",
			"nomeSocial": "",
			"email": "[email protected]",
			"codigoExterno": 1919191,
			"codUsuario": "36718678171",
			"cpf": "367.186.781-71",
			"senha": "MTIzNffNzg=",
			"emailcomplementar": null,
			"sexo": "masculino",
			"dataNascimento": "01-10-1978",
			"idRaca": "10",
			"raca": "Não declarado",
			"naturalidade": 4124400,
			"nomeDaMae": ""
		}