## 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 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:

```json
{
  "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

```bash
curl -X POST 'https://api.mbcom.cloud/api/trade/v1/msp/price-suggestions/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/accept' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
