DELETE Deletar Fornecedor
Remove um fornecedor existente.
Autenticação necessária
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Permissão necessária
Exige a permissão delete_suppliers.
ID do fornecedor
O id pode ser obtido na rota de Listar Fornecedores, no campo id de cada fornecedor.
Endpoint
DELETE https://api-dev.imagemais.com.br/api/suppliers
Body
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID do fornecedor |
Requisição
curl -X 'DELETE' \
'https://api-dev.imagemais.com.br/api/suppliers' \
-H 'accept: */*' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"id": 4
}'
Respostas
200 Deletado com sucesso
{
"message": "Supplier 4 deletado com sucesso",
"status": 200
}
400 Fornecedor do sistema
Retornado quando o fornecedor é um fornecedor padrão do sistema (isSystem: true), que não pode ser excluído.
{
"statusCode": 400,
"message": "Fornecedor do sistema não pode ser excluído"
}
404 Fornecedor não encontrado
Retornado quando o id informado não existe.
{
"statusCode": 404,
"message": "Supplier não encontrado"
}