privado
180
edições
Mudanças
De UltramaxWiki
Gestão Escolar - API de integração (ver código-fonte)
Edição das 12h55min de 23 de fevereiro de 2024
, 23 fevereiro→Resposta
|-
|-
|id
|id
|Código identificador único (id)
|Código identificador único de uma matricula do aluno (id). Um aluno pode ter mais pode ter mais de uma matrícula, inclusive no mesmo período letivo. Caso deseje um id exclusivo do aluno, independente da matrícula. Será necessário pegar o id do Aluno que está dentro da matrícula
|Número
|Número
|
|
|Sexo
|Sexo
|0..1
|0..1
|-
|urlFotoAwsS3
|URL com o caminho da foto no S3
|Texto
|
|-
|pessoasAutorizadas
|Pessoas que tem autorização para retirar o Aluno
|PessoaAutorizada
|0..N
|}
|}
====Estado:====
====Estado:====
|Estado da Federação que o aluno mora
|Estado da Federação que o aluno mora
|Estado*
|Estado*
|
|}
====PessoaAutorizada:====
{| class="wikitable"
|'''Atributo'''
|'''Descrição'''
|Tipo
|Tamanho
|-
|nome
|Nome da Pessoa
|Texto
|
|-
|rg
|RG com número da pessoa autorizada
|Texto
|
|-
|parentesco
|descrição com o parentesco da pessoa autorizada
|Texto
|
|-
|cpf
|CPF da pessoa autorizada a retirar
|Texto
|
|
|}
|}
|}
|}
=== Enturmamento aluno ===
=====DadosTitulos:=====
{| class="wikitable"
|'''Atributo'''
|'''Descrição'''
|Tipo
|Tamanho
|-
|nome
|Nome da pessoa associada ao título (responsável pelo pagamento)
|Texto
(base)/gestaoescolar/services/enturmamento/rest/aluno
|70
|-
|dataDePagamento
|Data que o pagamento do título foi efetivado
|+
|Texto
|10
|-
|-
|Sim
|dataFaturamento
|portal
|A data que a nota fiscal associada ao boleto/título foi gerada, ou, caso ainda não tenha sido gerada, a Data prevista para faturamento (data associada ao título no Gestão Escolar)
|Texto
|10
|+
|-
|-
|CURSO_CODIGO
|vencimento
|Código do curso
|Data de vencimento prevista para o título
|Texto
|Texto
|15
|10
|-
|-
|CURSO_ID
|inicioCurso
|Identificador do curso
|Data com início que a matrícula do aluno está configurado
|Número
|Texto
|
|10
|-
|-
|CURSO_NOME
|curso
|Nome do curso
|Nome do curso que está associada a matrícula
|Texto
|Texto
|70
|70
|-
|-
|DISCIPLINA_CODIGO
|rm
|Identificador da disciplina
|RA do aluno com identificador único
|Número
|Texto
|
|20
|-
|-
|DISCIPLINA_NOME
|status
|Nome da disciplina
|Situação atual da matrícula
|Texto
|Texto
|200
|30
|-
|-
|IE_CODIGO
|turma
|Código da instituição de ensino fornecido pelo portal externo
|Turma principal associada a matricula
|Texto
|Texto
|
|65
|-
|-
|PERIODO_CODIGO
|valorCobrado
|Identificador do período letivo
|Valor efetivamente cobrado para o título (baixado)
|Número
|Numero
|
|
|-
|-
|PERIODO_LETIVO
|valorDocumento
|Nome do período letivo
|Valor base esperado para o título (não considera descontos configurados)
|Número
|Número
|
|
|}
===Enturmamento aluno===
Realiza a busca dos alunos e as turmas que frequentam com disciplina no modelo especifico do google for education. Para que seja retornado deve seguir os seguintes pré requisitos:
*Matrícula deve ter o status matriculado ou ativa
*A turma deve ter status diferente de encerrado
*O cursa do aluno deve ter o status cursando
*A série deve estar ativa
*O curso não deve estar com o campo "Não enviar na API de enturmamento" selecionado
Método: GET
(base)/gestaoescolar/services/enturmamento/rest/aluno
====Query string (parâmetro)====
{| class="wikitable"
|+
!Obrigatório
!Campo
!Descrição
|-
|-
|SERIE_CODIGO
|Sim
|Código para a série concatenando código do curso e seqência da série no curso
|portal
|Portal externo que deseja buscar o enturmamento dos alunos, o e-mail do aluno no retorno será o de login a esse portal, os valores aceitos são:
-GOOGLE_FOR_EDUCATION;
|SERIE_ID
-MICROSOFT_TEAMS;
|}
|Número
|
====Respostas esperadas====
|-
Status 200: : OK
|SERIE_NOME
|Nome da série
Status 417: : Caso não seja informado o portal ou o mesmo não seja cadastrado na escola
Status 401: : Caso o token de autenticação não esteja no header da requisição ou esteja expirado
{| class="wikitable"
|+
!Atributo
!Descrição
!Tipo
!Tamanho
|-
|CURSO_CODIGO
|Código do curso
|Texto
|Texto
|70
|15
|-
|CURSO_ID
|Identificador do curso
|Número
|
|-
|-
|TURMA_CODIGO
|CURSO_NOME
|Replica o nome da turma
|Nome do curso
|Texto
|Texto
|65
|70
|-
|-
|TURMA_DISCIPLINA_CODIGO
|DISCIPLINA_CODIGO
|Código que associa a turma com a disciplina no quadro curricular
|Identificador da disciplina
|Número
|Número
|
|
|-
|-
|TURMA_ID
|DISCIPLINA_NOME
|Identificador da turma
|Nome da disciplina
|Número
|Texto
|200
|-
|IE_CODIGO
|Código da instituição de ensino fornecido pelo portal externo
|Texto
|
|
|-
|-
|TURMA_NOME
|IE_ID
|Nome da turma
|Identificado da instituição de ensino fornecido pelo portal externo
|Texto
|Texto
|65
|
|-
|-
|ALUNO_RA
|IE_NOME
|RM do aluno
|Nome da instituição de ensino fornecido pelo portal externo
|Texto
|Texto
|20
|
|-
|-
|ALUNO_ID
|PERIODO_CODIGO
|Identificador do aluno
|Identificador do período letivo
|Número
|Número
|
|
|-
|-
|ALUNO_NOME
|PERIODO_LETIVO
|Nome do aluno
|Nome do período letivo
|Texto
|Número
|70
|
|-
|-
|ALUNO_EMAIL
|SERIE_CODIGO
|E-mail do aluno para acesso ao portal
|Código para a série concatenando código do curso e seqência da série no curso
|Texto
|Texto
|255
|
|-
|-
|ALUNO_CPF
|SERIE_ID
|CPF do aluno
|Identificador da série
|Número
|Número
|
|
|-
|-
|RESP_PED_NOME
|SERIE_NOME
|Nome do responsável pedagógico
|Nome da série
|Texto
|Texto
|70
|70
|-
|-
|RESP_PED_EMAIL
|TURMA_CODIGO
|E-mail pessoal do responsável pedagógico
|Replica o nome da turma
|Texto
|Texto
|255
|65
|}
|-
|TURMA_DISCIPLINA_CODIGO
|Código que associa a turma com a disciplina no quadro curricular
|Número
|
|-
|TURMA_ID
|Identificador da turma
|Número
|
|+
|-
|-
|Sim
|TURMA_NOME
|portal
|Nome da turma
|Texto
|65
|+
|-
|-
|CURSO_CODIGO
|ALUNO_RA
|Código do curso
|RM do aluno
|Texto
|Texto
|15
|20
|-
|-
|CURSO_ID
|ALUNO_ID
|Identificador do curso
|Identificador do aluno
|Número
|Número
|
|
|-
|-
|CURSO_NOME
|ALUNO_NOME
|Nome do curso
|Nome do aluno
|Texto
|Texto
|70
|70
|-
|-
|DISCIPLINA_CODIGO
|ALUNO_EMAIL
|E-mail do aluno para acesso ao portal
|-
|Texto
|Texto
|200
|255
|-
|-
|IE_CODIGO
|ALUNO_CPF
|Código da instituição de ensino fornecido pelo portal externo
|CPF do aluno
|Texto
|Número
|
|
|-
|-
|IE_ID
|RESP_PED_NOME
|Identificado da instituição de ensino fornecido pelo portal externo
|Nome do responsável pedagógico
|Texto
|Texto
|
|70
|-
|-
|IE_NOME
|RESP_PED_EMAIL
|Nome da instituição de ensino fornecido pelo portal externo
|E-mail pessoal do responsável pedagógico
|Texto
|Texto
|
|255
|-
|}
===Enturmamento professor===
|Número
Realiza a busca dos professores e as turmas que lecionam com disciplina no modelo especifico do google for education. Para que seja retornado deve seguir os seguintes pré requisitos:
|
*O período letivo deve estar ativo
*Turma tem que ter status diferente de encerrado
*A série deve estar ativa
*O curso não deve estar com o campo "Não enviar na API de enturmamento" selecionado
Método: GET
(base)/gestaoescolar/services/enturmamentoProfessor/rest/professor
====Query string (parâmetro)====
{| class="wikitable"
|+
!Obrigatório
!Campo
!Descrição
|-
|-
|PERIODO_LETIVO
|Sim
|Nome do período letivo
|portal
|Número
|Portal externo que deseja buscar o enturmamento dos professor, o e-mail do aluno no retorno será o de login a esse portal, os valores aceitos são:
|
-GOOGLE_FOR_EDUCATION;
|-
|SERIE_CODIGO
-MICROSOFT_TEAMS;
|Código para a série concatenando código do curso e seqência da série no curso
|}
|Texto
|
====Respostas esperadas====
Status 200: : OK
Status 417: : Caso não seja informado o portal ou o mesmo não seja cadastrado na escola
Status 401: : Caso o token de autenticação não esteja no header da requisição ou esteja expirado
{| class="wikitable"
|+
!Atributo
!Descrição
!Tipo
!Tamanho
|-
|CURSO_CODIGO
|Código do curso
|Texto
|15
|-
|-
|SERIE_ID
|CURSO_ID
|Identificador da série
|Identificador do curso
|Número
|Número
|
|
|-
|-
|SERIE_NOME
|CURSO_NOME
|Nome da série
|Nome do curso
|Texto
|Texto
|70
|70
|-
|-
|TURMA_CODIGO
|DISCIPLINA_CODIGO
|Replica o nome da turma
|Identificador da disciplina
|Número
|
|-
|DISCIPLINA_NOME
|Nome da disciplina
|Texto
|Texto
|65
|200
|-
|-
|TURMA_DISCIPLINA_CODIGO
|IE_CODIGO
|Código que associa a turma com a disciplina no quadro curricular
|Código da instituição de ensino fornecido pelo portal externo
|Número
|Texto
|
|
|-
|-
|TURMA_ID
|IE_ID
|Identificador da turma
|Identificado da instituição de ensino fornecido pelo portal externo
|Número
|Texto
|
|
|-
|-
|TURMA_NOME
|IE_NOME
|Nome da turma
|Nome da instituição de ensino fornecido pelo portal externo
|Texto
|Texto
|65
|
|-
|-
|PROFESSOR_CODIGO
|PERIODO_CODIGO
|Replica o identificador do professor
|Identificador do período letivo
|Número
|Número
|
|
|-
|-
|PROFESSOR_CPF
|PERIODO_LETIVO
|CPF do professor
|Nome do período letivo
|Número
|Número
|
|
|-
|-
|PROFESSOR_EMAIL
|SERIE_CODIGO
|E-mail do professor para acesso ao portal externo
|Código para a série concatenando código do curso e seqência da série no curso
|Texto
|Texto
|255
|
|-
|-
|PROFESSOR_ID
|SERIE_ID
|Identificador do professor
|Identificador da série
|Número
|Número
|
|
|-
|-
|PROFESSOR_NOME
|SERIE_NOME
|Nome do professor
|Nome da série
|Texto
|Texto
|70
|70
|-
|-
|PROFESSOR_PERFIL
|TURMA_CODIGO
|Retorna fixo o valor 4
|Replica o nome da turma
|Texto
|65
|-
|TURMA_DISCIPLINA_CODIGO
|Código que associa a turma com a disciplina no quadro curricular
|Número
|
|
|-
|TURMA_ID
|Identificador da turma
|Número
|
|
|-
|-
|TURMA_DISCIPLINA_PERFIL
|TURMA_NOME
|Retorna fixo o valor 4
|Nome da turma
|Texto
|65
|-
|PROFESSOR_CODIGO
|Replica o identificador do professor
|Número
|
|
|-
|PROFESSOR_CPF
|CPF do professor
|Número
|
|
|-
|-
|TURMA_TIPO_ID
|PROFESSOR_EMAIL
|Retorna fixo o valor 4
|E-mail do professor para acesso ao portal externo
|Texto
|255
|-
|PROFESSOR_ID
|Identificador do professor
|Número
|
|
|
|-
|}
|PROFESSOR_NOME
|Nome do professor
|Texto
|70
|-
|PROFESSOR_PERFIL
|Retorna fixo o valor 4
|Texto
|
|-
|TURMA_DISCIPLINA_PERFIL
|Retorna fixo o valor 4
|Texto
|
|-
|TURMA_TIPO_ID
|Retorna fixo o valor 4
|Texto
|
|}
===Manutenção de cursos===
===Cadastrar chave do aluno===
Realiza a atualização no perfil do aluno cadastrando a chave de acesso para aquele portal.
Método: Post
Método: POST
(base)/gestaoescolar/services/curso/rest/add
(base)/gestaoescolar/services/chavePortal/rest/aluno
====Body====
====Query string (parâmetro)====
{| class="wikitable"
{| class="wikitable"
|'''Atributo'''
|+
!Obrigatório
!Campo
!Descrição
|-
|-
|'''sigla'''
|Sim
|Código identificador do Curso
|portal
|Portal externo no qual deve ser cadastrada a chave de acesso do aluno, os valores aceitos são:
-GOOGLE_FOR_EDUCATION;
-MICROSOFT_TEAMS;
|-
|-
|'''codigoUnidade'''
|Sim
|Código da unidade de ensino que o curso pertence. Fixo "1"
|atualizar
|Coleção de alunos que devem ser atualizados, cada elemento deve ter o identificador do aluno e o login daquele aluno no portal, serão respectivamente os campos id e chave
|}
'''Exemplo:'''
{
"portal":"GOOGLE_FOR_EDUCATION",
"atualizar":[
{
"chave": "alu3@email.com",
|-
"id": 5
}
]
}
====Respostas esperadas====
Status 200: : OK
Status 417: : Caso não seja informado o portal ou o mesmo não seja cadastrado na escola ou caso de erro de validação no processo de gravação que será especificado no retorno.
Status 401: : Caso o token de autenticação não esteja no header da requisição ou esteja expirado
===Cadastrar chave do professpr===
Realiza a atualização no perfil do professor cadastrando a chave de acesso para aquele portal.
Método: POST
(base)/gestaoescolar/services/chavePortal/rest/professor
====Query string (parâmetro)====
{| class="wikitable"
|+
!Obrigatório
!Campo
!Descrição
|-
|Sim
|portal
|Portal externo no qual deve ser cadastrada a chave de acesso do aluno, os valores aceitos são:
-GOOGLE_FOR_EDUCATION;
-MICROSOFT_TEAMS;
|-
|Sim
|atualizar
|Coleção de professores que devem ser atualizados, cada elemento deve ter o identificador do professor e o login daquele professor no portal, serão respectivamente os campos id e chave
|}
'''Exemplo:'''
{
"portal":"GOOGLE_FOR_EDUCATION",
"atualizar":[
{
"chave": "alu3@email.com",
"id": 5
}
]
}
====Respostas esperadas====
Status 200: : OK
Status 417: : Caso não seja informado o portal ou o mesmo não seja cadastrado na escola ou caso de erro de validação no processo de gravação que será especificado no retorno.
Status 401: : Caso o token de autenticação não esteja no header da requisição ou esteja expirado
==APIS para manutenção da base de dados==
===Manutenção de cursos===
Faz a manutenção de um curso. Através do código de integração será localizado um curso existente para alteração ou, caso não exista, será criado um novo curso
Método: Post
(base)/gestaoescolar/services/curso/rest/add
====Body====
{| class="wikitable"
|'''Atributo'''
|'''Descrição'''
|Tipo
|Mínimo
|Máximo
|-
|'''sigla'''
|Código identificador do Curso
|S
|1
|15
|-
|'''codigoUnidade'''
|Código da unidade de ensino que o curso pertence. Fixo "1"
|N
|N
|1
|1
|50
|3
|}
|-
|'''nome'''
|Descrição do curso
|S
|1
|70
|-
|'''itemServico'''
|Código do serviço para emissão de NFS-e. Depende de cada instituição e do curso. Por exemplo: 05673. Ver com a instituição qual código usar para cada curso
|S
|4
|9
|-
|'''codigoIntegracao'''
|Código único de integração, será a chave entre os diferentes sistemas
|S
|1
|255
|-
|'''modalidadeCurso'''
|‘EAD’ fixo
|S
|1
|30
|-
|'''naturezaOperacao'''
|Natureza de operação será usada na geração das notas fiscais
Valores válidos:
CANCELADO("Cancelado"),
EXIGIBILIDADE_SUSPENSAO_DECISAO_JUDICAL(
"Exigibilidade por suspensão de decisão judicial - Válido até 22/02/2015"),
EXIGIBILIDADE_SUSPENSAO_DECISAO_JUDICAL_2(
"dados": {
"Exigibilidade por suspensão de decisão judicial"),
EXIGIBILIDADE_SUSPENSAO_PROCEDIMENTO_ADM(
"codigoUnidade":1,
"Exigibilidade por suspensão de procedimento administrativo - Válido até 22/02/2015"),
EXIGIBILIDADE_SUSPENSAO_PROCEDIMENTO_ADM_2(
"itemServico": "545454",
"Exigibilidade por suspensão de procedimento administrativo"),
EXIGIBILIDADE_SUSPENSAO_TRIBUTADO_FORA_MUNICIPIO(
"modalidadeCurso": "EAD"
"Tributado fora do Munícipio, porém Exigibilidade Suspensa - Válido a partir de 23/02/2015"),
EXIGIBILIDADE_SUSPENSAO_TRIBUTADO_MUNICIPIO(
"statusProcessamento": "OK",
"Tributado no Munícipio, porém Exigibilidade Suspensa - Válido a partir de 23/02/2015"),
EXPORTACAO( "Exportação"),
EXPORTACAO_SERVICO(
"Exportação de serviços - Válido a partir de 23/02/2015"),
EXTRAVIADO("Extraviado - Válido até 22/02/2015"),
IMUNE("Imune - Válido até 22/02/2015"),
(base)/gestaoescolar/services/aluno/rest/responsavelfinanceiro
IMUNIDADE("Imunidade"),
ISENCAO("Isenção - Válido até 22/02/2015"),
ISENCAO_ATUAL("Isenção"),
MICRO_EMPREENDEDOR_INDIVIDUAL("Micro Empreendedor Individual (MEI)"),
SIMPLES("Simples Nacional"),
TRIBUTACAO_FORA_MUNICIPIO("Tributação fora do munipio"),
TRIBUTACAO_MUNICIPIO("Tributação no municipio"),
TRIBUTADO_FORA_MUNICIPIO_IMUNE()
"Tributado fora do município, porém Imune - Válido a partir de 23/02/2015"),
TRIBUTADO_FORA_MUNICIPIO_ISENTO(
"Tributado fora do município, porém Isento - Válido a partir de 23/02/2015"),
TRIBUTADO_MUNICIPIO_IMUNE("Tributado no município, porém Imune - Válido a partir de 23/02/2015"),
TRIBUTADO_MUNICIPIO_ISENTO("Tributado no município, porém Isento - Válido a partir de 23/02/2015");
|N
|N
|1
|1
|60
|50
|-
|}
====Respostas esperadas====
Status 200: Status Processamento: OK
Status 417: Status Processamento: JACADASTRADO. Quando a mesma sigla de curso está cadastrado em mais de um registro.
Status 500: Status Processamento: ERRO
====Exemplo:====
=====Requisição=====
{"sigla":"Curso","codigoUnidade":1,"nome":"Curso teste","itemServico":"545454","codigoIntegracao":"SA-KJ-AD-NB","modalidadeCurso":"EAD"}
=====Resposta=====
{
"dados": {
|-
|'''enderecoEstado'''
"sigla": "Curso",
"codigoUnidade":1,
"nome": "Curso teste",
|'''enderecoLogradouro'''
"itemServico": "545454",
|Logradouro do end residencial do aluno Ex. rua guapore
|S
"codigoIntegracao": "SA-KJ-AD-NB",
|60
"modalidadeCurso": "EAD"
},
"statusProcessamento": "OK",
"response": "ACCEPTED",
"acao": "Manutenção OK"
}
===Manutenção de alunos===
Adiciona ou altera um aluno. Através do C.P.F informado será localizado na base de dados do gestão escolar o aluno correspondente. Caso encontre, será atualizado todos os campos bases enviados no header, por outro lado, caso não encontre, será incluído um novo registro para o aluno.
Método: Post
(base)/gestaoescolar/services/aluno/rest/responsavelfinanceiro
====Body====
{| class="wikitable"
|'''Atributo'''
|'''Descrição'''
|Tipo
|Mínimo
|Máximo
|-
|-
|'''enderecoNumero'''
|'''nome'''
|Número do end residencial do aluno Ex. 521
|Nome do aluno.
|S
|S
|0
|1
|7
|70
|-
|-
|'''nascimento'''
|'''celular'''
|Date com a data de nascimento do aluno dd/MM/yyyy
|Número de telefone celular Ex: 11998465521 ou (11) 99999-9999
|S
|S
|10
|11
|10
|15
|-
|'''cpf'''
|Sequencia numérica com o CPF do aluno Ex. 65696655565
|N
|11
|11
|-
|-
|'''rg'''
|'''email'''
|RG do aluno Ex: 584245999
|Email do aluno Ex: aluno@aluno.com.br
|S
|S
|>1
|>1
|25
|255
|-
|-
|'''sexo'''
|'''enderecoBairro'''
|Indicador do gênero do aluno Ex MASCULINO.
|Bairro do end residencial do aluno Ex. vila didi
|S
|S
|1
|60
|-
|'''enderecoCep'''
|CEP do end residencial do aluno Ex. 13203320
|S
|8
|8
|8
|-
|-
|'''nacionalidade'''
|'''enderecoCidade'''
|Nacionalidade do aluno
|Cidade do end residencial do aluno Ex. jundiai
|S
|1
|20
|-
|'''enderecoComplemento'''
|Complemento do end residencial do aluno Ex. casa
|S
|S
|0
|0
|30
|60
|-
|-
|'''filiacao1'''
|'''enderecoEstado'''
|Filiação 1 do aluno (Detalhes tabela pessoa)
|Estado do end residencial do aluno Ex. SP Max 2 caracteres deve ser a sigla correspondente ao Estado
|PessoaRemote
|S
|
|2
|
|2
|-
|-
|'''filiacao2'''
|'''enderecoLogradouro'''
|Filiação 2 do aluno (Detalhes tabela pessoa)
|Logradouro do end residencial do aluno Ex. rua guapore
|S
|S
|0*
|1
|20
|60
|-
|-
|'''nome'''
|'''enderecoNumero'''
|Nome do aluno.
|Número do end residencial do aluno Ex. 521
|S
|S
|1
|0
|70
|7
|-
|-
|'''celular'''
|'''nascimento'''
|Número de telefone celular Ex: 11998465521 ou (11) 99999-9999
|Date com a data de nascimento do aluno dd/MM/yyyy
|S
|S
|11
|10
|15
|10
|-
|-
|'''cpf'''
|'''rg'''
|Sequencia numérica com o CPF do aluno Ex. 65696655565
|RG do aluno Ex: 584245999
|S
|S
|>1
|>1
|255
|25
|-
|-
|'''enderecoBairro'''
|'''sexo'''
|Bairro do end residencial do aluno Ex. vila didi
|Indicador do gênero do aluno Ex MASCULINO.
MASCULINO/FEMININO/NAODECLARADO
|S
|S
|1
|8
|60
|15
|-
|-
|'''enderecoCep'''
|'''nacionalidade'''
|CEP do end residencial do aluno Ex. 13203320
|Nacionalidade do aluno
|S
|S
|8
|0
|8
|30
|-
|'''filiacao1'''
|Filiação 1 do aluno (Detalhes tabela pessoa)
|PessoaRemote
|
|
|-
|'''filiacao2'''
|Filiação 2 do aluno (Detalhes tabela pessoa)
|PessoaRemote
|
|
|-
|-
|'''enderecoCidade'''
|'''rm'''
|Cidade do end residencial do aluno Ex. jundiai
|Código de matrícula que deve ser informado apenas quando o autonumeração de RM está desligada no Gestão Escolar
|S
|S
|1
|0*
|20
|20
|}
====Filiação====
Usado nos dados do aluno para representar uma filiação.
{| class="wikitable"
|'''Atributo'''
|'''Descrição'''
|Tipo
|Mínimo
|Máximo
|-
|-
|'''enderecoComplemento'''
|'''nome'''
|Complemento do end residencial do aluno Ex. casa
|Nome do aluno.
|S
|S
|0
|1
|60
|70
|-
|-
|'''enderecoEstado'''
|'''celular'''
|Estado do end residencial do aluno Ex. SP Max 2 caracteres deve ser a sigla correspondente ao Estado
|Número de telefone celular Ex: 11998465521 ou (11) 99999-9999
|S
|S
|2
|11
|2
|15
|-
|-
|'''enderecoLogradouro'''
|'''cpf'''
|Logradouro do end residencial do aluno Ex. rua guapore
|Sequencia numérica com o CPF do aluno Ex. 65696655565
|N
|11
|11
|-
|'''email'''
|Email do aluno Ex: aluno@aluno.com.br
|S
|>1
|255
|-
|'''enderecoBairro'''
|Bairro do end residencial do aluno Ex. vila didi
|S
|S
|1
|1
|60
|60
|-
|-
|'''enderecoNumero'''
|'''enderecoCep'''
|Número do end residencial do aluno Ex. 521
|CEP do end residencial do aluno Ex. 13203320
|S
|S
|0
|8
|7
|8
|-
|-
|'''nascimento'''
|'''enderecoCidade'''
|Date com a data de nascimento do aluno dd/MM/yyyy
|Cidade do end residencial do aluno Ex. jundiai
|S
|S
|10
|1
|10
|20
|-
|-
|'''rg'''
|'''enderecoComplemento'''
|Complemento do end residencial do aluno Ex. casa
|S
|0
|60
|-
|'''enderecoEstado'''
|Estado do end residencial do aluno Ex. SP Max 2 caracteres deve ser a sigla correspondente ao Estado
|S
|2
|2
|-
|'''enderecoLogradouro'''
|Logradouro do end residencial do aluno Ex. rua guapore
|S
|1
|60
|-
|'''enderecoNumero'''
|Número do end residencial do aluno Ex. 521
|S
|0
|7
|-
|'''nascimento'''
|Date com a data de nascimento do aluno dd/MM/yyyy
|S
|10
|10
|-
|'''rg'''
|RG do aluno Ex: 584245999
|RG do aluno Ex: 584245999
|S
|S
Status 500: Status Processamento: ERRO
Status 500: Status Processamento: ERRO
====Exemplo====
======Principais validações conhecidas referentes ao erro HTTP 417: Regras de negócio======
Manutenção de matrícula
- Ter um código sku (identificador único)
Atualização
- Não pode o código Identificador único da matrícula estar associado a Outro CPF
Erro: Já existe um aluno com CPF diferente ({0}) usando o mesmo código de mátricula único {1}
- O código integração do curso "codigoIntegracao" deve estar associado a algum curso no GE
Erro: Código SKU do curso não foi informado
- O código integração do curso "codigoIntegracao" deve ser igual ao código de integração de cursa da matrícula já existente
Erro: O código de integração do curso ({0}) não é o mesmo código SKU já definido para a matrícula: {1}
- Caso a matrícula existente não seja uma pré matrícula e não tenha nenhuma disciplina já associada (cursa)
Erro: A matrícula {0} não tem nenhuma disciplina associada
Inclusão
- codigoIntegracao fornecido não está associado a nenhum curso no GE
Erro: Não foi localizado o curso correspondente para o código {0}
- atributo cpf_cnpj fornecido não está associado a nenhum aluno no GE (Precisa cadastro o aluno antes)
Erro: Não foi localizado o curso correspondente para o código {0}
- atributo codigoUnidade fornecido não tem uma unidade de ensino com o mesmo código no GE
Erro: Não foi possível determinar qual será a unidade de ensino com o código {0} para a matrícula.
- atributo periodoLetivo fornecido não tem um período letivo correspondente no GE
Erro: ão foi possível determinar qual será a período letivo com o código {0} para a matrícula. Por favor entrar em contato com a secretaria e buscar no Wiki do sistema pelo código de ajuda: CFGAPI001
- atributos numeroSerieDeMatricula e a combição dos atributo codigoIntegracao(curso), codigoUnidade (Unidade de ensino) e periodoLetivo (período letívo) devem localizar a série/turma que o aluno deve ser matrículado,
}
Erro: Não foi possível determinar qual será a série para a matrícula: Sequência: {0}.
- atributo codigoIntegracao localizar um curso com modalidade EAD e valor do atributo valor for maior que zero e a série localizada não tiver mais de
uma receita obrigatória cadastrada
Erro: A série deve conter apenas uma receita obrigatória. Por favor entrar em contato com a secretaria e buscar no Wiki do sistema pelo código de ajuda: CFGAPI001
Geração dos boletos:
- Caso a matrícula tenha Tenha o atributo do valor maior que zero, e a modalidade do curso referente ao atributo codigoIntegracao for EAD
e não tiver nenhum atributo "titulos" fornecido, o processo vai tentar criar os títulos financeiros de acordo com o configurado na aba financeiro
no gestão escolar e caso alguma despesa da matrícula existente não esteja configurada no financeiro da série dará o erro:
Erro: A conta contábil de recebimento não está configurado na parte financeira da série para a receita:
- Caso o atributo "titulos" esteja preenchido e a somatória do atributo do titulo chamado valorDocumento não bater com o atributo "valor" do
corpo da matrícula.
{| class="wikitable"
Erro: O valor total informado ({0}) não bate com a somatória de valores de cada parcela ({1})
- Caso o curso associado seja da modalidade EAD e tenha o atributo valor maior que zero e a matrícula gerada durante a chamada fique sem nenhuma
despesa de matrícula associada
Erro: Não existe nenhuma despesa configurada para a matrícula, verifique se existe configuração de despesa financeira para a série {0} e então, inclua uma despesa para a matrícula.
- Caso o atributo "nossoNumero" do titulo já esteja associado a algum outro boleto no Gestão Escolar
Erro: O título com o código externo {0} já existe, não é permitido adicionar a matrícula com a mesma referência
====Exemplo====
====Exemplo====
=====Requisição=====
=====Requisição=====
{"cpf_cnpj":2865474325,"codigoIntegracao":"SA-KJ-AD-NB","codigoMatriculaUnico":"201254", "codigoUnidade":"1","numeroSerieDeMatricula":1,"valor":1000.0,"quantidadeParcelas":1,"formaPagamento":"DINHEIRO"}
=====Resposta=====
=====Resposta=====
{
{
"dados": {
"dados": {
"nomeSacado": "Aluno teste",
"pagamentoCartao": false,
"numeroDocumento": 8597757,
"cpf_cnpj": 2865474325,
"valorAbatimentoConcedido": 0.0,
"codigoIntegracao": "SA-KJ-AD-NB",
"valorDescontoConcedido": 0.0,
"codigoMatriculaUnico": "201254",
"codigoUnidade":1,
"valorDocumento": 1100.0,
"numeroSerieDeMatricula": 1,
"valorLiquido": 0.0,
"valor": 1000.0,
"valorMoraMulta": 0.0,
"quantidadeParcelas": 1,
"valorOutrasDespesas": 0.0,
"formaPagamento": "DINHEIRO", },
"statusProcessamento": "OK",
"response": "ACCEPTED",
"acao": "Manutenção OK"
}
===Financeiro: Criação de título na matrícula (Titulo)===
Usada na API de matrícula do aluno. Cada título deve ser adicionado na API da Matrícula do aluno. A API de matrículas foi alterada para permitir incluir títulos na alteração. Com isso, será possível adicionar novos títulos para matrículas já existentes, desde que o código "nosso número" já não esteja associado a outro títulos no sistema gestão escolar.
{| class="wikitable"
{| class="wikitable"
|Mínimo
|Mínimo
|Máximo
|Máximo
|-
|'''dataVencimento'''
|Data de vencimento do título
|S
|10
|10
|-
|-
|'''nossoNumero'''
|'''nossoNumero'''
|Número gerado pelo sistema interno que criou o título e que deve ser compartilhado com o Gestão Escolar para que cada interação funcione de forma correta
|Número gerado pelo sistema externo que criou o título e que deve ser compartilhado com o Gestão Escolar para que cada interação funcione de forma correta
|S
|S
|1
|1
|50
|50
|-
|-
|'''formaPagamento'''
|'''valorDocumento'''
|Forma de pagamento para execução da baixa.
|Valor que representa o título
|N
|
|
|}
===Financeiro: Alteração de títulos===
Método: Post
(base)/gestaoescolar/services/financeiro/rest/titulo
Ao fazer um POST com indicando o campo de integração (Nosso número) , o valor do documento e a data de vencimento o Web Service irá fazer alteração dos campos correspondentes no boleto já gerado durante a fase da matricula do aluno permitindo assim que os dados desses campos fiquem sincronizados entre os sistemas.
|S
{| class="wikitable"
|3
|'''Atributo'''
|20
|'''Descrição'''
|Tipo
|Mínimo
|Máximo
|-
|-
|'''dataOcorrencia'''
|'''dataVencimento'''
|Data de aconteceu a baixa do título, essa data será usada como referência pela baixa no gestão escolar e deve ser incluída,
|Data de vencimento do título
|S
|S
|10
|10
|10
|10
|-
|-
|'''valorPagamento'''
|'''nossoNumero'''
|Valor do pagamento que deve ser executado no gestão escolar
|Número gerado pelo sistema externo que criou o título e que deve ser compartilhado com o Gestão Escolar para que cada interação funcione de forma correta
|S
|1
|50
|-
|'''valorDocumento'''
|Valor que representa o título
|N
|N
|
|
|
|
|}
|}
'''Respostas esperadas'''
'''Respostas esperadas'''
Status 200: Status Processamento: OK
Status 200: Status Processamento: OK
Status 417: Status Processamento: TITULO_NAO_EXISTE (Quando o título informado não existe)
Status 417: Status Processamento: TITULO_NAO_EXISTE (Quando o título informado não existe)
Body:
Body:
{"nossoNumero":"58745876","formaPagamento":"BOLETO","valorPagamento":1100.0,"dataOcorrencia":"11/06/2021"}
{"nossoNumero":"58745876","valorDocumento":"1100.0", "dataVencimento":"11/07/2021"}
=====Resposta=====
=====Resposta=====
"dados": {
"dados": {
"nomeSacado": "Aluno teste",
"nomeSacado": "Aluno teste",
"valorDespesaCobranca": 0.0,
"valorDespesaCobranca": 0.0,
"valorDocumento": 1000.0,
"valorDocumento": 1100.0,
"valorLiquido": 0.0,
"valorLiquido": 0.0,
"valorOutrosCreditos": 0.0,
"valorOutrosCreditos": 0.0,
"valorPagamento": 1100.0,
"dataVencimento": "10/07/2021",
"nossoNumero": "58745876"
"nossoNumero": "58745876"
}
}
===Financeiro: Cancela Título.===
===Financeiro: Baixa Título.===
Método: Delete
Método: Post
(base)/gestaoescolar/services/financeiro/rest/titulo
(base)/gestaoescolar/services/financeiro/rest/titulo
{| class="wikitable"
{| class="wikitable"
|1
|1
|50
|50
|}
|-
|'''formaPagamento'''
|Forma de pagamento para execução da baixa.
Valores válidos:
DINHEIRO, CHEQUE, C_CREDITO,C_DEBITO, BOLETO, DEB_AUTOMATICO,TRANSFERENCIA, DOC,OUTRO_BAIXA_ADM,DEPOSITO,DUPLICADA, FIES, PREFEITURA,PROUNI, FOLHA_DE_PGTO, CHEQUE_PRE,PAGAMENTO_ONLINE, PERMUTA, PIX
|S
|3
|20
|-
|'''dataOcorrencia'''
|Data de aconteceu a baixa do título, essa data será usada como referência pela baixa no gestão escolar e deve ser incluída,
|S
|10
|10
|-
|'''valorPagamento'''
|Valor do pagamento que deve ser executado no gestão escolar
|N
|
|
|-
|'''dataVencimento'''
|Data de vencimento do título que está em processo de baixa
|S
|10
|10
|-
|'''valorDocumento'''
|Valor do documento original que está em processo de baixa
|N
|
|
|}
A diferença entre as duas APIs acima é o campo "valorPagamento", caso ele seja informado será obrigatório ter os dados de forma de pagamento e data da ocorrência. Caso não seja informado o valor do pagamento, será feita a tentativa de alterar o titulo com o valor do campo valorDocumento ou dataVencimento.
'''Respostas esperadas'''
Status 200: Status Processamento: OK
Status 417: Status Processamento: TITULO_JA_CANCELADO (Quando tenta cancelar um titulo que já foi cancelado)
"acao": "Manutenção OK",
Status 417: Status Processamento: TITULO_JA_BAIXADO (Quando tenta cancelar um titulo que já foi baixado)
Status 417: Status Processamento: TITULO_NAO_EXISTE (Quando o título informado não existe)
tatus 417: Status Processamento: ERRO: Erro genérico de negócio
Status 500: Status Processamento: ERRO
====Exemplo====
=====Requisição=====
Body:
{"nossoNumero":"58745876","formaPagamento":"BOLETO","valorPagamento":1100.0,"dataOcorrencia":"11/06/2021"}
=====Resposta=====
{
"acao": "Manutenção OK",
"dados": {
"dados": {
"formaPagamento": "BOLETO",
"nomeSacado": "Aluno teste",
"nomeSacado": "Aluno teste",
"numeroDocumento": 8597756,
"numeroDocumento": 8597757,
"valorAbatimentoConcedido": 0.0,
"valorAbatimentoConcedido": 0.0,
"valorOutrosCreditos": 0.0,
"valorOutrosCreditos": 0.0,
"nossoNumero": "58745875"
"valorPagamento": 1100.0,
"dataOcorrencia": "11/06/2021",
"nossoNumero": "58745876"
},
},
}
}
===Financeiro: Consulta Títulos.===
===Financeiro: Cancela Título.===
Método: GET
Método: Delete
(base)/gestaoescolar/services/financeiro/rest/titulo
(base)/gestaoescolar/services/financeiro/rest/titulo
Executa a consulta determinados do título
Executa o cancelamento do título
{| class="wikitable"
{| class="wikitable"
|'''Atributo'''
|'''Atributo'''
|Máximo
|Máximo
|-
|-
|'''skumatricula'''
|'''nossoNumero'''
|Identificador único da matrícula (padrão) EAD
|Número gerado pelo sistema interno que criou o título e que deve ser compartilhado com o Gestão Escolar para que cada interação funcione de forma correta
|S
|S
|1
|1
|
|50
|-
|}
====Respostas esperadas====
Status 200: Status Processamento: OK
Status 417: Status Processamento: TITULO_JA_CANCELADO (Quando tenta cancelar um titulo que já foi cancelado)
Status 417: Status Processamento: TITULO_JA_BAIXADO (Quando tenta cancelar um titulo que já foi baixado)
Status 417: Status Processamento: TITULO_NAO_EXISTE (Quando o título informado não existe)
tatus 417: Status Processamento: ERRO: Erro genérico de negócio
Status 500: Status Processamento: ERRO
====Exemplo====
=====Requisição=====
Param:
nossoNumero=[numero]
====Respostas esperadas====
=====Resposta=====
{
"acao": "Manutenção OK",
"dados": {
"nomeSacado": "Aluno teste",
"numeroDocumento": 8597756,
"valorAbatimentoConcedido": 0.0,
"acao": "Manutenção OK",
"dados": [
"valorDescontoConcedido": 0.0,
"valorDespesaCobranca": 0.0,
"valorDocumento": 1000.0,
"valorLiquido": 0.0,
"valorMoraMulta": 0.0,
"valorOutrasDespesas": 0.0,
"valorOutrosCreditos": 0.0,
"nossoNumero": "58745875"
},
"response": "OK",
"response": "OK",
}
}
===Financeiro: Consulta Títulos alterado no período.===
===Financeiro: Consulta Títulos.===
Método: GET
Método: GET
(base)/gestaoescolar/services/financeiro/rest/tituloalteradosperiodo
(base)/gestaoescolar/services/financeiro/rest/titulo
Executa a consulta determinados do título
{| class="wikitable"
{| class="wikitable"
|'''Atributo'''
|'''Atributo'''
|Máximo
|Máximo
|-
|-
|'''inicio'''
|'''skumatricula'''
|Data de inicio da consulta
|Identificador único da matrícula (padrão) EAD
|S
|S
|10
|1
|10
|
|-
|-
|'''fim'''
|'''idmatricula'''
|Data fim da consulta
|Identifcador interno da matricula
|S
|N
|10
|
|10
|11
|}
|-
Atenção: O intervalo de datas permitido para consulta é de no máximo 7 dias. Ao não informar o início, caso o fim tenha data,será considerado a mesma data para início e vice versa. Caso as duas datas sejam nulas/vazias, será considerado o dia atual em ambas.
|'''cpf'''
|CPF do aluno, irá trazer todos os títulos relacionados
====Respostas esperadas====
|N
Status 200: Status Processamento: OK
|
|11
Status 417: Status Processamento: ERRO , caso o intervalo de datas informado seja maior do que 7 dias
|-
|'''rmaluno'''
Status 500: Status Processamento: ERRO
|Código de RM (registro de matricula) do aluno, só aplicado no filtro se não tiver uma idmatricula informado
|S
|
|
|-
|'''codigocurso'''
|Código do curso, só aplicado quando o rmaluno é informado no filtro
|S
|
|
|-
|'''exibecancelados'''
|Exibe ou não os títulos cancelados , padrão false, informe true para ligar o parâmetro
|S
|
|
|}
Use o parâmetro skumatricula, idinternomatricula ou cpf, caso informe os três, será usado o skumatricula como
padrão e se localizar uma matrícula para o id informado irá retornar os títulos ligados a ela, usando o cpf
irá retornar os títulos localizados para o aluno para qualquer matrícula.
O parâmetro skumatricula é referene ao código da matrícula feito em um sistema externo EAD que está ligado ao gestão escolar, ao informar esse código
será retornada apenas as títulos referentes a essa matrícula. Se passar o idmatricula, é referente ao identificador interno do Gestão Escolar, utilize a API de consultas de matrículas para obter esse código para usar aqui e informado esse parâmetro será carregado os títulos referentes a essa matrícula.
No caso, o CPF do aluno, quando informado, vai pegar todos os títulos, de qualquer matrícula, que esteja associado ao CPF do aluno
====Respostas esperadas====
Status 200: Status Processamento: OK
Status 500: Status Processamento: ERRO
====Exemplo====
=====Requisição=====
Param:
cpf=[numero] ou skumatricula=[numero], exibecancelados=[texto]
=====Resposta=====
"acao": "Manutenção OK",
"dados": [
{
"tituloSituacaoRemote": "ATRASADO",
"dataVencimento": "30/07/2021",
"codigoIntegracao": "SKU_TESTE",
"codigoMatriculaUnico": "UYJA_HAHHS",
"nomeSacado": "Luíza da Silva",
"numeroDocumento": 430114,
"valorDocumento": 1400.02
},
{
"tituloSituacaoRemote": "PENDENTE",
"codigoIntegracao": "SKU_TESTE",
"codigoMatriculaUnico": "UYJA_HAHHS",
"dataVencimento": "30/08/2021",
"nomeSacado": "Luíza da Silva",
"numeroDocumento": 430092,
"valorDocumento": 1400.02
}
],
"response": "OK",
"statusProcessamento": "OK"
}
===Financeiro: Consulta Títulos alterado no período===
Método: GET
(base)/gestaoescolar/services/financeiro/rest/tituloalteradosperiodo
Executa a consulta determinados do título que foram alterados no período
{| class="wikitable"
|'''Atributo'''
|'''Descrição'''
|Tipo
|Mínimo
|Máximo
|-
|'''inicio'''
|Data de inicio da consulta
|S
|10
|10
|-
|'''fim'''
|Data fim da consulta
|S
|10
|10
|}
Atenção: O intervalo de datas permitido para consulta é de no máximo 7 dias. Ao não informar o início, caso o fim tenha data,será considerado a mesma data para início e vice versa. Caso as duas datas sejam nulas/vazias, será considerado o dia atual em ambas.
====Respostas esperadas====
Status 200: Status Processamento: OK
Status 417: Status Processamento: ERRO , caso o intervalo de datas informado seja maior do que 7 dias
Status 500: Status Processamento: ERRO
====Exemplo====
=====Requisição=====
Param:
cpf=[numero] ou skumatricula=[numero], exibecancelados=[texto]
=====Resposta=====
"acao": "Manutenção OK",
"dados": [
{
"tituloSituacaoRemote": "ATRASADO",
"dataVencimento": "30/07/2021",
"nomeSacado": "Luíza da Silva",
"pagamentoTerceiroCodigoExterno": "55848848",
"numeroDocumento": 430114,
"valorDocumento": 1400.02
},
{
"tituloSituacaoRemote": "PENDENTE",
"dataVencimento": "30/08/2021",
"nomeSacado": "Luíza da Silva",
"pagamentoTerceiroCodigoExterno": "55848848",
"numeroDocumento": 430092,
"valorDocumento": 1400.02
}
],
"response": "OK",
"statusProcessamento": "OK"
}
===Controle de acesso: Envio de eventos de entrada e saída===
Método: POST
(base)/gestaoescolar/services/controleacesso/rest/add
Insere registros de entrada e saída para alunos. Deve ser enviado um array com 1 ou mais registros.
'''<u>Importante: Enviar os eventos na ordem certa, ou seja, ordenado por data/hora. Não pode enviar primeiro a SAÍDA e depois a ENTRADA. Sempre ordenar pela data/hora crescente para enviar.</u>'''
{| class="wikitable"
|'''Atributo'''
|'''Descrição'''
|Tipo
|Mínimo
|Máximo
|-
|'''dataHoraOcorrencia'''
|Data e hora do evento. Formato: dd/mm/yyyy HH:mm
|S
|16
|16
|-
|'''descricao'''
|Descrição a ser gravada na ficha do aluno para esse evento. Exemplo: "Registrado por reconhecimento facial"
|S
|1
|20
|-
|'''ra'''
|Deve ter a String exata que representa a Registro de Matrícula do aluno (rm)
|S
|1
|255
|-
|'''tipoAcessos'''
|Informar "E" para entrada ou "S" para saída
|S
|1
|1
|}
Exemplo de request:
[{
"dataHoraOcorrencia": "23/08/2022 13:20",
"descricao": "Registrado por reconhecimento facial",
"ra": "1655",
"tipoAcessos": "S"
},
{
"pagamentoTerceiroCodigoExterno": "55848848",
"dataHoraOcorrencia": "23/08/2022 13:13",
"descricao": "Registrado por reconhecimento facial",
"ra": "2726",
"tipoAcessos": "E"
}
}
]
----
----
----
----
[[Category:GestaoEscolar]]
[[Category:GestaoEscolar]]
[[Category:API]]
[[Category:API]]
