Histórico da Página

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.

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.

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

<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

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

• 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

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

Possíveis retorno de erro:

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

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

Erro geral: HTTP Code 50x - Body: MensagemPSESI

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.

<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

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

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

Possíveis retorno de erro:

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

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

Erro geral: HTTP Code 50x - Body: MensagemPSESI

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

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

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

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

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

Possíveis retorno de erro:

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

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

Erro geral: HTTP Code 50x - Body: MensagemPSESI

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

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

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

Deverá ser enviado as Turmas e Turmas/Disciplina Criando ou Atualizando - Sendo que na criação a chave é o conjunto idred|regional|turno|segmento|serie|turma e para atualização utilizar o idturma (a ser retornado pela API).

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

{
		"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",
			    "disciplinaitinerario": "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

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

Possíveis retorno de erro:

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

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

Erro geral: HTTP Code 50x - Body: MensagemPSESI

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.