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"