跳轉到主要內容
POST
Create recall by return inventory IDs
此頁面由 AI 自動翻譯。API 技術規格以英文呈現為標準。如有任何疑問,請參閱英文版本。
Recall 即將停用。要把庫存寄至 Return Helper 香港倉庫,請建立 destinationType: RH_WAREHOUSE 的 Consolidate Shipping Order。Consolidate Shipping 也支援依 FNSKU 加入 FBA 庫存。
為已抵達倉庫的一個或多個退件庫存項建立召回請求。召回會將物品從倉庫再次寄出,目的地為我們的香港倉庫。

前置條件

  • 目標庫存項必須已存在於您的帳戶。returnInventoryId 由 newInventoryCreated webhook 事件推送——整合應在自有端快取。
  • 每筆庫存目前的 handlingStatusCode 必須可依處理狀態機推進至召回(Handling.rtn)——通常 pending 或 ohd 狀態可用。
  • 任何一項都不可處於已啟用(未取消)的召回中。
  • 任何項所屬行項目都不可存在待處理的 VAS——請先處理。

必填欄位

  • returnInventoryIdList — 非空 List<long>。

副作用

  • 每筆庫存的 handlingCode 會被設為 rtn。
  • 每筆庫存的 RMA 對映會被鎖定,禁止交換。
  • 召回履行為非同步;狀態更新透過 webhook 推送(recallShipmentDispatched、recallDelivered 等)。

相關

授權

x-rr-apikey
string
header
必填

Your API key

x-rr-apitoken
string
header
必填

Your API token — keep this private

主體

application/json
returnInventoryIdList
integer<int64>[]
必填

List of return inventory IDs

回應

Success

recallList
object[]

List of created recalls