u

docs/api/routes/order/_id/shipment.post.md

@@ -27,7 +27,8 @@ Updates the materialized `ordersummary` table (`shipped_quantity`, `is_shipped`)
 | `warehouseId` | no | integer | Optional target warehouse ID to deduct stock from (defaults to company default warehouse) |
 | `externalNumber` | no | string | Optional external delivery note reference (defaults to order.externalNumber or order.number) |
 | `lines` | yes | object[] | Positions to ship |
-| `lines[].sku` | yes | string | Article SKU |
+| `lines[].sku` | no | string | Article SKU (omit for SKU-less order lines) |
+| `lines[].orderLineId` | no | integer | Order line id (`lines[].id` of the order); required for SKU-less lines, ignored when `sku` is given |
 | `lines[].amount` | no | number | Quantity to ship. Defaults to remaining unshipped quantity for this SKU. |
 | `lines[].name` | no | string |  |
 | `lines[].pu` | no | number |  |
@@ -44,6 +45,7 @@ Updates the materialized `ordersummary` table (`shipped_quantity`, `is_shipped`)
   "lines": [
     {
       "sku": "…",
+      "orderLineId": 1,
       "amount": 1,
       "name": "…",
       "pu": 1,
@@ -82,7 +84,8 @@ Created shipment
         "net": 1,
         "rebate": 1,
         "taxrate": 1,
-        "comment": "…"
+        "comment": "…",
+        "shippable": true
       }
     ],
     "shippings": [
@@ -124,7 +127,7 @@ Created shipment
 
 | Status | Description |
 |--------|-------------|
-| 400 | Validation error or article not in order — `{"error":"…"}` |
+| 400 | Validation error, article not in order, or article not shippable — `{"error":"…"}` |
 | 401 | Unauthorized — `{"error":"…"}` |
 | 404 | Order not found — `{"error":"…"}` |
 | 409 | Cumulative shipment amount exceeds ordered amount, or insufficient stock — `{"error":"…"}` |