ConnectCloud Developers

Reject a price suggestion (tenant:trade:msp:write, tenant:trade:msp:approve or tenant:masterdata:write)

POST /api/trade/v1/msp/price-suggestions/{id}/reject

Module: Trade · operationId: rejectMspPriceSuggestion · Tag: MSP billing · Auth: access token (Authorization: Bearer <accessToken>)

Marks the suggestion rejected; masterdata is not changed. 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)

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 of open, 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": "rejected",
  "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/reject' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI