ReturnItemDelete 指令
這個指令會刪除退貨商品授權 (RMA) 中的訂單項目。

參數值
- http://host_name/path/
- (必要)WebSphere Commerce Server 和架構路徑的完整名稱。
- langId
- 設定或重設在階段作業期間的屬意語言;
有關商店的支援語言可在 STORELANG 表格中找到。
- storeId
- (必要)商店的參考號碼。
- forUser
- 將代替其執行指令之使用者的登入 ID;只有具備處理訂單權限的人才可指定這個參數。
- forUserId
- 將代替其執行指令之使用者的登入 ID;只有具備客戶服務代表安全職務的人員可指定這個參數。
使用者由 USERS 表格中所找到的內部使用者 ID 來識別。
- RMAItemId
- (必要)要刪除的 RMAItem 識別碼。
- outRMAName
- 要傳遞給重新導向 URL 的「名稱-值」配對所用的名稱。
在鏈結指令時,這個參數非常有用。
如果沒有指定這個參數,就會使用 "RMAId"。
- URL
- (必要)當指令順利完成時所要呼叫的 URL。
範例
下列範例會刪除 RMA 中的 RMA 項目 25 和 26,然後顯示該 RMA
http://myhostname/webapp/wcs/stores/servlet/ReturnItemDelete?
&RMAId=25&RMAItemID=26&URL=ReturnDisplay&storeId=1
規則
- 所刪除的每一個 RMA 項目可位於不同的現存 RMA 中。
- 如果執行這個指令時指定了 forUser 或 forUserId 參數的值,
則 RMA 狀態必須是 "EDT"、"APP" 或
"PND",不然的話,RMA 狀態必須是 "PRC"。
- 如果沒有收到項目的任何部份,且如果項目尚未退款,則會刪除該 RMA 項目及其元件。
如果有指定 forUser 或 forUserId 參數,RMA 的狀態會設為
"EDT",如果沒有指定其中一個參數,則會設為 "PRC"。
- 當順利完成時,設定為重新導向至指定的 URL。
- 呼叫作業指令 ExtendReturnItemDeleteCmd。
異常狀況
在下列條件下時,指令執行會失敗:
- 如果 RMA 不是處於正確的狀態,指令會產生 ECApplicationException,
其中包含訊息 _ERR_RMA_IN_INVALID_STATE_FOR_COMMAND
- 如果 RMA 項目至少已經收到一部分或退款,則指令會產生
ECApplicationException,其中包含訊息 _ERR_CANNOT_DELETE_RETURN_ITEM