Accept a price suggestion (tenant:trade:msp:write, tenant:trade:msp:approve or tenant:masterdata:write)
POST /api/trade/v1/msp/price-suggestions/{id}/accept
Module: Trade · operationId: acceptMspPriceSuggestion · Tag: MSP billing · Auth: access token (Authorization: Bearer <accessToken>)
Writes the suggested sales and purchase price to the article in masterdata and marks the suggestion accepted.
Needs any one of tenant:trade:msp:write, tenant:trade:msp:approve, tenant:masterdata:write. A suggestion is decided once: a second decision answers 409 price_suggestion_decided; one a run changed since it was read answers 409 price_suggestion_changed.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string (uuid) | yes |
Responses
- 200 The decided suggestion (
application/json) - 401 No valid session or bearer token (no body).
- 403 Missing permission, no active tenant in the token, or a missing CSRF token on a cookie write. (
application/json) - 404 Not found in the tenant. (
application/json) - 409 Already decided (
price_suggestion_decided), changed by a run since it was read (price_suggestion_changed) or – accept only – the article has other prices in masterdata by now (price_changed, nothing written) (application/json) - 502 Masterdata refused the prices (
masterdata_refused); the suggestion stays open (application/json)
Fields of the 200 answer:
articleNumber(string, required): Article number in masterdata.id(string (uuid), required): Id of the suggestion.month(integer, required): Billing month in which the change was found.provider(string, required): The provider the price comes from.skuKey(string, required): The provider's SKU key of the article.status(string, required): Status of the suggestion (open,accepted,rejected). (one ofopen,accepted,rejected)updatedAt(string (date-time), required): When the suggestion last changed.year(integer, required): Billing year in which the change was found.articleId(string (uuid)): The masterdata article.currency(string): Currency (ISO 4217).decidedAt(string (date-time)): When it was accepted or rejected.decidedBy(string): Who decided; missing while open.newPurchase(number): Suggested purchase price.newSales(number): Suggested sales price.oldPurchase(number): Purchase price now in masterdata.oldSales(number): Sales price now in masterdata.priceSince(string (date-time)): The new price applies since.subscriptionId(string): The subscription the price was read from.supplierAddressId(string (uuid)): Masterdata address of the supplier.
Example 200 answer:
{
"articleId": "4b7d9f13-5e6a-4c8b-a1d2-3e4f5a6b7f21",
"articleNumber": "MSFTCFQ7TTC0LCHC0002P1YM",
"currency": "EUR",
"decidedAt": "2026-11-19T10:30:00Z",
"decidedBy": "laura.kaestner@muster-it.example",
"id": "6e7f8a9b-0c1d-4e2f-8a3b-4c5d6e7f8a01",
"month": 10,
"newPurchase": 18,
"newSales": 21.6,
"oldPurchase": 17.2,
"oldSales": 20.6,
"priceSince": "2026-11-01T00:00:00Z",
"provider": "ingram",
"skuKey": "CFQ7TTC0LCHC:0002/P1YM",
"status": "accepted",
"subscriptionId": "1700012399",
"supplierAddressId": "6d8f0a12-3c4e-4a5b-9d6f-7e8a9b0c1d10",
"updatedAt": "2026-11-19T10:30:00Z",
"year": 2026
}
Example request
curl -X POST 'https://api.mbcom.cloud/api/trade/v1/msp/price-suggestions/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/accept' \
-H "Authorization: Bearer $ACCESS_TOKEN"