Adjust Stock

Use absolute stock values when adjusting stock. Manual and error reasons require a note.

PATCH /api/v1/skus/{id}

{
  "on_hand": 12,
  "reason": "manual",
  "note": "Postman smoke test manual stock adjustment.",
  "reference": "POSTMAN-MANUAL-001"
}

Bulk adjustment

POST /api/v1/stock-adjustments/bulk

{
  "reason": "manual",
  "note": "Stock correction after count.",
  "reference": "COUNT-001",
  "lines": [
    { "type": "sku", "id": 123, "new_qty": 25 }
  ]
}

Multiple warehouses

If the account has turned on multiple warehouses, on_hand and new_qty are figures for one warehouse. Send warehouse_id (find ids with GET /api/v1/warehouses) on the single-SKU update, or once at the top level of the bulk body to apply it to every SKU line. With more than one active warehouse it is required and the request is rejected with a 422 without it; with one active warehouse (or the feature off) it is optional and requests behave exactly as before. Move stock between warehouses with POST /api/v1/stock-transfers:

POST /api/v1/stock-transfers

{
  "from_warehouse_id": 1,
  "to_warehouse_id": 2,
  "reference": "Pallet 14",
  "lines": [
    { "sku_id": 123, "quantity": 10 }
  ]
}