Update return inventory handling
返品在庫
Return Inventory Handling を更新
POST
Update return inventory handling
1 件の返品在庫レコードのハンドリング決定を更新します——つまり、倉庫が受領したパーセルをどう扱うかを指示します。多くは倉庫がパーセルをログ済みの後に呼び出されます。これ以降、在庫は選択されたハンドリング（再入庫、廃棄、リコール、再送など）の経路を辿ります。
呼び出すタイミング
- カスタマーサポートまたはオペレーションチームがハンドリングを決定した後。
必須フィールド
returnInventoryId— long。存在し、アカウントに属していること。倉庫でパーセルがログされたタイミングの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.