ReturnItemAdd 指令

這個指令會新增產品到退貨商品授權 (RMA) 中。

osrtnitad.gif(9639 個位元組)

參數值

http://host_name/path/
(必要)WebSphere Commerce Server 和架構路徑的完整名稱。
forUser
將代替其執行指令之使用者的登入 ID;只有具備處理訂單權限的人才可指定這個參數。
forUserId
與 forUser 相同,但卻是 USERS 表格中之內部使用者 ID 所指的使用者。
creditAdjustment_i
調整產品退款金額的額度。 這個數目的格式必須符合 java.math.BigDecimal 物件的規則。 這個數目的小數位數必須使用句點。 這個金額會放置在 RMAITEM 表格的 ADJUSTMENT 直欄中。這是一個選用的參數,只有在指定了 forUserId 參數時才有效。
langId
設定或重設在階段作業期間的屬意語言; 有關商店的支援語言可在 STORELANG 表格中找到。
storeId
(必要)商店的參考號碼。
orderItemId_i
(必要)OrderItem ID(如果可用的話)。 如果要傳回不是動態套件之一部份的元件,或要從 OrderItem 傳回整個套件,就必須指定這個參數的值。 如果要傳回有 OrderItem 的動態套件的一部份,就必須指定這個參數及 catEntryId_i 參數的值。
catEntryId_i
(必要)退回的型錄項目。這個值必須是產品或項目。 其它型錄項目值都不在支援範圍內,且會呼叫 BAD_MISSING_CMD_PARAMETER 異常狀況。 如果要傳回不是 OrderItem 的元件,就必須指定這個參數的值。 如果要傳回有 OrderItem 的動態套件的一部份,就必須指定這個參數及 orderItem_i 參數的值。
attrName_i
產品定義的任何獨特屬性。
attrValue_i
產品屬性的值。
RMAId
退貨項目要加入其中的現有 RMA 的識別碼。 如果要建立新的 ,請以 "**" 為值。 如果沒有指定這個參數的值,就會以 ** 為預設值。
quantity_i
(必要)退回的數量。
UOM_i
quantity_i 的度量單位。這個值應該符合 QTYUNIT 表格中的主要鍵。 如果沒有指定的話,則會使用 CATENTSHIP 表格中,CATENTRY_ID 與 OrderItem 相同的那一列的 QUANTITYMEASURE 直欄值, 且 quantity_i 參數值會乘以 CATENTSHIP 表格中相同列的 NOMINALQUANTITY 直欄。
comment_i
退貨項目的相關備註。
reason_i
(必要)購物者所提供的退貨原因。 這個值可以在 RTNREASON 表格的 CODE 直欄中找到,原因為 'B' 或 'C'。
outRMAName 
要傳遞給重新導向 URL 的「名稱-值」配對所用的名稱。 在鏈結指令時,這個參數非常有用。 如果沒有指定這個參數,就會使用 RMAId 參數的值。
URL
(必要)當指令順利完成時所要呼叫的 URL。
forUserId
將代替其執行指令之使用者的登入 ID;只有具備客戶服務代表安全職務的人員可指定這個參數。 使用者由 USERS 表格中所找到的內部使用者 ID 來識別。

範例
下列範例會在一個新的 RMA 中新增 5 個訂單項目 15。 退貨的原因碼是 DEFECT。RMA 建立好後就會顯示出來。
    http://myhostname/webapp/wcs/stores/servlet/ReturnItemAdd?
    orderItemId_1=15&quantity_1=5&reason_1=DEFECT&RMAId=**&storeId=1
    &URL=ReturnDisplay

規則

異常狀況

 相關概念

相關參照

IBM copyright