Excluir Processo
Remove um processo do sistema
Descrição
Remove permanentemente um processo do sistema com as seguintes características:
- Permite exclusão apenas quando não há informadores cadastrados no processo
- Remove automaticamente respostas de questionários vinculadas ao processo
- Remove histórico de grupos e vínculos residuais da pivot
- Operação irreversível - não pode ser desfeita
- Valida se o processo existe antes da exclusão
- Retorna confirmação da exclusão
- Requer autenticação JWT válida
Detalhes do Endpoint
VERBO
DELETE
URL BASE
http://api.provisao.nabrasil.org.br/v1
ENDPOINT
/processes/{id}
Cabeçalhos
| Parâmetro | Valor |
|---|---|
| Authorization | Bearer <token> |
| Accept | application/json |
Parâmetros da URL
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| id | string | Sim | UUID do processo a ser excluído |
Respostas
Sucesso - 200
{
"success": true,
"message": "Processo excluído com sucesso"
}
Erro - 404 (Processo não encontrado)
{
"success": false,
"message": "Processo não encontrado"
}
Erro - 401 (Token inválido)
{
"success": false,
"message": "Token não fornecido"
}
Erro - 409 (Informadores cadastrados)
{
"success": false,
"message": "Não é possível excluir o processo porque existem informadores cadastrados. Remova todos os informadores antes de excluir o processo."
}
Códigos de Resposta
| Código | Descrição |
|---|---|
| 200 | Processo excluído com sucesso |
| 401 | Token inválido ou expirado |
| 404 | Processo não encontrado |
| 409 | Processo possui informadores cadastrados |