Histórico da Página

...

Expandir

title	Processo de Exportação [Atualizado]

Aviso
Antes de realizar a exportação das entidades ao Portal SESI, certifique-se que todos os parâmetros e configurações citadas acima, estejam preenchidas e com os valores corretos.

Após as configurações descritas acima, o usuário poderá executar o processo de Exportação.

A exportação de dados é responsável pelo envio das seguintes Entidades:

Alunos (e responsáveis acadêmicos)
Docentes
Funcionários (Diretores escolares, secretários Escolares, orientadores, comissão coordenadores)
Turmas
Matriculas
Aulas Docentes
Oficinas (apenas para o Regional Paraná)

Antes de executar o processo é necessário que o usuário entenda as regras de cada Entidade que será integrada.

Aviso
Para que os alunos integrados com sucesso sejam visualizados no Portal SESI Educação, é premissa que também tenham sido integradas as entidades: Turmas e Matrículas.

Informações

title	Clique na entidade e veja as regras ao lado

Section

border	true

Column

width	30

Toggle Cloak

exclusive	true
id	1

Pré Cadastro de Pessoa

Toggle Cloak

exclusive	true
id	2

Integração de Alunos/responsáveis

Toggle Cloak

exclusive	true
id	3

Integração de Turmas [Novo!]

Toggle Cloak

exclusive	true
id	4

Integração de Matrículas [Alterado!]

Toggle Cloak

exclusive	true
id	5

Integração de Docentes

Toggle Cloak

exclusive	true
id	6

Integração de Aulas do Docente

Toggle Cloak

exclusive	true
id	7

Integração de Funcionários

Toggle Cloak

exclusive	true
id	8

Integração de Oficinas

Column

width	70

Cloak

visible	true
id	1

Essa integração antecede o envio de Aluno, Responsável, Docente e Funcionários para o Portal SESI, na intenção de identificar se será aproveitado algum cadastro existente ou criado o pré-cadastro.

Para integração de alunos e responsáveis acadêmicos (para alunos menores de 18 anos), tem como base o cadastro de Pessoa. Sendo assim consideramos:

Campos obrigatórios para integração

Nome
Estado Natal e Naturalidade
Data de nascimento
Sexo
E-mail mail (Exceto para alunos de 0 a 7 anos da Educação Infantil)
Nome da mãe (caso não possua CPF informado)

Campos de envio opcional

CPF
Nome Social
E-mail Complementar (caso o email O365 Esteja preenchido ele será enviado como principal).

Outras validações

Sendo encontrado um registro, o Portal SESI retornará o Iduser* correspondente. *Identificar único da pessoa no Portal SESI.

Cloak

visible	true
id	2

Para integração de alunos e responsáveis acadêmicos (para alunos menores de 18 anos), tem como base o cadastro de Pessoa. Sendo assim consideramos:

Campos obrigatórios para integração

Nome
Estado Natal e Naturalidade
Data de nascimento
Sexo
E-mail mail (Exceto para alunos de 0 a 7 anos da Educação Infantil)
Usuário* (caso o usuário esteja inativo será enviado o comando de inativação ao Portal SESI)
Senha do usuário
Nome da mãe (caso não possua CPF informado)

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

Campos de envio opcional

CPF
Nome Social
E-mail Complementar (caso o email O365 Esteja preenchido ele será enviado como principal)
Raça

Outras validações

E-mail do responsável acadêmico: Será verificado se o responsável acadêmico é também um aluno ou Professor. Caso seja, consultamos se o e-mail do responsável acadêmico (PPESSOA) é o mesmo e-mail do campo complementar a Office 365 (aluno ou professor). Se os e-mails forem idênticos, a validação na Quickemail não será necessária, se forem divergentes, a validação na Quickemail será aplicada respeitando os parâmetros cadastrados.
Notificação de Alerta para E-mail Inválido: Será exibida notificação no cadastro de Aluno, caso seja realizada inclusão ou alteração no e-mail, para validar a sintaxe* do e-mail (*se tem domínio, o @ e ponto caracteres validos) e alertar da importância de um e-mail válido.
Matrículas do aluno: Caso o aluno possua matrícula, é necessário que a mesma esteja com a flag "Enviar ao Portal Sesi" para que o aluno seja integrado.

Cloak

id	3

Para integração é necessário de as Turmas e Turmas/disciplinas sejam cadastras considerando:

Campos obrigatórios para integração

Para turmas e turmas Disciplinas:

Turno
Data inicial
Data final
Código turma¹

Para o Novo Ensino Médico considerar também:

Itinerário Formativo

Outras validações

[Novo!]

¹Será

No caso do Itinerário Formativo, serão consideradas as turmas/disciplinas que fizerem parte da matriz curricular e estejam definidas como parte do Itinerário. As disciplinas do itinerário formativo podem ou não fazer parte da grade de disciplinas, mas para efeito de considerar que elas são do Itinerário Formativo será verificado se o campo "Itinerário Formativo" da Turma/Disciplina está preenchido.

true@TITRequisitos da integração de Turmas/Disciplinas do Itinerário Formativo [Novo!]

@TIT

Serão consideradas como disciplinas do Itinerário Formativo aquelas que estiverem vinculadas à Matriz Curricular no anexo de Itinerários Formativos

No anexo de Disciplinas do Itinerário o campo "Grupo de complemento" será considerado para o DE/PARA

Outras validações

[Novo!] ¹Será verificado se o parâmetro 'Utiliza campo complementar Turma SESI Educação' está marcado.
- Este campo marcado indica que no processo de exportação de
parâmetro 'Utiliza campo complementar Turma SESI Educação' está marcado.
- Este campo marcado indica que no processo de exportação de turmas ao Portal SESI Educação, será considerado como código da turma, o valor informado no campo complementar mencionado.
- Caso desmarcado será considerado o valor do campo nativo da turma 'Código da turma' (STURMA.CODTURMA).
  - RedAtenção Caso o parâmetro esteja marcado o envio do código da turma para o Portal SESI será o campo complementar “Turma Sesi Educação” desde que esteja preenchido. Quando ele não está preenchido a customização envia o Código da Turma (STURMA.CODTURMA).
Campo complementar Enviar ao Portal SESI no cadastro da Turma: Este campo, por padrão estará marcado. Caso seja desmarcado a Turma e seus vínculos não serão considerados na integração com o Portal SESI.

Reenvio de turmas já exportadas [Novo!]

[Novo!] Para as Turmas que já foram enviadas com sucesso para o Portal SESI com o código da Turma, e o Regional necessite reenviar o registro alterando para o envio da informação existente no campo complementar Turma SESI Educação, será necessário:

Alterar/incluir os registros das Turmas para que a integração entenda que o registro sofreu atualização e precisa ser reenviado ao Portal SESI, nesse reenvio serão consideradas as novas regras implementadas neste escopo.
O fato de preencher o campo complementar Turma SESI educação já é uma alteração válida para o reenvio.
Executar o processo de exportação de Turmas.

Cloak

id	4

Serão exportadas as Matriculas dos alunos considerando:

Itens que serão integrados

[Alterado!] Alunos já exportados ao Portal SESI e que estejam matriculados com algum dos Status (status indica) abaixo:

Pré-matrícula: para matrículas no período letivo que estiverem parametrizadas com Situação de Matrícula que o Status Indica estiver preenchido como “Pré-Matriculado” ou “Matriculado” e a Data corrente é menor que a Data Início da Turma. A data da turma não tem interferência na validação desse status;
Matriculado: para matrículas no período letivo que estiverem parametrizadas com Situação de Matrícula que o Status Indica estiver preenchido como “Matriculado” e não forem identificados como Concluinte ou Pré-Matriculado;
Inativo: para matrículas no período letivo que estiverem parametrizadas com Situação de Matrícula que o Status Indica estiver preenchido como “Inativo”.

Importante:

Passaremos a enviar todas as matrículas elegíveis ao Portal SESI educação e não mais somente a última, porém atualizações serão enviadas somente em caso de alteração de situação de matrícula ou resultado, pois estes são os campos enviados que não fazem parte da chave da matrícula.
Considerando que a situação de matrícula ‘Pré matriculado’, possivelmente são de alunos cuja turma em que está vinculado ainda não foi iniciada, caso o aluno não tenha situação de matrícula considerada “Matriculado”, no Portal SESI o aluno permanecerá Inativo, até que esta “Pré-matrícula” tenha mudado para “Matriculado”.
[Novo!] É importante ficar atento à parametrização da situação de matrícula campo "Status indica", pois ele deve estar coerente com o que será enviado para o Portal SESI. A partir da versão 12.1.2402.024 a data inicial da turma não considerada para identificação do Status Indica, passando a valer o DExPARA definido na parametrização.
Assim se o aluno possui uma situação no SGE que o identifica como um pré-matrícula este deve ter o Status indica de pré-matrícula, valendo a mesma regra para as demais situações.

Outras Outras validações

Campo complementar Enviar ao Portal SESI na Matrícula do Período letivo: Este campo, por padrão estará marcado. Caso seja desmarcado essa matrícula não será considerada na integração com o Portal SESI.
A data de início daturma não é considerada um pré-requisito para exportação. Consideramos a data da entrada da pré-matrícula no SGE (exceto para alunos da EJA).

Cloak

id	5

Para integração de Docentes (Professores), tem como base o cadastro de Pessoa. Sendo assim consideramos:

Campos obrigatórios para integração

Nome
Estado Natal e Naturalidade
Data de nascimento
Sexo
E-mail
Usuário (Ativo)
Senha do usuário
Nome da mãe (caso não possua CPF informado)

Campos de envio opcional

CPF
Nome Social
E-mail Complementar (caso o e-mail O365 Esteja preenchido ele será enviado como principal)
Raça

Atenção!

Para que o professor seja exportado, é necessário que ele tenha validar se:

Possui um usuário cadastrado

no SGE e esteja ministrando aula em

e ativo vinculado ao cadastrado do Professor;
Esteja vinculado à uma Turma/Disciplina com data vigente (Data de Início e Fim que compreenda a data que esteja exportando) e que tenha sido informada no cadastro De/Para para disciplinas;
A Turma a qual a Turma/Disciplina esteja vinculada tenha data vigente (Data de Início e Fim que compreenda a data que esteja exportando);
Data vigente (Data de Início e Fim que compreenda a data que esteja exportando) no cadastro do Professor na Turma/Disciplina.

Cloak

id	6

Para integração de Aulas do Docente, será enviado a relação do Docente com as turmas/disciplinas:

Validações

Professores vinculados a turmas/disciplina, já integradas

Verificar as regras de envio das turmas e turmas/disciplinas.

Cloak

id	7

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

Sendo assim, consideramos:

Campos obrigatórios para integração

Nome
Estado Natal e Naturalidade
Data de nascimento
Sexo
E-mail
Usuário* (caso o usuário esteja inativo será enviado o comando de inativação ao Portal SESI)
Senha do usuário
Perfil de funcionário (Cadastrado nos parâmetros)
Nome da mãe (caso não possua CPF informado)

Campos de envio opcional

CPF
Nome Social
E-mail Complementar (caso o e-mail O365 Esteja preenchido ele será enviado como principal)
Raça

Outras validações

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

Cloak

id	8

A integração das Oficinas será tratada em tópico a parte deste manual.

Conhecendo a regra de cada Entidade que será exportada. O usuário poderá executar o processo de Exportação através do Menu:

TOTVS Educacional | Sistema Industria | Integradores | Portal SESI | Exportação de Entidades

Informações
Esse processo poderá ser agendado conforme recurso nativo. O processo de exportação acontece de formar síncrona. O primeiro envio pode levar mais tempo para ser concluído.

Executando manualmente o processo o usuário poderá selecionar uma ou mais entidades.

O resultado da exportação é registrado no Monitor de log da integração, descrito no próximo tópico deste manual.

Após a exportação dos dados, cada exportação gera um determinado registro de Log.

O Monitor de Log, possibilita uma visão dos dados que foram enviados e o retorno de cada exportação. Ele estará disponível no Menu:

TOTVS Educacional | Sistema Industria | Integradores | Portal SESI | DE/PARA da integração

Image Removed

Ao acessar a tela é apresentado todos os Registros da Exportação. Para facilitar o entendimento vamos apresenta-lo por Funcionalidade.

Image Removed

Cada Funcionalidade integrada, traz as informações de Log:

Image Removed

No anexo Item de log, é possível visualizar com mais detalhes os dados exportados:

Image Removed

Na tela do anexo temos acesso a:

Expandir

title	Monitor de log

Informações

title	Clique no item a esquerda e veja a descrição a direita

Section

border	true

Column

width	30

Toggle Cloak

exclusive	true
id	10

Mensagem

Toggle Cloak

exclusive	true
id	20

Dados Enviados

Toggle Cloak

exclusive	true
id	30

Dados Recebidos

Column

width	70

Cloak

visible	true
id	10

Mensagem: descrição geral da execução do processo.

Exemplo: Criação do aluno realizada com sucesso.

Cloak

visible	true
id	20

Dados enviados: Aqui é possível verificar se todos os dados preenchidos foram enviados.

Exemplo de exportação de Pré Cadastro de Pessoa:

Method= POST (criação) ou PUT (atualização)
iduser = identificador único da pessoa no Portal SESI
idred: será enviado fixo “7”
codigoExterno: campo livre 1 (Cadastro de Filial: DFILIAL.CAMPOLIVRE1)

Cloak

id	30

Dados recebidos: retorno da exportação.

Exemplo: “cadastro realizado com sucesso’’

Caso seja apresentado algum erro na exportação, é possível identificar qual regra foi violada, a partir da mensagem apresentada:

Image Removed

No exemplo acima, o Pré cadastro de pessoa nao foi exportado porque o "O campo Email não é um endereço de email válido."

Nesta situação, o usuário poderá corrigir o campo e realizar o reenvio desse log, através do Processo: Reenvio de dados:

Image Removed

Expandir

title	Atualização de dados [Atualizado]

Os dados referentes a alunos, docentes e funcionários estão sujeitos a modificações após a exportação inicial. Quando essas alterações ocorrerem, ao realizar o processo de exportação novamente, a customização enviará ao Portal SESI apenas os campos que foram modificados.

Vale ressaltar que os campos que foram alterados não serão exportados novamente.

Estado

colour	Green
title	Exemplo:

Aluno na criação (Method =POST) não tinha registro de nome social. Atualizando o cadastro do aluno com a inclusão do nome social e realizado a exportação novamente, foi enviada a atualização (Method = PUT) com o nome social cadastrado (JULIO):

Image Removed Image Removed

Aviso

title	Reenvio de turmas já exportadas

[Novo!] Considerando a nova regra, onde o campo complementar: Turma SESI Educação, pode ser considerado:

Para as Turmas que já foram enviadas com sucesso para o Portal SESI com o código da Turma (STURMA.CODTURMA), e o Regional necessite reenviar o registro alterando para o envio da informação existente no campo complementar Turma SESI Educação, será necessário:

Alterar/incluir os registros das Turmas para que a integração entenda que o registro sofreu atualização e precisa ser reenviado ao Portal SESI, nesse reenvio serão consideradas as novas regras implementadas neste escopo.
O fato de preencher o campo complementar Turma SESI educação já é uma alteração válida para o reenvio.
Executar o processo de exportação de Turmas.

	Integração - Gatilhos

Pré-Requisitos / Parametrizações

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

Detalhamento do Processamento

Foram desenvolvidos pontos de gatilhos que serão acionados durante a modificação de cadastro de aluno e de matrícula, para a exportação dos dados para o Portal SESI Educação. Dados de professores e funcionários serão exportados em situações de mudanças cadastrais ou quando houver associação do professor a uma turma, do funcionário a uma comissão coordenadora ou à diretoria da filial.

Quando o usuário executar alguma alteração nos cadastros ou realizar a execução dos processos abaixo, a integração será executada para o(s) registro(s) selecionado(s).

Cadastros:

Cadastro de Pessoas.
Cadastro de Aluno.
Cadastro de Matrículas.
Matrícula on-line.
Cadastro de Turmas.
Cadastro de Professores.
Currículo e Oferta | Oferta | Turma Disciplina | Professores;
Estrutura Curricula | Matriz Curricular | Matriz Aplicada | Comissão Coordenadora.
Cadastro de Filial | Dados Educacionais | Diretores por Filial.
Cadastro de Usuários (apenas para alterações de e-mail/senha).

Processos:

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ícula | Matrículas | <anexo> Matrículas em disciplinas | <processo> Alterar situação de matrícula.
Matrícula e Avaliação | Matrícula | 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.

Filtragem dos Registros para Integração:
Apenas os registros de alunos cujo curso/segmento estejam configurados para integração serão processados.Somente as matrículas que estiverem em situações cadastradas como "situações de matrícula" serão incluídas na integração.

Validações Antes do Envio:
E-mail: O preenchimento do campo de e-mail será obrigatório conforme a configuração do curso/segmento do aluno em questão (por exemplo, no momento da matrícula ou alteração de cadastro).
Responsável Acadêmico: Para alunos menores de 18 anos, a presença de um responsável acadêmico será exigida, de acordo com as regras definidas para o curso/segmento relacionado ao aluno ou ao processo em execução.

Processamento e Integração:
As rotinas do sistema identificarão automaticamente os alunos envolvidos no processo (podendo ser mais de um ao mesmo tempo) e enviarão suas informações para integração.
As regras de integração (como coleta de dados, mapeamento de campos e validações) seguirão o mesmo padrão já utilizado para a integração de alunos. A integração ocorrerá apenas para os alunos cujas chaves primárias forem fornecidas.

Resultado da Integração:
Após a integração, o sistema avaliará o resultado (sucesso ou falha) para cada aluno.Um registro de log será gerado, contendo informações sobre o aluno, o status da integração e, em caso de erro, a mensagem de erro correspondente.

Tratamento de Erros:
Se ocorrer algum erro durante a integração, o processo principal não será interrompido. No entanto, o erro será registrado no log, e a integração com o Portal SESI Educação não será realizada para os registros afetados.

Exportação de Dados de Funcionários e Professores:
Apenas os cadastros de funcionários e professores que possuírem um usuário associado e atenderem às regras de validação de campos obrigatórios serão exportados.

Expandir

title	Monitor de log

Após a exportação dos dados, cada exportação gera um determinado registro de Log.

O Monitor de Log, possibilita uma visão dos dados que foram enviados e o retorno de cada exportação. Ele estará disponível no Menu:

TOTVS Educacional | Sistema Industria | Integradores | Portal SESI | DE/PARA da integração

Image Added

Ao acessar a tela é apresentado todos os Registros da Exportação. Para facilitar o entendimento vamos apresenta-lo por Funcionalidade.

Image Added

Cada Funcionalidade integrada, traz as informações de Log:

Image Added

No anexo Item de log, é possível visualizar com mais detalhes os dados exportados:

Image Added

Na tela do anexo temos acesso a:

Informações

title	Clique no item a esquerda e veja a descrição a direita

Section

border	true

Column

width	30

Toggle Cloak

exclusive	true
id	10

Mensagem

Toggle Cloak

exclusive	true
id	20

Dados Enviados

Toggle Cloak

exclusive	true
id	30

Dados Recebidos

Column

width	70

Cloak

visible	true
id	10

Mensagem: descrição geral da execução do processo.

Exemplo: Criação do aluno realizada com sucesso.

Cloak

visible	true
id	20

Dados enviados: Aqui é possível verificar se todos os dados preenchidos foram enviados.

Exemplo de exportação de Pré Cadastro de Pessoa:

Method= POST (criação) ou PUT (atualização)
iduser = identificador único da pessoa no Portal SESI
idred: será enviado fixo “7”
codigoExterno: campo livre 1 (Cadastro de Filial: DFILIAL.CAMPOLIVRE1)

Cloak

id	30

Dados recebidos: retorno da exportação.

Exemplo: “cadastro realizado com sucesso’’

Caso seja apresentado algum erro na exportação, é possível identificar qual regra foi violada, a partir da mensagem apresentada:

Image Added

No exemplo acima, o Pré cadastro de pessoa nao foi exportado porque o "O campo Email não é um endereço de email válido."

Nesta situação, o usuário poderá corrigir o campo e realizar o reenvio desse log, através do Processo: Reenvio de dados:

Image Added

Expandir

title	Atualização de dados [Atualizado]

Os dados referentes a alunos, docentes e funcionários estão sujeitos a modificações após a exportação inicial. Quando essas alterações ocorrerem, ao realizar o processo de exportação novamente, a customização enviará ao Portal SESI apenas os campos que foram modificados.

Vale ressaltar que os campos que foram alterados não serão exportados novamente.

Estado

colour	Green
title	Exemplo:

Aluno na criação (Method =POST) não tinha registro de nome social. Atualizando o cadastro do aluno com a inclusão do nome social e realizado a exportação novamente, foi enviada a atualização (Method = PUT) com o nome social cadastrado (JULIO):

Image Added Image Added

Aviso

title	Reenvio de turmas já exportadas

[Novo!] Considerando a nova regra, onde o campo complementar: Turma SESI Educação, pode ser considerado:

Para as Turmas que já foram enviadas com sucesso para o Portal SESI com o código da Turma (STURMA.CODTURMA), e o Regional necessite reenviar o registro alterando para o envio da informação existente no campo complementar Turma SESI Educação, será necessário:

Alterar/incluir os registros das Turmas para que a integração entenda que o registro sofreu atualização e precisa ser reenviado ao Portal SESI, nesse reenvio serão consideradas as novas regras implementadas neste escopo.
O fato de preencher o campo complementar Turma SESI educação já é uma alteração válida para o reenvio.
Executar o processo de exportação de Turmas.

Expandir

title	Acesso ao Portal SESI via Portal do Aluno

Foi incluído no Portal do aluno, um menu para que ele acesse o Portal SESI.

Quando os alunos clicarem nesse link, eles serão direcionados automaticamente para o Portal SESI, onde serão autenticados automaticamente, sem a necessidade de inserir suas informações de login novamente.

Image Added

Expandir

title	Acesso ao Portal SESI via Portal do Professor

Também foi incluído no Portal do professor, um menu para que ele acesse o Portal SESI.

Quando os professores clicarem nesse link, eles serão direcionados automaticamente para o Portal SESI, onde serão autenticados automaticamente, sem a necessidade de inserir suas informações de login novamente.

Image Added

Foi incluído no Portal do aluno, um menu para que ele acesse o Portal SESI.

Quando os alunos clicarem nesse link, eles serão direcionados automaticamente para o Portal SESI, onde serão autenticados automaticamente, sem a necessidade de inserir suas informações de login novamente.

Image Removed

Expandir

title	Inativação de Alunos

Com base no controle dos dados mais recentes integrados das Matrículas do Aluno, passaremos a enviar a atualização de inativação do aluno utilizando o serviço “Matrículas do Aluno”.

Neste processo, deve-se considerar a parametrização do Requisito 01 do escopo FS008994 - Integração Portal SESI - Melhorias na Integração - Parte 1, que identifica as Situações de Matrícula e seus respectivos Status. Para cada situação, será considerado o valor a ser enviado.

Uma situação especial a ser considerada é a de Concluinte, que não está designada na parametrização. Essa condição é identificada quando o aluno apresenta a Situação de Matrícula com Status Indica “Matriculado” e a matrícula se enquadra em um dos seguintes cenários:

Data corrente não compreende o período da Turma, Data Início e Data Fim;
Possuem Resultado preenchido;

O campo statusMatricula será então preenchido condicionalmente considerando as seguintes possibilidades:

1.Pré-Matriculado (2): para matrículas no período letivo que estiverem parametrizadas com Situação de Matrícula que o Status Indica estiver preenchido como “Pré-Matriculado” ou “Matriculado” e a Data corrente é menor que a Data Início da Turma;

2.Concluinte (4): para matrículas no período letivo que estiverem parametrizadas com Situação de Matrícula que o Status Indica estiver preenchido como “Matriculado” e atenderem ao menos uma das seguintes regras:

1. Data corrente é maior que a Data Fim da Turma;
2. Possuem Resultado preenchido.

3. Matriculado (3): para matrículas no período letivo que estiverem parametrizadas com Situação de Matrícula que o Status Indica estiver preenchido como “Matriculado” e não forem identificados como Concluinte (4) ou Pré-Matriculado (2);

4. Inativo (0): para matrículas no período letivo que estiverem parametrizadas com Situação de Matrícula que o Status Indica estiver preenchido como “Inativo”;

Expandir

title	Acesso ao Portal SESI via Portal do Aluno

Expandir

title	Acesso ao Portal SESI via Portal do Professor

Também foi incluído no Portal do professor, um menu para que ele acesse o Portal SESI.

Quando os professores clicarem nesse link, eles serão direcionados automaticamente para o Portal SESI, onde serão autenticados automaticamente, sem a necessidade de inserir suas informações de login novamente.

Image Removed

Expandir

title	Inativação de Docentes

Sempre que houver a necessidade de Inativação de um docente no Portal SESI, o usuário deverá seguir o processo para inativação, conforme descrito abaixo:

Acesse o Menu: TOTVS Educacional | Currículo e oferta | Professores | Processos | Inativação de Professor - Portal SESI

Será apresentado na tela do lado esquerdo a lista de professores selecionados e que já foram exportados para o Portal SESI.
Ao Clicar em um registro do lado esquerdo, aparecerá do Lado direito da tela as filais que ele está vinculado.
Selecionar do lado direito em qual filial o docente será inativado.

Avançar a tela, os docentes e filiais selecionadas, serão apresentadas em árvore para que o usuário visualize a estrutura que faz parte da Inativação.

Após a execução do processo, a data final do vínculo do professor com turmas/disciplinas será alterada.

Os registros desse processo são gravados no Monitor de log.

...

Expandir

title	Dados técnicos

Expandir

title	Pré cadastro de Pessoa

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

Deverá ser utilizado antes do envio de uma pessoa (Aluno/Responsável/Docente/Funcionários) para o Portal SESI na intenção de identificar se reaproveita algum cadastro existente ou cria o pré-cadastro retornando o iduser correspondente.

Tabelas Afetadas: PPESSOA

Authorization - Basic Auth

Username <username>

Token <token>

Body

Bloco de código

language	c#
title	Raw

{
		"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)
}

Content

Idred: Identificador enviado de forma fixa o valor ‘7’.
Regional: Estado do cadastro da Coligada.
Código Externo: Código da Pessoa.
CPF: CPF da pessoa no SGE
Nome: Nome da pessoa no SGE (Campo Obrigatório).
Nome social: Nome social da pessoa.
E-mail: Endereço de e-mail, que será gravado no campo do cadastro da Pessoa. (Campo Obrigatório).

Quando Aluno: Caso o e-mail O365 (SALUNOCOMPL.EMAILO365) esteja preenchido este é enviado como principal, do contrário o e-mail do cadastro de pessoa (PPESSOA.EMAIL) do aluno é enviado.

Quando Responsável: E-mail do cadastro de pessoa (PPESSOA.EMAIL) do Responsável é enviado.

Quando Professor: Caso o e-mail O365 (SPROFESSORCOMPL.EMAILO365) esteja preenchido este é enviado como principal, do contrário o e-mail do cadastro de pessoa (PPESSOA.EMAIL) do professor é enviado.

Quando Funcionário: E-mail do cadastro de pessoa (PPESSOA.EMAIL) do Funcionário é enviado.

Data de Nascimento: Data de Nascimento do Aluno no SGE (Campo Obrigatório).
Naturalidade: Naturalidade do Aluno no SGE (Campo Obrigatório). (DCODIFICACAOMUNICIPIO.CODIGO: Quando preenchido pelo cadastro de Município enviaremos: Código do IBGE recuperado pela Codificação de Município da Classificação correspondente ao IBGE, informado nos parâmetros. Caso esteja preenchido por texto enviaremos de forma fixa “1000001”).
Nome da Mae: Nome da mãe do aluno. ( Obrigatório caso não possua CPF informado).

Retorno

Usuário Criado com Sucesso: HTTP Code 201 - Body: RetornoPessoa

Campo de Dados	Tipo	Obrig	Descrição	Schema
idUser	Body \| Json	Sim	Identificador do usuário	Int32

Usuário Atualizado com Sucesso: HTTP Code 200 - Body: RetornoPessoa

Campo de Dados	Tipo	Obrig	Descrição	Schema
idUser	Body \| Json	Sim	Identificador do usuário	Int32

Possíveis retorno de erro:

Autenticação Inválida: HTTP Code 401 - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador do erro	Int32
descricao	Body \| Json	Sim	Descrição do Erro	string

Regra não atendida: HTTP Code 400 - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador do erro	Int32
descricao	Body \| Json	Sim	Descrição do Erro	string

Erro geral: HTTP Code 50x - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador do erro	Int32
descricao	Body \| Json	Sim	Descrição do Erro	string

Importante: Caso já tenhamos o idUser para o Cadastro de Pessoa utilizaremos o que já tivermos gravado e não chamaremos a API de Pré-Cadastro da Pessoa.

Expandir

title	Integração de Aluno / responsável

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

Deverá ser utilizado o iduser retornado no serviço PessoaSGE para efetivar o cadastro do aluno informando o correspondente a pessoa do aluno e o correspondente ao Responsável, os quais serão enviados todos seus dados pertinentes, mesmo que se repitam alguns nesta primeira interação de criação de aluno.

Tabelas Afetadas: SALUNO, PPESSOA

Interface RM: TOTVS Educacional | Educacional | Currículo e Oferta | Alunos

Authorization - Basic Auth

Username <username>

Token <token>

Body

Bloco de código

language	c#
title	Raw

{
		"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"
	}
}

Content

Iduser: Identificador da Pessoa Recuperado pelo serviço de Pré-Cadastro da Pessoa, do Portal SESI.
Idred: Identificador enviado de forma fixa o valor ‘7’.
Regional: Estado do cadastro da Coligada.
Código Externo: Código da Pessoa.
Nome: Nome do Aluno no SGE (Campo Obrigatório).
Nome social: Nome social do cadastro
E-mail: Endereço de e-mail do Aluno, que será gravado no campo do cadastro da Pessoa. (Campo Obrigatório);
Código do usuário: Código do usuário no SGE.
CPF: CPF do Aluno no SGE
Senha: Senha do usuário no SGE
E-mail complementar: Caso o e-mail O365 (SALUNOCOMPL.EMAILO365) esteja preenchido o e-mail do cadastro de pessoa (PPESSOA.EMAIL) do aluno é enviado como e-mail complementar, do contrário nenhum e-mail é enviado como complementar.
Sexo: Correspondendo a 'Feminino' I 'Masculino' (Campo Obrigatório);
Data de Nascimento: Data de Nascimento do Aluno no SGE (Campo Obrigatório).
Raça: Identificador da raça
Naturalidade: Naturalidade do Aluno no SGE (Campo Obrigatório). (DCODIFICACAOMUNICIPIO.CODIGO: Quando preenchido pelo cadastro de Município enviaremos: Código do IBGE recuperado pela Codificação de Município da Classificação correspondente ao IBGE, informado nos parâmetros. Caso esteja preenchido por texto enviaremos de forma fixa “1000001”).
Nome da Mae: Nome da mãe do aluno. ( Obrigatório caso não possua CPF informado).
Email: Endereço de e-mail do Aluno, que será gravado no campo do cadastro da Pessoa.

Retorno

Aluno Criado com Sucesso: HTTP Code 201 - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador da mensagem	Int32
descricao	Body \| Json	Sim	Descrição da mensagem	String

Aluno Atualizado com Sucesso: HTTP Code 200 - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador da mensagem	Int32
descricao	Body \| Json	Sim	Descrição da mensagem	String

Possíveis retorno de erro:

Autenticação Inválida: HTTP Code 401 - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador do erro	Int32
descricao	Body \| Json	Sim	Descrição do Erro	string

Regra não atendida: HTTP Code 400 - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador do erro	Int32
descricao	Body \| Json	Sim	Descrição do Erro	string

Erro geral: HTTP Code 50x - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador do erro	Int32
descricao	Body \| Json	Sim	Descrição do Erro	string

Importante: Caso já tenhamos enviado com o Aluno com Sucesso, será utilizado o serviço de Atualização do Aluno.

Expandir

title	Atualização do aluno

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

Body

Bloco de código

language	c#
title	Raw

{
		"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"
	}
}

Expandir

title	Docente

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

Deverá ser utilizado o iduser retornado no serviço PessoaSGE para efetivar o cadastro do docente informando o correspondente a pessoa do docente, o qual será enviado todos seus dados pertinentes, mesmo que se repitam alguns nesta primeira interação de criação de docente.

Tabelas Afetadas: SALUNO, PPESSOA

Interface RM: TOTVS Educacional | Educacional | Currículo e Oferta | Professores

Authorization - Basic Auth

Username <username>

Token <token>

Body

Bloco de código

language	c#
title	Raw

{
		"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": ""
		}

Content

Iduser: Identificador da Pessoa Recuperado pelo serviço de Pré-Cadastro da Pessoa, do Portal SESI.
Idred: Identificador enviado de forma fixa o valor ‘7’.
Regional: Estado do cadastro da Coligada.
Código integrador: Cadastro de Filial (DFILIAL.CAMPOLIVRE1)
Ativo: Correspondente ao status do usuario no SGE (Verificamos o GUSUARIO.STATUS para definição de Ativo (1) e Inativo(0).
Código Externo: Código da Pessoa.
Nome: Nome do professor no SGE (Campo Obrigatório).
Nome social: Nome social do cadastro
E-mail: Endereço de e-mail do professor, que será gravado no campo do cadastro da Pessoa. (Campo Obrigatório). Caso o e-mail O365 (SPROFESSORCOMPL.EMAILO365) esteja preenchido este é enviado como principal, do contrário o e-mail do cadastro de pessoa (PPESSOA.EMAIL) do professor é enviado.
Código do usuário: Código do usuário no SGE.
CPF: CPF do professor no SGE
Senha: Senha do usuário no SGE
E-mail complementar: Caso o email O365 (SPROFESSORCOMPL.EMAILO365) esteja preenchido o email do cadastro de pessoa (PPESSOA.EMAIL) do professor é enviado como email complementar, do contrário nenhum email é enviado como complementar.
Sexo: Correspondendo a 'Feminino' I 'Masculino' (Campo Obrigatório);
Data de Nascimento: Data de Nascimento do professor no SGE (Campo Obrigatório).
Raça: Identificador da raça
Naturalidade: Naturalidade do professor no SGE (Campo Obrigatório). (DCODIFICACAOMUNICIPIO.CODIGO: Quando preenchido pelo cadastro de Município enviaremos: Código do IBGE recuperado pela Codificação de Município da Classificação correspondente ao IBGE, informado nos parâmetros. Caso esteja preenchido por texto enviaremos de forma fixa “1000001”).
Nome da Mae: Nome da mãe do professor. ( Obrigatório caso não possua CPF informado).
Email: Endereço de e-mail do professor, que será gravado no campo do cadastro da Pessoa.

Retorno

Docente Criado com Sucesso: HTTP Code 201 - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador da mensagem	Int32
descricao	Body \| Json	Sim	Descrição da mensagem	String

Docente Atualizado com Sucesso: HTTP Code 200 - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador da mensagem	Int32
descricao	Body \| Json	Sim	Descrição da mensagem	String

Possíveis retorno de erro:

Autenticação Inválida: HTTP Code 401 - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador do erro	Int32
descricao	Body \| Json	Sim	Descrição do Erro	string

Regra não atendida: HTTP Code 403 - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador do erro	Int32
descricao	Body \| Json	Sim	Descrição do Erro	string

Erro geral: HTTP Code 50x - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador do erro	Int32
descricao	Body \| Json	Sim	Descrição do Erro	string

Importante: Caso já tenhamos enviado com o Docente com Sucesso, será utilizado o serviço de Atualização do Docente.

Expandir

title	Atualização do Docente

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

Body

Bloco de código

language	c#
title	Raw

{
		"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": [email protected],
			"sexo": "masculino",
			"dataNascimento": "01-10-1978",
			"idRaca": "10",
			"raca": "Não declarado",
			"naturalidade": 4124400,
			"nomeDaMae": ""
		}

Expandir

title	Turma

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

Tabelas Afetadas: STURMA , STURMADISC

[Novo!] Para Turmas do Itinerário Formativo a estrutura do JSON é diferente da Turma que não é do Itinerário Formativo.

Authorization - Basic Auth

Username <username>

Token <token>

Body [Novo!]

Bloco de código

language	c#
title	Raw

{
		"idturma": "223344EMNEM-M-3C/2024",
		"idred": 7,
		"regional": "MG",
		"codigoIntegrador": "1234567",
		"turno": 1,
		"segmento": "18",
		"dataInicio": "29-01-2024",
		"dataFim": "11-12-2024",
		"serie": "3",
		"codTurma": "EMNEM-M-3C/2024",
		"itinerario": {
			"itinerario": "56"
			"grupo": "55"
		},
		"turmaDisciplina": [
			{
				"idTurmaDisc": 86537,
				"disciplinagrupo": "9",
				"area": "5"
			},
			{
				"idTurmaDisc": 86538,
				"grupo": "10",
				"disciplina    "itinerario": "11001",
				"area": "5"
			},
			{
				"idTurmaDisc": 86539,
				"disciplina": "10",
				"area": "5"
			},
			{
				"idTurmaDisc": 86540,
				"disciplina": "6",
				"area": "20"
			},
			{
				"idTurmaDisc": 86541,
				"disciplina": "2",
				"area": "20"
			},
			{
				"idTurmaDisc": 86542,
				"disciplina": "1",
				"area": "10"
			},
			{
				"idTurmaDisc": 86549,
				"disciplina": "183",
				"area": "15"
			},
			{
				"idTurmaDisc": 86550,
				"disciplina": "187",
				"area": "15"
			},
			{
				"idTurmaDisc": 86551,
				"disciplina": "8",
				"area": "15"
			},
			{
				"idTurmaDisc": 86552,
				"disciplina": "188",
				"area": "10"
			},
			{
				"idTurmaDisc": 90266,
				"disciplina": "",
				"area": "5"
			},
			{
				"idTurmaDisc": 86543,
				"disciplina": "3",
				"area": "15"
			},
			{
				"idTurmaDisc": 86544,
				"disciplina": "24",
				"area": "15"
			},
			{
				"idTurmaDisc": 86545,
				"disciplina": "25",
				"area": "15"
			},
			{
				"idTurmaDisc": 86546,
				"disciplina": "77",
				"area": "20"
			},
			{
				"idTurmaDisc": 86547,
				"disciplina": "184",
				"area": "15"
			},
			{
				"idTurmaDisc": 86548,
				"disciplina": "186",
				"area": "10"
			}
		]
	}

Content

Id. Turma: Identificador enviado de forma fixa o valor ‘7’.
Idred: Identificador enviado de forma fixa o valor ‘7’.
Regional: Estado do cadastro da Coligada.
Código integrador: Cadastro de Filial (DFILIAL.CAMPOLIVRE1).
Turno: Correspondendo à 'Manhã' | 'Noite' | 'Tarde' | 'Integral'.
Segmento: De/Para de Segmento correspondente ao Campo.
Data início: Data de Inicial da Turma formatado em “dd-MM-yyyy”.
Data fim: Data de Final da Turma formatado em “dd-MM-yyyy”.
Serie: De/Para de Serie correspondente ao Campo.
Código da turma: Código da Turma.
Grupo: De/Para de Área do Itinerário da Turma correspondente ao Campo.
Itinerário: De/Para de Itinerário correspondente ao Campo.
Id. Turmadisc: identificador da Turma/Disciplina.
Área: De/Para de Área - Grupo de Complemento correspondente ao Campo.

Retorno

Turma Atualizada com Sucesso: HTTP Code 200 - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador da mensagem	Int32
descricao	Body \| Json	Sim	Descrição da mensagem	String

Turma Criada com Sucesso: HTTP Code 201 - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador da mensagem	Int32
descricao	Body \| Json	Sim	Descrição da mensagem	String

Possíveis retorno de erro:

Autenticação Inválida: HTTP Code 401 - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador do erro	Int32
descricao	Body \| Json	Sim	Descrição do Erro	string

Regra não atendida: HTTP Code 403 - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador do erro	Int32
descricao	Body \| Json	Sim	Descrição do Erro	string

Erro geral: HTTP Code 50x - Body: MensagemPSESI

Campo de Dados	Tipo	Obrig	Descrição	Schema
codigo	Body \| Json	Sim	Identificador do erro	Int32
descricao	Body \| Json	Sim	Descrição do Erro	string

Importante: Todas as Turmas pertinentes a integração com Portal SESI educação que tiverem ao menos um aluno matriculado ou professor em turma/disciplina serão enviadas por completo.

...

Expandir

title	FAQ

Toggle Cloak

FAQ [Novo!]

Cloak

false

Erro Not Found: Envio de Funcionários

A inconsistência apresentada está relacionada à indisponibilidade do WebService vinculado ao Portal Sesi, o que pode ser atribuído a dois fatores principais:

API do portal não estar acessível no momento ou
Configuração inadequada do WebService.

Orientamos entrar em contato com o DN ou Educar Brasil para validações.

Erro: Method not Found: Exportação de Entidades

É fundamental verificar se o parâmetro SIGLADR está devidamente preenchido na Gestão CNI > Parâmetros Gerais.

Se o parâmetro estiver preenchido, recomenda-se solicitar imediatamente a reinstalação da biblioteca LIB DN em todos os servidores que compõem o ambiente. Antes da reinstalação, é aconselhável interromper os serviços de host.

Essa ação garantirá que todas as instâncias do sistema operem com a versão mais recente e funcional da biblioteca, reduzindo erros e aprimorando a performance geral do sistema.

Integração de Matrículas: Envio de várias matrículas para um mesmo aluno

Matrículas Múltiplas em Períodos Letivos Distintos

Neste exemplo, temos as seguintes matrículas:

Matrícula em andamento: Turma NEJAAFCZS24 - Nova EJA Ensino Médio, com status RDS (Reconhecimento de Saberes) e valor atribuído de "3".
Matrícula finalizada: Turma NEJAAFCZ24 - Nova EJA Ensino Fundamental Anos Finais, com valor atribuído de "0".

Análise: A possibilidade de um aluno ter mais de uma matrícula em períodos letivos diferentes, dentro de um único envio (request), está prevista na Integração Portal SESI 2.0.

Esta integração permite o envio de todas as matrículas cujo status esteja devidamente parametrizado, desde que o parâmetro "Não Enviar ao Portal SESI" esteja desmarcado.

Erro 401 Unauthorized: Comunicação entre API e Educar indisponível

Erro 401 UnathorizedNeste exemplo, ocorreu um erro 401 Unauthorized, indicando que a comunicação entre a API e o Educar está indisponível.

Para resolver essa questão, recomendamos os seguintes passos:

Verificar a configuração dos dados da integração:

Endereço de acesso ao webservice de integração, disponibilizado pela Educar Brasil;
Usuário do Portal SESI Educação para o consumo do webservice, disponibilizado pela Educar Brasil;
Chave de verificação para o consumo do webservice, disponibilizado pela Educar Brasil.

2. Caso persista, proceder a execução dos processos:

Desinstalar a customização do Portal SESI.
Verificar a pasta Custom (C:\TOTVS\CorporeRM\RM.Net\Custom) para identificar e excluir quaisquer DLL's relacionadas à customização.
Reinstalar as versões mais recentes das bibliotecas Win e Web.
Ajustar as tags Runservice e Owin: definir AutomaticAppStartup como True.
Revisar e ajustar o alias dos arquivos web.config.
Verificar a existência de scripts pendentes e executá-los.

Seguindo essas etapas, você poderá restabelecer a comunicação adequada entre os sistemas.

Processo de Exportação de Matrícula em Execução Não Concluído

O processo de exportação de Matrícula em execução não é concluído.

Para solucionar esse problema, recomendamos verificar a disponibilidade do campo complementar "Envia ao Portal SESI" associado à matrícula no período letivo.

Erro BadGateway 502: Envio da Entidade Aluno

A mensagem "Bad Gateway" ocorre quando o e-mail atribuído ao estudante é o mesmo utilizado para o responsável.

Para resolver essa situação, recomendamos as seguintes ações:

Ajustar Cadastros: É necessário garantir que cada pessoa tenha um e-mail diferente ao integrar com o Portal SESI.

Após realizar as correções, tente novamente o envio e confirme se a operação foi bem-sucedida.

Se o

problema

persistir, entre em contato com o Portal SESI para

, recomendamos verificar a disponibilidade do

serviço.

Consulte o DN sobre a capacidade de processamento das requisições, pois isso pode impactar a performance da integração.

Erro Bad Request Código: 9006 - Integração de Funcionário- E-mail em uso por outro usuário

campo complementar "Envia ao Portal SESI" associado à matrícula no período letivo.

Erro BadGateway 502: Envio da Entidade Aluno

A mensagem "Bad Gateway" ocorre quando o e-mail atribuído ao estudante é o mesmo utilizado para o responsável.

Erro: Bad Request {"codigo":9006,"message":"Email em uso por outro usuário"}

Para resolver essa situação, recomendamos as seguintes ações:

Verificação de Cadastro: Consulte a equipe do Educar para confirmar se o usuário possui um cadastro ativo no Portal SESI associado a outro código externo, o que está causando o conflito.
Inativação e Reativação: Proceda com a inativação do usuário, seguida pela sua reativação e, em seguida, tente reenviar as entidades.

Ajustar Cadastros: É necessário garantir que cada pessoa tenha um e-mail diferente ao integrar com o Portal SESI.
Após realizar as correções, tente novamente o envio e confirme se a operação foi bem-sucedida.
Se o problema persistir, entre em contato com o Portal SESI para verificar a disponibilidade do serviço.
Consulte o DN sobre a capacidade de processamento das requisições, pois isso pode impactar a performance da integração

Observação: Caso não consiga inativar pelo SGE, terá que validar diretamente com o pessoal da Educar Brasil como desativar esse alunos, pois se eles estão no Portal Sesi é porque foram integrados, como nessa base está integrando agora, provavelmente eles foram integrados em outro momento em outra base

.

Erro Bad Request Código:

9068

9006 - Integração de

Turmas - O grupo de itinerário é obrigatório

A mensagem de erro informa que "O grupo de itinerário é obrigatório", dessa forma ele deve ser cadastrado na parametrização do DE/PARA para que seja exportado com sucesso.

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

No exemplo a seguir, temos um cenários em que as turmas/disciplinas do itinerário formativo (Novo Ensino Médio) não foram integradas ao tentar enviar a entidade Turmas.

É essencial verificar se as disciplinas do Itinerário Formativo estão incluídas na grade do curso (Matriz Curricular). Para que o Itinerário seja corretamente identificado e enviado, as disciplinas devem fazer parte dessa grade.

Funcionário- E-mail em uso por outro usuário

Erro: Bad Request {"codigo":9006,"message":"Email em uso por outro usuário"}

Para resolver essa situação, recomendamos as seguintes ações:

Verificação de Cadastro: Consulte a equipe do Educar para confirmar se o usuário possui um cadastro ativo no Portal SESI associado a outro código externo, o que está causando o conflito.
Inativação e Reativação: Proceda com a inativação do usuário, seguida pela sua reativação e, em seguida, tente reenviar as entidades.

Observação: Caso não consiga inativar pelo SGE, terá que validar diretamente com o pessoal da Educar Brasil como desativar esse alunos, pois se eles estão no Portal Sesi é porque foram integrados, como nessa base está integrando agora, provavelmente eles foram integrados em outro momento em outra base

Caso as disciplinas do Itinerário não estejam integradas à Matriz Curricular, a turma/disciplina correspondente não será selecionada para envio ao Portal SESI, resultando na exclusão do itinerário do processo de envio

.

Erro Bad Request Código: 9079 - Integração de Turmas - O ID da disciplina é obrigatório

A mensagem de erro informa que "O ID da disciplina é obrigatório", dessa forma ele deve ser cadastrado na parametrização do DE/PARA para que seja exportado com sucesso.

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

Verifique se o campo está preenchido e se possui valores corretos.
Estes dados são disponibilizados pelo Portal SESI. Caso tenha dúvidas sobre o preenchimento correto, será necessário realizar contato com o time de suporte do mesmo.

Erro Bad Request Código: 9080 - Integração de Turmas - O ID da área é obrigatório

A mensagem de erro informa que "O ID da área é obrigatório", dessa forma ele deve ser cadastrado na parametrização do DE/PARA para que seja exportado com sucesso.

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

Verifique se o campo está preenchido e se possui valores corretos.
Estes dados são disponibilizados pelo Portal SESI. Caso tenha dúvidas sobre o preenchimento correto, será necessário realizar contato com o time de suporte do mesmo.

Erro Bad Request Código: 9087 - Integração de Turmas - O ID da área é inválido

A mensagem de erro informa que "O ID da área é inválido", dessa forma ele deve ser cadastrado na parametrização do DE/PARA para que seja exportado com sucesso.No caso do erro 9087, está relacionado ao registro: Área - Grupo Complemento

Este campo é preenchido no DE/PARA, que compõe 04 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

Verifique se o campo está preenchido e se possui valores corretos.
Estes dados são disponibilizados pelo Portal SESI. Caso tenha dúvidas sobre o preenchimento correto, será necessário realizar contato com o time de suporte do mesmo.

Indisponibilidade dos Parâmetros da Customização Portal SESI 2.0

Neste exemplo, onde não é possível acessar os parâmetros da Integração Portal SESI 2.0, recomendamos os seguintes passos:

Verificar a configuração dos dados da integração:

Desinstalar a customização do Portal SESI.
Verificar a pasta Custom (C:\TOTVS\CorporeRM\RM.Net\Custom) para identificar e excluir quaisquer DLL's relacionadas à customização.
Reinstalar as versões mais recentes das bibliotecas Win e Web.
Recriar o arquivo _brokercustom.dat.
Verificar a existência de scripts pendentes e executá-los.

Seguindo essas etapas, você poderá restabelecer a comunicação adequada entre os sistemas.

E-mail: The Email field is not a valid e-mail address

Este erro está relacionado a um cadastro de e-mail inválido.

Verifique a aplicação de acentuação, pontos e outros caracteres inválidos ao e-mail registrado. e, apóa, execute o reenvio de dados.

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 99

Nova versão Atual

Chave

Pré-Requisitos / Parametrizações

Detalhamento do Processamento

Authorization - Basic Auth

Body

Retorno

Authorization - Basic Auth

Body

Retorno

Body

Authorization - Basic Auth

Body

Retorno

Body

Authorization - Basic Auth

Body [Novo!]

Retorno