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:
{
"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
curl -X POST 'https://api.mbcom.cloud/api/trade/v1/purchase-carts/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/order' \
-H "Authorization: Bearer $ACCESS_TOKEN"