Skip to main content

POST Criar Desconto

Cria um novo 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 create_discounts.


Endpoint​

POST https://api-dev.imagemais.com.br/api/finances/discounts

Body​

CampoTipoObrigatórioDetalhe
namestring✅Nome do desconto
descriptionstring❌Descrição do desconto
percentagenumber❌Maior que 0, até 100
fixednumber❌Valor fixo de desconto
isEveryoneboolean❌true = aplica a todos os orçamentos
expirationDatestring❌Formato YYYY-MM-DD
proceduresIdsnumber[]❌IDs dos procedimentos específicos

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/finances/discounts' \
-H 'accept: */*' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Desconto VIP 10%",
"description": "Desconto de 10% para clientes VIP",
"percentage": 10,
"fixed": 10,
"isEveryone": true,
"expirationDate": "2025-01-01",
"proceduresIds": [1, 2, 3]
}'

Respostas​

201 Criado com sucesso​

{
"data": {
"id": 8,
"name": "Desconto VIP 10%",
"description": "Desconto de 10% para clientes VIP",
"percentage": 10,
"fixed": "10",
"isActive": true,
"isEveryone": true,
"accountId": 1,
"createdAt": "2026-05-19T17:24:38.745Z",
"updatedAt": "2026-05-19T17:24:38.745Z",
"expirationDate": "2025-01-01T00:00:00.000Z",
"deletedAt": null
}
}

400 Bad Request​

Retornado quando já existe um desconto com o mesmo name na conta, ou quando a gravação falha (ex.: proceduresIds com ID inexistente). O serviço devolve a mesma mensagem genérica nos dois casos.

{
"message": "Erro ao criar desconto",
"error": "Bad Request",
"statusCode": 400
}