Gestão de inspeções
Execução das inspeções. Cada registro liga um equipamento a uma inspeção, em uma
data, com inspetor, supervisor, checklist e resultado. Corresponde à tela
Gestão de inspeções, do módulo Gestão de equipamentos. Cada registro recebe um
código sequencial (code) e começa com o status Em preparação. O checklist do
registro está em Checklist da gestão de inspeção.
Status
status_id | Status | Significado |
|---|---|---|
| 1 | Em preparação | Registro criado. Pode ser alterado, apagado e ter o checklist preenchido |
| 2 | Aguardando inspeção | Enviado ao inspetor |
| 3 | Aguardando aprovação do supervisor | Concluído pelo inspetor, com supervisor indicado |
| 4 | Concluído | Inspeção encerrada |
Endpoints
| Método | Caminho | Descrição |
|---|---|---|
| GET | /equipment-management/inspections-management | Lista as gestões de inspeção |
| POST | /equipment-management/inspections-management | Cria uma gestão de inspeção |
| GET | /equipment-management/inspections-management/{uuid} | Consulta uma gestão de inspeção |
| PUT | /equipment-management/inspections-management/{uuid} | Altera uma gestão de inspeção |
| DELETE | /equipment-management/inspections-management/{uuid} | Apaga uma gestão de inspeção |
| PATCH | /equipment-management/inspections-management/{uuid}/change-status | Avança o status (Concluir, enviar para inspeção ou aprovar) |
| GET | /equipment-management/inspections-management/{uuid}/report | Abre o relatório da inspeção em PDF (Ver arquivo) |
| GET | /equipment-management/inspections-management/equipments | Lista os equipamentos para o campo Equipamento |
| GET | /equipment-management/inspections-management/inspections | Lista os vínculos de inspeção dos equipamentos, para o campo Inspeção |
| GET | /equipment-management/inspections-management/inspectors | Lista os inspetores, para o campo Inspetor |
| GET | /equipment-management/inspections-management/supervisors | Lista os supervisores, para o campo Supervisor |
| GET | /equipment-management/inspections-management/results | Lista os resultados gerais, para o campo Resultado |
GET /equipment-management/inspections-management
Lista as gestões de inspeção da empresa cliente.
Parâmetros de URL
| Parâmetro | Descrição |
|---|---|
| search | Texto para buscar pelo nome da inspeção |
| inspection_uuid | Lista somente as gestões do modelo de inspeção de uuid informado |
| status_id | Lista somente as gestões com o status informado |
| not_status_id | Exclui as gestões com o status informado |
| result_id | Lista somente as gestões com o resultado geral informado |
| per_page | Quantidade de registros por página. Com ele, a resposta é paginada |
| page | Número da página, quando per_page é informado |
Resposta (200): lista de gestões com id, uuid, code, equipment_id,
inspection_id, date, status_id, result_id, inspector_id, supervisor_id,
inspection_name, equipment_name, serial_number, status_name, result_name,
inspector_name e supervisor_name.
POST /equipment-management/inspections-management
Cria uma gestão de inspeção. O registro começa com o status Em preparação.
Corpo
| Campo | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| equipment_id | Sim | Número inteiro | id do equipamento, obtido em GET /equipment-management/inspections-management/equipments |
| inspection_id | Sim | Número inteiro | id do vínculo da inspeção ao equipamento, obtido em GET /equipment-management/inspections-management/inspections (não é o id do modelo) |
| date | Sim | Data (AAAA-MM-DD) | Data da inspeção |
| inspector_id | Não | Número inteiro | id do inspetor, obtido em GET /equipment-management/inspections-management/inspectors |
| supervisor_id | Não | Número inteiro | id do supervisor, obtido em GET /equipment-management/inspections-management/supervisors |
| result_id | Não | Número inteiro | id do resultado geral, obtido em GET /equipment-management/inspections-management/results |
| comments | Não | Texto | Observações sobre a inspeção |
Resposta (201): o registro criado, com uuid, code e status_id igual a 1.
curl -X POST https://api.pedagogo.app/equipment-management/inspections-management \
-H "Authorization: Bearer <token-de-sessao>" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"equipment_id": 25, "inspection_id": 41, "date": "2026-11-10", "inspector_id": 7}'
GET /equipment-management/inspections-management/{uuid}
Devolve o registro, com os dados do equipamento, da inspeção, do inspetor, do
supervisor, o status, o resultado e a lista de itens do checklist (checklists).
Resposta (200).
PUT /equipment-management/inspections-management/{uuid}
Altera o registro. Os campos são os mesmos do cadastro, todos com Não. Na tela, a edição só é feita com o status Em preparação. Resposta (200): o registro alterado.
DELETE /equipment-management/inspections-management/{uuid}
Apaga o registro (exclusão lógica). Na tela, só é feito com o status Em
preparação. Resposta (200), com corpo null.
PATCH /equipment-management/inspections-management/{uuid}/change-status
Avança o status do registro. A ação depende do status atual e de quem chama. Sem corpo.
Regras
- Se algum item do checklist estiver sem resultado, a resposta é 400 com a
mensagem
Complete o checklist.. - Em preparação (1): exige inspetor (400,
Selecione um inspetor.). Quando quem chama é o inspetor, exige resultado geral (400,Informe o resultado para concluir a inspeção.) se não houver supervisor. Com supervisor, o status passa a Aguardando aprovação do supervisor (3). Sem supervisor, a inspeção é concluída (4). Quando quem chama não é o inspetor, o registro é enviado para inspeção (2). - Aguardando inspeção (2): só o inspetor pode concluir (400,
Somente o inspetor pode aprovar a inspeção.). Exige resultado geral. Sem supervisor, o status passa a Concluído (4). Com supervisor, passa a Aguardando aprovação do supervisor (3). - Aguardando aprovação do supervisor (3): só o supervisor pode finalizar (400,
Somente o supervisor pode finalizar a inspeção.). Exige resultado geral. O status passa a Concluído (4). - Concluído (4): a resposta é 400, com a mensagem
Inspeção já finalizada..
Ao concluir a inspeção sem supervisor, o relatório em PDF é gerado.
Resposta
- 200:
{"message": "Status alterado."}. - 400:
{"message": "..."}, com a mensagem da regra que bloqueou a ação.
GET /equipment-management/inspections-management/{uuid}/report
Abre o relatório da inspeção em PDF, para download. Se o relatório ainda não tiver sido guardado, ele é gerado na hora. O relatório traz os dados da inspeção, o checklist com resultados e fotos, o resultado geral e os campos de assinatura do inspetor e do supervisor.
Auxiliares
| Caminho | Parâmetros | Resposta |
|---|---|---|
| GET /equipment-management/inspections-management/equipments | search (descrição, número de série ou grupo), group_id | Equipamentos, com id, uuid, details, serial_number e group_name |
| GET /equipment-management/inspections-management/inspections | equipment_id, equipment_uuid, startExpiration, endExpiration | Vínculos de inspeção, com id (usado em inspection_id), inspection, equipment_id, details, serial_number, group_name, expiration_date e matrix |
| GET /equipment-management/inspections-management/inspectors | search (nome, e-mail ou celular) | Usuários cadastrados como inspetores |
| GET /equipment-management/inspections-management/supervisors | search (nome, e-mail ou celular) | Usuários cadastrados como supervisores |
| GET /equipment-management/inspections-management/results | Nenhum | Resultados gerais, com id e result |