ConnectCloud Developers

Get the tenant's price calculation scale (tenant:masterdata:read)

GET /api/masterdata/price-tiers

Module: Master data · operationId: getPriceTiers · Tag: Settings · Auth: access token (Authorization: Bearer <accessToken>)

Markup and rounding per purchase price range, ordered by fromCost. Product groups without own priceTiers use their parent's scale, then this one. While none is stored the answer is the default scale: one row from 0 with 0 % and NONE.

Responses

  • 200 The scale (application/json)
  • 401 Missing, invalid or expired token (empty body)
  • 403 The token lacks the permission or carries no tenant (application/json)

Fields of the 200 answer:

  • priceTiers (array of PriceTier, required): Rows ordered by fromCost
    • fromCost (number, required): Purchase price from which the row applies (inclusive, net, base currency); the first row is 0
    • markupRate (number, required): Markup in percent of the purchase price (max 1000)
    • rounding (string, required): NONE rounds half up to cents; UP_x rounds up to the next multiple of x (0.05, 0.10, 0.50, 1, 5, 10); END_90/END_99 take the smallest price ending in .90/.99 that is not below the value. (one of NONE, UP_0_05, UP_0_10, UP_0_50, UP_1, UP_5, UP_10, END_90, END_99)

Example 200 answer:

{
  "priceTiers": [
    {
      "fromCost": 0,
      "markupRate": 35,
      "rounding": "END_99"
    },
    {
      "fromCost": 500,
      "markupRate": 25,
      "rounding": "END_99"
    },
    {
      "fromCost": 2000,
      "markupRate": 15,
      "rounding": "UP_10"
    }
  ]
}

Example request

curl -X GET 'https://api.mbcom.cloud/api/masterdata/price-tiers' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI