Serviço externo padrão MentorWeb - Realiza matricula em lote

Serviço externo do Mentor que realiza matricula em lote.
Para saber mais sobre serviços externos clique aqui.

Nome do serviço externo: matriculaAlunoNaTurmaEmLote

Para ver como montar a URL de chamada para esse serviço externo, acesse a página referente à execução de serviços externos clicando aqui.

1. Parâmetros para chamada do serviço externo

Parâmetro Descrição Obrigatório Tipo Observação
preMatricula Pre-matricula (S=Sim, N=Nao) padrao = N Não Texto
turmaID Id da turma Sim Númerico
listPessoaTurmaMatricular Lista de inscritos Sim Coleção Lista de inscritos(pessoaID)
pessoaID Id da pessoa Sim Númerico

2. Exemplo de chamada do Serviço pelo postman

URL: http://IP:PORTA/APLICACAO/rest/servicoexterno/execute/matriculaAlunoNaTurmaEmLote


2.1. Exemplo da passagem de parâmetros por Json:

{
   "preMatricula": "N",
   "turmaID": 7021,
   "listPessoaTurmaMatricular": [
      {
         "pessoaID": 99999999
      },
      {
         "pessoaID": 99999999
      },
      {
         "pessoaID": 99999999
      },
      {
         "pessoaID": 99999999
      },
      {
         "pessoaID": 99999999
      },
      {
         "pessoaID": 99999999
      },
      {
         "pessoaID": 99999999
      }
   ]
}

3. Retorno do serviço (Json)


Para obter o retorno do serviço deve-se verificar o status da requisição http. Sempre que o status for 200, significa que o processo foi realizado com sucesso.

Exemplos de retorno Json:

Sucesso - Status code 200:

{
    "resultado": "SUCESSO"
}

Com erro - Status code 509:

{
    "resultado": "ERRO",
    "erro": {
        "operacao": "br.com.edusoft.mentorweb.servico.controller.ServicoExternoAcademicoImplJava.matriculaAlunoNaTurmaEmLote",
        "valores": "{\n\"preMatricula\": \"N\",\n \"turmaID\": 7021,\n \"listPessoaTurmaMatricular\": [\n  {\n  \"pessoaID\": 292484\n}\n ]\n}",
        "motivo": "EduBaseRuntimeException: Turma é obrigatória."
    }
}
  • (edição externa)