Create VAS by return inventory ID
增值服務
依 Return Inventory ID 建立 VAS
Create value-added service requests for one or more return inventories. Inventory must be set to On-hold handling before creating VAS. Split parcel VAS must be submitted separately from other VAS types.
POST
Create VAS by return inventory ID
為已收到的退件庫存請求一項或多項加值服務（VAS）——品質檢驗、重新包裝、拍照、拆分包裹等。倉庫執行 VAS 後，會透過後續 webhook 事件回報結果。
前置條件
- 目標庫存項已存在於您的帳戶。
returnInventoryId由newInventoryCreatedwebhook 事件推送——請在自有端快取。 - 每筆目標庫存的
handlingCode必須為ohd（暫存）。VAS 僅在庫存為暫存時允許；若已進入其他處理路徑，請先透過 更新退件庫存處理 移回ohd。 - 從 取得所有 VAS 選擇有效的
vasCode。
必填欄位
createVasList— 非空 payload 列表。每個 payload 對應一筆庫存與一項或多項 VAS 請求。
returnInventoryId— 字串，必須可解析為 long；必須存在且為暫存狀態。createVasDetailList— VAS 明細物件列表，每項含vasCode與該 VAS 專屬欄位。
returnInventoryId 必須唯一——同一呼叫中不可對同一庫存建立兩個 payload。
拆分包裹規則
若任一 payload 中的 VAS 使用vasCode: SPLIT_PARCEL：
- 該 VAS 必須是該 payload
createVasDetailList中的唯一一項（不能與其他 VAS 同 payload 同庫存併用）。 - 僅
SPLIT_PARCEL允許（且通常需要）檔案附件。其他 VAS 代碼不可附件。
副作用
- VAS 處理期間，庫存的處理保持在
ohd。 - 後續 webhook 事件會回報進度：
vasUpdated，以及拆分包裹時的splitLineItem與newInventoryCreated（針對拆分件）。 - 拆分包裹 VAS 完成時，可能產生額外的庫存紀錄（拆分後的物品）。
相關
- 取得所有 VAS — 有效的
vasCode值。 - 取得所有 VAS 狀態 — VAS 生命週期的代碼至標籤對映。
- 更新退件庫存處理 — 若庫存已離開
ohd，將其移回。 - Webhooks —
vasUpdated事件會將 VAS 生命週期推送至您的端點。