《旺店通ERPapi_V1_9_1最新版》由会员分享，可在线阅读，更多相关《旺店通ERPapi_V1_9_1最新版（36页珍藏版）》请在金锄头文库上搜索。
1、word格式旺店通ERP接口文档V1.9.1北京掌上先机网络科技有限公司研发部目录一、 概述3二、 接口规范说明3接口方式：3接口数据传输类型：3格式：3三、 接口描述41. 创建单据接口42. 取消单据接口63. 查询货品库存信息74. 订单发货物流信息推送接口95. 库存同步接口116. 查询订单接口（根据订单编号）127. 查询订单接口（根据订单修改时间）168. 订单物流同步接口219. 货品信息同步接口2210.查询详细出库单接口2411.查询详细入库单接口2612.查询ERP货品信息2913.查询ERP采购单信息32. .1、 概述旺店通ERP外部接口文档用于描述旺店通ERP系统和
2、外部管理软件进行数据交互的接口格式。本文档为外部管理软件对接旺店通ERP提供解决方案，规范外部管理软件跟旺店通ERP对接的数据交互格式和业务流程。2、 接口规范说明接口方式：REST - HTTP POST (数据要放到post 的data 里面)接口数据传输类型：JSON格式：Method=?&SellerID=? & InterfaceID=? & Sign=? & Content=?Method 是本次请求的业务类型SellerID是ERP为卖家分配的帐号。 限长32InterfaceID是ERP为外部接口分配的帐号限长32Sign是签名验证字段 为取 content+key的md5值再
3、进行Base64编码,key是ERP给外部接口的授权字段，用于这里进行签名验证，key由ERP分配Content是需要传输的数据部分为JSON格式这些请求参数都需要进行URL编码。md5 模式为 32位小写如下为生成Sign的例子：content=test:1 key=12345content+key=test:112345md5(c+k)=4a8f9de0e8638669490179ff525e0d29再进行base64编码：NGE4ZjlkZTBlODYzODY2OTQ5MDE3OWZmNTI1ZTBkMjk=最后url编码：NGE4ZjlkZTBlODYzODY2OTQ5MDE3OWZm
4、NTI1ZTBkMjk%3DSign=NGE4ZjlkZTBlODYzODY2OTQ5MDE3OWZmNTI1ZTBkMjk%3D旺店通ERP接口采用HTTP POST的方式接受请求和返回结果，请求参数和回传结果均采用JSON格式。发送请求的样例：Method=NewOrder&SellerID=maijia&InterfaceID=interf&Sign=YUFTLsgl0YlsOUoIJKL&Content=“OutInFlag”: 0,.以下接口描述均只介绍Content参数内容,UTF-8编码3、 接口描述1. 创建单据接口 用途：外部系统向旺店通ERP下发业务单据。ERP根据下发的单
5、据在系统内创建相应的业务单据。 触发：外部系统发起请求 业务类型：Method = NewOrder请求元素说明元素名称限长是否必填默认值样例说明一级节点-单据信息OutInFlagInt(1)是无1出入库类型标记（0普通入库，1普通出库，2采购入库，3销售出库）IF_OrderCode32是无OR2013010101外部单据编号WarehouseNO16是无BJZP仓库编号(销售出库时非空)Remark500否无需紧急处理备注TheCause50否无采购入库出入库原因ProviderNO50否无GYS001供应商编号ProviderName200否无北京供应商供应商名称LinkMan50否无
6、张三供应商联系人LinkManTel20否无13333333联系人电话LinkManAdr300否无北京联系人地址RegOperatorNO20否无YW001业务员编号GoodsTotalDecimal(19,4)是无4000.00货款合计(销售出库时非空)FavourableTotalDecimal(19,4)否无0.00优惠金额OtherFeeDecimal(19,4)否无100.00其他费用COD_FlagInt(1)否00货到付款标记，0为不需要货到付款，1为需要货到付款 OrderPayDecimal(19,4)否无4010.00订单付款金额（含运费）（出库时非空）Logistics
7、PayDecimal(19,4)否无10.00运费（出库时非空）LogisticsCode20否无EMS物流公司编号ShopName100否无测试店铺订单所属店铺名称（出库时非空）NickName50否无这是一个网名客户平台昵称BuyerName50否无小明收货人姓名（出库时非空）BuyerPostCode6否无456789收货人邮编（出库时非空）BuyerTel20否无1333333收货人联系方式BuyerProvince20否无北京收货人所在省（出库非空）BuyerCity20否无北京收货人所在市（出库非空）BuyerDistrict20否无海淀区收货人所在区、县（出库非空）BuyerAd
8、r200否无北京海淀区远大路1号收货地址（出库非空）BuyerEmail50否无收货人emaillNeedInvoiceInt(1)否01是否需要发票，1需要，0不需要InvoiceTitle100否无收款公司发票抬头InvoiceContent500否无电脑*1发票内容ItemCountInt(11)否无1货品详细的行项目数量PayTime否无付款时间TradeTime否无交易时间ChargeID否无支付单号二级节点-货品明细 ItemListSku_Code50是无HP1001货品的唯一编码Sku_Name350否无电脑货品名称Sku_PriceDecimal(19,4)否0.004000
9、.00货品单价DiscountDecimal(19,4)否0.000.9折扣TotalDecimal(19,4)否0.003600.00单品金额小计QtyDecimal(19,4)是无1货品数量Item_Remark1024否无打折处理行项目备注示例：“OutInFlag”: 0,“IF_OrderCode”: “OR2013010101”,“WarehouseNO”: “BJZP”,“Remark”: “需紧急处理”,“TheCause”: “有人白送”,“ItemCount”: 2,“ItemList”:“Item”:“Sku_Code”: “HP1001”,“Sku_Name”: “电脑
10、”,“Sku_Price”: 4000.00,“Qty”: 1,“Item_Remark”: “打折处理”,“Sku_Code”: “HP1002”,“Qty”: 2返回元素说明元素名称限长是否必填默认值样例说明ResultCode20是无0请求接收结果（0成功，非0失败）ResultMsg200否无签名验证失败请求失败时返回失败原因ErpOrderCode32否无CG2001010133新生成的旺店通erp单据编号示例：“ResultCode”: 1,“ResultMsg”: “货品HP1002不存在”2. 取消单据接口 用途：外部系统请求取消单据 触发：外部系统发送请求 业务类型：Meth
11、od = CancelOrder 说明： 处理请求时会判断单据是否是可取消则状态，如果是不可取消则失败请求元素说明元素名称限长是否必填默认值样例说明OrderCode32是无JY2001010133ERP内单据编号OrderType1是无1单据类型(1是订单,2采购单)Reason200否无顾客不要了取消原因Log1否无0签出后是否拦截0 不拦截(默认)1 拦截 如果签出则无法取消示例“OrderCode”: “JY2001010133”,“OrderType”: “1”,“Reason”:”顾客不要了”返回元素说明元素名称限长是否必填默认值样例说明ResultCode20是无0请求接收结果（
12、0成功，非0失败）ResultMsg200是无单据不存在请求失败原因示例：“ResultCode”: 0,“ResultMsg”: “Success”3. 查询货品库存信息 用途：用于外部系统查询货品的库存信息(分页查询) 触发：外部系统发送请求 业务类型：Method=QueryStorage 说明：如果不指定Sku_Code则是查询整个仓库的所有货品库存,每页大小为固定值50请求元素说明元素名称限长是否必填默认值样例说明WarehouseNO16是无BJZP仓库编号Sku_Code32否无HP1001货品的唯一编码PageNO10否11指定页码，取值为大于1的整数StartTime20否无2016-3-30 00:00:01开始时间EndTime20否无2016-3-30 23:00:00结束时间示例“WarehouseNO”: “BJZP”,“Sku_Code”: “HP1001”返回元素说明元素名称限长是否必填默认值样例说明ResultCode20是无0请求接收结果（0成功，非0失败）ResultMsg200是无仓库不存在请求失败原因TotalCo
