庫存

讀取庫存，並執行受控調整、銷售上限及手動預留。

操作

取得清單 · 庫存 — 庫存查看產品庫存、倉庫和內部位置。 GET 建立 · 庫存調整 — 庫存更改實際和可銷售產品數量。 POST 取得 · 庫存 — 庫存查看產品庫存、倉庫和內部位置。 GET 更新 · 庫存 — 庫存更改實際和可銷售產品數量。 PATCH 更新 · 手動預留 — 庫存變更手動保留. 適用於外部整合操作。 PATCH 更新 · 銷售上限 — 庫存變更銷售限額. 適用於外部整合操作。 PATCH 建立匯入建立最多1000個兌換碼或100個檔案的草稿。此時不會增加可售庫存。 POST 取消匯入捨棄未完成的草稿。此操作不會撤回已確認的入庫記錄。 DELETE 讀取匯入檢查狀態、版本與驗證結果。草稿屬於建立它的API金鑰。 GET 確認入庫依據已驗證批次建立預定或已收貨的入庫記錄。預定庫存暫時不可銷售。 POST 接收預定入庫接收既有庫存單位，無須再次匯入兌換碼或檔案。 POST 驗證匯入驗證整個批次。重複或無效項目會使批次遭到拒絕，兌換碼不會被截短。 POST 撤回入庫僅撤回可用單位。已預留及已分配單位仍與訂單連結。 POST 讀取數位庫存設定修改前讀取設定和數量。回應不包含兌換碼或檔案內容。 GET 設定數位庫存Professional及以上方案可啟用獨立兌換碼或檔案。停用後仍保留先前購買的存取權限。 PATCH 列出庫存單位每頁讀取最多100個單位。清單僅顯示中繼資料，不揭露兌換碼。 GET 調整分配順序依所需順序提交完整且未篩選的頁面。版本過期時回傳409。 POST 讀取可用單位內容兌換碼以JSON回傳，檔案以二進位回傳。每次請求都需要Bearer及reveal權限。 GET 檢查可用單位存取權限不下載內容，執行與GET相同的權限檢查。此操作不會預留單位。 HEAD 移除可用單位說明原因後移除未售出的兌換碼或檔案。已預留或已分配單位會遭到拒絕。 POST 替換可用單位替換兌換碼或檔案而不改變順序。修改記錄保留在倉庫歷程中。 POST 準備私人上傳為檔案預留空間，並連結到匯入或待替換的單位。 POST 檢查上傳檢查大小、檢查碼及格式。上傳就緒不代表已完成入庫。 GET 上傳檔案透過HTTPS以multipart/form-data傳送檔案。請勿傳送Base64或需要擷取的URL。 PUT

工作原理

庫存記錄區分實物 on_hand 數量、訂單預留、手動預留和可售數量。請使用回傳的庫存記錄識別碼和版本；產品庫存與變體庫存是不同目標。

sellable_limit 為 -1 表示無限制，0 表示不可銷售。無限可售量在 available 中以 null 表示。不要將 null 當作零。庫存調整、銷售上限和手動預留具有獨立操作及權限。