旺店通ERPapi_V1_9_1最新版

1、旺店通 ERP 接口文档V1.9.1北京掌上先机网络科技有限公司研发部目录一、概述 2二、接口规范说明 2接口方式： 2接口数据传输类型： 2格式： 2三、接口描述 21. 创建单据接口 22. 取消单据接口 33. 查询货品库存信息 34. 订单发货物流信息推送接口 45. 库存同步接口 46. 查询订单接口（根据订单编号） 57. 查询订单接口（根据订单修改时间） 68. 订单物流同步接口 99. 货品信息同步接口 910. 查询详细出库单接口 911. 查询详细入库单接口 错误 !未定义书签。12. 查询 ERP 货品信息 错误 !未定义书签。13. 查询 ERP 采购单信息 错误 !未

2、定义书签。一、概述交文格式外业务流软件对接旺档用于描述旺店供解决方案系规范外部管理软件跟行数据交互的R 口对接的数据二、接口规范说明接口方式：REST - HTTP POST （数据要放到 post 的 data 里面）接口数据传输类型：JSON格式：ERP给外部接口的授果均e采用 jsn三、接口描述1.创建单据接口元请求用发说外部系统发起店求ew是否必下发业务单据。样例P根据下发的单据在系统内创建相应的业务单一级节点-单据信息I a、OutlnFlaglnt(1)是无1出销库类型标记（2采购入库入IF OrderCode32是无OR2013010101外部单据编号WarehouseNO16是

3、无BJZP仓库编号（销售出库时非空）Remark500否无需紧急处理备注TheCause50否无采购入库出入库原因ProviderNO50否无GYS001供应商编号ProviderName200否无北京供应商供应商名称linkMan50否无张三1 八丿一 1 IJ a1 牛屮供应商联系人L inkManTel20否无联系人电话linkManAdr300否无北京联系人地址RegOperatorNO20口否X U 无-1 YW001业务员编号GoodsTotal是无4000 00货款合计（销售出库时非空 ）vavoiEaweiiotaiDeCifflal0彳 HWuu优款合计（销售出丿牛时非空丿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否无这早一个网名叫”空）| 力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 尸丿收货人联系方式uuy DI 1 DIDi 11 fZVjfD* r cc-J20口否匕无北京收货人所在省（出牛非空）Buyeiiiovince202011否3无无北京北

6、京收货人所在省（出牛非空丿 收货人所在市（屮库非空）ouywi ouy二 Uon否木无无海淀区收货丿人所在11（出牛非空丿1货人冃所在区曰（出牛斗非BuyeDistict20否无海淀区收贝人所在区、县（出丿牛非BuverFmail50否无收货人 emaillJ MI1Needl nvoiceIn t否01需要需要发票，1需要，0不InvoiceTitle100否.无收款公司发票抬头InvoiceContent500否无电脑*1发票内容ItemCou ntIn t(11)否无1货品详细的行项冃数量PavTime否无付款时间TradeTime否无交易时间ChargelD否无支付单号一级节点-货品明

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货品数量Item Remark119,4) I1024否X U 无打扌斤处卜壬甲行项冃备注11 H 11 1 1 Cl 1 iv5J J J 八吐1 jo m示 例；wujoaoesBe：m“om”mxLnu卽“电打”处理”否必填认坠样例验证失败二说明成收旺店 回失

8、败功因据编号失败）HP1002不存在2.取消单据接口元请求说途说外处系请求时会判断必据是否是可取消则状例态，如果是不可取消则失败OrderCodeOrderTypeReason32200JY2001010133ERP内单据编号顾客不要了单据类型（1是订单,2采购单） 取消原因LogResultCodeResultMsg20200默认值样例0单据不存在说明请求接收结果（0成功，非0失败）请求失败原因签拦截是否如果签出则无法取消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卖出数量SellPrice20丿匸是.无4000t-l-l屮-卖出价格20/匸是无200tn V 1 1 M货品优惠仝额eyscouniMion bGfft201是无无2001贝品优惠金额是否赠品

10、是为 1 否为0ZzTrf 亠y u/1 1 口 H H /丿 J1 ：1 / JM”un”：oo ”,品”7.?查询订单接口（根据订单修改时间）触以根起返系的口求查器页查询来计B并的。单信息,4按照修会默认查找结束进行处理,订单查询接口优化建议及注意事项最后修改时间-订单的任何字段发生变化最后修改时间都会随着变化订单重复查询到-因为是最后修改时间，订单可能会重复获得，如果想尽量少的重复获得可以注意尽量少的反复修改订单三 分页 从最后一页开始查询，第一次查询可以PageNO = 0 PageSize = 1获得 总记录数，具体数据不处理只获得总记录数，然后开始从最后一页开始分页获取-建议使用增

11、量查询，每隔一段时间查询一次，下一次查询的开始时间使用上一次的结束时间， 这样每次获得的单量较少，重复的单量也会比较少只是那些单据信息有过修改过的才会重复获得 四订单退款、申请退款、发生拦截出库这些理论上来说都是不满足发货的，需要注意做相应的处理订单拦截的问题分析及解决方案:抓取订单信息之后，遇到以下情况：#平台上（淘宝京东等）买家退款卖家还同意了退款，这个时候仓库并不知道，按照流程发货了,导致货品发货款也退了的情况（卖家很可能货款都没了 ）#卖家驳回订单对订单进行修改而后又审核过去了，如果仓库那边没有更新或来不及更新、按流程发货了，可能导致发错货的情况或者不满足买家的要求#平台上（淘宝京东等

12、）买家修改了订单信息，卖家还没有来得及处理订单时仓库已经按照流程发 货了，可能导致发错货的情况。#卖家手动取消了订单，仓库并不知道，按流程发货了，导致多发的现象。元解决方案（建议）:1仓库那边发货回传失败了，包裹就不发货，仓库对于订单重复获得做对应的修改，重复获取订单 后发现退款等拦截出库的就拦截发货，及时与卖家沟通。2如果是先发货后同步到旺店通ERP则需要提前拦截订单发货A. 需要抓取状态为已取消（TradeStatus为0 ）的订单，抓取到之后如果在仓库系统里存在则需要在仓库系统里取消。B. 需要抓取状态为待审核和待财审（C. 抓取状态为已审核（ TradeStatus 5） 数量和货品种

13、类、收件人地址、姓名、联系方式， 素求称新到仓库系统里去。TradeStatus 2）,如果在仓库系统里存在，则需要拦截。 的订单，如果订单在仓库系统里存在，则需要检查货品 物流，仓库是否有变化，有变化，需要把新的订单StartTime20En dTimeTradeStatusPageNOPageSize20501010是否必填默认值样例说明是.是无.无40200M0t012Q(m(0t02check_trade1一10查询修改时间满足的起始时间查询修改时间满足的中止时间（已财订单流单_eW_pde）_logistics）页码，取值范围：大于0的整数每页条数，取值范围 140ResultCod

14、e20是无0败求接收结果（0成功非0失ResultMsg200是无单据不存在z V*-，J/、* 丿少 7 丿 J：11*/、请求失败原因TotalCount20是无查询到的单据数,一级节占-订单信息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订单创建时间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间 发货时间LastModifyTi20是无2001 01 01 0-0-0最后修改时间me uviuuiiy 11TradeStatuswu50是无

16、无jUU 1 U 1 U 1.1最丿口修改时间1 1LU wDofunHQtciti icuu50是无1待已审消态asesesdiesdetxctUI lUOlcilUo kJQU1早3无无Tl ClUCrTTU 1U1U1IU1退款状态退待品请与客眦是否需要发票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 口 口口早占发/、V M-J kA 卖家备注ShopType-J* 1 U10/ J7匕无淘宝平台店铺类型,pi lop i ypurv200是无旗舰店平台店铺名称Ol IU|J 11 lOT二 uu200早无无丹舰丿店急需发货丨 口丿店于铺名称ERP中的订单标记名称11 uuc厂ChlmOperatorzuu50-是7无无心、IfiJ ZKJAL客月服1号匚rl中口的订单标记名称审单员名称NamiepDi 015三级节占 -货*品明细信言自 Detaill

18、ist1 11 3、1 J/J Qki旦帀UDd HHd匚匚）匚）rh QI/! 裤一后4口日n禺旁術石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名称卖出数量.11 x-Z W U 1 IIon曰无1xnnn卖出数量1SellPrice20是曰、无无4000200商品零售价货品优惠金额eyscounuvion20d1 是曰yo200d口品丿优惠金额2曰木IH萌口曰# tA木# tcDGITT1是无1疋否赠曰品，疋为1，否为 0品”TradeCode32是无JY200101