追蹤文件站台與 API 的異動
2026 年 11 月 14 日
這一版統一庫存欄位的命名,並把可組數量從組合品主檔移除。兩項都是破壞性變更,有串接庫存或組合品的整合請在上線前調整。
⚠️ 庫存欄位統一改名為 inventoryQuantity
同一個「在庫數」過去在查詢時叫 inventoryQty、在批次寫入時叫 quantity,現在一律叫 inventoryQuantity;可售數也跟著改成 availableQuantity。
- 批次寫入不再讀取舊的
quantity。繼續送quantity不會報錯,而是被當成沒帶:在庫數維持現值、不留異動紀錄;如果該筆也沒帶isNegativeStockAllowed,會回報 failed。請務必改送inventoryQuantity。 - 兩個欄位都沒帶時的錯誤字串由
quantity or isNegativeStockAllowed is required改為inventoryQuantity or isNegativeStockAllowed is required。有比對這個字串的整合需要調整。 - 組合品配方的每組用量(
components[].quantity)與數量精度(quantityPrecision)不是庫存欄位,名稱不變。
⚠️ 組合品主檔移除可組數量
GET /v1/bundles 與 GET /v1/bundles/{id} 的回應不再有 availableQty(以目前庫存最多能組出幾份)。組合品主檔現在不回傳任何庫存數字。
- 組合品自身的在庫數與可售數,請改查
GET /v1/bundles/{id}/stock。 - API 不再提供可組數量;需要時請用各組成規格的
GET /v1/skus/{id}/stock與配方的每組用量自行計算。
各端點的完整規則見「API 規格」的「庫存」「組合品庫存」「組合品」,錯誤字串見「錯誤碼」。