Dismiss a purchase recommendation (tenant:purchase-recommendation:write)
POST /api/trade/v1/purchase-recommendations/{id}/dismiss
Module: Trade · operationId: dismissPurchaseRecommendation · Tag: Purchasing · Auth: access token (Authorization: Bearer <accessToken>)
Sets an open recommendation aside with a reason (required, 422 without). It stays dismissed while its need stays the same; a different need opens it again.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string (uuid) | yes |
Request body
application/json (required)
reason(string, required)
Example:
{
"reason": "Kunde holt selbst ab"
}
Responses
- 200 Dismissed (
application/json) - 400 Error (
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 Not open (
recommendation_not_open). (application/json) - 422 The input is not valid for the stored data. (
application/json)
Fields of the 200 answer:
articleId(string): Masterdata product id (empty for an order line without article).cartId(string (uuid)): The cart of anin_cartrecommendation.dismissReason(string): Why it was dismissed; set while dismissed.dropShip(boolean): The supplier delivers straight to the customer (shipTo).id(string (uuid)): Id of the recommendation.key(string): Stable key: the first revision of the order line, or the article and warehouse of a stock refill.orderId(string (uuid)): Sales order the recommendation is for; absent for minimum stock.orderLineId(string (uuid)): The current revision of the sales order line.orderNumber(string): Number of that sales order.pendingNeed(number): Set whilein_cartwhen the need changed since: the current need (0 = no need any more).quantity(number): The need; whilein_cartthe quantity in the cart.reason(string): Why (German), e.g.Auftrag AB-2026-00012 Pos. 3 nicht gedeckt.removedNeed(number): Set on an open recommendation a person took out of a cart: the automatic cart leaves it alone up to this quantity.shipTo(object): Delivery address of a drop-ship recommendation.source(string):order: the uncovered rest of a sales order line;stock: refill below the minimum stock. (one oforder,stock)status(string):open,in_cart,orderedordismissed. (one ofopen,in_cart,ordered,dismissed)updatedAt(string (date-time)): When the recommendation was last changed.warehouseId(string): Warehouse of a stock line (empty for drop shipment).
Example 200 answer:
{
"articleId": "4b7d9f13-5e6a-4c8b-a1d2-3e4f5a6b7d07",
"dismissReason": "Kunde holt selbst ab",
"dropShip": false,
"id": "6a9b0c1d-2e3f-4a4b-9c5d-7e8f9a0b1c01",
"key": "stock:4b7d9f13-5e6a-4c8b-a1d2-3e4f5a6b7d07:HAUPT",
"quantity": 16,
"reason": "Mindestbestand 10 unterschritten (frei 4)",
"source": "stock",
"status": "dismissed",
"updatedAt": "2026-11-19T07:00:00Z",
"warehouseId": "HAUPT"
}
Example request
curl -X POST 'https://api.mbcom.cloud/api/trade/v1/purchase-recommendations/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/dismiss' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"reason":"Kunde holt selbst ab"}'