旺店通ERPapi_V1_9_1最新版

1、34旺店通ERP接口文檔旺店通ERP接口文檔V1.9.1北京掌上先機(jī)網(wǎng)絡(luò)科技有限公司研發(fā)部目錄一、 概述3二、 接口規(guī)范說(shuō)明3接口方式：3接口數(shù)據(jù)傳輸類型：3格式：3三、 接口描述41. 創(chuàng)建單據(jù)接口42. 取消單據(jù)接口63. 查詢貨品庫(kù)存信息74. 訂單發(fā)貨物流信息推送接口95. 庫(kù)存同步接口116. 查詢訂單接口（根據(jù)訂單編號(hào)）127. 查詢訂單接口（根據(jù)訂單修改時(shí)間）168. 訂單物流同步接口219. 貨品信息同步接口2210.查詢?cè)敿?xì)出庫(kù)單接口2411.查詢?cè)敿?xì)入庫(kù)單接口2612.查詢ERP貨品信息2913.查詢ERP采購(gòu)單信息32341、 概述旺店通ERP外部接口文檔用于描述旺店通E

2、RP系統(tǒng)和外部管理軟件進(jìn)行數(shù)據(jù)交互的接口格式。本文檔為外部管理軟件對(duì)接旺店通ERP提供解決方案，規(guī)范外部管理軟件跟旺店通ERP對(duì)接的數(shù)據(jù)交互格式和業(yè)務(wù)流程。2、 接口規(guī)范說(shuō)明接口方式：REST - HTTP POST (數(shù)據(jù)要放到post 的data 里面)接口數(shù)據(jù)傳輸類型：JSON格式：Method=?&SellerID=? & InterfaceID=? & Sign=? & Content=?Method 是本次請(qǐng)求的業(yè)務(wù)類型SellerID是ERP為賣家分配的帳號(hào)。 限長(zhǎng)32InterfaceID是ERP為外部接口分配的帳號(hào)限長(zhǎng)32Sign是簽名驗(yàn)證字段

3、 為取 content+key的md5值再進(jìn)行Base64編碼,key是ERP給外部接口的授權(quán)字段，用于這里進(jìn)行簽名驗(yàn)證，key由ERP分配Content是需要傳輸?shù)臄?shù)據(jù)部分為JSON格式這些請(qǐng)求參數(shù)都需要進(jìn)行URL編碼。md5 模式為 32位小寫如下為生成Sign的例子：content="test":1 key=12345content+key="test":112345md5(c+k)=4a8f9de0e8638669490179ff525e0d29再進(jìn)行base64編碼：NGE4ZjlkZTBlODYzODY2OTQ5MDE3OWZmNTI1ZTB

4、kMjk=最后url編碼：NGE4ZjlkZTBlODYzODY2OTQ5MDE3OWZmNTI1ZTBkMjk%3DSign=NGE4ZjlkZTBlODYzODY2OTQ5MDE3OWZmNTI1ZTBkMjk%3D旺店通ERP接口采用HTTP POST的方式接受請(qǐng)求和返回結(jié)果，請(qǐng)求參數(shù)和回傳結(jié)果均采用JSON格式。發(fā)送請(qǐng)求的樣例：Method=NewOrder&SellerID=maijia&InterfaceID=interf&Sign=YUFTLsgl0YlsOUoIJKL&Content=“OutInFlag”: 0,.以下接口描述均只介紹Conte

5、nt參數(shù)內(nèi)容,UTF-8編碼3、 接口描述1. 創(chuàng)建單據(jù)接口Ø 用途：外部系統(tǒng)向旺店通ERP下發(fā)業(yè)務(wù)單據(jù)。ERP根據(jù)下發(fā)的單據(jù)在系統(tǒng)內(nèi)創(chuàng)建相應(yīng)的業(yè)務(wù)單據(jù)。Ø 觸發(fā)：外部系統(tǒng)發(fā)起請(qǐng)求Ø 業(yè)務(wù)類型：Method = NewOrder請(qǐng)求元素說(shuō)明元素名稱限長(zhǎng)是否必填默認(rèn)值樣例說(shuō)明一級(jí)節(jié)點(diǎn)-單據(jù)信息OutInFlagInt(1)是無(wú)1出入庫(kù)類型標(biāo)記（0普通入庫(kù)，1普通出庫(kù)，2采購(gòu)入庫(kù)，3銷售出庫(kù)）IF_OrderCode32是無(wú)OR2013010101外部單據(jù)編號(hào)WarehouseNO16是無(wú)BJZP倉(cāng)庫(kù)編號(hào)(銷售出庫(kù)時(shí)非空)Remark500否無(wú)需緊急處理備注TheCa

6、use50否無(wú)采購(gòu)入庫(kù)出入庫(kù)原因ProviderNO50否無(wú)GYS001供應(yīng)商編號(hào)ProviderName200否無(wú)北京供應(yīng)商供應(yīng)商名稱LinkMan50否無(wú)張三供應(yīng)商聯(lián)系人LinkManTel20否無(wú)13333333聯(lián)系人電話LinkManAdr300否無(wú)北京聯(lián)系人地址RegOperatorNO20否無(wú)YW001業(yè)務(wù)員編號(hào)GoodsTotalDecimal(19,4)是無(wú)4000.00貨款合計(jì)(銷售出庫(kù)時(shí)非空)FavourableTotalDecimal(19,4)否無(wú)0.00優(yōu)惠金額OtherFeeDecimal(19,4)否無(wú)100.00其他費(fèi)用COD_FlagInt(1)否00貨到付款

7、標(biāo)記，0為不需要貨到付款，1為需要貨到付款 OrderPayDecimal(19,4)否無(wú)4010.00訂單付款金額（含運(yùn)費(fèi)）（出庫(kù)時(shí)非空）LogisticsPayDecimal(19,4)否無(wú)10.00運(yùn)費(fèi)（出庫(kù)時(shí)非空）LogisticsCode20否無(wú)EMS物流公司編號(hào)ShopName100否無(wú)測(cè)試店鋪訂單所屬店鋪名稱（出庫(kù)時(shí)非空）NickName50否無(wú)這是一個(gè)網(wǎng)名客戶平臺(tái)昵稱BuyerName50否無(wú)小明收貨人姓名（出庫(kù)時(shí)非空）BuyerPostCode6否無(wú)456789收貨人郵編（出庫(kù)時(shí)非空）BuyerTel20否無(wú)1333333收貨人聯(lián)系方式BuyerProvince20否無(wú)北京收

8、貨人所在?。ǔ鰩?kù)非空）BuyerCity20否無(wú)北京收貨人所在市（出庫(kù)非空）BuyerDistrict20否無(wú)海淀區(qū)收貨人所在區(qū)、縣（出庫(kù)非空）BuyerAdr200否無(wú)北京海淀區(qū)遠(yuǎn)大路1號(hào)收貨地址（出庫(kù)非空）BuyerEmail50否無(wú)buyer收貨人emaillNeedInvoiceInt(1)否01是否需要發(fā)票，1需要，0不需要InvoiceTitle100否無(wú)收款公司發(fā)票抬頭InvoiceContent500否無(wú)電腦*1發(fā)票內(nèi)容ItemCountInt(11)否無(wú)1貨品詳細(xì)的行項(xiàng)目數(shù)量PayTime否無(wú)付款時(shí)間TradeTime否無(wú)交易時(shí)間ChargeID否無(wú)支付單號(hào)二級(jí)節(jié)點(diǎn)-貨品明細(xì)

9、 ItemListSku_Code50是無(wú)HP1001貨品的唯一編碼Sku_Name350否無(wú)電腦貨品名稱Sku_PriceDecimal(19,4)否0.004000.00貨品單價(jià)DiscountDecimal(19,4)否0.000.9折扣TotalDecimal(19,4)否0.003600.00單品金額小計(jì)QtyDecimal(19,4)是無(wú)1貨品數(shù)量Item_Remark1024否無(wú)打折處理行項(xiàng)目備注示例：“OutInFlag”: 0,“IF_OrderCode”: “OR2013010101”,“WarehouseNO”: “BJZP”,“Remark”: “需緊急處理”,“The

10、Cause”: “有人白送”,“ItemCount”: 2,“ItemList”:“Item”:“Sku_Code”: “HP1001”,“Sku_Name”: “電腦”,“Sku_Price”: 4000.00,“Qty”: 1,“Item_Remark”: “打折處理”,“Sku_Code”: “HP1002”,“Qty”: 2返回元素說(shuō)明元素名稱限長(zhǎng)是否必填默認(rèn)值樣例說(shuō)明ResultCode20是無(wú)0請(qǐng)求接收結(jié)果（0成功，非0失?。㏑esultMsg200否無(wú)簽名驗(yàn)證失敗請(qǐng)求失敗時(shí)返回失敗原因ErpOrderCode32否無(wú)CG2001010133新生成的旺店通erp單據(jù)編號(hào)示例：“Re

11、sultCode”: 1,“ResultMsg”: “貨品HP1002不存在”2. 取消單據(jù)接口Ø 用途：外部系統(tǒng)請(qǐng)求取消單據(jù)Ø 觸發(fā)：外部系統(tǒng)發(fā)送請(qǐng)求Ø 業(yè)務(wù)類型：Method = CancelOrderØ 說(shuō)明： 處理請(qǐng)求時(shí)會(huì)判斷單據(jù)是否是可取消則狀態(tài)，如果是不可取消則失敗請(qǐng)求元素說(shuō)明元素名稱限長(zhǎng)是否必填默認(rèn)值樣例說(shuō)明OrderCode32是無(wú)JY2001010133ERP內(nèi)單據(jù)編號(hào)OrderType1是無(wú)1單據(jù)類型(1是訂單,2采購(gòu)單)Reason200否無(wú)顧客不要了取消原因Log1否無(wú)0簽出后是否攔截0 不攔截(默認(rèn))1 攔截 如果簽出則無(wú)法取消

12、示例“OrderCode”: “JY2001010133”,“OrderType”: “1”,“Reason”:”顧客不要了”返回元素說(shuō)明元素名稱限長(zhǎng)是否必填默認(rèn)值樣例說(shuō)明ResultCode20是無(wú)0請(qǐng)求接收結(jié)果（0成功，非0失?。㏑esultMsg200是無(wú)單據(jù)不存在請(qǐng)求失敗原因示例：“ResultCode”: 0,“ResultMsg”: “Success”3. 查詢貨品庫(kù)存信息Ø 用途：用于外部系統(tǒng)查詢貨品的庫(kù)存信息(分頁(yè)查詢)Ø 觸發(fā)：外部系統(tǒng)發(fā)送請(qǐng)求Ø 業(yè)務(wù)類型：Method=QueryStorageØ 說(shuō)明：如果不指定Sku_Code則是查

13、詢整個(gè)倉(cāng)庫(kù)的所有貨品庫(kù)存,每頁(yè)大小為固定值50請(qǐng)求元素說(shuō)明元素名稱限長(zhǎng)是否必填默認(rèn)值樣例說(shuō)明WarehouseNO16是無(wú)BJZP倉(cāng)庫(kù)編號(hào)Sku_Code32否無(wú)HP1001貨品的唯一編碼PageNO10否11指定頁(yè)碼，取值為大于1的整數(shù)StartTime20否無(wú)2016-3-30 00:00:01開始時(shí)間EndTime20否無(wú)2016-3-30 23:00:00結(jié)束時(shí)間示例“WarehouseNO”: “BJZP”,“Sku_Code”: “HP1001”返回元素說(shuō)明元素名稱限長(zhǎng)是否必填默認(rèn)值樣例說(shuō)明ResultCode20是無(wú)0請(qǐng)求接收結(jié)果（0成功，非0失敗）ResultMsg200是無(wú)倉(cāng)

14、庫(kù)不存在請(qǐng)求失敗原因TotalCount10是無(wú)1查詢的貨品總數(shù)量WarehouseNO16是無(wú)BJZP倉(cāng)庫(kù)編號(hào)二級(jí)節(jié)點(diǎn) 貨品明細(xì) ItemListSku_Code50是無(wú)HP1001貨品的唯一編碼Qty20是無(wú)10庫(kù)存總量（含占用量）SellCount20是無(wú)2銷售訂購(gòu)量SendCount20是無(wú)5待發(fā)貨量示例：“ResultCode”: 0,“ResultMsg”: “”,“TotalCount”:1,“WarehouseNO”: “BJZP”,“ItemList”:“Item”:“Sku_Code”: “HP1001”,“Qty”: 10,“SellCount”: 2,“SendCoun

15、t”: 54. 訂單發(fā)貨物流信息推送接口Ø 用途：ERP定時(shí)向外部系統(tǒng)推送訂單發(fā)貨的物流信息Ø 觸發(fā)：ERP主動(dòng)發(fā)起Ø 業(yè)務(wù)類型：Method = LogisticsReturnØ 注意：ERP是分批回傳的，一次最多回傳50條訂單信息請(qǐng)求元素說(shuō)明元素名稱限長(zhǎng)是否必填樣例說(shuō)明Post參數(shù)Method20是LogisticsReturn業(yè)務(wù)類型SellerID32是MaijiaERP分配的賣家?guī)ぬ?hào)Sign32是見接口規(guī)范說(shuō)明簽名驗(yàn)證Content是見json元素示例內(nèi)容為JSON格式的庫(kù)存信息JSON元素OrderCode32是OR2013010101外部系

16、統(tǒng)訂單編號(hào)TradeNO32是JY201301010001ERP內(nèi)訂單編號(hào)ErpLogisticCode20是EMS物流公司編碼LogisticName50是EMS物流公司名稱PostID30是3273832728物流單號(hào)SndTime20是2001-01-01 10:0:0發(fā)貨時(shí)間示例Method=LogisticsReturn&SellerID=maijia&Sign=YUPljoslfoPO2KJL&Content=“TradeList”:“Trade”:“OrderCode”:”O(jiān)R2013010101”,“TradeNO”:”JY201301010001”,“

17、ErpLogisticCode”: “SF”,“LogisticName”: “順豐速運(yùn)”,“PostID”: “3273832728”,“SndTime”:”2001-01-01 10:00:00”,“OrderCode”:”O(jiān)R2013010102”,“TradeNO”:”JY201301010002”,“ErpLogisticCode”: “EMS”,“LogisticName”: “EMS”,“PostID”: “3273832729”,“SndTime”:”2001-01-01 10:00:00”返回元素說(shuō)明元素名稱限長(zhǎng)是否必填默認(rèn)值樣例說(shuō)明ResultListResultCode2

18、0是無(wú)0請(qǐng)求結(jié)果（0成功，非0失?。㏑esultMsg200是無(wú)簽名驗(yàn)證失敗請(qǐng)求失敗原因結(jié)果列表-ResultIF_OrderCode16是OR2013010101外部系統(tǒng)訂單編號(hào)OrderCodeResultCode20是無(wú)0請(qǐng)求接收結(jié)果（0成功，非0失敗）ResultMsg是 系統(tǒng)異常請(qǐng)求失敗原因示例“ResultList”:“ResultCode”:0,“ResultMsg”:”,“Result”:“IF_OrderCode”:”O(jiān)R2013010101”,“ResultCode”:”0”,“ResultMsg”: “success”,“IF_OrderCode”:”O(jiān)R20130101

19、02”,“ResultCode”:”1”,“ResultMsg”: “單據(jù)不存在”5. 庫(kù)存同步接口Ø 用途：外部系統(tǒng)同步更新ERP內(nèi)的貨品庫(kù)存信息Ø 觸發(fā)：外部系統(tǒng)發(fā)送請(qǐng)求Ø 業(yè)務(wù)類型：Method = SyncStorageØ 說(shuō)明： ERP內(nèi)的庫(kù)存就由外部系統(tǒng)來(lái)維護(hù)請(qǐng)求元素說(shuō)明元素名稱限長(zhǎng)是否必填默認(rèn)值樣例說(shuō)明WarehouseNO16是無(wú)BJZP倉(cāng)庫(kù)編號(hào)Sku_Code32是無(wú)HP001貨品商家編碼Outer_Code32否無(wú)2001外部編碼(如果Sku_Code為空,則這個(gè)編碼不可為空,二者只能選其一來(lái)對(duì)應(yīng)商品,都填的話以Sku_Code為準(zhǔn))

20、Qty20是無(wú)10需要同步的數(shù)量示例“WarehouseNO”: “BJZP”,“Sku_Code”: “HP1001”,“Outer_Code”:2001,“Qty”:1返回元素說(shuō)明元素名稱限長(zhǎng)是否必填默認(rèn)值樣例說(shuō)明ResultCode20是無(wú)0請(qǐng)求接收結(jié)果（0成功，非0失敗）ResultMsg200是無(wú)倉(cāng)庫(kù)不存在請(qǐng)求失敗原因示例：“ResultCode”: 0,“ResultMsg”: “Success”6. 查詢訂單接口（根據(jù)訂單編號(hào)）Ø 用途：外部系統(tǒng)請(qǐng)求查詢ERP內(nèi)訂單信息Ø 觸發(fā)：外部系統(tǒng)發(fā)送請(qǐng)求Ø 業(yè)務(wù)類型：Method = QueryTradeBy

21、NOØ 說(shuō)明： 訂單編號(hào)為ERP內(nèi)訂單編號(hào)請(qǐng)求元素說(shuō)明元素名稱限長(zhǎng)是否必填默認(rèn)值樣例說(shuō)明OrderCode32是無(wú)JY2001010133ERP內(nèi)單據(jù)編號(hào)示例“OrderCode”: “JY2001010133”返回元素說(shuō)明元素名稱限長(zhǎng)必填項(xiàng)默認(rèn)值樣例說(shuō)明ResultCode20是無(wú)0請(qǐng)求接收結(jié)果（0成功，非0失?。㏑esultMsg200是無(wú)單據(jù)不存在請(qǐng)求失敗原因TradeNO50是無(wú)JY2001010133ERP內(nèi)訂單編號(hào)TradeNO22048是無(wú)1000235421來(lái)源單號(hào)WarehouseNO32是無(wú)BJZP倉(cāng)庫(kù)編號(hào)RegTime20是無(wú)2001-01-01 0:0:0訂單

22、創(chuàng)建時(shí)間TradeTime20是無(wú)2001-01-01 0:0:0交易時(shí)間PayTime20是無(wú)2001-01-01 0:0:0付款時(shí)間ChkTime20是無(wú)2001-01-01 0:0:0審單時(shí)間StockOutTime20是無(wú)2001-01-01 0:0:0出庫(kù)時(shí)間SndTime20是無(wú)2001-01-01 0:0:0發(fā)貨時(shí)間LastModifyTime20是無(wú)2001-01-01 0:0:0最后修改時(shí)間TradeStatus50是無(wú)1訂單狀態(tài)(已取消cancel_trade)(預(yù)訂單pre_trade)(待審核check_trade)(待財(cái)審finance_trade)待發(fā)貨wait_s

23、end_trade(已完成 over_trade)RefundStatus50是無(wú)0退款狀態(tài)(未退款trade_no_refund(等待客服確認(rèn)trade_wait_seller_agree)(訂單部分商品已退款，請(qǐng)與客服確認(rèn)trade_part_refunded)(訂單已退款trade_refundedbInvoice1是無(wú)1是否需要發(fā)票InvoiceTitle200是無(wú)個(gè)人發(fā)票抬頭InvoiceContent200是無(wú)發(fā)票內(nèi)容NickName50是無(wú)奇峰谷客戶網(wǎng)名SndTo50是無(wú)張三收件人姓名Country50是無(wú)中國(guó)收件人國(guó)家Province50是無(wú)北京收件人省份City50是無(wú)北京收

24、件人城市Town50是無(wú)海淀收件人區(qū)縣Adr500是無(wú)北京海淀收件人地址Tel20是無(wú)12321收件人電話Zip20是無(wú)10010收件人郵編ChargeType1是無(wú)0付款方式(1擔(dān)保交易)(2 銀行收款)(3現(xiàn)金收款)(4貨到付款)(5欠款記應(yīng)收)(6客戶預(yù)存款)SellSkuCount20是無(wú)1貨品數(shù)量GoodsTotal20是無(wú)4000貨品總額PostageTotal20是無(wú)20應(yīng)收郵費(fèi)FavourableTotal20是無(wú)200訂單總優(yōu)惠AllTotal20是無(wú)3820應(yīng)收金額LogisticsCode20是無(wú)EMS物流公司編碼PostID50是無(wú)125632441貨運(yùn)單號(hào)Custom

25、erRemark2048是無(wú)送點(diǎn)贈(zèng)品買家留言Remark2048是無(wú)早點(diǎn)發(fā)賣家備注ShopType10是無(wú)淘寶平臺(tái)店鋪類型ShopName200是無(wú)旗艦店平臺(tái)店鋪名稱TradeFlag200是無(wú)急需發(fā)貨ERP訂單標(biāo)記名稱ChkOperatorName50是無(wú)客服1號(hào)審單員名稱二級(jí)節(jié)點(diǎn) -貨品明細(xì)信息 DetailListSkuCode50是無(wú)HP1001ERP內(nèi)Sku唯一標(biāo)識(shí)即商家編碼SkuName350否無(wú)洗衣機(jī)貨品Sku名稱PlatformGoodsCode50是無(wú)1008平臺(tái)貨品編號(hào)PlatformGoodsName200是無(wú)洗衣機(jī)平臺(tái)貨品名稱PlatformSkuCode50是無(wú)100

26、841平臺(tái)Sku編碼PlatformSkuName200否無(wú)全自動(dòng)平臺(tái)Sku名稱SellCount20是無(wú)1賣出數(shù)量SellPrice20是無(wú)4000賣出價(jià)格DiscountMoney20是無(wú)200貨品優(yōu)惠金額bGift1是無(wú)1是否贈(zèng)品，是為1，否為0示例：“ResultCode”: 0,“ResultMsg”: “Success”,“TradeNO”: “JY2001010133”,“TradeNO2“: “1000235421”,“RegTime“: “2001-01-01 0:0:0”,“TradeTime“: “2001-01-01 0:0:0”,“PayTime“: “2001-01

27、-01 0:0:0”,“ChkTime“: “2001-01-01 0:0:0”,“StockOutTime“: “2001-01-01 0:0:0”,“SndTime“: “2001-01-01 0:0:0”,“LastModifyTime”:”2001-01-01 12:00:00”,“TradeStatus“: “check_trade”,“RefundStatus“: “trade_no_refund”,“bInvoice“: “1”,“InvoiceTitle“: “個(gè)人”,“InvoiceContent“: “NickName“: “奇峰谷”,“SndTo“: “張三”,“Coun

28、try”:”中國(guó)”,“Province”:”北京”,“City”:”北京”,“Town”:”海淀”,“Adr“: “北京海淀”,“Tel“: ,“Zip“10010”,“ChargeType“: “0”,“SellSkuCount“: “1”,“GoodsTotal“: “4000”,“PostageTotal“: “20”,“FavourableTotal“: “200”,“AllTotal“: “3820”,“LogisticsCode“: “EMS”,“PostID“: “123654263”,“CustomerRemark“: “送點(diǎn)贈(zèng)品”,“Remark“:

29、 “早點(diǎn)發(fā)”,“ShopType”:淘寶,“ShopName”:”旗艦店”,“TradeFlag”:”急需發(fā)貨”,“ChkOperatorName”:”,“DetailList“: “Detail”“SkuCode“: “HP1001”,“SkuName“: “全自動(dòng)洗衣機(jī)”,“PlatformGoodsCode”:”1008”,“PlatformGoodsName”:”洗衣機(jī)”,“PlatformSkuCode“: “100841”,“PlatformSkuName“: “全自動(dòng)”,“SellCount“: “1”,“SellPrice“: “4000”,“DiscountMoney“: “

30、200”,“bGift“: “0”7. 查詢訂單接口（根據(jù)訂單修改時(shí)間）Ø 用途：外部系統(tǒng)請(qǐng)求查詢ERP內(nèi)訂單信息Ø 觸發(fā)：外部系統(tǒng)發(fā)送請(qǐng)求Ø 業(yè)務(wù)類型：Method = QueryTradeByMTimeØ 注意：起止時(shí)間跨度最大1小時(shí)，并且是最近30天內(nèi)的訂單信息，按照修改時(shí)間查找結(jié)束時(shí)間不能超過(guò)當(dāng)前接口服務(wù)器當(dāng)前時(shí)間，開始時(shí)間不能大于結(jié)束時(shí)間。Ø 說(shuō)明： 根據(jù)修改時(shí)間分頁(yè)查詢訂單，每頁(yè)的條數(shù)最大為40，超出40系統(tǒng)會(huì)默認(rèn)為40進(jìn)行處理，可以根據(jù)返回的TotalCount來(lái)計(jì)算下次請(qǐng)求要設(shè)置的頁(yè)碼。訂單查詢接口優(yōu)化建議及注意事項(xiàng) 

31、一 最后修改時(shí)間 - 訂單的任何字段發(fā)生變化 最后修改時(shí)間都會(huì)隨著變化 二 訂單重復(fù)查詢到 - 因?yàn)槭亲詈笮薷臅r(shí)間，訂單可能會(huì)重復(fù)獲得，如果想盡量少的重復(fù)獲得可以注意盡量少的反復(fù)修改訂單 三 分頁(yè) 從最后一頁(yè)開始查詢，第一次查詢 可以 PageNO = 0 PageSize = 1 獲得 總記錄數(shù)，具體數(shù)據(jù)不處理只獲得總記錄數(shù)，然后開始從最后一頁(yè)開始分頁(yè)獲取           - 建議使用增量查詢，每隔一段時(shí)間查詢一次，下一次查詢的開始時(shí)間使用上一次的結(jié)束時(shí)間，這樣每次獲得的單量較少

32、，重復(fù)的單量也會(huì)比較少只是那些單據(jù)信息有過(guò)修改過(guò)的才會(huì)重復(fù)獲得四 訂單退款、申請(qǐng)退款、發(fā)生攔截出庫(kù) 這些理論上來(lái)說(shuō)都是不滿足發(fā)貨的，需要注意做相應(yīng)的處理 訂單攔截的問(wèn)題分析及解決方案： 抓取訂單信息之后，遇到以下情況：     # 平臺(tái)上(淘寶京東等)買家退款賣家還同意了退款，這個(gè)時(shí)候倉(cāng)庫(kù)并不知道，按照流程發(fā)貨了，導(dǎo)致貨品發(fā)貨款也退了的情況(賣家很可能貨款都沒(méi)了)     # 賣家駁回訂單對(duì)訂單進(jìn)行修改而后又審核過(guò)去了，如果倉(cāng)庫(kù)那邊沒(méi)有更新或來(lái)不及更新、按流程發(fā)貨了，可能導(dǎo)致發(fā)錯(cuò)貨的情況或者不滿

33、足買家的要求     # 平臺(tái)上(淘寶京東等)買家修改了訂單信息，賣家還沒(méi)有來(lái)得及處理訂單時(shí)倉(cāng)庫(kù)已經(jīng)按照流程發(fā)貨了，可能導(dǎo)致發(fā)錯(cuò)貨的情況。     # 賣家手動(dòng)取消了訂單，倉(cāng)庫(kù)并不知道，按流程發(fā)貨了，導(dǎo)致多發(fā)的現(xiàn)象。 解決方案(建議)：     1.倉(cāng)庫(kù)那邊發(fā)貨回傳失敗了，包裹就不發(fā)貨，倉(cāng)庫(kù)對(duì)于訂單重復(fù)獲得做對(duì)應(yīng)的修改，重復(fù)獲取訂單后發(fā)現(xiàn)退款等攔截出庫(kù)的就攔截發(fā)貨，及時(shí)與賣家溝通。     2.如果是先發(fā)貨后同步到旺店通ERP

34、 則需要提前攔截訂單發(fā)貨         A. 需要抓取狀態(tài)為已取消（ TradeStatus 為 0 ）的訂單，抓取到之后如果在倉(cāng)庫(kù)系統(tǒng)里存在則需要在倉(cāng)庫(kù)系統(tǒng)里取消。         B. 需要抓取狀態(tài)為待審核和待財(cái)審（  TradeStatus 2），如果在倉(cāng)庫(kù)系統(tǒng)里存在，則需要攔截。         C. 抓取狀態(tài)為已審核（ Tra

35、deStatus 5）的訂單，如果訂單在倉(cāng)庫(kù)系統(tǒng)里存在，則需要檢查貨品數(shù)量和貨品種類、收件人地址、姓名、聯(lián)系方式，物流，倉(cāng)庫(kù)是否有變化，有變化，需要把新的訂單信息更新到倉(cāng)庫(kù)系統(tǒng)里去。 請(qǐng)求元素說(shuō)明元素名稱限長(zhǎng)是否必填默認(rèn)值樣例說(shuō)明StartTime20是無(wú)2001-01-01 12:00:00查詢修改時(shí)間滿足的起始時(shí)間EndTime20是無(wú)2001-01-02 12:00:00查詢修改時(shí)間滿足的中止時(shí)間TradeStatus50是無(wú)check_trade訂單狀態(tài)(已取消cancel_trade)(預(yù)訂單pre_trade)(待審核check_trade)(待財(cái)審financ

36、e_trade)(待發(fā)貨wait_send_trade)(待打印物流單wait_print_logistics)(已完成 over_trade)(委外訂單 out_send)PageNO10否11頁(yè)碼，取值范圍：大于0的整數(shù)PageSize10否4010每頁(yè)條數(shù)，取值范圍140示例“StartTime”: “2001-01-01 12:00:00”,“EndTime”: “2001-01-02 12:00:00”,“TradeStatus”:”check_trade”,“PageNO”:1,“PageSize”:40返回元素說(shuō)明元素名稱限長(zhǎng)必填項(xiàng)默認(rèn)值樣例說(shuō)明ResultCode20是無(wú)0請(qǐng)求

37、接收結(jié)果（0成功，非0失?。㏑esultMsg200是無(wú)單據(jù)不存在請(qǐng)求失敗原因TotalCount20是無(wú)1查詢到的單據(jù)數(shù)二級(jí)節(jié)點(diǎn) -訂單信息 TradeListTradeNO50是無(wú)JY2001010133ERP內(nèi)訂單編號(hào)TradeNO22048是無(wú)1000235421來(lái)源單號(hào)WarehouseNO32是無(wú)BJZP倉(cāng)庫(kù)編號(hào)RegTime20是無(wú)2001-01-01 0:0:0訂單創(chuàng)建時(shí)間TradeTime20是無(wú)2001-01-01 0:0:0交易時(shí)間PayTime20是無(wú)2001-01-01 0:0:0付款時(shí)間ChkTime20是無(wú)2001-01-01 0:0:0審單時(shí)間StockOutT

38、ime20是無(wú)2001-01-01 0:0:0出庫(kù)時(shí)間SndTime20是無(wú)2001-01-01 0:0:0發(fā)貨時(shí)間LastModifyTime20是無(wú)2001-01-01 0:0:0最后修改時(shí)間TradeStatus50是無(wú)1訂單狀態(tài)(已取消cancel_trade)(預(yù)訂單pre_trade)(待審核check_trade)(待財(cái)審finance_trade)待發(fā)貨wait_send_trade(已完成 over_trade)RefundStatus50是無(wú)trade_no_refund退款狀態(tài)(未退款trade_no_refund(等待客服確認(rèn)trade_wait_seller_agre

39、e)(訂單部分商品已退款，請(qǐng)與客服確認(rèn)trade_part_refunded)(訂單已退款trade_refundedbInvoice1是無(wú)1是否需要發(fā)票InvoiceTitle200是無(wú)個(gè)人發(fā)票抬頭InvoiceContent200是無(wú)發(fā)票內(nèi)容NickName50是無(wú)奇峰谷客戶網(wǎng)名SndTo50是無(wú)張三收件人姓名Country50是無(wú)中國(guó)收件人國(guó)家Province50是無(wú)北京收件人省份City50是無(wú)北京收件人城市Town50是無(wú)海淀收件人區(qū)縣Adr500是無(wú)北京海淀收件人地址Tel30是無(wú)12321收件人電話(如果顧客填寫了手機(jī)和固話,則用空格隔開)Zip20是無(wú)10010收件人郵編Cha

40、rgeType1是無(wú)0付款方式(1擔(dān)保交易)(2 銀行收款)(3現(xiàn)金收款)(4貨到付款)(5欠款記應(yīng)收)(6客戶預(yù)存款)SellSkuCount20是無(wú)1貨品數(shù)量GoodsTotal20是無(wú)4000貨品總額PostageTotal20是無(wú)20應(yīng)收郵費(fèi)FavourableTotal20是無(wú)200訂單總優(yōu)惠AllTotal20是無(wú)3820應(yīng)收金額LogisticsID11是無(wú)無(wú)物流公司idLogisticsName20是無(wú)無(wú)物流公司名稱LogisticsCode20是無(wú)EMS物流公司編碼PostID50是無(wú)125632441貨運(yùn)單號(hào)CustomerRemark2048是無(wú)送點(diǎn)贈(zèng)品買家留言Remar

41、k2048是無(wú)早點(diǎn)發(fā)賣家備注ShopType10是無(wú)淘寶平臺(tái)店鋪類型ShopName200是無(wú)旗艦店平臺(tái)店鋪名稱TradeFlag200是無(wú)急需發(fā)貨ERP中的訂單標(biāo)記名稱ChkOperatorName50是無(wú)客服1號(hào)審單員名稱三級(jí)節(jié)點(diǎn) -貨品明細(xì)信息 DetailListSkuCode50是無(wú)HP1001ERP內(nèi)Sku唯一標(biāo)識(shí)即商家編碼SkuName350否無(wú)全自動(dòng)洗衣機(jī)貨品Sku名稱PlatformGoodsCode50是無(wú)1008平臺(tái)貨品編號(hào)PlatformGoodsName200是無(wú)洗衣機(jī)平臺(tái)貨品名稱PlatformSkuCode50是無(wú)100841平臺(tái)Sku編碼PlatformSkuN

42、ame200否無(wú)全自動(dòng)平臺(tái)Sku名稱SellCount20是無(wú)1賣出數(shù)量SellPrice20是無(wú)4000商品零售價(jià)DiscountMoney20是無(wú)200貨品優(yōu)惠金額bGift1是無(wú)1是否贈(zèng)品，是為1，否為0示例：“ResultCode”: 0,“ResultMsg”: “Success”,“TotalCount”:1,“TradeList”:“Trade”:“TradeNO”: “JY2001010133”,“TradeNO2“: “1000235421”,“WarehouseNO”:”BJZP”,“RegTime“: “2001-01-01 0:0:0”,“TradeTime“: “20

43、01-01-01 0:0:0”,“PayTime“: “2001-01-01 0:0:0”,“ChkTime“: “2001-01-01 0:0:0”,“StockOutTime“: “2001-01-01 0:0:0”,“SndTime“: “2001-01-01 0:0:0”,“LastModifyTime”:”2001-01-01 12:00:00”,“TradeStatus“: “check_trade”,“RefundStatus“: “trade_no_refund”,“bInvoice“: “1”,“InvoiceTitle“: “個(gè)人”,“InvoiceContent“: “N

44、ickName“: “奇峰谷”,“SndTo“: “張三”,“Country”:”中國(guó)”,“Province”:”北京”,“City”:”北京”,“Town”:”海淀”,“Adr“: “北京海淀”,“Tel“: ,“Zip“10010”,“ChargeType“: “0”,“SellSkuCount“: “1”,“GoodsTotal“: “4000”,“PostageTotal“: “20”,“FavourableTotal“: “200”,“AllTotal“: “3820”,“LogisticsCode“: “EMS”,“PostID“: “123654263”

45、,“CustomerRemark“: “送點(diǎn)贈(zèng)品”,“Remark“: “早點(diǎn)發(fā)”,“ShopType”:淘寶,“ShopName”:”旗艦店”,“TradeFlag”:”急需發(fā)貨”,“ChkOperatorName”:”,“DetailList“: “Detail”“SkuCode“: “HP1001”,“SkuName“: “全自動(dòng)洗衣機(jī)”,“PlatformGoodsCode”:”1008”,“PlatformGoodsName”:”洗衣機(jī)”,“PlatformSkuCode“: “100841”,“PlatformSkuName“: “全自動(dòng)”,“SellCount“: “1”,“Se

46、llPrice“: “4000”,“DiscountMoney“: “200”,“bGift“: “0”8. 訂單物流同步接口Ø 用途：外部系統(tǒng)同步更新ERP內(nèi)的訂單的物流信息Ø 觸發(fā)：外部系統(tǒng)發(fā)送請(qǐng)求Ø 業(yè)務(wù)類型：Method = SyncLogistics說(shuō)明： 淘寶只支持自己聯(lián)系物流(線下發(fā)貨) 發(fā)貨方式。更新完物流信息之后ERP會(huì)把物流信息同步到平臺(tái)上去。LogisticsCode是物流方式的編碼，這個(gè)要跟ERP中相對(duì)應(yīng)才能同步成功請(qǐng)求元素說(shuō)明元素名稱限長(zhǎng)是否必填默認(rèn)值樣例說(shuō)明TradeCode32是無(wú)JY2001010133ERP訂單編號(hào)Logistic

47、sCode32是無(wú)EMS物流方式編碼LogisticsNumber20是無(wú)12334567890物流單號(hào)Type1否01操作類型:默認(rèn)值為0(0,只同步發(fā)貨信息不扣減庫(kù)存)(1,同步發(fā)貨信息并扣減庫(kù)存)示例“TradeCode”: “JY2001010133”,“LogisticsCode”: “EMS”,“LogisticsNumber”:”1234567890”,“Type”:1返回元素說(shuō)明元素名稱限長(zhǎng)是否必填默認(rèn)值樣例說(shuō)明ResultCode20是無(wú)0請(qǐng)求接收結(jié)果（0成功，非0失?。㏑esultMsg200是無(wú)訂單不存在請(qǐng)求失敗原因示例：“ResultCode”: 0,“ResultMs

48、g”: “Success”9. 貨品信息同步接口Ø 用途：外部接口同步貨品信息到ERPØ 觸發(fā)：外部接口發(fā)送請(qǐng)求Ø 業(yè)務(wù)類型：Method = SyncGoodsØ 注意：如果貨品是多規(guī)格的，需要在SkuList里列出所有規(guī)格，如果貨品是單規(guī)格的，則SkuList可以省略。 此接口是同步接口，如果貨品存在的話會(huì)更新貨品信息，如果不存在則是新建。但需要保證GoodsNO和SkuCode對(duì)應(yīng)請(qǐng)求元素說(shuō)明元素名稱限長(zhǎng)是否必填默認(rèn)值樣例說(shuō)明貨品列表-GoodsListGoodsNO20是無(wú)HP1001貨品編號(hào)GoodsName32是無(wú)電腦貨品名稱Weight32否0.02.4重量（kg）Price10否0.03200.0單價(jià)（元）Barcode32否無(wú)HP1001條碼（單規(guī)格時(shí)填寫）Sku列表- SkuListSkuCode50是無(wú)HP