ReReturnItemUpdate 指令
這個指令會更新退貨項目的相關資訊,也可以就多個退貨商品授權 (RMA) 項目來予以呼叫。

參數值
- http://host_name/path/
- (必要)WebSphere Commerce Server 和架構路徑的完整名稱。
- langId
- 設定或重設在階段作業期間的屬意語言;
有關商店的支援語言可在 STORELANG 表格中找到。
- storeId
- (必要)商店的參考號碼。
- forUser
- 將代替其執行指令之使用者的登入 ID;只有具備處理訂單權限的人才可指定這個參數。
- forUserId
- 將代替其執行指令之使用者的登入 ID;只有具備客戶服務代表安全職務的人員可指定這個參數。
使用者由 USERS 表格中所找到的內部使用者 ID 來識別。
- creditAdjustment_i
- 調整產品退款金額的額度。
這個數目的格式必須符合 java.math.BigDecimal 物件的規則。
這個數目的小數位數必須使用句點。
這個金額會置換
CalculateReturnItemAdjustmentCmd
作業指令計算出來的任何金額。這是一個選用的參數,僅在有指定
forUser 或 forUserId 參數時才有效。
- receive_i
- 指定商店應不應接收退貨項目元件。
比方說,損壞的雜貨不需要退貨給商店,但毛衣需要。
- RMAItemId_i
- (必要)RMAItem 識別碼。
- quantity_i
- 退回的數量。
- UOM_i
- quantity_i 的度量單位。這個值應該符合
QTYUNIT 表格中的主要鍵。
如果沒有指定的話,則會使用 CATENTSHIP
表格中,CATENTRY_ID 與 OrderItem 相同的那一列的 QUANTITYMEASURE 直欄值,
且 quantity_i 參數值會乘以 CATENTSHIP
表格中相同列的 NOMINALQUANTITY 直欄。
- comment_i
- 退貨項目的相關備註。
- reason_i
- 購物者所提供的退貨原因。這個值可以在 RTNREASON 表格的 CODE 直欄中找到,原因為 'B' 或 'C'。
- URL
- (必要)當指令順利完成時所要呼叫的 URL。
- outRMAName
- 要傳遞給重新導向 URL 的「名稱-值」配對所用的名稱。
在鏈結指令時,這個參數非常有用。
如果沒有指定這個參數,就會使用 "RMAId"。
範例
下列範例會更新 RMAItem 123,指定其退回數量為 2,並更新
RMAItem 456,指定其退回數量為 3。順利完成時,會顯示出 RMA。
http://myhostname/webapp/wcs/stores/servlet/ReturnItemUpdate?RMAItemId_1=123&RMAItemId_2=456
&quantity_1=1&quantity_2=3&URL=ReturnDisplay&storeId=1
規則
- 更新退貨項目,可就多個 RMA 項目來予以呼叫。
如果這個指令是由多個 RMA 項目共同呼叫,則所有 RMA 項目都必須隸屬於相同的 RMA。
- RMA 的 PREPARED 旗號設為 'N'。如果有指定 forUser 或 forUserId
參數,RMA 的起始狀態必須是 'EDT'、'PND'、'APP',然後狀態會設為 'EDT'。
不然的話,RMA 的起始狀態必須是 'PRC',然後狀態會變更為 'PRC'。
- 每個項目都會依照下列方式來處理:
- 檢查確認先前沒有將 RMA 項目退款給客戶。
- 更新 RMA 項目。如果有指定項目的數量或收到參數,則會更新
元件(在 RMAITEMCMP 表格中)。
- 呼叫 AutoApproveReturnItemCmd
作業指令,查看項目是可以自動核准,然後根據作業指令的結果,將 RMA 項目標示為
"系統核准" 或 "核准擱置"。
- 當順利完成時,設定為重新導向至指定的 URL。
- 呼叫作業指令
ExtendReturnItemUpdateCmd。
異常狀況
- 如果 RMA 狀態不是設為 'PRC'(亦即,沒有使用 forUser 或 forUserId
參數),或不是設為 'EDT'、'PND'、'APP'(有使用 forUser 或 forUserId
參數),則會產生 ECApplicationException,其中包含訊息
_ERR_RMA_IN_INVALID_STATE_FOR_COMMAND。
- 如果 RMA 項目所屬的 RMA 不同於其它已經處理過的 RMA 項目時,則會產生
ECApplicationException,其中包含訊息 _ERR_BAD_MISSING_CMD_PARAMETER。
- 如果 RMA 項目已經退款,則會產生 ECApplicationException,其中包含訊息
_ERR_BAD_MISSING_CMD_PARAMETER。