Create recall by return inventory IDs
リコール
Return Inventory ID で Recall を作成
POST
Create recall by return inventory IDs
すでに倉庫に到着している 1 件以上の返品在庫アイテムに対してリコール要求を作成します。リコールは倉庫から再発送し、宛先は当社の香港倉庫です。
前提条件
- 対象在庫アイテムはアカウントに存在している必要があります。
returnInventoryIdはnewInventoryCreatedwebhook イベントで配信されるため、統合は自社側でキャッシュしてください。 - 各在庫の現在の
handlingStatusCodeは、ハンドリング状態機械上でリコール(Handling.rtn)に進めるものでなければなりません——通常はpendingまたはohd状態が対象です。 - いずれのアイテムにも、有効な(未キャンセルの)リコールが存在してはなりません。
- いずれのアイテムのラインアイテムにも保留中の VAS が存在してはなりません——先に解決してください。
必須フィールド
returnInventoryIdList— 空でないList<long>。
副作用
- 各在庫の
handlingCodeがrtnに設定されます。 - 各在庫の RMA マッピングが、スワップ防止のためロックされます。
- リコールの履行は非同期です。状態更新は webhook(
recallShipmentDispatched、recallDeliveredなど)で配信されます。
関連
- リコール注文を作成 — リコールペイロードを直接受け付けるレガシーの非バッチ版。新規統合では本バッチエンドポイントを優先してください。
- 返品在庫 ID でリコールをキャンセル — 倉庫が履行する前にリコールを取り消します。
- すべてのリコール在庫ステータスを取得 — コード → ラベルのマッピング。
- Webhooks —
recallUpdateStatusおよび各リコール ライフサイクル イベントが進捗をエンドポイントへ配信します。