旺店通ERPapi_V1_9_1最新版

1、旺店通 ERP 接口文檔V1.9.1北京掌上先機網(wǎng)絡(luò)科技有限公司研發(fā)部目錄一、概述 2二、接口規(guī)范說明 2接口方式： 2接口數(shù)據(jù)傳輸類型： 2格式： 2三、接口描述 21. 創(chuàng)建單據(jù)接口 22. 取消單據(jù)接口 33. 查詢貨品庫存信息 34. 訂單發(fā)貨物流信息推送接口 45. 庫存同步接口 46. 查詢訂單接口（根據(jù)訂單編號） 57. 查詢訂單接口（根據(jù)訂單修改時間） 68. 訂單物流同步接口 99. 貨品信息同步接口 910. 查詢詳細出庫單接口 911. 查詢詳細入庫單接口 錯誤 !未定義書簽。12. 查詢 ERP 貨品信息 錯誤 !未定義書簽。13. 查詢 ERP 采購單信息 錯誤 !未

2、定義書簽。一、概述交文格式外業(yè)務(wù)流軟件對接旺檔用于描述旺店供解決方案系規(guī)范外部管理軟件跟行數(shù)據(jù)交互的R 口對接的數(shù)據(jù)二、接口規(guī)范說明接口方式：REST - HTTP POST （數(shù)據(jù)要放到 post 的 data 里面）接口數(shù)據(jù)傳輸類型：JSON格式：ERP給外部接口的授果均e采用 jsn三、接口描述1.創(chuàng)建單據(jù)接口元請求用發(fā)說外部系統(tǒng)發(fā)起店求ew是否必下發(fā)業(yè)務(wù)單據(jù)。樣例P根據(jù)下發(fā)的單據(jù)在系統(tǒng)內(nèi)創(chuàng)建相應(yīng)的業(yè)務(wù)單一級節(jié)點-單據(jù)信息I a、OutlnFlaglnt(1)是無1出銷庫類型標記（2采購入庫入IF OrderCode32是無OR2013010101外部單據(jù)編號WarehouseNO16是

3、無BJZP倉庫編號（銷售出庫時非空）Remark500否無需緊急處理備注TheCause50否無采購入庫出入庫原因ProviderNO50否無GYS001供應(yīng)商編號ProviderName200否無北京供應(yīng)商供應(yīng)商名稱linkMan50否無張三1 八丿一 1 IJ a1 牛屮供應(yīng)商聯(lián)系人L inkManTel20否無聯(lián)系人電話linkManAdr300否無北京聯(lián)系人地址RegOperatorNO20口否X U 無-1 YW001業(yè)務(wù)員編號GoodsTotal是無4000 00貨款合計（銷售出庫時非空 ）vavoiEaweiiotaiDeCifflal0彳 HWuu優(yōu)款合計（銷售出丿牛時非空丿O

4、fnerFee19&品0(否無1nn* 00其他費用Cod FlaaIn t(1)否00到到付款標i為需要貨不需要貨OrderPay111 / Decimall否無4010 00到付力款少11丿J*丿為需要貨到付款界 牛單非空傘額（含運費）（出Vyi M1 1cryLogisticsPay19,4)iDe4mal(否yts無10 00A牛時,円非空 曰 /以 ） 屮運費（出庫時非空）loaisticsCode20否無EMS物流公司編號ShopName厶o100口否無測試店鋪訂單肝屬店鋪名稱（出庫時Micl/Alcma501=1否無這早一個網(wǎng)名叫”空）| 力t 丿 J ”| |11 t j丿 1

5、 114客戶平臺昵稱1 x 1 v/Fvl 弋 d 1 1 UBuyerName50口否無尼丄人1 V J/小明J曰丿 1 口 1兒丿1小收貨人姓名（出牛時非空）B uyerPostCode611否無J叨456789*人7工1 口 ULJ / 1 1 1 J | 工* ）收貨人郵編（出庫時非空）L-*Ll JF V# 1 1VrB uyerTelD20n否7T3無AJAl. 7 V WP-/|ln I JJL丿干口 J T 尸丿收貨人聯(lián)系方式uuy DI 1 DIDi 11 fZVjfD* r cc-J20口否匕無北京收貨人所在省（出牛非空）Buyeiiiovince202011否3無無北京北

6、京收貨人所在?。ǔ雠７强肇?收貨人所在市（屮庫非空）ouywi ouy二 Uon否木無無海淀區(qū)收貨丿人所在11（出牛非空丿1貨人冃所在區(qū)曰（出牛斗非BuyeDistict20否無海淀區(qū)收貝人所在區(qū)、縣（出丿牛非BuverFmail50否無收貨人 emaillJ MI1Needl nvoiceIn t否01需要需要發(fā)票，1需要，0不InvoiceTitle100否.無收款公司發(fā)票抬頭InvoiceContent500否無電腦*1發(fā)票內(nèi)容ItemCou ntIn t(11)否無1貨品詳細的行項冃數(shù)量PavTime否無付款時間TradeTime否無交易時間ChargelD否無支付單號一級節(jié)點-貨品明

7、細ffl ItemlistSku Code 50 是 無 HP1001 貨品的唯一編碼Sku Name350否無電腦貨品名稱Sku PriceDe4)mal(否0 004000 00貨品單價DiscountDe4)mal(否0 000 Q扌斤扌nTotalDe4mal(否0 003600 00申品金額小計QtyDe4mal(是無1貨品數(shù)量Item Remark119,4) I1024否X U 無打扌斤處卜壬甲行項冃備注11 H 11 1 1 Cl 1 iv5J J J 八吐1 jo m示 例；wujoaoesBe：m“om”mxLnu卽“電打”處理”否必填認墜樣例驗證失敗二說明成收旺店 回失

8、敗功因據(jù)編號失?。〩P1002不存在2.取消單據(jù)接口元請求說途說外處系請求時會判斷必據(jù)是否是可取消則狀例態(tài)，如果是不可取消則失敗OrderCodeOrderTypeReason32200JY2001010133ERP內(nèi)單據(jù)編號顧客不要了單據(jù)類型（1是訂單,2采購單） 取消原因LogResultCodeResultMsg20200默認值樣例0單據(jù)不存在說明請求接收結(jié)果（0成功，非0失?。┱埱笫≡蚝灁r截是否如果簽出則無法取消Mo“例sultCoge:： CSUccess”3.查詢貨品庫存信息元請求說途說型果外指系送查求否必填庫存信息值整個M樣例的查詢有貨品庫存明，母頁大小為固定值50Wareh

9、ouseNO16是無BJZP倉庫編號Sku Code32否y u無HP1001L Li / r 回料 I/O1008平臺貨品編號FNOtfoemGood200是無洗衣機111H H 卩 IJ平臺貨品名稱PdatformSkuC50-7是無1008411曰曰TT-平臺Sku編碼PlateormSkuN200否yu無1 1仝自動r 11 OrkU IU H J平臺Sku名稱SellCou nt20P是無1賣出數(shù)量SellPrice20丿匸是.無4000t-l-l屮-賣出價格20/匸是無200tn V 1 1 M貨品優(yōu)惠仝額eyscouniMion bGfft201是無無2001貝品優(yōu)惠金額是否贈品

10、是為 1 否為0ZzTrf 亠y u/1 1 口 H H /丿 J1 ：1 / JM”un”：oo ”,品”7.?查詢訂單接口（根據(jù)訂單修改時間）觸以根起返系的口求查器頁查詢來計B并的。單信息,4按照修會默認查找結(jié)束進行處理,訂單查詢接口優(yōu)化建議及注意事項最后修改時間-訂單的任何字段發(fā)生變化最后修改時間都會隨著變化訂單重復(fù)查詢到-因為是最后修改時間，訂單可能會重復(fù)獲得，如果想盡量少的重復(fù)獲得可以注意盡量少的反復(fù)修改訂單三 分頁 從最后一頁開始查詢，第一次查詢可以PageNO = 0 PageSize = 1獲得 總記錄數(shù)，具體數(shù)據(jù)不處理只獲得總記錄數(shù)，然后開始從最后一頁開始分頁獲取-建議使用增

11、量查詢，每隔一段時間查詢一次，下一次查詢的開始時間使用上一次的結(jié)束時間， 這樣每次獲得的單量較少，重復(fù)的單量也會比較少只是那些單據(jù)信息有過修改過的才會重復(fù)獲得 四訂單退款、申請退款、發(fā)生攔截出庫這些理論上來說都是不滿足發(fā)貨的，需要注意做相應(yīng)的處理訂單攔截的問題分析及解決方案:抓取訂單信息之后，遇到以下情況：#平臺上（淘寶京東等）買家退款賣家還同意了退款，這個時候倉庫并不知道，按照流程發(fā)貨了,導致貨品發(fā)貨款也退了的情況（賣家很可能貨款都沒了 ）#賣家駁回訂單對訂單進行修改而后又審核過去了，如果倉庫那邊沒有更新或來不及更新、按流程發(fā)貨了，可能導致發(fā)錯貨的情況或者不滿足買家的要求#平臺上（淘寶京東等

12、）買家修改了訂單信息，賣家還沒有來得及處理訂單時倉庫已經(jīng)按照流程發(fā) 貨了，可能導致發(fā)錯貨的情況。#賣家手動取消了訂單，倉庫并不知道，按流程發(fā)貨了，導致多發(fā)的現(xiàn)象。元解決方案（建議）:1倉庫那邊發(fā)貨回傳失敗了，包裹就不發(fā)貨，倉庫對于訂單重復(fù)獲得做對應(yīng)的修改，重復(fù)獲取訂單 后發(fā)現(xiàn)退款等攔截出庫的就攔截發(fā)貨，及時與賣家溝通。2如果是先發(fā)貨后同步到旺店通ERP則需要提前攔截訂單發(fā)貨A. 需要抓取狀態(tài)為已取消（TradeStatus為0 ）的訂單，抓取到之后如果在倉庫系統(tǒng)里存在則需要在倉庫系統(tǒng)里取消。B. 需要抓取狀態(tài)為待審核和待財審（C. 抓取狀態(tài)為已審核（ TradeStatus 5） 數(shù)量和貨品種

13、類、收件人地址、姓名、聯(lián)系方式， 素求稱新到倉庫系統(tǒng)里去。TradeStatus 2）,如果在倉庫系統(tǒng)里存在，則需要攔截。 的訂單，如果訂單在倉庫系統(tǒng)里存在，則需要檢查貨品 物流，倉庫是否有變化，有變化，需要把新的訂單StartTime20En dTimeTradeStatusPageNOPageSize20501010是否必填默認值樣例說明是.是無.無40200M0t012Q(m(0t02check_trade1一10查詢修改時間滿足的起始時間查詢修改時間滿足的中止時間（已財訂單流單_eW_pde）_logistics）頁碼，取值范圍：大于0的整數(shù)每頁條數(shù)，取值范圍 140ResultCod

14、e20是無0敗求接收結(jié)果（0成功非0失ResultMsg200是無單據(jù)不存在z V*-，J/、* 丿少 7 丿 J：11*/、請求失敗原因TotalCount20是無查詢到的單據(jù)數(shù),一級節(jié)占-訂單信息TradelistTr*aNIC M IVOnCMCMn 匚QD 夬彳苗幺點縣TradeNC22048是丿J無1000235421t=-m=1 Q|IU J來源單號W/arehouseNC32是無RJZp1 * V倉庫編號V vai DI IUUDD1 N vyRegTime20是無2001-01-01 0：0：0訂單創(chuàng)建時間TradeTime20是無2001-01-01 0-0-01 LU JJ

15、 |交易時間PayTime20是無2001 01 01 0-0-0付款時間-廠 uy i ii i idChkTime20是yu無2001-01-01 0-0-01 J 矽口 J 1審單時間StockCutTime20是無2001 01 01 0-0-01 r 1 11J 11 J-出庫時間O LUL/ivk U1 1 II1 IL*Sn dTimeC-J20是無無厶 UU 1 U 1 U 1 MM. KJ2001-01-01 0-0-0出庫時J間 發(fā)貨時間LastModifyTi20是無2001 01 01 0-0-0最后修改時間me uviuuiiy 11TradeStatuswu50是無

16、無jUU 1 U 1 U 1.1最丿口修改時間1 1LU wDofunHQtciti icuu50是無1待已審消態(tài)asesesdiesdetxctUI lUOlcilUo kJQU1早3無無Tl ClUCrTTU 1U1U1IU1退款狀態(tài)退待品請與客眥是否需要發(fā)票Ul 11 onn曰、無無1 人A二| 仃j- j八 l-lx物流公司 id,LogisticsNam20是無無物流公司名稱loll VOI veil I I logisticsCode-J20是無y uEMSf丿b 一 QJ丿口丿1小物流公司編碼PostID50是丿LJ無125632441PU VIL1 J i/HU HV貨運單號C

17、UstomerRem2048是無彳送占贈品買家留言lw 1111 1 vt# 1 nRemarkKJ* 1 O2048是無人1丄八、丿1 口 口口早占發(fā)/、V M-J kA 賣家備注ShopType-J* 1 U10/ J7匕無淘寶平臺店鋪類型,pi lop i ypurv200是無旗艦店平臺店鋪名稱Ol IU|J 11 lOT二 uu200早無無丹艦丿店急需發(fā)貨丨 口丿店于鋪名稱ERP中的訂單標記名稱11 uuc廠ChlmOperatorzuu50-是7無無心、IfiJ ZKJAL客月服1號匚rl中口的訂單標記名稱審單員名稱NamiepDi 015三級節(jié)占 -貨*品明細信言自 Detaill

18、ist1 11 3、1 J/J Qki旦帀UDd HHd匚匚）匚）rh QI/! 褲一后4口日n禺旁術(shù)石H.木-XO無全自動洗衣機I1 J 7FU r P-|/J、/、I1 口JH J貨口 Sku名稱SkUNameC rrr35050否曰亠!無無全曰動洗衣機1008J貨品Sku 名稱、平臺貨品編號5CaJdurmGood50onn1 是H.7無1008平臺貝口仃編號XTZ厶牝口 Q缶sNaamemGoodPilOtformSkuC20050無無洗衣機100841平臺貨品名稱、平 Sku 編ode 15 11uu onn是否無無1 UUOt 1全曰動丨臺編碼J平厶 d 1夕彘PiffleformSkUNSellCount20020否是無無全曰動1平臺Sku名稱賣出數(shù)量.11 x-Z W U 1 IIon曰無1xnnn賣出數(shù)量1SellPrice20是曰、無無4000200商品零售價貨品優(yōu)惠金額eyscounuvion20d1 是曰yo200d口品丿優(yōu)惠金額2曰木IH萌口曰# tA木# tcDGITT1是無1疋否贈曰品，疋為1，否為 0品”TradeCode32是無JY200101