ConnectCloud Developers

Get what a sales order has ordered, received and delivered (tenant:trade:sales:read)

GET /api/trade/v1/sales/order-confirmations/{id}/supply

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

Per orderable line of the order (summed over its revisions): the quantity, what linked purchase order lines order and received, and what was delivered (outbound delivery notes plus drop-ship receipts); and every purchase order linked to one of its lines. Computed when read.

Parameters

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

Responses

  • 200 Supply of the order (application/json)
  • 401 No valid session or bearer token (no body).
  • 404 Not an order of the tenant. (application/json)

Fields of the 200 answer:

  • complete (boolean): Every line is delivered, or a stock line is received in full.
  • lines (array of object): Supply per order line.
    • deliveredQty (number): Quantity of the linked delivery note lines (not cancelled) plus what drop-ship purchase orders received.
    • deliveryDate (string (date-time)): The order's delivery date.
    • dropShip (boolean): The line is delivered by drop shipment.
    • orderId (string (uuid)): Id of the sales order.
    • orderLineId (string (uuid)): Id of the order line.
    • orderedQty (number): Quantity of the linked purchase order lines.
    • overOrderedQty (number): Ordered beyond the order line: max(0, orderedQty − quantity).
    • productId (string): Masterdata article (product) id.
    • quantity (number): Quantity of the order line.
    • receivedQty (number): Goods receipt quantity of the linked purchase order lines.
    • rootLineId (string (uuid)): The first revision of the line.
  • orderId (string (uuid)): Id of the sales order.
  • purchaseOrders (array of LinkedPurchaseOrder): Purchase orders linked to the order.
    • dropShip (boolean): The supplier delivers straight to the customer.
    • id (string (uuid)): Id of the purchase order.
    • poNumber (string): Number of the purchase order.
    • status (string): Status of the purchase order.
    • supplierAddressId (string): Masterdata address of the supplier.
    • supplierName (string): Name of the supplier.

Example 200 answer:

{
  "complete": false,
  "lines": [
    {
      "deliveredQty": 6,
      "deliveryDate": "2026-11-24T00:00:00Z",
      "dropShip": false,
      "orderId": "2f6b1d84-7c3e-4a5b-9e21-6a0c4d8b1e02",
      "orderLineId": "9c2d3e4f-5a6b-4c7d-8e8f-1a2b3c4d5e01",
      "orderedQty": 6,
      "overOrderedQty": 0,
      "productId": "4b7d9f13-5e6a-4c8b-a1d2-3e4f5a6b7c02",
      "quantity": 6,
      "receivedQty": 6,
      "rootLineId": "9c2d3e4f-5a6b-4c7d-8e8f-1a2b3c4d5e01"
    },
    {
      "deliveredQty": 1,
      "deliveryDate": "2026-11-24T00:00:00Z",
      "dropShip": false,
      "orderId": "2f6b1d84-7c3e-4a5b-9e21-6a0c4d8b1e02",
      "orderLineId": "9c2d3e4f-5a6b-4c7d-8e8f-1a2b3c4d5e02",
      "orderedQty": 0,
      "overOrderedQty": 0,
      "productId": "4b7d9f13-5e6a-4c8b-a1d2-3e4f5a6b7c01",
      "quantity": 1,
      "receivedQty": 0,
      "rootLineId": "9c2d3e4f-5a6b-4c7d-8e8f-1a2b3c4d5e02"
    }
  ],
  "orderId": "2f6b1d84-7c3e-4a5b-9e21-6a0c4d8b1e02",
  "purchaseOrders": [
    {
      "dropShip": false,
      "id": "1b4c5d6e-7f8a-4b9c-8d0e-2f3a4b5c6d01",
      "poNumber": "BE-2026-0061",
      "status": "received",
      "supplierAddressId": "6d8f0a12-3c4e-4a5b-9d6f-7e8a9b0c1d02",
      "supplierName": "Kabelwerk Süd GmbH"
    }
  ]
}

Example request

curl -X GET 'https://api.mbcom.cloud/api/trade/v1/sales/order-confirmations/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/supply' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI