Create recall by return inventory IDs
回收
依 Return Inventory ID 建立 Recall
POST
Create recall by return inventory IDs
為已抵達倉庫的一個或多個退件庫存項建立召回請求。召回會將物品從倉庫再次寄出,目的地為我們的香港倉庫。
前置條件
- 目標庫存項必須已存在於您的帳戶。
returnInventoryId由newInventoryCreatedwebhook 事件推送——整合應在自有端快取。 - 每筆庫存目前的
handlingStatusCode必須可依處理狀態機推進至召回(Handling.rtn)——通常pending或ohd狀態可用。 - 任何一項都不可處於已啟用(未取消)的召回中。
- 任何項所屬行項目都不可存在待處理的 VAS——請先處理。
必填欄位
returnInventoryIdList— 非空List<long>。
副作用
- 每筆庫存的
handlingCode會被設為rtn。 - 每筆庫存的 RMA 對映會被鎖定,禁止交換。
- 召回履行為非同步;狀態更新透過 webhook 推送(
recallShipmentDispatched、recallDelivered等)。
相關
- 建立召回訂單 — 直接接受召回 payload 的舊版非批次端點。新整合請優先使用本批次端點。
- 依退件庫存 ID 取消召回 — 在倉庫履行前撤銷召回。
- 取得所有召回庫存狀態 — 代碼至標籤對映。
- Webhooks —
recallUpdateStatus與召回生命週期事件會將進度推送至您的端點。