CreateAuction 指令
藉由在 AUCTION 表格中插入一列以建立拍賣。
新拍賣列的狀態為 'F'(未來)。 MonitorAuction
指令將負責準時啟動拍賣。

參數值
- http://host_name/path/
- WebSphere Commerce Server 與架構路徑的完整名稱。
- prrfnbr
- 所要建立之拍賣的產品參考號碼。
- store_rn
- 擁有該產品之商家的參考號碼。
- quant
- 所要拍賣之項目的數量。
- autype
- 拍賣的類型:O(公開喊價)、SB(秘密投標)或 D(降價拍賣)。
- aurulemacro
- 用以在客戶面前顯示拍賣規則的 JSP 頁面名稱。
- auprdmacro
- 在拍賣結束前作為產品頁面的 .jsp 頁面名稱。
- auruletype
- 用以指出所選之拍賣結束基準種類的整數。
- minbid
- 這是拍賣的底價。此為所能接受的得標出價底線。
- austdate
- 連同 austtim 參數所構成的時間戳記,用以指出未來拍賣的開始時間。
可為空白,在此情況下,則拍賣會立即開始。
- austtim
- 連同 austdate 參數所構成的時間戳記,用以指出未來拍賣開始的時間。可為空白,在此情況下,則拍賣會立即開始。
- auenddat
- 連同 auendtim 參數所構成的時間戳記,用以指出未來拍賣的結束時間。
- auendtim
- 連同 auenddat 參數所構成的時間戳記,用以指出未來拍賣的結束時間。
- audaydur
- 將搭配 autimdur 參數,指出最後一次出價後過多久拍賣即告結束。
- autimdur
- 將搭配 audaydur 參數,指出最後一次出價後過多久拍賣即告結束。
請注意,隨著 auruletype 參數值而不同,您可能需要指定 auenddat/auendtim 參數或 audaydur/autimdur 參數,或兩者都必須指定。
- audeposit
- 這是每項出價都需要的付款授權。
當得標者在拍賣中得標後卻未買下產品時將損失的金額。
- aubidrule
- 出價規則參考號碼。
- austartprice
- 一開始的開價(「降價拍賣」方面)。
- aucurprice
- 目前的開價(限「降價拍賣」方面)。
- aucurquant
- 目前的供貨數量(「降價拍賣」方面)。
- ausdesc
- 拍賣的簡短文字說明。
- auldesc
- 拍賣的完整文字說明。
規則
- 驗證傳入的參數。
- 呼叫 CatalogEntryAccessBean,檢查產品是否已公佈並可供訂購。
- 呼叫 AuctionDataBean,檢查同一項產品是否出現在另一個現行拍賣或未來拍賣中。
- 呼叫 CheckInventory 作業指令,判斷庫存是否足夠。
- 呼叫 UpdateInventory 作業指令,以保留拍賣的庫存量。 供貨數量會因拍賣中的下單數量而減少。
提供庫存量的供貨中心會儲存在 AUCTION 表格中。 當結束拍賣時會採用此資訊。
庫存量會歸還給供貨中心,並針對得標出價建立訂單。
- 檢查有拍賣的相關規則之時,是不是也有出價規則,並檢查下列項目:
- 最小出價數量小於或等於拍賣數量。
- 任何的數量加價不會超過拍賣數量。
- 更新 CATENTRY 表格中的 ONAUCTION 直欄,
指出產品正在拍賣中。
- 更新 AUCTDESC 表格中的詳細與簡短說明。
異常狀況
- 如果有任何傳入的參數出現矛盾或發生錯誤,則會設定 BAD_ADD_AUCTION 異常作業來處理錯誤。
- 若遺漏必要欄位,則會擲出 _ERR_TOOLS_AUCTION_REQUIRED。
- 若遺漏規則範本,則會擲出 _ERR_TOOLS_AUCTION_REQUIRED_RULEMACRO。
- 若遺漏產品範本,則會擲出 _ERR_TOOLS_AUCTION_REQUIRED_PRODMACRO。
- 若欄位無效,則會擲出 _ERR_TOOLS_AUCTION_BAD_PARAMETER。
- 若指定的數值無效,則會擲出 _ERR_TOOLS_AUCTION_INVALID_NUMBER。
- 若拍賣類型無效,則會擲出 _ERR_TOOLS_AUCTION_INVALID_TYPE。
- 若「降價拍賣」的報價不正確,則會擲出 _ERR_TOOLS_AUCTION_DUTCH_PRICE。
- 若「降價拍賣」的規則類型不是 1,則會擲出 _ERR_TOOLS_AUCTION_DUTCH_RULE_TYPE。
- 若未指定「降價拍賣」的報價,則會擲出 _ERR_TOOLS_AUCTION_DUTCH_PRICE_MISSING。
- 若指定的起始日期與時間無效,則會擲出 _ERR_TOOLS_AUCTION_START_TIMSTAMP。
- 若指定的結束日期與時間無效,則會擲出 _ERR_TOOLS_AUCTION_END_TIMSTAMP。
- 若指定的產品尚未公佈,則會擲出 _ERR_TOOLS_AUCTION_PRODUCT_NOT_PUBLISHED。
- 若指定的產品無法購買,則會擲出 _ERR_TOOLS_AUCTION_PRODUCT_NOT_BUYABLE。
- 若指定的產品已在拍賣中,則會擲出 _ERR_TOOLS_AUCTION_PRODUCT_ON_AUCTION。
- 若指定的出價規則不存在,則會擲出 _ERR_TOOLS_AUCTION_NO_BID_RULE。
- 若指定之出價規則的規則類型與拍賣類型不同,則會擲出 _ERR_TOOLS_AUCTION_BID_RULE_TYPE。
- 若出價規則中遺漏值範圍與加價,或者其格式無效,則會擲出 _ERR_TOOLS_BAD_RULE_TEXT。
- 若數量不等於或大於出價規則中的最少數量,則會擲出 _ERR_TOOLS_AUCTION_QUANTITY_COMPARE。
- 若指定的數量大於可用的庫存量,則會擲出 _ERR_TOOLS_AUCTION_QUANTITY_INVENTORY_CHECK。
- 若結束類型無效,則會擲出 _ERR_TOOLS_AUCTION_CLOSE_TYPE。
- 若在可用的庫存量中發現錯誤,則會擲出 _ERR_TOOLS_AUCTION_INV_CHANGE。
- 若結束類型無效,則會擲出 _ERR_TOOLS_AUCTION_INVALID_RULETYPE。
- 若發生不明的錯誤狀況,則會擲出 _ERR_TOOLS_AUCTION_MSG_NOT_HANDLE。

