Skip to main content

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​

CampoTipoObrigatórioDescrição
idnumber✅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"
}