ConnectCloud Developers

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"

View as Markdown · Interactive reference · OpenAPI