批次更新組合品庫存
批次覆蓋多個組合品自身的在庫數,一次寫入多筆,逐筆結果互不影響。
⚠️ inventoryQuantity 是絕對的在庫數,不是增減量,規則與 POST /v1/skus/stock/batch 相同。
每一筆用 bundleId(組合 SKU 序號)指定組合品,不接受料號。inventoryQuantity 與 isNegativeStockAllowed 都是選填,省略的欄位維持現值——沒帶 inventoryQuantity 不會被當成 0,在庫數不變、也不留異動紀錄。兩個欄位都沒帶時,該筆 failed,error 為 inventoryQuantity or isNegativeStockAllowed is required。
送出空陣列或沒有 body 會在受理前被拒絕,回傳 400 empty_batch;已受理的請求一律回傳 HTTP 200,逐筆結果依請求順序放在 items,一筆請求一列。bundleId 不存在、屬於其他租戶,或指向一般規格時,該筆回報 failed 並帶 bundle not found,不影響其他筆。逐筆狀態是小寫的 ok 或 failed。
Authentication
每個 /v1 請求都必須帶 X-Client-Id、X-Timestamp、X-Nonce 與 X-Signature 四個標頭。X-Signature 是以 client secret 對 canonical string 做 HMAC-SHA256 後的 Base64。
canonical string 的組成、可複製的簽章範例與 401 排查步驟,請參閱「驗證與簽章」。
Request
要設定庫存的組合 SKU 序號。不存在、屬於其他租戶,或指向一般規格時,這一筆回報 failed,error 為 bundle not found。
選填。更新後組合品自身的絕對在庫數,不是增減量。省略時在庫數維持現值(不會被當成 0);與 isNegativeStockAllowed 都省略時該筆 failed。
選填。true 時組合品自身不限量,只看組成規格;false 時組合品自身的可售數用完就不能再下單。省略時維持現值。
Response
逐筆的處理結果,依請求順序排列,筆數與送出的筆數相同。