メインコンテンツへスキップ
POST
/
api
/
Recall
/
createRecallByReturnInventoryId
Create recall by return inventory IDs
curl --request POST \
  --url https://api.returnshelper.com/uat/user/api/Recall/createRecallByReturnInventoryId \
  --header 'Content-Type: application/json' \
  --header 'x-rr-apikey: <api-key>' \
  --header 'x-rr-apitoken: <api-key>' \
  --data '
{
  "returnInventoryIdList": [
    123
  ]
}
'
{
  "recallList": [
    {
      "apiId": 123,
      "recallId": 123,
      "warehouseId": 123,
      "recallNumber": "<string>",
      "recallStatusCode": "<string>",
      "warehouseRemarks": "<string>",
      "recallInventoryList": [
        {}
      ]
    }
  ]
}
このページはAIによって自動翻訳されています。API技術仕様は英語が正式です。不明点がある場合は英語版を参照してください。
すでに倉庫に到着している 1 件以上の返品在庫アイテムに対してリコール要求を作成します。リコールは倉庫から再発送し、宛先は当社の香港倉庫です。

前提条件

  • 対象在庫アイテムはアカウントに存在している必要があります。returnInventoryIdnewInventoryCreated webhook イベントで配信されるため、統合は自社側でキャッシュしてください。
  • 各在庫の現在の handlingStatusCode は、ハンドリング状態機械上でリコール(Handling.rtn)に進めるものでなければなりません——通常は pending または ohd 状態が対象です。
  • いずれのアイテムにも、有効な(未キャンセルの)リコールが存在してはなりません。
  • いずれのアイテムのラインアイテムにも保留中の VAS が存在してはなりません——先に解決してください。

必須フィールド

  • returnInventoryIdList — 空でない List<long>

副作用

  • 各在庫の handlingCodertn に設定されます。
  • 各在庫の RMA マッピングが、スワップ防止のためロックされます。
  • リコールの履行は非同期です。状態更新は webhook(recallShipmentDispatchedrecallDelivered など)で配信されます。

関連

承認

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