商康電子商務(wù)與供應(yīng)鏈系統(tǒng)接口整合詳細(xì)設(shè)計(jì)方案v1.2.doc

湖南商康醫(yī)藥有限公司電子商務(wù)網(wǎng)站與供應(yīng)鏈系統(tǒng)整合詳細(xì)設(shè)計(jì)方案版本日期描述V1.02010年08月30日確認(rèn)整合方案V1.12010年10月20日根據(jù)聯(lián)調(diào)實(shí)際情況對文檔進(jìn)行補(bǔ)充和更正目錄1.背景與需求32.述語53.整合方案53.1.接口設(shè)計(jì)原則53.2.接口架構(gòu)和部署63.3.約定說明73.4.中間表接口方式詳細(xì)描述73.5.通知表83.5.1.I_EC_NOTE（電子商務(wù)系統(tǒng)業(yè)務(wù)通知表）83.5.2.I_EC_NOTE_BAK（電子商務(wù)系統(tǒng)業(yè)務(wù)通知備份表）83.5.3.I_ERP_NOTE（ERP系統(tǒng)業(yè)務(wù)通知表）93.5.4.I_ERP_NOTE_BAK（ERP系統(tǒng)業(yè)務(wù)通知備份表）104.主要業(yè)務(wù)處理114.1.訂單114.1.1.接口表114.1.2.WebService134.1.3.業(yè)務(wù)描述164.2.商品184.2.1.接口表184.2.2.WebService214.2.3.業(yè)務(wù)描述224.2.4.約定說明244.3.會(huì)員254.3.1.接口表254.3.2.業(yè)務(wù)描述264.4.促銷294.4.1.WebService295.異常處理325.1.訂單異常處理325.2.訂單退貨325.3.接口調(diào)用異常325.3.1.有數(shù)據(jù)依賴的業(yè)務(wù)產(chǎn)生異常335.3.2.只是數(shù)據(jù)普通交互，沒有依賴關(guān)系的業(yè)務(wù)產(chǎn)生異常335.4.數(shù)據(jù)庫異常335.5.網(wǎng)絡(luò)等異常335.6.操作系統(tǒng)336.性能要求與驗(yàn)收準(zhǔn)則331. 背景與需求湖南商康醫(yī)藥有限公司供應(yīng)鏈系統(tǒng)采用普升軟件提供的普升醫(yī)藥物流管理系統(tǒng)（PowerGSP），是商康醫(yī)藥和其母公司全洲醫(yī)藥集團(tuán)以及全洲醫(yī)藥集團(tuán)下屬分公司/子公司、辦事處進(jìn)行醫(yī)藥商業(yè)貿(mào)易及供應(yīng)鏈服務(wù)的核心業(yè)務(wù)處理軟件，主要負(fù)責(zé)采購、質(zhì)量、銷售、財(cái)務(wù)、倉儲(chǔ)、物流等關(guān)鍵業(yè)務(wù)的信息管理。電子商務(wù)網(wǎng)站由用友開發(fā)，實(shí)現(xiàn)的主要內(nèi)容包括網(wǎng)上交易管理、網(wǎng)上訂單受理、訂單狀態(tài)反饋、網(wǎng)絡(luò)在線客服以及網(wǎng)上支付等。供應(yīng)鏈系統(tǒng)與電子商務(wù)網(wǎng)站的接口與集成需求主要內(nèi)容包括：（一）數(shù)據(jù)共享與集成l 電子商務(wù)網(wǎng)站的客戶資料、商品資料基本信息從供應(yīng)鏈系統(tǒng)進(jìn)行增量同步；l 供應(yīng)鏈系統(tǒng)將商品促銷活動(dòng)信息定期傳送給電子商務(wù)網(wǎng)站，由電子商務(wù)網(wǎng)站在前端展現(xiàn)。（二）業(yè)務(wù)流程集成l 電子商務(wù)網(wǎng)站完成訂單后，能夠?qū)⒂唵翁峤坏焦?yīng)鏈系統(tǒng)，并將庫存滿足情況反饋到電子商務(wù)網(wǎng)站，方便訂單提交者確認(rèn)支付；l 電子商務(wù)網(wǎng)站對訂單進(jìn)行確認(rèn)和支付以后，將訂單及支付信息提交給供應(yīng)鏈系統(tǒng)，由供應(yīng)鏈系統(tǒng)對支付進(jìn)行核驗(yàn)，確認(rèn)支付完成后，進(jìn)行出庫揀配和物流配送，并將訂單狀態(tài)反饋到商務(wù)網(wǎng)站，以便電子商務(wù)網(wǎng)站可以向客戶提供訂單狀態(tài)查詢服務(wù)；l 電子商務(wù)網(wǎng)站的注冊會(huì)員需要成為藥品交易的供應(yīng)商或客戶時(shí)，可以將相關(guān)資料提交到供應(yīng)鏈系統(tǒng)，經(jīng)供應(yīng)鏈系統(tǒng)進(jìn)行客戶資料審核后，反饋到電子商務(wù)網(wǎng)站。圖1.訂單前后臺(tái)處理用例圖圖2.數(shù)據(jù)交換用例圖注：更詳細(xì)業(yè)務(wù)描述請參考商康網(wǎng)B2B需求分析說明書2. 述語B2B系統(tǒng)指商康網(wǎng)B2B電子商務(wù)系統(tǒng)。ERP系統(tǒng)也稱供應(yīng)鏈系統(tǒng)、業(yè)務(wù)系統(tǒng)或批發(fā)系統(tǒng)，即普升PowerGSP。采購會(huì)員能通過B2B系統(tǒng)在線采購商品的采購商會(huì)員，后來商康項(xiàng)目組把“采購商”改名為“采購會(huì)員”；ERP中與B2B采購會(huì)員相對應(yīng)的是往來單位。3. 整合方案3.1. 接口設(shè)計(jì)原則l 可靠性：B2B系統(tǒng)和ERP系統(tǒng)是隔離的，確保是一個(gè)系統(tǒng)出了問題不影響對方。l 安全性：系統(tǒng)之間有清晰的調(diào)用邊界，可以對只涉及到的表開放相應(yīng)的權(quán)限。l 可追溯：可以通過檔案日志和備份日志追溯處理時(shí)間和執(zhí)行的系統(tǒng)。3.2. 接口架構(gòu)和部署B(yǎng)2B系統(tǒng)與ERP系統(tǒng)以中間表和WebService這兩種方式進(jìn)行整合，架構(gòu)與部署如圖4所示。圖4.系統(tǒng)連接架構(gòu)示意圖中間表對于實(shí)時(shí)性不強(qiáng)的業(yè)務(wù)（比如基礎(chǔ)數(shù)據(jù)、商品等），兩方系統(tǒng)將通過數(shù)據(jù)庫中間表的形式實(shí)現(xiàn)數(shù)據(jù)共享或交互。在這種方式下，B2B系統(tǒng)和ERP系統(tǒng)根據(jù)業(yè)務(wù)需要往約定的中間接口表寫入或讀取數(shù)據(jù)。如圖5所示。中間接口表將部署在ERP外網(wǎng)數(shù)據(jù)庫實(shí)例里，如圖4所示。電子商務(wù)系統(tǒng)中間表ERP系統(tǒng)圖5.中間表方式接口示意圖WebService對于實(shí)時(shí)性很強(qiáng)或有復(fù)雜的規(guī)則（如促銷等）的業(yè)務(wù)則將通過web service來實(shí)現(xiàn)數(shù)據(jù)共享或交互。3.3. 約定說明l 電子商務(wù)系統(tǒng)與ERP系統(tǒng)是兩個(gè)各自獨(dú)立運(yùn)行的系統(tǒng)，中間表可駐留在任一方的數(shù)據(jù)庫實(shí)例內(nèi)。l 中間表的數(shù)據(jù)庫編碼為UTF-8。l B2B系統(tǒng)與ERP系統(tǒng)對中間表要有相應(yīng)的讀寫權(quán)限，也需要定義和執(zhí)行存儲(chǔ)過程的權(quán)限。l 電子商務(wù)系統(tǒng)與ERP系統(tǒng)不可以直接訪問對方的數(shù)據(jù)，它們只能通過中間表來進(jìn)行數(shù)據(jù)同步。l 若具體業(yè)務(wù)沒有明確說明，中間表數(shù)據(jù)中為NULL的字段默認(rèn)視作無效數(shù)據(jù)雙方都不需要進(jìn)行處理；空字符串視作有效數(shù)據(jù)。l 為了方便操作，所有通知表均不添加外鍵約束。l 中間表名稱，ERP系統(tǒng)端的表以”I_ERP_”作為前綴；B2B系統(tǒng)端的表以“I_EC_”作為前綴。l 中間表名、中間表字段名在數(shù)據(jù)庫中一律使用大寫。l WebService的服務(wù)調(diào)用名稱、輸入輸出參數(shù)名稱嚴(yán)格區(qū)分大小寫。l WebService的服務(wù)調(diào)用名稱、輸入輸出參數(shù)信息、XML格式等以最終確認(rèn)的WebService Schema文件為準(zhǔn)。3.4. 中間表接口方式詳細(xì)描述通知機(jī)制中間表中設(shè)置了“通知表”用以模擬消息機(jī)制，ERP系統(tǒng)和B2B系統(tǒng)均有屬于自己的通知表，通知表的詳細(xì)說明請看3.5通知表一節(jié)。通知對方處理事件B2B系統(tǒng)或ERP系統(tǒng)往自己的通知表里寫入事件通知，把業(yè)務(wù)事件代碼寫入通知的actionType字段。接收/處理事件B2B系統(tǒng)或ERP系統(tǒng)監(jiān)控（定時(shí)輪詢）對方的通知表；有新消息的情況下讀取新通知，根據(jù)通知里的業(yè)務(wù)事件代碼（actionType）進(jìn)行相關(guān)的數(shù)據(jù)讀取和操作；處理完事件后把通知的handleStatus設(shè)置成1、把handleTime設(shè)置成當(dāng)前時(shí)間，再把通知數(shù)據(jù)轉(zhuǎn)移到通知備份表。示例ERP系統(tǒng)新添加了一個(gè)商品，通知B2B系統(tǒng)過程：（1） ERP系統(tǒng)在自己的通知表I_ERP_NOTE里寫入一條新通知。（2） ERP把新增的商品數(shù)據(jù)寫入中間表I_ERP_PRODUCT，并把通知的ID寫進(jìn)記錄里作為與通知表關(guān)聯(lián)的鍵。B2B同步新商品數(shù)據(jù)過程：（1） B2B系統(tǒng)監(jiān)控對方的通知表I_ERP_NOTE。（2） B2B系統(tǒng)發(fā)現(xiàn)I_ERP_NOTE有新消息，通過actionType得知該消息是ERP系統(tǒng)里新添加了商品，需要進(jìn)行數(shù)據(jù)同步。（3） B2B系統(tǒng)通過通知ID到I_ERP_PRODUCT表讀取新增的商品數(shù)據(jù)，并進(jìn)行處理。（4） 處理完后把通知的handleStatus設(shè)置為1、把handleTime設(shè)置成當(dāng)前時(shí)間。（5） B2B系統(tǒng)把通知移動(dòng)到通知備份表I_ERP_NOTE_BAK，即把數(shù)據(jù)先復(fù)制到備份表再把通知記錄刪除。3.5. 通知表l 通知表就是一個(gè)負(fù)責(zé)總控消息的表；通知表的數(shù)據(jù)都必須是需要處理的；l 通過查看通知表，可知道當(dāng)前有哪些業(yè)務(wù)需要處理；通過查看通知表備份表，可知道已經(jīng)處理了哪些業(yè)務(wù)；l 通知表的數(shù)據(jù)處理完就備份刪除；而其他中間表的數(shù)據(jù)是累加的，處理完后是否需要清空要視乎事務(wù)的需要。3.5.1. I_EC_NOTE（電子商務(wù)系統(tǒng)業(yè)務(wù)通知表）字段名稱數(shù)據(jù)類型備注ecNoteIDintegerPK，自增actionTypeVarchar(32)業(yè)務(wù)事件代碼【1=訂單】1_2 =取消訂單1_3 =在線支付【3=會(huì)員】3_1會(huì)員網(wǎng)上注冊3_2為ERP往來單位開通B2B會(huì)員帳號noteTimedate通知時(shí)間orderIdinteger如果是關(guān)于訂單的通知,填寫訂單接口表的訂單Id；否則為NULLorderStatusInteger訂單狀態(tài)notesVarchar(255)說明內(nèi)容(關(guān)于訂單狀態(tài)變化的說明文字，如訂單被客戶撤銷等)handleStatusinteger0 未處理 ，1處理成功，2處理失敗handleTimedate處理時(shí)間，默認(rèn)是null 注：處理完成后的通知數(shù)據(jù)要進(jìn)行備份和刪除，即先把通知數(shù)據(jù)復(fù)制到 I_ EC_NOTE_BAK再刪除。3.5.2. I_EC_NOTE_BAK（電子商務(wù)系統(tǒng)業(yè)務(wù)通知備份表）當(dāng)ERP系統(tǒng)處理I_EC_NOTE后要修改處理狀態(tài)和更新處理時(shí)間，并備份到I_EC_NOTE_BAK中。字段名稱數(shù)據(jù)類型字段含義ecNoteIDinteger對應(yīng)I_EC_NOTE表同名字段。主鍵actionTypeVarchar(32)對應(yīng)I_EC_NOTE表同名字段。noteTimeDate對應(yīng)I_EC_NOTE表同名字段。handleTimedate對應(yīng)I_EC_NOTE表同名字段。OrderIDIntegerOrderStatusIntegerNoteshandleStatusinteger對應(yīng)I_EC_NOTE表同名字段。handleTimedate對應(yīng)I_EC_NOTE表同名字段。3.5.3. I_ERP_NOTE（ERP系統(tǒng)業(yè)務(wù)通知表）字段名稱數(shù)據(jù)類型字段含義erpNoteIDintegerPK，自增actionTypeVarchar(32)業(yè)務(wù)類型【1=訂單】1_1 =更新訂單狀態(tài)1_4=更新TMS信息【2=商品】2_1 = 新增或修改商品信息2_1_d = 刪除商品信息2_2 = 新增或修改經(jīng)營類型2_2_d = 刪除經(jīng)營類型2_3 = 新增或修改功效類別2_3_d = 刪除功效類別2_4 = 新增或修改品種類型2_4_d = 刪除品種類型2_5 = 新增或修改劑型2_5_d =刪除劑型2_6 = 新增或修改基本藥品目錄分類2_6_d = 刪除基本藥品目錄分類2_7=新增或更新物流商信息2_7_d=刪除物流商信息【3=會(huì)員】3_3 GSP認(rèn)證通知3_4往來單位信息增量更新noteTimedate通知時(shí)間OrderIDInteger如果是關(guān)于訂單的通知,填寫訂單接口表的主鍵erpOrderID；否則為NULLorderStatusInteger訂單狀態(tài)1草擬2已提交3待支付4已確認(rèn)支付5已申請出庫6正在揀配出庫7已出庫待發(fā)運(yùn)8貨物已發(fā)出9確認(rèn)收貨10已終止(整單退貨退款)11財(cái)務(wù)撤銷確認(rèn)-1已作廢notesVarchar(255)說明內(nèi)容(關(guān)于訂單狀態(tài)變化的說明文字，如訂單被ERP撤銷、訂單審核失敗等)handleStatusinteger未處理是0 ，處理完是1handleTimedate處理時(shí)間，新增加的為null 注：處理完成后的通知數(shù)據(jù)要進(jìn)行備份和刪除，即先把通知數(shù)據(jù)復(fù)制到 I_ ERP_NOTE_BAK再刪除。3.5.4. I_ERP_NOTE_BAK（ERP系統(tǒng)業(yè)務(wù)通知備份表）當(dāng)電子商務(wù)系統(tǒng)處理I_ERP_NOTE后要修改處理狀態(tài)和更新處理時(shí)間，并備份到I_ERP_NOTE_BAK中。字段名稱數(shù)據(jù)類型字段含義erpNoteIDinteger對應(yīng)I_ERP_NOTE表同名字段。actionTypeVarchar(32)對應(yīng)I_ERP_NOTE表同名字段。noteTimedate對應(yīng)I_ERP_NOTE表同名字段。OrderIDInteger對應(yīng)I_ERP_NOTE表同名字段。orderStatusInteger對應(yīng)I_ERP_NOTE表同名字段。notesVarchar(255)對應(yīng)I_ERP_NOTE表同名字段。handleTimedate對應(yīng)I_ERP_NOTE表同名字段。handleStatusinteger對應(yīng)I_ERP_NOTE表同名字段。handleTimedate對應(yīng)I_ERP_NOTE表同名字段。4. 主要業(yè)務(wù)處理4.1. 訂單B2B系統(tǒng)只接收客戶訂單，受理用戶在線支付，不對訂單進(jìn)行任何處理，所有處理都是在ERP內(nèi)處理，處理的信息需反饋到電子商務(wù)系統(tǒng)。B2B系統(tǒng)訂單的id和編號與ERP系統(tǒng)訂單的id和編號保持一致。4.1.1. 接口表4.1.1.1. I_EC_ORDER_PAYMENT（電子商務(wù)- 訂單支付）訂單支付時(shí)候，所記錄的信息字段名稱數(shù)據(jù)類型備注ecNoteIDintegerPK，關(guān)聯(lián)I_EC_NOTE表OrderIDInteger相關(guān)聯(lián)的訂單IDpaymentAmtNumeric(12,2)支付金額payFlowIdvarchar(32)支付的流水號receiveBankvarchar(128)收款行receiveAccountvarchar(32)收款帳號payBankvarchar(128)付款行PayTimeDate支付時(shí)間createTimeDate寫記錄時(shí)間4.1.1.2. I_ERP_ORDER（ERP-訂單處理表）ERP系統(tǒng)需要供B2B共享的訂單數(shù)據(jù)存放在此表中，訂單狀態(tài)發(fā)生變化時(shí)，通過業(yè)務(wù)通知向B2B發(fā)送消息。字段名稱數(shù)據(jù)類型字段含義erpOrderIDintegerPK（由ERP系統(tǒng)產(chǎn)生）orderNoVarchar(32)訂單號，由ERP系統(tǒng)產(chǎn)生customerIDInteger采購客戶代號orderDateDate訂單日期（訂單首次向ERP提交的時(shí)間）orderStatusInteger訂單狀態(tài)1草擬2已提交3待支付4已確認(rèn)支付5已申請出庫6正在揀配出庫7已出庫待發(fā)運(yùn)8貨物已發(fā)出9確認(rèn)收貨10已終止(整單退貨退款)11財(cái)務(wù)撤銷確認(rèn)-1已作廢paymentStatusinteger支付狀態(tài)。0未支付1已支付provinceVarchar(32)收貨地址省份cityVarchar(32)收貨地址城市countyVarchar(32)收貨地址縣(區(qū))addressVarchar(64)收貨詳細(xì)地址(鄉(xiāng)鎮(zhèn)、街道、門牌號)deliverTypeinteger提貨方式：1-送貨,2-送托,3-托運(yùn),4-自提（可用的提貨方式與收貨地址有關(guān))deliverVendorIDinteger物流商ID(可用的物流商與地址和配送方式有關(guān))receiverNameVarchar(32)收貨人姓名paymentTypeinteger支付方式：1-款到發(fā)貨;2-貨到付款;3-定期結(jié)算noteVarchar2(60)處理備注operatorVarchar(255)業(yè)務(wù)處理人handleTimedate業(yè)務(wù)處理時(shí)間orderSourceinteger訂單來源：1-網(wǎng)上平臺(tái) 2-呼叫中心 3-業(yè)務(wù)系統(tǒng)4.1.1.3. I_ERP_ORDER_ITEM（ERP-訂單明細(xì)表）ERP訂單明細(xì)表記錄訂單購買的具體商品字段名稱數(shù)據(jù)類型備注erpOrderIdintegerPK,（FK，I_ERP_ORDER.ERPOrderID)orderItemNointegerPKproductIdinteger商品IdtotalDemandnumber(14,4)訂購數(shù)量(客戶的意向訂購數(shù)量)totalSatisfiedNumber(14,4)滿足數(shù)量(因庫存不足或銷售策略限制，該品種數(shù)量不能大于該滿足數(shù)量)totalConfirmedNumber(14,4)確認(rèn)數(shù)量(客戶最終確認(rèn)購買的數(shù)量，必須是0至滿足數(shù)量之間的數(shù)值，客戶最終付款應(yīng)該以確認(rèn)數(shù)量為基礎(chǔ)）priceNumber(14,4)單價(jià)（實(shí)際成交的單價(jià)）amountNumber(14,2)金額(該訂單項(xiàng)目的金額，一般為確認(rèn)數(shù)量*單價(jià)）totalShortNumber(14,4)缺貨數(shù)量（訂單支付以后，因特殊原因?qū)е碌娜必洈?shù)量，出現(xiàn)缺貨時(shí)須與客戶及時(shí)溝通并確認(rèn)是否繼續(xù)執(zhí)行該訂單以及執(zhí)行的選項(xiàng)，如限期補(bǔ)發(fā)缺貨或部分退款等）notesVarchar(255)說明備注（用于無法完全滿足或缺貨時(shí)的說明）lotNumberVarchar(32)批次productionDateVarchar(32)生產(chǎn)日期4.1.1.4. I_ERP_TMS TMS信息(物流信息)字段名稱數(shù)據(jù)類型備注erpNoteIDinteger等于I_ERP_NOTE的erpNoteIDerpOrderIDintegersequenceNointeger順序號(每個(gè)訂單從1開始遞增)noteVarchar(255)組和字符operatorVarchar(32)操作者createTimedate時(shí)間4.1.1.5. I_ERP_VENDOR 物流服務(wù)商信息字段名稱數(shù)據(jù)類型備注pidintegerPKerpNoteIDinteger等于I_ERP_NOTE的erpNoteIDvenderIdinteger物流供應(yīng)商IdvendorNamevarchar（64）物流供應(yīng)商名稱memovarchar（128）備注4.1.2. WebService4.1.2.1. ERP系統(tǒng)下訂單服務(wù)接口名稱：addSalesOrder輸入?yún)?shù)：參數(shù)名稱(參數(shù)類型)范例說明argXml（String ，XML格式） erpCustomerId：ERP系統(tǒng)往來單位IdorderType:訂單類型0-普通訂單 1-團(tuán)購訂單totalAmount：訂單總金額shippingCost：運(yùn)費(fèi)deliverVendorID：物流商IddeliveryType：1 送貨 2 送托 3 托運(yùn) 4 自提 paymentType：支付方式：1-款到發(fā)貨;2-貨到付款;3-定期結(jié)算receiverName：收貨人姓名telephone：收貨人電話號碼zip：收貨人郵編fax：收貨人傳真country：收貨人國家state：收貨人省份city：收貨人城市district；收貨人縣address：收貨人地址hasInvoice：是否需要發(fā)票，非1不需要1=需要invoiceTitle：發(fā)票抬頭deliveryTime：送貨時(shí)間（如：只工作日送貨(雙休日、假日不用送)）note客戶備注 varchar（60）createTime：下單時(shí)間orderItem：訂單項(xiàng)itemCount：訂單項(xiàng)的數(shù)量itemNo:訂單項(xiàng)標(biāo)識(shí)productId：商品IdtotalDemand表示訂購數(shù)量(客戶的意向訂購數(shù)量)。price：購買價(jià)格（折扣后的價(jià)格）ruleId:應(yīng)用的促銷方案Id返回值：返回類型范例說明String，XML格式 orderItems:需要確認(rèn)數(shù)量的的訂單明細(xì)項(xiàng)集合;orderItem: 需要確認(rèn)數(shù)量的的訂單明細(xì)項(xiàng)（多個(gè)）;productId：商品IdtotalSatisfied表示滿足數(shù)量(因庫存不足或銷售策略限制，該品種數(shù)量不能大于該滿足數(shù)量)。resultCode表示ERP系統(tǒng)對該購買行為意向的是否能滿足的狀態(tài)。note表示說明備注（用于無法完全滿足或缺貨時(shí)的說明）resultCode有以下幾種取值：0=可以完全接受;1=不能購買，因?yàn)閷?shí)際庫存不能滿足。2=不能購買，因?yàn)樾再|(zhì)限銷，該商品無法供應(yīng)給此顧客。3=不能購買，因?yàn)榈貐^(qū)限銷，該商品無法運(yùn)往顧客所在地。4=不能購買，因?yàn)槠贩N限銷。4.1.2.2. B2B更新訂單明細(xì)項(xiàng)確認(rèn)采購數(shù)量接口名稱：updateOrderItemTotalConfirmed輸入?yún)?shù)：參數(shù)名稱(參數(shù)類型)范例說明輸入xmlargXml 說明：orderId表示訂單iditemNo：訂單項(xiàng)PktotalConfirmed：確認(rèn)數(shù)量(客戶最終確認(rèn)購買的數(shù)量，必須是0至滿足數(shù)量之間的數(shù)值，客戶最終付款應(yīng)該以確認(rèn)數(shù)量為基礎(chǔ)）返回值：返回類型范例說明String，XML格式 status表示返回狀態(tài)，如果成功修改為0，否則為非14.1.3. 業(yè)務(wù)描述4.1.3.1. B2B系統(tǒng)下訂單采購會(huì)員在線下訂單，B2B系統(tǒng)調(diào)用WebService向ERP系統(tǒng)提交新訂單，這個(gè)過程會(huì)有以下幾種情況：1. 一切正常：下單成功，B2B系統(tǒng)的WebService調(diào)用返回新訂單的id和訂單號。2. 訂購貨物未能全部滿足：下單成功，WebService調(diào)用除了返回新訂單的id和訂單號，還返回不能完全滿足品種的可滿足數(shù)量和未能滿足的原因（例如缺貨、品種禁銷、品種限銷、地區(qū)限銷）。3. 地區(qū)限銷異常：若下單的往來單位所在地區(qū)不在所訂購貨物的限銷地區(qū)內(nèi)，B2B系統(tǒng)的WebService調(diào)用返回那些商品地區(qū)限銷的內(nèi)容提示。4. 往來單位異常：若下單的往來單位未能達(dá)到下單條件，例如未通過GSP認(rèn)證或者根本就不存在，B2B系統(tǒng)的WebService調(diào)用返回下單失敗的內(nèi)容提示。5. 其他異常：例如ERP系統(tǒng)檢測到訂單信息不對、所訂購的品種不存在等情況，B2B系統(tǒng)的WebService調(diào)用返回具體的異常原因。6. 運(yùn)行時(shí)異常：若WebService不可用（通常由斷網(wǎng)、ERP WebService滿負(fù)荷、服務(wù)器DOWN機(jī)等原因造成），這種情況WebService不能正常調(diào)用，B2B系統(tǒng)的下單中斷。7. 分布系統(tǒng)異常：若WebService提交運(yùn)行后，由于網(wǎng)絡(luò)的原因?qū)е翬RP已經(jīng)執(zhí)行下單服務(wù)而B2B得不到結(jié)果，則B2B系統(tǒng)可能會(huì)在網(wǎng)絡(luò)恢復(fù)以后再次下單，而導(dǎo)致同一客戶訂單在ERP中形成多筆訂單。所調(diào)用的WebService詳細(xì)信息技術(shù)請看“4.1.2.1ERP系統(tǒng)下訂單服務(wù)”一節(jié)。4.1.3.2. B2B系統(tǒng)更訂單項(xiàng)采購數(shù)量采購會(huì)員在線成功下訂單后，由于某些特殊原因（例如庫存沒法滿足、區(qū)域限銷、品種限銷等）商康沒法全部滿足訂單的供貨，B2B系統(tǒng)會(huì)讓采購會(huì)員進(jìn)行商品采購數(shù)量的更改確認(rèn)。確認(rèn)后B2B系統(tǒng)調(diào)用WebService要把采購數(shù)量確認(rèn)信息提交給ERP系統(tǒng)。所調(diào)用的WebService詳細(xì)信息技術(shù)請看“4.1.2.2更新訂單項(xiàng)采購數(shù)量”一節(jié)。4.1.3.3. B2B更新訂單狀態(tài)ERP系統(tǒng)接口處理流程：l ERP系統(tǒng)向“ERP系統(tǒng)業(yè)務(wù)通知表”【I_ERP_NOTE】新增一條記錄n erpNoteID = 自增idn actionType = 1_1 n noteTime = 當(dāng)前時(shí)間n handleStatus = 0n handleTime = nullB2B系統(tǒng)接口處理流程：l B2B收到新通知（讀取“ERP系統(tǒng)業(yè)務(wù)通知表” 【I_ERP_NOTE】）。l 根據(jù)actionType到表【I_ERP_NOTE】讀取訂單狀態(tài)信息【orderStatus】進(jìn)行相應(yīng)更新。l B2B處理完后，把通知表的相應(yīng)記錄的處理狀態(tài)【handleStatus】修改為1，【handleTime】修改為當(dāng)前時(shí)間；然后把該記錄復(fù)制到“ERP系統(tǒng)業(yè)務(wù)通知備份表”【I_ERP_NOTE_BAK】作備份及以后用于跟蹤。B2B系統(tǒng)刪除剛處理的通知記錄。4.1.3.4. B2B系統(tǒng)取消訂單請求前臺(tái)采購商在下達(dá)的訂單在未確認(rèn)支付時(shí)候可取消訂單（是否能夠成功取消訂單需要等待ERP的狀態(tài)變更通知）。B2B系統(tǒng)接口處理流程：l B2B系統(tǒng)向“B2B系統(tǒng)業(yè)務(wù)通知表”【I_EC_NOTE】新增一條記錄n erpNoteID = 自增idn actionType = 1_2n noteTime = 當(dāng)前時(shí)間n handleStatus = 0n handleTime = nulll B2B系統(tǒng)根據(jù)發(fā)生改變的信息相應(yīng)在【I_EC_ORDER】表上新增一條記錄修改erpNoteID使該記錄與新增的通知關(guān)聯(lián)。ERP系統(tǒng)接口處理流程：l ERP系統(tǒng)收到新通知（讀取“B2B系統(tǒng)業(yè)務(wù)通知表” 【I_EC_NOTE】）。l 更新到ERP取消訂單ERP處理完后，把通知表的相應(yīng)記錄的處理狀態(tài)【handleStatus】修改為1，【handleTime】修改為當(dāng)前時(shí)間；然后把該記錄復(fù)制到“ERP系統(tǒng)業(yè)務(wù)通知備份表”【I_EC_NOTE_BAK】作備份及以后用于跟蹤。ERP系統(tǒng)刪除剛處理的通知記錄。4.1.3.5. B2B系統(tǒng)在線支付采購商在B2B下單后，執(zhí)行在線支付，支付信息需要同步到ERP系統(tǒng)里。B2B系統(tǒng)接口處理流程：l B2B系統(tǒng)向“B2B系統(tǒng)業(yè)務(wù)通知表”【I_EC_NOTE】新增一條記錄n erpNoteID = 自增idn actionType = 1_3n noteTime = 當(dāng)前時(shí)間n handleStatus = 0n handleTime = nulll B2B系統(tǒng)根據(jù)發(fā)生改變的信息相應(yīng)在【I_EC_ORDER_PAYMENT】表上新增一條記錄n 修改erpNoteID使該記錄與新增的通知關(guān)聯(lián)。ERP系統(tǒng)接口處理流程：l ERP系統(tǒng)收到新通知（讀取“B2B系統(tǒng)業(yè)務(wù)通知表” 【I_EC_NOTE】）。l 到表【I_EC_ORDER_PAYMENT】獲得訂單的支付信息。ERP處理完后，把通知表的相應(yīng)記錄的處理狀態(tài)【handleStatus】修改為1，【handleTime】修改為當(dāng)前時(shí)間；然后把該記錄復(fù)制到“ERP系統(tǒng)業(yè)務(wù)通知備份表”【I_EC_NOTE_BAK】作備份及以后用于跟蹤。ERP系統(tǒng)刪除剛處理的通知記錄。4.1.3.6. ERP系統(tǒng)更新TMS信息ERP系統(tǒng)接口處理流程：l ERP系統(tǒng)向“ERP系統(tǒng)業(yè)務(wù)通知表”【I_ERP_NOTE】新增一條記錄n erpNoteID = 自增idn actionType = 1_4 n noteTime = 當(dāng)前時(shí)間n handleStatus = 0n handleTime = nulll ERP系統(tǒng)根據(jù)發(fā)生改變的信息相應(yīng)在【I_ERP_TMS】表上新增一條記錄n 修改erpNoteID使該記錄與新增的通知關(guān)聯(lián)。B2B系統(tǒng)接口處理流程：l B2B收到新通知（讀取“ERP系統(tǒng)業(yè)務(wù)通知表” 【I_ERP_NOTE】）。l 根據(jù)actionType到表【I_ERP_TMS】讀取TMS信息進(jìn)行相應(yīng)更新。l B2B處理完后，把通知表的相應(yīng)記錄的處理狀態(tài)【handleStatus】修改為1，【handleTime】修改為當(dāng)前時(shí)間；然后把該記錄復(fù)制到“ERP系統(tǒng)業(yè)務(wù)通知備份表”【I_ERP_NOTE_BAK】作備份及以后用于跟蹤。B2B系統(tǒng)刪除剛處理的通知記錄。4.2. 商品4.2.1. 接口表4.2.1.1. I_ERP_PRODUCT（ERP-商品信息）字段名稱數(shù)據(jù)類型是否必須備注pidinteger接口表主鍵IdproductIdinteger本身Id。相當(dāng)于“品種ID”erpNoteIDinteger等于I_ERP_NOTE的erpNoteIDproductNamevarchar(128)商品名稱，相當(dāng)于“品名”salesMeasureUnitNamevarchar(32)銷售單位名稱,相當(dāng)于“單位”，如“包”，“盒”specvarchar(128)規(guī)格originvarchar(128)廠家產(chǎn)地stautssmallint是否禁止銷售，空或0 = 否，其他=是smallPackingQuantityinteger件裝數(shù)量midPackingQuantityinteger中包裝數(shù)量 saleTypeIdinteger經(jīng)營類別外鍵ideffectTypeIdinteger功效類別外鍵idproductKindIdinteger品種類別外鍵iddosageFormIdinteger劑型外鍵idapproveNumbervarchar(128)批準(zhǔn)文號categoryIdinteger基本藥品目錄分類外鍵idwholesalePricenumeric(12,2)批發(fā)價(jià)bidPricenumeric(12,2)中標(biāo)價(jià)retailPricenumeric(12,2)零售價(jià)pricenumeric(12,2)建議銷售價(jià)格，即下訂單的價(jià)格，以銷售單位作為計(jì)量標(biāo)準(zhǔn)。commonNamevarchar(128)通用名isSaleLimitsmallint是否性質(zhì)限銷，空或0 = 否，其他=是。（webservice）isDistrictLimitsmallint是否地區(qū)限銷，空或0 = 否，其他=是。與客戶相關(guān)，例如禁止銷售給藥房。（webservice）mnemonicCodevarchar(256)助記碼 （商品所有助記碼的拼接的字符串，各個(gè)字符串用英文分號分割，如：ABC;ERT;TTG）pinyinCodevarchar(256)拼音碼chemicalNamevarchar(128)化學(xué)名稱purchasePeriodinteger采購周期 單位：天inventoryinteger庫存量logNumberVarchar(32)批次productionDateVarchar(32)生產(chǎn)日期示例： 字段名稱示例一示例二pid1productId100erpNoteID1000productName板藍(lán)根含片薄膜衣salesMeasureUnitName盒spec每盒10袋，每袋10克（相當(dāng)于總藥材10克）origin佛山市順德康富來藥業(yè)有限公司stautssmallPackingQuantity20midPackingQuantity30saleTypeId5effectTypeId4productKindId3dosageFormId6approveNumber國藥準(zhǔn)字Z4402216categoryId2wholesalePrice535.00bidPrice525.50retailPrice540.25price538.00commonName板藍(lán)根顆粒isSaleLimitisDistrictLimit1mnemonicCodeXTKACV;板藍(lán)根chemicalNameTTCpurchasePeriod2周半4.2.1.2. I_ERP_SALE_TYPE（ERP-經(jīng)營類別）字段名稱數(shù)據(jù)類型是否必須備注pidinteger接口表主鍵IderpNoteIDinteger等于I_ERP_NOTE的erpNoteIDsaleTypeIdinteger經(jīng)營類別IdsaleTypeNamevarchar(128)經(jīng)營類別名稱ParentInteger父類代號(自關(guān)聯(lián)pid)ClasscodeVarchar2(40)類別編碼ClassLevelinteger類別級別Termiatedinteger是否葉節(jié)點(diǎn)(0-非葉節(jié)點(diǎn) 其他-葉節(jié)點(diǎn))4.2.1.3. I_ERP_EFFECT_TYPE（ERP-功效類別）字段名稱數(shù)據(jù)類型是否必須備注pidinteger接口表主鍵IderpNoteIDinteger等于I_ERP_NOTE的erpNoteIDeffectTypeIdinteger功效類別ideffectTypeNamevarchar(128)功效類別名稱ParentInteger父類代號(自關(guān)聯(lián)pid)ClasscodeVarchar2(40)類別編碼ClassLevelinteger類別級別Terminatedinteger是否葉節(jié)點(diǎn)(0-非葉節(jié)點(diǎn) 其他-葉節(jié)點(diǎn))4.2.1.4. I_ERP_PRODUCT_KIND（ERP-品種類別）字段名稱數(shù)據(jù)類型是否必須備注pidinteger接口表主鍵IderpNoteIDinteger等于I_ERP_NOTE的erpNoteIDproductKindIdinteger品種類別idproductKindNamevarchar(128)品種類別名稱ParentInteger父類代號(自關(guān)聯(lián)pid)ClasscodeVarchar2(40)類別編碼ClassLevelinteger類別級別Terminatedinteger是否葉節(jié)點(diǎn)(0-非葉節(jié)點(diǎn) 其他-葉節(jié)點(diǎn))4.2.1.5. I_ERP_DOSAGE_FORM（ERP-劑型）字段名稱數(shù)據(jù)類型是否必須備注pidinteger接口表主鍵IderpNoteIDinteger等于I_ERP_NOTE的erpNoteIDdosageFormIdinteger劑型iddosageFormNamevarchar(128)劑型名稱4.2.1.6. I_ERP_CATEGORY（ERP-基本藥品目錄分類）字段名稱數(shù)據(jù)類型是否必須備注pidinteger接口表主鍵IderpNoteIDinteger等于I_ERP_NOTE的erpNoteIDcategoryIdinteger目錄分類idcategoryNamevarchar(128)基本藥品目錄分類名稱4.2.2. WebService4.2.2.1. B2B系統(tǒng)獲得客戶購買行為的滿足情況。接口名稱：getBuyInfo描述：B2B系統(tǒng)告知ERP系統(tǒng)客戶的購買行為，ERP系統(tǒng)把滿足情況等返回B2B系統(tǒng)。B2B系統(tǒng)在添加商品到購物車和下單時(shí)候調(diào)用。輸入?yún)?shù)：參數(shù)名稱(參數(shù)類型)范例說明argXml（String ，XML格式） 11500 31400 item表示一個(gè)購買意向；productId表示商品主鍵；erpCustomerId表示客戶主鍵;totalDemand表示訂購數(shù)量(客戶的意向訂購數(shù)量)。左側(cè)示例表示erpCustomerId為1的顧客意向訂購500個(gè)單位productId為1的商品，以及400個(gè)單位productId為3的商品返回值：返回類型范例說明String，XML格式 115003000 314003001庫存不足無法滿足 resultCode表示ERP系統(tǒng)對該購買行為意向的是否能滿足的狀態(tài)。totalSatisfied表示滿足數(shù)量(因庫存不足或銷售策略限制，該品種數(shù)量不能大于該滿足數(shù)量)。note表示說明備注（用于無法完全滿足或缺貨時(shí)的說明）resultCode有以下幾種取值：0=可以完全接受;1=不能購買2=不能購買，因?yàn)樾再|(zhì)限銷，該商品無法供應(yīng)給此顧客。3=不能購買，因?yàn)榈貐^(qū)限銷，該商品無法運(yùn)往顧客所在地。4=限購數(shù)量限制。4.2.3. 業(yè)務(wù)描述4.2.3.1. ERP系統(tǒng)更新商品信息。ERP系統(tǒng)接口處理流程：l ERP系統(tǒng)向“ERP系統(tǒng)業(yè)務(wù)通知表”【I_ERP_NOTE】新增一條記錄n erpNoteID = 自增idn actionType = “2_1”表示新增或修改，“2_1_d”表示刪除n noteTime = 當(dāng)前時(shí)間n handleStatus = 0n handleTime = nulll ERP系統(tǒng)根據(jù)發(fā)生改變的信息相應(yīng)在【I_ERP_PRODUCT】表上新增