Skip to main content

PATCH Ativar ou Desativar Desconto

Desativa um desconto.

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 update_discounts.


Endpoint​

PATCH https://api-dev.imagemais.com.br/api/finances/discounts/{id}/status

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
idnumber✅ID do desconto

Requisição​

curl -X 'PATCH' \
'https://api-dev.imagemais.com.br/api/finances/discounts/1/status' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

Inverte o isActive do desconto (ativo ↔ inativo). A resposta traz o desconto como estava antes da troca — para saber o novo estado, inverta o isActive retornado ou busque o desconto de novo.

{
"data": {
"id": 3,
"name": "Agendamento",
"description": "Desconto de agendamento",
"percentage": null,
"fixed": "10",
"isActive": true,
"expirationDate": null,
"isEveryone": false,
"procedures": [
{
"id": 18,
"name": "Consulta",
"price": "100"
}
],
"createdAt": "2026-08-21T23:58:32.077Z",
"updatedAt": "2026-08-21T23:58:32.077Z"
}
}

403 Sem permissão​

{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}

404 Não encontrado​

{
"message": "Desconto não encontrado",
"error": "Not Found",
"statusCode": 404
}