## Send the cart's purchase orders to their suppliers (tenant:purchase-cart:write plus the channel's send permission)

`POST /api/trade/v1/purchase-carts/{id}/order`

Module: Trade · operationId: `orderPurchaseCart` · Tag: Purchasing · Auth: access token (`Authorization: Bearer <accessToken>`)

Sends every draft, unsent purchase order of the cart through the channel of its offer: EGIS orders through EGIS
(`tenant:egis-order:send` as well), Ingram offers through the Ingram API and masterdata supplier prices by mail
to the supplier's order address (both `tenant:purchase-order:send` as well, like `POST /purchase-orders/{id}/send`);
a channel without a send permission of its own is never used from here. Each order gets an outcome; a failure
(missing data, no channel for the distributor yet – Infinigate –, missing permission) is reported in `error`
and does not stop the others. Sent orders are not sent again.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string (uuid) | yes |  |

### Responses

- **200** One outcome per purchase order (`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** The cart does not allow it (`code`): `cart_not_open` (ordered or discarded), `recommendation_not_open`,
`line_ordered` (the line is on a purchase order), `nothing_to_order`, `no_proposal` (optimize first),
`proposal_stale` / `cart_changed` (optimize again), `accept_in_progress` (an optimization, accept or order of
the cart is running; retry shortly), `drop_ship_no_address` (a drop-ship order has no delivery address).
 (`application/json`)
- **423** An active workflow locks the transaction. (`application/json`)
- **502** A dependent service (DMS, masterdata, a distributor) failed or is unreachable. (`application/json`)
- **503** Purchase orders are not available in this installation. (`application/json`)

Fields of the 200 answer:

- `outcomes` (array of PurchaseCartSendOutcome)
  - `channel` (string): The offer source, e.g. `egis`.
  - `error` (string): Why it was not sent (German); absent when sent.
  - `poId` (string (uuid)): Id of the purchase order.
  - `poNumber` (string): Number of the purchase order.

Example 200 answer:

```json
{
  "outcomes": [
    {
      "channel": "egis",
      "poId": "1b4c5d6e-7f8a-4b9c-8d0e-2f3a4b5c6d75",
      "poNumber": "BE-2026-00075"
    },
    {
      "channel": "masterdata",
      "error": "Für Kabelwerk Süd GmbH ist keine Bestelladresse hinterlegt (Stammdaten › Lieferant › Bestell-E-Mail).",
      "poId": "1b4c5d6e-7f8a-4b9c-8d0e-2f3a4b5c6d74",
      "poNumber": "BE-2026-00074"
    }
  ]
}
```

### Example request

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