Skip to main content

PATCH Atualizar Regra de Pagamento

Atualiza dias e/ou valor mínimo de uma regra 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.

Sem permissão específica

Não exige @CheckPermissions — basta estar autenticado.


Endpoint​

PATCH https://api-dev.imagemais.com.br/api/payment-rules/{id}

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
idstring✅ID da regra de pagamento

Corpo da Requisição​

CampoTipoObrigatórioValores válidosDescrição
daysOfWeekstring[]❌DOM, SEG, TER, QUA, QUI, SEX, SAB; ao menos 1 itemDias da semana cobertos pela regra (mesmo enum de DoctorScheduleDays.dayOfWeek)
minimumPaymentValuenumber❌mín. 0Valor do pagamento mínimo garantido nesses dias
excludedProcedureIdsnumber[]❌inteiroProcedimentos com produtividade calculada à parte, fora da regra do mínimo

Requisição​

curl -X 'PATCH' \
'https://api-dev.imagemais.com.br/api/payment-rules/abc123' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"daysOfWeek": [
"DOM"
],
"minimumPaymentValue": 700,
"excludedProcedureIds": [
12,
34
]
}'

Respostas​

200 Sucesso​

{
"data": {
"id": 3,
"doctorId": 4,
"accountId": 1,
"daysOfWeek": [
"DOM"
],
"minimumPaymentValue": "2",
"excludedProcedureIds": [],
"createdAt": "2026-09-30T18:48:36.230Z",
"updatedAt": "2026-09-30T18:48:36.460Z",
"deletedAt": null
}
}

400 Requisição inválida​

Mensagens possíveis:

  • Os seguintes dias já possuem uma regra de pagamento para este médico: {join}
  • Um ou mais procedimentos informados não foram encontrados
{
"message": "Os seguintes dias já possuem uma regra de pagamento para este médico: {join}",
"error": "Bad Request",
"statusCode": 400
}

404 Não encontrado​

{
"message": "Regra de pagamento não encontrada",
"error": "Not Found",
"statusCode": 404
}

500 Erro interno​

{
"message": "Erro ao atualizar regra de pagamento",
"error": "Internal Server Error",
"statusCode": 500
}