u

src/api/openapi.js

@@ -974,7 +974,7 @@
  *             type: string
  *     ManifestLine:
  *       type: object
- *       required: [id, sku, name, pu, amount, net, rebate, taxrate, comment]
+ *       required: [id, sku, name, pu, amount, net, rebate, taxrate, shippable, comment]
  *       description: Line shape for quote and order
  *       properties:
  *         id:
@@ -1001,6 +1001,9 @@
  *         comment:
  *           type: string
  *           nullable: true
+ *         shippable:
+ *           type: boolean
+ *           description: false for non-shippable lines (e.g. shipping cost, rounding); excluded from shipment and from order completeness (`isShipped`)
  *     ManifestLineInput:
  *       type: object
  *       required: [amount, net, taxrate]
@@ -1030,6 +1033,9 @@
  *         comment:
  *           type: string
  *           nullable: true
+ *         shippable:
+ *           type: boolean
+ *           description: Defaults to true. Set false for non-shippable lines (e.g. shipping cost, rounding); they cannot be shipped and do not make the order incomplete.
  *     QuoteSummary:
  *       type: object
  *       required: [id, number, type, date]

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: