Exibir código-fonte para Gestão Escolar - API de integração

==Introdução==

Este manual é utilizado principalmente para integração com o site de vendas/e-commerce da instituição de ensino de modo que o site de vendas possa cadastrar e matricular os alunos no sistema Ultramax.

==Pré-Requisitos==

#No endereço dos endopoints abaixo trocar o "(base)" pelo host da instituição, por exemplo: https://demo.ultramax.com.br/, já que cada instituição tem o seu host independente.
#Para gerar o codigoAPI e senhaAPI entre em contato com o suporte da Ultramax através do e-mail suporte@ultramax.com.br ou através de outros canais de atendimento do site [https://www.ultramax.com.br www.ultramax.com.br]
#Além do codigoAPI e senhaAPI entrar em contato com a Ultramax para solicitar a criação de um ambiente de testes.

==Padrões==
   Cada endpoint executado retorna uma resposta com um wrap contendo:

·        Os dados que foram processados

·        A situação do processamento (OK, JAPROCESSADO, ERRO, CURSO_NAO_EXISTE, ALUNO_NAO_EXISTE)

·        Response com o código http (200, 409,417, 500 e 204)

==Endpoints da API==

===Gerar token de autenticação===
Gera um token de autenticação para acessar os recursos da API de Integração do gestão escolar. Este token deve ser utilizado para consumir os demais endpoints.

(base)/gestaoescolar/services/login/login/autentica

====Body====
{| class="wikitable"
|'''Atributo'''
|'''Descrição'''
|-
|'''senhaApi'''
|Deve ter a senha que foi gerada ao cadastrar um  registro de api no sistema gestão escolar
|-
|'''codigoApi'''
|Deve ter o código de api que foi gerado ao cadastrar um registro de  api no sistema gestão escolar
|}

====Respostas esperadas:====
Status 200 , com o respectivo código de token gerado. Onde o código é composto por: Código da api, Data hora atual, Tempo de expiração em 15 minutos, Chave interna

Status 401. Quando a senha e o código de api fornecidos não estão de acordo com o cadastro na área de tabelas/API do Gestão Escolar;

Status 500. Caso algum erro interno ocorra durante o processamento

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

(base)/gestaoescolar/services/curso/rest/add

====Body====
{| class="wikitable"
|'''Atributo'''
|'''Descrição'''
|-
|'''Sigla'''
|Código  identificador do Curso, max 15 caracteres
|-
|'''Nome'''
|Descrição do curso, Max 70  caracters
|-
|'''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, max 9  caracteres
|-
|'''codigoIntegracao'''
|Código único de integração,  será a chave entre os diferentes sistemas, max 255 caracteres
|-
|'''modalidadeCurso'''
|‘EAD’  fixo
|}

====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","nome":"Curso teste","itemServico":"545454","codigoIntegracao":"SA-KJ-AD-NB","modalidadeCurso":"EAD"}

=====Resposta=====
{

   "dados": {

       "sigla": "Curso",

       "nome": "Curso teste",

       "itemServico": "545454",

       "codigoIntegracao": "SA-KJ-AD-NB",

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

(base)/gestaoescolar/services/aluno/rest/responsavelfinanceiro

====Body====
{| class="wikitable"
|'''Atributo'''
|'''Descrição'''
|-
|'''Sigla'''
|Código  identificador do Curso, max 15 caracteres
|-
|'''Celular'''
|:"Número de telefone celular Ex: 11998465521"
|-
|'''Cpf'''
|Sequencia numérica com o CPF do aluno Ex. 65696655565
|-
|'''Email'''
|Email  do aluno Ex: aluno@aluno.com.br
|-
|'''enderecoBairro'''
|Bairro do end residencial do aluno Ex. vila didi
|-
|'''enderecoCep'''
|CEP  do end residencial do aluno Ex. 13203320
|-
|'''enderecoCidade'''
|Cidade do end residencial do aluno Ex. jundiai
|-
|'''enderecoComplemento'''
|Complemento  do end residencial do aluno Ex. casa
|-
|'''enderecoEstado'''
|Estado do end residencial do aluno Ex. SP Max 2 caracteres  deve ser a sigla correspondente ao Estado
|-
|'''enderecoLogradouro'''
|Logradouro  do end residencial do aluno Ex. rua guapore
|-
|'''enderecoNumero'''
|Número do end residencial do aluno Ex. 521
|-
|'''Nascimento'''
|timestamp  com a data de nascimento do aluno Ex 319518000000
|-
|'''Nome'''
|Nome do aluno. Max 70 caracteres
|-
|'''Rg'''
|RG  do aluno Ex: 584245999
|-
|'''Sexo'''
|Indicador do gênero do aluno Ex MASCULINO.

MASCULINO/FEMININO
|}

====Respostas esperadas====
Status 200: Status Processamento: OK

Status 417: Status Processamento: JACADASTRADO

Status  500:  Status Processamento: ERRO

====Exemplo====

=====Requisição=====
{"celular":"11998465521","cpf":2865474325,"email":"wescleyfcosta@gmail.com","enderecoBairro":"vila didi","enderecoCep":"13203320","enderecoCidade":"jundiai","enderecoComplemento":"casa","enderecoEstado":"SP","enderecoLogradouro":"rua guapore","enderecoNumero":"521","nascimento":319518000000,"nome":"wescley","rg":"584245999","sexo":"MASCULINO"}

=====Resposta=====
{

   "dados": {

       "celular": "11998465521",

       "cpf": 2865474325,

       "email": "wescleyfcosta@gmail.com",

       "enderecoBairro": "vila didi",

       "enderecoCep": "13203320",

       "enderecoCidade": "jundiai",

       "enderecoComplemento": "casa",

       "enderecoEstado": "SP",

       "enderecoLogradouro": "rua guapore",

       "enderecoNumero": "521",

       "nascimento": 319518000000,

       "nome": "wescley",

       "rg": "584245999",

       "sexo": "MASCULINO"

   },

   "statusProcessamento": "OK",

   "response": "ACCEPTED",

   "acao": "Manutenção OK"

}

===Manutenção de matrículas===
Adiciona ou altera uma matrícula. Pelo código da matrícula único, código de integração entre os sistemas, será possível atualizar os dados de uma matrícula, caso ela exista, ou incluir uma nova.

(base)/gestaoescolar/services/matricula/rest/add

====Body====
{| class="wikitable"
|'''Atributo'''
|'''Descrição'''
|-
|'''cpf_cnpj'''
|CPF do aluno que será gerada a matrícula, apenas  numeros
|-
|'''codigoIntegracao'''
|Código de integração para um Curso existente
|-
|'''codigoMatriculaUnico'''
|Código de integração para busca de uma matrícula ou  para criar uma nova
|-
|'''numeroSerieDeMatricula'''
|numero inteiro indicando com a sequência da série no curso que a  matrícula deve ser feita. Ex: um curso que tenha três séries e a matrícula  deve ser feita no primeira delas, deve passar 1
|-
|'''Valor'''
|Valor equivamente ao curso: Ex: 1000.0
|-
|'''quantidadeParcelas'''
|Quantidade de parcelas. Ex 1
|-
|'''formaPagamento'''
|Forma de pagamento que deve usado na baixa do título.

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
|-
|'''bandeiraCartao'''
|:"Bandeira do cartão EX VISA". Esse campo depende de novas  conversas com ASAS. '''Por enquanto pode ficar VISA fixo'''
|}

====Respostas esperadas====
Status 200: Status Processamento: OK

Status 417: Status Processamento: JACADASTRADO (quando existe uma outra matrícula não cancelada no mesmo período letivo)

Status 417: Status Processamento: CURSO_NAO_EXISTE (quando o código de integração informado não encontrou um curso correspondente cadastrado)

Status 417: Status Processamento: ALUNO_NAO_EXISTE (quando o C.P.F informado não encontrou um aluno correspondente cadastrado)

Status  500:  Status Processamento: ERRO

====Exemplo====

=====Requisição=====
{"cpf_cnpj":2865474325,"codigoIntegracao":"SA-KJ-AD-NB","codigoMatriculaUnico":"201254","numeroSerieDeMatricula":1,"valor":1000.0,"quantidadeParcelas":1,"formaPagamento":"DINHEIRO","bandeiraCartao":"VISA"}

=====Resposta=====
{

   "dados": {

       "pagamentoCartao": false,

       "cpf_cnpj": 2865474325,

       "codigoIntegracao": "SA-KJ-AD-NB",

       "codigoMatriculaUnico": "201254",

       "numeroSerieDeMatricula": 1,

       "valor": 1000.0,

       "quantidadeParcelas": 1,

       "formaPagamento": "DINHEIRO",

       "bandeiraCartao": "VISA"

   },

   "statusProcessamento": "OK",

   "response": "ACCEPTED",

   "acao": "Manutenção OK"

}

----
[[Category:GestaoEscolar]]
[[Category:API]]