Qualificações do aluno online

Registros de qualificação de uma matrícula online: nota de teoria, nota de prática e data. Na tela, a qualificação fica em Alunos online, na ação Qualificação do menu da linha. A data é obrigatória.

Todas as rotas usam o uuid da matrícula no caminho: {training_student_uuid}.

Endpoints

Método	Caminho	Descrição
GET	/comercial/online-students/{training_student_uuid}/qualifications	Lista as qualificações da matrícula
POST	/comercial/online-students/{training_student_uuid}/qualifications	Registra uma qualificação
GET	/comercial/online-students/{training_student_uuid}/qualifications/{id}	Consulta uma qualificação
PUT	/comercial/online-students/{training_student_uuid}/qualifications/{id}	Altera uma qualificação
DELETE	/comercial/online-students/{training_student_uuid}/qualifications/{id}	Exclui uma qualificação
GET	/comercial/online-students/{training_student_uuid}/qualifications/{id}/report	Gera o relatório da qualificação (PDF)

Consulta

GET /comercial/online-students/{training_student_uuid}/qualifications

Lista as qualificações da matrícula.

Parâmetros de URL

Parâmetro	Descrição
search	Busca pelo nome ou pelo e-mail do aluno
column e order	Coluna e sentido da ordenação
per_page e page	Paginação

Resposta: 200. Sem per_page, a resposta é uma lista simples. Com per_page, a resposta é paginada. Cada item traz id, date, theory, practice, student_name, student_document, student_passport, user_create_name e user_update_name.

GET /comercial/online-students/{training_student_uuid}/qualifications/{id}

Devolve uma qualificação da matrícula.

Resposta: 200, com a qualificação, incluindo a matrícula associada.

GET /comercial/online-students/{training_student_uuid}/qualifications/{id}/report

Gera o relatório da qualificação, em PDF.

Resposta: 200, com o PDF.

Registro, alteração e exclusão

POST /comercial/online-students/{training_student_uuid}/qualifications

Registra uma qualificação na matrícula.

Corpo

Campo	Obrigatório	Tipo	Descrição
date	Sim	data	Data da qualificação
theory	Não	número	Nota de teoria
practice	Não	número	Nota de prática

Resposta: 200, com a qualificação criada.

Exemplo

curl -X POST "https://api.pedagogo.app/comercial/online-students/<uuid-da-matricula>/qualifications" \
  -H "Authorization: Bearer <token-de-sessao>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-03-20",
    "theory": 8.5,
    "practice": 9
  }'

PUT /comercial/online-students/{training_student_uuid}/qualifications/{id}

Altera uma qualificação.

Uma qualificação vinculada a uma avaliação não tem a nota de teoria alterada.

Corpo

Campo	Obrigatório	Tipo	Descrição
date	Não	data	Data da qualificação
theory	Não	número	Nota de teoria. Não pode ser alterada em qualificação vinculada a uma avaliação
practice	Não	número	Nota de prática

Resposta: 200, com a qualificação alterada.

DELETE /comercial/online-students/{training_student_uuid}/qualifications/{id}

Exclui uma qualificação. Uma qualificação vinculada a uma avaliação não pode ser excluída.

Resposta: 200, sem corpo.