u

src/api/openapi.js

@@ -975,10 +975,11 @@
  *           description: Sort order
  *     StockAdjustmentInput:
  *       type: object
+ *       description: Stock adjustment input. Provide `sku` and `amount` for single-item adjustments, or `lines` for batch adjustments. Note that `sku` must be a string (e.g. "25"), not a number.
  *       properties:
  *         sku:
  *           type: string
- *           description: Article SKU (for single-item adjustment)
+ *           description: Article SKU string (e.g. "25", not a number; for single-item adjustment)
  *         warehouseId:
  *           type: integer
  *           description: Target warehouse ID
@@ -998,12 +999,16 @@
  *             properties:
  *               sku:
  *                 type: string
+ *                 description: Article SKU string (e.g. "25", not a number)
  *               warehouseId:
  *                 type: integer
+ *                 description: Target warehouse ID
  *               amount:
  *                 type: number
+ *                 description: Signed adjustment quantity (+ to add, - to remove)
  *               text:
  *                 type: string
+ *                 description: Reason or memo
  *     StockAdjustmentResult:
  *       type: object
  *       properties:

src/api/routes/stock.js

@@ -65,6 +65,8 @@ export function register(app, basePath = '') {
      *     description: |
      *       Writes signed (+ or -) entries to the append-only ledger under an implicit manifest
      *       of type "adjustment", allocating a number from the "adjustment" number scheme.
+     *
+     *       **Note:** `sku` must be a string (e.g. `"25"`), not a number. For single-item adjustments, provide `sku` and `amount` at top-level. For batch adjustments, provide `lines: [{ sku, amount, ... }]`.
      *     security:
      *       - cookieAuth: []
      *     x-markdown: stock/adjust.md