Update return inventory handling
退貨庫存
更新 Return Inventory Handling
POST
Update return inventory handling
更新單筆退件庫存紀錄的處理決定——告訴倉庫該如何處置已收到的包裹。多於倉庫登記包裹後呼叫；自此庫存便會沿著所選處理路徑（入庫、銷毀、召回、補寄等）繼續。
何時呼叫
- 客服或營運團隊決定處理方式後。
必填欄位
returnInventoryId— 長整數；必須存在且屬於您的帳戶。倉庫登記包裹時由newInventoryCreatedwebhook 事件推送；請在自有端快取以備後續操作。webhook 流為庫存 ID 的真實資料來源。handlingCode— 字串，必須是 取得所有處理類型 回傳的值之一。不能直接使用rsd（補寄）或tbc（待確認）——這兩類有專屬端點。常用值：ohd（暫存）、rtn（退回）、rst（入庫）、dsp（銷毀）。
handlingStatusCode 為 pending 且新處理為 ohd（暫存），呼叫始終允許——便於在調查期間將庫存掛起。
下列情況無法更新處理：
- 庫存所屬行項目存在待處理的 VAS（加值服務）請求。請先透過 取得所有 VAS 與 VAS 端點取消或完成 VAS。
副作用
- 庫存紀錄上的
handlingCode與handlingStatusCode會被更新。 - 若新處理不是
ohd或oth（其他），將鎖定 RMA 對映以禁止對該庫存進行 RMA 交換。
相關
- 取消退件庫存處理 — 在倉庫執行前撤銷處理決定。
- 依退件庫存 ID 建立召回 — 透過專屬召回流程處理被召回的庫存。
- 建立補寄訂單 — 走補寄路徑（同樣無法直接透過本端點抵達）。
- Webhooks —
newInventoryCreated、vasUpdated、庫存處理完成事件與notifyUserRmaSwapped都會推送庫存生命週期至您的端點。
授權
Your API key
Your API token — keep this private
主體
application/json
回應
Success
Universal response envelope. Successful responses include the business payload as additional top-level fields alongside correlationId and meta. Failed responses (auth errors, validation errors) only populate correlationId and meta, with meta.errorCode and meta.error describing the failure.