Poser / mettre à jour le plafond de remise d'un rôle

PUT

/v1/establishments/{establishmentId}/discount-caps/{roleCode}

curl --request PUT \
  --url 'https://example.com/v1/establishments/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/discount-caps/receptionist?scope=discount' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "maxPctBp": 1, "maxAmountCents": "5000" }'

Upsert du plafond (% max + € max) d’un rôle sur l’établissement. Les rôles illimités (manager/director) ne sont pas configurables (400).

Authorizations

• ApiKeyAuth
• BearerAuth

Parameters

Path Parameters

establishmentId

required

string format: uuid

roleCode

required

string

Example

receptionist

Query Parameters

scope

string

default: discount

Allowed values: discount derogation

Autorité plafonnée : remise folio (discount, défaut) ou dérogation résa (derogation).

Request Body ^required

Media type application/json

object

maxPctBp

required

% max en basis points (1000 = 10 %)

integer

<= 10000

maxAmountCents

required

Montant TTC max remisé en centimes (bigint string, ≥ 0)

string

Example

5000

Responses

200

Media type application/json

object

data

required

object

roleCode

required

string

maxPctBp

required

integer

maxAmountCents

required

string

Example ^generated

{
  "data": {
    "roleCode": "example",
    "maxPctBp": 1,
    "maxAmountCents": "example"
  }
}

400

RoleCode invalide ou rôle illimité (manager/director), montant/pct hors bornes

403

Permission pricing.manage ou scope insuffisant