Histórico da Página

<div class="post">POST</div>
<div class="endereco">/rm/api/TOTVSCustomizacao/IntegracaoSALESFORCE/GravarAluno</div>

Realiza a gravação do aluno no SGE, conforme dados enviados pela API.

Importante: Caso o CPF enviado já exista no SGE, a API identifica a pessoa e o RA, e atualiza o cadastro com os dados enviados.

Tabelas Afetadas: SALUNO, PPESSOA, SALUNOCOMPL

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

Authorization - Basic Auth

Username <username>

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

Body

{
  		"Nomeidred": "Teste Api 2 "7,
  		"EstadoNatalregional": "MGAC",
  		"NaturalidadecodigoExterno": "Belo Horizonte"1234567,
  		"DataNascimentocpf": "05/07/1978862.873.376-05",
  		"Cpfnome": "85763425022",
Adriano Duarte "Cep": "38700412"Cardoso",
  		"RuanomeSocial": "Pascoal Soares",
  "Numero": 10,
  "Complemento		"email": "102[email protected]",
  		"BairrodataNascimento": "Savassi22-04-2000",
  		"Estadonaturalidade": "SP"4110706,
  		"CidadenomeDaMae": "SãoIvone Duarte PauloCardoso"
	},
  "Pais"MensagemPSESI: "Brasil",
  "Tel_Residencial": "3333333333333",
  "Tel_Celular": "2312321312",
  "Tel_3": "13123132313",
  "Fax": "312321313131",
  "SitOcupacional": 1,
  "TipoEscola": 3,
  "CodColigada": 3,
  "IdMatrizAplicada": 4,
  "Email": "[email protected]",
  "NomeMae": "Nome da mãe do Aluno"
}

Content

{
		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 Nome: Nome do Aluno no SGE (Campo Obrigatório);EstadoNatal: Estado Natal do Aluno no SGE .

• 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);. 
• Naturalidade: Naturalidade do Aluno no SGE (Campo Obrigatório);
• DataNascimento: Data de Nascimento do Aluno no SGE (Campo Obrigatório);
• Cpf: CPF do Aluno no SGE (Campo Obrigatório);
• Cep: CEP do Aluno no SGE;
• Rua: Rua do Aluno no SGE;
• Numero: Número do Aluno no SGE;
• Complemento: Complemento do Aluno no SGE;
• Bairro: Nome do bairro do Aluno;
• Estado: Sigla do Estado do Aluno;
• Cidade: Nome da Cidade do Aluno;
• Pais: Nome do País do Aluno;
• Tel_Residencial: Telefone Residencial do Aluno no SGE;
• Tel_Celular: Telefone Celular do Aluno no SGE;
• Tel_3: Telefone 3 do Aluno no SGE;
• Fax: Fax do Aluno no SGE;
• SitOcupacional: Situação ocupacional do Aluno no SGE;

       Valores possíveis:
               1 = Empregado
               2 = Desempregado
               3 = Empregador
               4 = Autônomo/Conta Própria
               5 = Profissional Liberal
               6 = 1º Emprego
               7 = Aposentado
               8 = Microempreendedor Individual - MEI
               9 = Aprendiz com contrato   

• TipoEscola: Tipo de escola de Origem do Aluno no SGE;

             Valores possíveis:
               1 = Particular
               2 = Pública - Municipal
               3 = Pública - Estadual
               4 = Pública - Federal
               9 = Não Declarado

• CodColigada: Código da Coligada no SGE (Campo Obrigatório);
• IdMatrizAplicada: Identificador da Matriz Aplicada (Curso/Habilitação e Período Letivo) (Campo Obrigatório);
• NomeMae:  Nome da mãe do aluno, que será gravado em campo complementar do cadastro do aluno (não obrigatório na API).
• Email: Endereço de e-mail do Aluno, que será gravado no campo do cadastro da Pessoa.

Retorno

{
   "Message": "Aluno: 205, existente em base, atualizado com Sucesso!\r\n",
   "Status": "Sucesso",
   "StatusCode": 200
}

Content

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