Error

A valid request URL is required to generate request examples

{
  "id": "disc-2026-04-17-0142",
  "scope": "ticket",
  "lineId": null,
  "basis": "percent",
  "baseCents": 3980,
  "amountCents": -398,
  "effectiveBps": 1000,
  "reason": "manual_markdown",
  "note": "Damaged packaging on the display unit",
  "actorId": "usr-manager-3",
  "at": "2026-04-17T14:32:05.000Z"
}

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "statusCode": 123,
    "fieldErrors": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

Promotions

Get an applied discount by id

Reads back ONE already-applied discount by the id the caller chose when applying it — the audit trace, not a configuration. It tells you what was taken off (amountCents, SIGNED and <= 0), off what gross (baseCents), how deep that was (effectiveBps), under which coded reason, by which actorId and at what instant. Use it to justify a reduction that already happened or to confirm an apply landed. There is no list endpoint and no search by ticket: you must already hold the id. This reads MANUAL discounts only — automatic promotions are at GET /v1/promotions and promo codes at GET /v1/coupons. 404s when no discount carries the id.

GET

discounts

{id}

Error

A valid request URL is required to generate request examples

{
  "id": "disc-2026-04-17-0142",
  "scope": "ticket",
  "lineId": null,
  "basis": "percent",
  "baseCents": 3980,
  "amountCents": -398,
  "effectiveBps": 1000,
  "reason": "manual_markdown",
  "note": "Damaged packaging on the display unit",
  "actorId": "usr-manager-3",
  "at": "2026-04-17T14:32:05.000Z"
}

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "statusCode": 123,
    "fieldErrors": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

Authorizations

Authorization

string

header

required

Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.

Path Parameters

string

required

Minimum string length: 1

Response

The traced applied discount, with its attribution and signed reduction.

string

required

scope

enum<string>

required

Available options:

line,

ticket

lineId

string | null

required

basis

enum<string>

required

Available options:

percent,

amount

baseCents

integer

required

Required range: -9007199254740991 <= x <= 9007199254740991

amountCents

integer

required

Required range: -9007199254740991 <= x <= 9007199254740991

effectiveBps

integer

required

Required range: -9007199254740991 <= x <= 9007199254740991

reason

enum<string>

required

Available options:

manual_markdown,

promotional,

loyalty_reward,

damaged_goods,

manager_goodwill

actorId

string

required

string

required

note

string

Apply an authorised discount to a whole ticket List automatic promotion rules

Ventes & encaissement

Catalogue & stock

Finance

Clients & fidélité

Marketing & promotions

Services

Système

Other

Get an applied discount by id

Authorizations

Path Parameters

Response