u

src/api/routes/order.js

@@ -151,7 +151,7 @@ export function register(app, basePath = '') {
      *       Creates a sales order with header and lines in one transaction.
      *       `date` is the document date (expected delivery).
      *       `entityId` must be a company customer (not Lieferanten).
-     *       Each line requires `sku` or `name`, `amount`, `net`, and `taxrate` (rate); `pu` defaults to `1`; `rebate` defaults to `0`.
+     *       Each line requires `sku` or `name`, `amount`, `net`, and `taxrate` (rate); `pu` defaults to `1`; `rebate` defaults to `0`; `shippable` defaults to `true` (`false` = not shippable, excluded from order completeness).
      *     security:
      *       - cookieAuth: []
      *     x-markdown: order/create.md

src/api/routes/shipment.js

@@ -181,11 +181,14 @@ export function register(app, basePath = '') {
      *                 description: Positions to ship
      *                 items:
      *                   type: object
-     *                   required: [sku]
+     *                   description: Provide `sku` for order lines with a SKU, or `orderLineId` for SKU-less order lines (exactly one of them).
      *                   properties:
      *                     sku:
      *                       type: string
-     *                       description: Article SKU
+     *                       description: Article SKU (omit for SKU-less order lines)
+     *                     orderLineId:
+     *                       type: integer
+     *                       description: Order line id (`lines[].id` of the order); required for SKU-less lines, ignored when `sku` is given
      *                     amount:
      *                       type: number
      *                       description: Quantity to ship. Defaults to remaining unshipped quantity for this SKU.
@@ -212,7 +215,7 @@ export function register(app, basePath = '') {
      *                 shipment:
      *                   $ref: '#/components/schemas/Shipment'
      *       400:
-     *         description: Validation error or article not in order
+     *         description: Validation error, article not in order, or article not shippable
      *         content:
      *           application/json:
      *             schema: