Replace the tenant's price calculation scale (tenant:settings:write)
PUT /api/masterdata/price-tiers
Module: Master data · operationId: savePriceTiers · Tag: Settings · Auth: access token (Authorization: Bearer <accessToken>)
Replaces the scale as a whole. At least one row; the first starts at fromCost 0, fromCost
rises strictly from row to row (4 decimals), markupRate is 0–1000, at most 50 rows. Invalid rows
answer 400 with field keys like priceTiers[1].fromCost.
Request body
application/json (required)
priceTiers(array of PriceTier, required): Rows ordered byfromCostfromCost(number, required): Purchase price from which the row applies (inclusive, net, base currency); the first row is 0markupRate(number, required): Markup in percent of the purchase price (max 1000)rounding(string, required):NONErounds half up to cents;UP_xrounds up to the next multiple of x (0.05, 0.10, 0.50, 1, 5, 10);END_90/END_99take the smallest price ending in .90/.99 that is not below the value. (one ofNONE,UP_0_05,UP_0_10,UP_0_50,UP_1,UP_5,UP_10,END_90,END_99)
Example:
{
"priceTiers": [
{
"fromCost": 0,
"markupRate": 35,
"rounding": "END_99"
},
{
"fromCost": 500,
"markupRate": 25,
"rounding": "END_99"
},
{
"fromCost": 2000,
"markupRate": 15,
"rounding": "UP_10"
}
]
}
Responses
- 200 Saved (
application/json) - 400 Malformed body or query parameter (
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 byfromCostfromCost(number, required): Purchase price from which the row applies (inclusive, net, base currency); the first row is 0markupRate(number, required): Markup in percent of the purchase price (max 1000)rounding(string, required):NONErounds half up to cents;UP_xrounds up to the next multiple of x (0.05, 0.10, 0.50, 1, 5, 10);END_90/END_99take the smallest price ending in .90/.99 that is not below the value. (one ofNONE,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 PUT 'https://api.mbcom.cloud/api/masterdata/price-tiers' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"priceTiers":[{"fromCost":0,"markupRate":35,"rounding":"END_99"},{"fromCost":500,"markupRate":25,"rounding":"END_99"},{"fromCost":2000,"markupRate":15,"rounding":"UP_10"}]}'