OrderItemAdd 指令

這個指令會在要出貨的項目清單中新增項目或產品。

osoiadd.gif(14233 個位元組)

參數值

http://host_name/path/
(必要)WebSphere Commerce Server 和架構路徑的完整名稱。
forUser
將代替其執行指令之使用者的登入 ID;只有具備處理訂單權限的人才可指定這個參數。
forUserId
與 forUser 相同,但卻是 USERS 表格中之內部使用者 ID 所指的使用者。
langId
設定或重設在階段作業期間的屬意語言; 有關商店的支援語言可在 STORELANG 表格中找到。
URL
(必要)當指令順利完成時所要呼叫的 URL。
storeId
(必要)商店的參考號碼;您無法從商場購買,因此,這是一個必要的項目。
catEntryId_i
(必要)要放在訂單中之項目的參考號碼。
partNumber_i
若有指定,則會忽略 catEntryId 參數。 partNumber 與 memberId 用以決定 catentry_id (藉由選取 CATENTRY 表格中的 PARTNUMBER 與 MEMBER_ID 直欄), 而此指令會將參考號碼視如 catEntryId 的值。
memberId_i
擁有下單型錄之成員的識別碼。
attrName_i
定義給項目的任何明確屬性。
attrValue_i
attrName 中的屬性值。
quantity_i
(必要)要新增到訂單中的項目數量。
UOM_i
quantity_i 的度量單位。這個值應該符合 QTYUNIT 表格中的主要鍵。 如果沒有指定的話,會使用 CATENTSHIP 表格中 CATENTRY_ID 與 OrderItem 相同的那一列的 QUANTITYMEASURE 直欄值, 且 quantity_i 參數值會乘以 CATENTSHIP 表格中相同列的 NOMINALQUANTITY 直欄。
addressId_i
產品和項目之出貨地址的參考號碼。
shipModeId_i
產品或項目要用的出貨模式的參考號碼。
comment_i
建立或更新的訂購項目所要併入的備註。
contractId_i
用來管理要新增項目之訂單的合約識別碼;每家商店都有預設合約,不過,您可以另行設定。
field1_i
保留給商店使用的整數值。
field2_i
保留給商店使用的一個文字值。這個參數最多可有 254 個字元。
offerId_i
用來管理要新增項目之訂單的優惠識別碼。
orderId
要新增項目之訂單的識別碼。
outOrderName
指定要新增到重新導向 URL 中之已建或已更新訂單的參考號碼名稱。  當您串連指令時,請使用此參數與 outOrderItemName。 
outOrderItemName
要新增到重新導向 URL 中的已建立或已更新之訂單項目的參考號碼名稱。
listId
喜好項目清單 ID。當您指定此參數時,OrderItemAdd 指令會建立一份內含清單中所有項目的新訂單。
orderDesc
指定這個指令所建立之新訂單的訂單說明。
remerge
在同一訂單中要合併於其他 OrderItems 且具有相同的 correlationGroup 屬性 (如果可能) 的 OrderItems 清單。 除非其 InventoryStatus 是 "NALC",或 allocate、backorder 或 reverse 參數指定了 OrderItems,否則,不會合併 OrderItems。
merge
在同一訂單中要合併於其他 OrderItems (如果可能),且不論其 correlationGroup 屬性是什麼的 OrderItems 清單。 除非其 InventoryStatus 是 "NALC",或 allocate、backorder 或 reverse 參數指定了 OrderItems,否則,不會合併 OrderItems。
check
CheckInventory 作業指令應該檢查的 OrderItems 清單。
allocate
應該由 AllocateExistingInventory 作業指令從現有庫存來配置的 OrderItems 清單。
backorder
AllocateExpectedInventory 作業指令應該補貨的 OrderItems 清單。 如果 allocate 和 backorder 參數指定了相同的 OrderItem,且能夠配置它,它就不會補貨。
reverse
應該適當地呼叫 DeallocateExistingInventory 或 DeallocateExpectedInventory 作業指令來釋出其配置(也就是適當地從現有或預期庫存中解除配置)的 OrderItems 清單。
configurationId_i
如果 OrderItem 代表已架構的動態套件,這就是架構 ID。

附註:只有在啟用 ATP 庫存時, 才適合使用 remerge、merge、check、allocate、backorder 和 reverse 等參數 (請參閱 STORE 表格中的 ALLOCATIONGOODFOR 直欄)。它們代表要傳遞給 AllocateInventory 作業指令的 OrderItems 清單,由 AllocateInventory 作業指令依如下指定來呼叫 CheckInventoryAvailability、AllocateExistingInventory、AllocateExpectedInventory、DeallocateExistingInventory 和 DeallocateExpectedInventory 作業指令。 另外,這些參數也接受 OrderItem 縮寫,請參閱訂單子系統指令的說明,以取得詳細資料。

預設 ATP 參數值如下:

範例 1
下列範例是新增 3 份參考號碼為 24 的產品到每份客戶現行擱置訂單中 (只限於有型錄項目 24 的商店下所建立的現行擱置訂單), 並指出它們要出貨到地址參考號碼 2 所對應的地址,之後,再呼叫 OrderItemDisplay 指令。
     http://myhostname/webapp/wcs/stores/servlet/OrderItemAdd?addressId=2
     &URL=/webapp/wcs/stores/servlet/OrderItemDisplay&catEntryId=24&quantity=3

範例 2
下列範例會新增 10 份參考號碼為 2 的型錄項目到現行客戶的新訂單中。 orderId 參數會新增到重新導向 URL 中; 其值為所建訂單的參考號碼,且會呼叫 OrderItemDisplay 指令。
     http://myhostname/webapp/wcs/stores/servlet/OrderItemAdd?catEntryId=2&quantity=10
     &orderId=**&outOrderName=orderId&URL=/webapp/wcs/stores/servlet/OrderItemDisplay

範例 3
下列範例會新增一個下列內容所構成的組合銷售:
312200001 項目
312200301 項目
含 312200201 屬性的 312200200 產品
     http://myhostname/webapp/wcs/stores/servlet/OrderItemAdd?catEntryId_1=312200001
     &quantity_1=1&shipModeId_1=1&catEntryId_2=312200301&quantity_2=1
     &shipModeId_2=1&catEntryId_3=312200200&attrName_3=312200201
     &attrValue_3=Value+2200200+1&quantity_3=1&shipModeId_3=1&URL=OrderItemDisplay

範例 4
下列範例是新增兩項具有多個屬性的產品到購物車中, 其中第一個型錄項目有兩個屬性,第二個型錄項目有三個屬性:           http://myhostname/webapp/wcs/stores/servlet/OrderItemAdd?catEntryId_1=111&attrName_1=1
&attrValue_1=a&attrName_1=2&attrValue_1=b&quantity_1=1&catEntryId_2=222&attrName_2=21
&attrValue_2=aa&attrName_2=22&attrValue_2=bb&attrName_2=33&attrValue_2=cc&quantity_2=1
&URL=OrderItemDisplay

規則

異常狀況

 相關概念

相關參照

IBM copyright