Skip to main content

PATCH Atualizar Desconto do Orçamento

Aplica ou remove um desconto geral em um orçamento. Ao aplicar um desconto geral, os descontos individuais dos procedimentos são removidos.

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


Endpoint​

PATCH https://api-dev.imagemais.com.br/api/budgets/discount

Corpo da Requisição​

CampoTipoObrigatórioDescrição
idnumber✅ID do orçamento (inteiro positivo)
discountIdnumber❌ID do desconto a aplicar. Omitir/null remove o desconto geral
customDiscountobject❌Desconto avulso no total do orçamento: kind (PERCENT ou FIXED), value (percentual de 0,01 a 100, ou valor fixo maior que 0, com até 2 casas) e reason (3 a 200 caracteres). O servidor calcula o valor em reais
Descontos por procedimento

Quando um discountId é informado, todos os descontos individuais dos procedimentos deste orçamento são apagados.


Requisição​

curl -X 'PATCH' \
'https://api-dev.imagemais.com.br/api/budgets/discount' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"id": 25266,
"discountId": 7
}'

Respostas​

200 Sucesso​

{
"data": {
"id": 110,
"createUserId": 1,
"patientId": 53,
"statusId": 2,
"createdAt": "2026-09-29T22:33:53.240Z",
"updatedAt": "2026-09-29T22:33:54.407Z",
"deletedAt": null,
"discountId": 3,
"requestingDoctorId": null,
"observationId": null,
"reason": "Paciente vai confirmar com o convênio",
"note": null,
"contacted": false,
"contactedAt": null,
"contactedById": null,
"netValue": "190"
}
}

404 Orçamento não encontrado​

{
"message": "Orçamento não encontrado",
"statusCode": 404
}

500 discountId inválido​

Retornado quando o discountId informado não existe. O endpoint não valida a existência do desconto antes de gravar — o erro vem de uma violação de chave estrangeira no banco, capturada pelo filtro de exceções padrão do NestJS (mensagem genérica, sem tratamento específico no controller).

{
"statusCode": 500,
"message": "Internal server error"
}