Este endpoint permite gerar uma declaração de matrícula em formato PDF, a partir do CPF de um aluno. O arquivo gerado será disponibilizado por um link para download direto.
🔗 Endpoint
GET| https://portal.unibalsas.edu.br/appub/api/declaracao-matricula/88888888888
📤 Resposta
✅ Sucesso – 200 OK
{
"file_link": "https://portal.unibalsas.edu.br/appub/storage/declaracoesMatricula/NOME_COMPLETO_DO_ALUNO.pdf"
"cpf": "88888888888",
"ra": "88.8.88888"
}Descrição:
O PDF da declaração foi gerado com sucesso. O campo file_link contém o link direto para download do documento.
❌ Erro – CPF inválido ou não encontrado – 404 Not Found
{
"message": "Não foi possível obter os dados do aluno. Verifique o CPF informado."
}Possíveis causas:
CPF não existe no banco de dados.
Aluno não possui matrícula ativa.
Erro no retorno do serviço de consulta SQL.
❌ Erro – Falha ao gerar relatório – 500 Internal Server Error
{
"message": "Falha ao gerar o relatório."
}Possíveis causas:
Erro na comunicação com o WebService da TOTVS.
Problemas com os parâmetros RA ou Período Letivo.
❌ Erro – Falha ao obter o tamanho do relatório – 500 Internal Server Error
{
"message": "Falha ao obter o tamanho do relatório."
}Possíveis causas:
ID do relatório inválido.
Problema no WebService ao retornar o tamanho do arquivo.
❌ Erro – Falha ao obter o arquivo gerado – 500 Internal Server Error
{
"message": "Falha ao obter o arquivo gerado."
}Possíveis causas:
O relatório gerado não retornou conteúdo.
Erro ao buscar o arquivo em base64.
❌ Erro – Falha ao decodificar o arquivo – 500 Internal Server Error
{
"message": "Falha ao decodificar o arquivo em Base64."
}Possíveis causas:
Conteúdo do arquivo está corrompido ou inválido.
Resposta do WebService com base64 malformado.
🛠️ Observações Técnicas
- O serviço se conecta com o WebService da TOTVS via SOAP.
- A geração do relatório é feita com base nos dados RA e IDPERLET consultados com o CPF informado.
- O nome do arquivo PDF gerado é baseado no nome do aluno.