旺店通ERPapi_V1_9_1最新版

来源：叨叨游戏网

旺店通ERP接口文档

V1.9.1

北京掌上先机网络科技有限公司

研发部

一、概述 ......................................................................................................................................................... 1 二、接口规范说明 ......................................................................................................................................... 1

接口方式： ............................................................................................................................................... 1 接口数据传输类型： ............................................................................................................................... 1 格式： ....................................................................................................................................................... 1 三、接口描述 ................................................................................................................................................. 1

1. 创建单据接口 ...................................................................................................................................... 1 2. 取消单据接口 ...................................................................................................................................... 4 3. 查询货品库存信息 .............................................................................................................................. 4 4. 订单发货物流信息推送接口 .............................................................................................................. 6 5. 库存同步接口 ...................................................................................................................................... 7 6. 查询订单接口（根据订单编号） ...................................................................................................... 8 7. 查询订单接口（根据订单修改时间） ............................................................................................ 12 8. 订单物流同步接口 ............................................................................................................................ 17 9. 货品信息同步接口 ............................................................................................................................ 18 10.查询详细出库单接口 ........................................................................................................................ 19 11.查询详细入库单接口 ........................................................................................................................ 22 12.查询ERP货品信息 ........................................................................................................................... 24 13.查询ERP采购单信息 ....................................................................................................................... 27

一、概述

旺店通ERP外部接口文档用于描述旺店通ERP系统和外部管理软件进行数据交互的接口格式。本文档为外部管理软件对接旺店通ERP提供解决方案，规范外部管理软件跟旺店通ERP对接的数据交互格式和业务流程。

二、接口规范说明

接口方式：

REST --- HTTP POST (数据要放到post 的data 里面)

接口数据传输类型：

JSON

格式：

Method=&SellerID= & InterfaceID= & Sign= & Content= Method 是本次请求的业务类型

SellerID是ERP为卖家分配的帐号。限长32 InterfaceID是ERP为外部接口分配的帐号限长32

Sign是签名验证字段为取 content+key的md5值再进行Base编码,key是ERP给外部接口的授权字段，用于这里进行签名验证，key由ERP分配 Content是需要传输的数据部分为JSON格式这些请求参数都需要进行URL编码。 md5 模式为 32位小写如下为生成Sign的例子：

content={\"test\":1} key=12345 content+key={\"test\":1}12345

再进行base编码：NGE4ZjlkZTBlODYzODY2OTQ5MDE3OWZmNTI1ZTBkMjk= 最后url编码：NGE4ZjlkZTBlODYzODY2OTQ5MDE3OWZmNTI1ZTBkMjk%3D Sign=NGE4ZjlkZTBlODYzODY2OTQ5MDE3OWZmNTI1ZTBkMjk%3D 旺店通ERP接口采用HTTP POST的方式接受请求和返回结果，请求参数和回传结果均采用JSON格式。

发送请求的样例：

Method=NewOrder&SellerID=maijia&InterfaceID=interf&Sign=YUFTLsgl0YlsOUoIJKL&Content={

“OutInFlag”: 0, ........ }

以下接口描述均只介绍Content参数内容,UTF-8编码

三、接口描述

1. 创建单据接口

 用途：外部系统向旺店通ERP下发业务单据。ERP根据下发的单据在系统内创建相应

的业务单据。

 触发：外部系统发起请求

 业务类型：Method = NewOrder 请求元素说明

元素名称 OutInFlag 限长 Int(1) 是否必填默认值是无样例 1 说明出入库类型标记（0普通入库，1普通出库，2采购入库，3销售出库）外部单据编号仓库编号(销售出库时非空) 备注出入库原因供应商编号供应商名称供应商联系人联系人电话联系人地址业务员编号货款合计(销售出库时非空) 优惠金额其他费用货到付款标记，0为不需要货到付款，1为需要货到付款订单付款金额（含运费）（出库时非空）运费（出库时非空）物流公司编号订单所属店铺名称（出库时非空）客户平台昵称收货人姓名（出库时非空）收货人邮编（出库时非空）收货人联系方式收货人所在省（出库非空）收货人所在市（出库非空）收货人所在区、县（出库非空）收货地址（出库非空）收货人emaill 一级节点---单据信息 IF_OrderCode WarehouseNO Remark TheCause ProviderNO ProviderName LinkMan LinkManTel LinkManAdr RegOperatorNO GoodsTotal FavourableTotal OtherFee COD_Flag OrderPay LogisticsPay LogisticsCode ShopName NickName BuyerName BuyerPostCode BuyerTel BuyerProvince BuyerCity BuyerDistrict BuyerAdr BuyerEmail 32 16 500 50 50 200 50 20 300 20 Decimal(19,4) Decimal(19,4) Decimal(19,4) Int(1) Decimal(19,4) Decimal(19,4) 20 100 50 50 6 20 20 20 20 200 50 是是否否否否否否否否是否否否否否否否否否否否否否否否否无无无无无无无无无无无无无 0 无无无无无无无无无无无无无 BJZP 需紧急处理采购入库 GYS001 北京供应商张三北京 YW001 4000.00 0.00 100.00 0 4010.00 10.00 EMS 测试店铺这是一个网名小明 4567 1333333 北京北京海淀区北京海淀区远大路1号 NeedInvoice InvoiceTitle InvoiceContent ItemCount PayTime TradeTime ChargeID Sku_Code Sku_Name Sku_Price Discount Total Qty Item_Remark Int(1) 100 500 Int(11) 50 350 Decimal(19,4) Decimal(19,4) Decimal(19,4) Decimal(19,4) 1024 否否否否否否否是否否否否是否 0 无无无无无无无无 0.00 0.00 0.00 无无 1 收款公司电脑*1 1 HP1001 电脑 4000.00 0.9 3600.00 1 打折处理是否需要，1需要，0不需要抬头内容货品详细的行项目数量付款时间交易时间支付单号货品的唯一编码货品名称货品单价折扣单品金额小计货品数量行项目备注二级节点---货品明细 ItemList 示例： {

“OutInFlag”: 0,

“IF_OrderCode”: “”,

“WarehouseNO”: “BJZP”, “Remark”: “需紧急处理”, “TheCause”: “有人白送”, “ItemCount”: 2, “ItemList”: {

“Item”: [

{

“Sku_Code”: “HP1001”, “Sku_Name”: “电脑”, “Sku_Price”: 4000.00, “Qty”: 1,

“Item_Remark”: “打折处理” }, {

“Sku_Code”: “HP1002”, “Qty”: 2 }

] } }

返回元素说明元素名称 ResultCode ResultMsg ErpOrderCode 限长是否必填默认值样例 20 200 32 是否否无无无 0 签名验证失败说明请求接收结果（0成功，非0失败）请求失败时返回失败原因新生成的旺店通erp单据编号示例： {

“ResultCode”: 1,

“ResultMsg”: “货品HP1002不存在” }

2. 取消单据接口

 用途：外部系统请求取消单据  触发：外部系统发送请求

 业务类型：Method = CancelOrder

 说明：处理请求时会判断单据是否是可取消则状态，如果是不可取消则失败请求元素说明元素名称 OrderCode OrderType Reason Log 限长是否必填默认值样例 32 1 200 1 是是否否无无无无 1 顾客不要了 0 说明 ERP内单据编号单据类型(1是订单,2采购单) 取消原因签出后是否拦截 0 不拦截(默认) 1 拦截如果签出则无法取消示例 {

“OrderCode”: “”, “OrderType”: “1”,

“Reason”:”顾客不要了” }

返回元素说明元素名称 ResultCode ResultMsg 限长是否必填默认值样例 20 200 是是无无 0 单据不存在说明请求接收结果（0成功，非0失败）请求失败原因示例：

{

“ResultCode”: 0,

“ResultMsg”: “Success” }

3. 查询货品库存信息

 用途：用于外部系统查询货品的库存信息(分页查询)

 触发：外部系统发送请求

 业务类型：Method=QueryStorage

 说明：如果不指定Sku_Code则是查询整个仓库的所有货品库存,每页大小为固定值50 请求元素说明元素名称 WarehouseNO Sku_Code PageNO StartTime EndTime 限长是否必填默认值样例 16 32 10 20 20 是否否否否无无 1 无无 BJZP HP1001 1 2016-3-30 00:00:01 2016-3-30 23:00:00 说明仓库编号货品的唯一编码指定页码，取值为大于1的整数开始时间结束时间示例 {

“WarehouseNO”: “BJZP”, “Sku_Code”: “HP1001” }

返回元素说明元素名称 ResultCode ResultMsg TotalCount WarehouseNO Sku_Code Qty SellCount SendCount 限长是否必填默认值样例 20 200 10 16 50 20 20 20 是是是是是是是是无无无无无无无无 0 仓库不存在 1 BJZP HP1001 10 2 5 说明请求接收结果（0成功，非0失败）请求失败原因查询的货品总数量仓库编号货品的唯一编码库存总量（含占用量）销售订购量待发货量二级节点货品明细 ItemList 示例： {

“ResultCode”: 0, “ResultMsg”: “”, “TotalCount”:1,

“WarehouseNO”: “BJZP”, “ItemList”: {

“Item”: [

{

“Sku_Code”: “HP1001”, “Qty”: 10, “SellCount”: 2,

“SendCount”: 5 } ] } }

4. 订单发货物流信息推送接口

 用途：ERP定时向外部系统推送订单发货的物流信息  触发：ERP主动发起

 业务类型：Method = LogisticsReturn

 注意：ERP是分批回传的，一次最多回传50条订单信息请求元素说明元素名称 Post参数 Method SellerID Sign Content JSON元素 OrderCode TradeNO ErpLogisticCode LogisticName PostID SndTime 32 32 20 50 30 20 是是是是是是 EMS EMS 2001-01-01 10:0:0 外部系统订单编号 ERP内订单编号物流公司编码物流公司名称物流单号发货时间 20 32 32 是是是是 LogisticsReturn Maijia 见接口规范说明见json元素示例业务类型 ERP分配的卖家帐号签名验证内容为JSON格式的库存信息限长是否必填样例说明示例

Method=LogisticsReturn&SellerID=maijia&Sign=YUPljoslfoPO2KJL&Content= {

“TradeList”: {

“Trade”: [

{

“OrderCode”:””, “TradeNO”:””,

“ErpLogisticCode”: “SF”, “LogisticName”: “顺丰速运”, “PostID”: “”,

“SndTime”:”2001-01-01 10:00:00” }, {

“OrderCode”:””, “TradeNO”:””,

“ErpLogisticCode”: “EMS”,

“LogisticName”: “EMS”, “PostID”: “”,

“SndTime”:”2001-01-01 10:00:00” } ] } }

返回元素说明元素名称 ResultList ResultCode ResultMsg 结果列表--Result IF_OrderCode ResultCode ResultMsg 16 20 是是是无外部系统订单编号 0 系统异常 OrderCode 请求接收结果（0成功，非0失败）请求失败原因 20 200 是是无无 0 请求结果（0成功，非0失败）签名验证失败请求失败原因限长是否必填默认值样例说明示例

{

“ResultList”: {

“ResultCode”:0, “ResultMsg”:””, “Result”: [

{

“IF_OrderCode”:””, “ResultCode”:”0”,

“ResultMsg”: “success” }, {

“IF_OrderCode”:””, “ResultCode”:”1”,

“ResultMsg”: “单据不存在” } ] } }

5. 库存同步接口

   

用途：外部系统同步更新ERP内的货品库存信息触发：外部系统发送请求

业务类型：Method = SyncStorage

说明： ERP内的库存就由外部系统来维护

请求元素说明元素名称 WarehouseNO Sku_Code Outer_Code 限长是否必填默认值样例 16 32 32 是是否无无无 BJZP HP001 2001 说明仓库编号货品商家编码外部编码(如果Sku_Code为空,则这个编码不可为空,二者只能选其一来对应商品,都填的话以Sku_Code为准) 需要同步的数量 Qty 20 是无 10 示例 {

“WarehouseNO”: “BJZP”, “Sku_Code”: “HP1001”, “Outer_Code”:2001, “Qty”:1 }

返回元素说明元素名称 ResultCode ResultMsg 限长是否必填默认值样例 20 200 是是无无 0 仓库不存在说明请求接收结果（0成功，非0失败）请求失败原因示例：

{

“ResultCode”: 0,

“ResultMsg”: “Success” }

6. 查询订单接口（根据订单编号）

 用途：外部系统请求查询ERP内订单信息  触发：外部系统发送请求

 业务类型：Method = QueryTradeByNO  说明：订单编号为ERP内订单编号请求元素说明元素名称 OrderCode 示例 {

“OrderCode”: “” }

返回元素说明元素名称 ResultCode ResultMsg TradeNO 限长 20 200 50 必填项是是是默认值无无无样例 0 单据不存在说明请求接收结果（0成功，非0失败）请求失败原因 ERP内订单编号限长是否必填默认值样例 32 是无说明 ERP内单据编号 TradeNO2 WarehouseNO RegTime TradeTime PayTime ChkTime StockOutTime SndTime LastModifyTime TradeStatus 2048 32 20 20 20 20 20 20 20 50 是是是是是是是是是是无无无无无无无无无无 BJZP 2001-01-01 0:0:0 2001-01-01 0:0:0 2001-01-01 0:0:0 2001-01-01 0:0:0 2001-01-01 0:0:0 2001-01-01 0:0:0 2001-01-01 0:0:0 1 来源单号仓库编号订单创建时间交易时间付款时间审单时间出库时间发货时间最后修改时间订单状态 (已取消cancel_trade) (预订单pre_trade) (待审核check_trade) (待财审finance_trade) 待发货wait_send_trade (已完成 over_trade) 退款状态 (未退款trade_no_refund (等待客服确认trade_wait_seller_agree) (订单部分商品已退款，请与客服确认trade_part_refunded) (订单已退款trade_refunded 是否需要抬头内容客户网名收件人姓名收件人国家收件人省份收件人城市收件人区县收件人地址收件人电话收件人邮编 RefundStatus 50 是无 0 bInvoice InvoiceTitle NickName SndTo Country Province City Town Adr Tel Zip 1 200 50 50 50 50 50 50 500 20 20 是是是是是是是是是是是是无无无无无无无无无无无无 1 个人奇峰谷张三中国北京北京海淀北京海淀 12321 10010 InvoiceContent 200 ChargeType 1 是无 0 付款方式 (1担保交易)(2 银行收款) (3现金收款)(4货到付款) (5欠款记应收)(6客户预存款) 货品数量货品总额应收邮费订单总优惠应收金额物流公司编码货运单号买家留言卖家备注平台店铺类型平台店铺名称 ERP订单标记名称审单员名称 SellSkuCount GoodsTotal PostageTotal FavourableTotal AllTotal LogisticsCode PostID CustomerRemark Remark ShopType ShopName TradeFlag ChkOperatorName SkuCode SkuName PlatformGoodsCode PlatformGoodsName PlatformSkuCode PlatformSkuName SellCount SellPrice DiscountMoney bGift 20 20 20 20 20 20 50 2048 2048 10 200 200 50 是是是是是是是是是是是是是无无无无无无无无无无无无无 1 4000 20 200 3820 EMS 送点赠品早点发淘宝旗舰店急需发货客服1号二级节点 ----货品明细信息 DetailList 50 350 50 200 50 200 20 20 20 1 是否是是是否是是是是无无无无无无无无无无 HP1001 洗衣机 1008 洗衣机 100841 全自动 1 4000 200 1 ERP内Sku唯一标识即商家编码货品Sku名称平台货品编号平台货品名称平台Sku编码平台Sku名称卖出数量卖出价格货品优惠金额是否赠品，是为1，否为0 示例： {

“ResultCode”: 0,

“ResultMsg”: “Success”, “TradeNO”: “”, “TradeNO2“: “”,

“RegTime“: “2001-01-01 0:0:0”, “TradeTime“: “2001-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“: “个人”, “InvoiceContent“: “ “NickName“: “奇峰谷”, “SndTo“: “张三”, “Country”:”中国”, “Province”:”北京”, “City”:”北京”, “Town”:”海淀”, “Adr“: “北京海淀”, “Tel“: “”, “Zip“10010”,

“ChargeType“: “0”, “SellSkuCount“: “1”, “GoodsTotal“: “4000”, “PostageTotal“: “20”, “FavourableTotal“: “200”, “AllTotal“: “3820”,

“LogisticsCode“: “EMS”, “PostID“: “”,

“CustomerRemark“: “送点赠品”, “Remark“: “早点发”, “ShopType”:淘宝,

“ShopName”:”旗舰店”, “TradeFlag”:”急需发货”, “ChkOperatorName”:””, “DetailList“: {

“Detail” [

{

“SkuCode“: “HP1001”,

“SkuName“: “全自动洗衣机”, “PlatformGoodsCode”:”1008”, “PlatformGoodsName”:”洗衣机”,

“PlatformSkuCode“: “100841”, “PlatformSkuName“: “全自动”, “SellCount“: “1”, “SellPrice“: “4000”,

“DiscountMoney“: “200”, “bGift“: “0” } ] } }

7. 查询订单接口（根据订单修改时间）

   

用途：外部系统请求查询ERP内订单信息触发：外部系统发送请求

业务类型：Method = QueryTradeByMTime

注意：起止时间跨度最大1小时，并且是最近30天内的订单信息，按照修改时间查找结束时间不能超过当前接口服务器当前时间，开始时间不能大于结束时间。

 说明：根据修改时间分页查询订单，每页的条数最大为40，超出40系统会默认为40

进行处理，可以根据返回的TotalCount来计算下次请求要设置的页码。订单查询接口优化建议及注意事项?

一最后修改时间 --- 订单的任何字段发生变化最后修改时间都会随着变化?

二订单重复查询到 --- 因为是最后修改时间，订单可能会重复获得，如果想尽量少的重复获得可以注意尽量少的反复修改订单? 三分页从最后一页开始查询，第一次查询可以 PageNO = 0 PageSize = 1 获得总记录数，具体数据不处理只获得总记录数，然后开始从最后一页开始分页获取 ??

? ??? ??---?建议使用增量查询，每隔一段时间查询一次，下一次查询的开始时间使用上一次的结束时间，这样每次获得的单量较少，重复的单量也会比较少只是那些单据信息有过修改过的才会重复获得

四订单退款、申请退款、发生拦截出库这些理论上来说都是不满足发货的，需要注意做相应的处理?

订单拦截的问题分析及解决方案：?

抓取订单信息之后，遇到以下情况：?

? ??### 平台上(淘宝京东等)买家退款卖家还同意了退款，这个时候仓库并不知道，按照流程发货了，导致货品发货款也退了的情况(卖家很可能货款都没了)?

? ??### 卖家驳回订单对订单进行修改而后又审核过去了，如果仓库那边没有更新或来不及更新、按流程发货了，可能导致发错货的情况或者不满足买家的要求?

? ??### 平台上(淘宝京东等)买家修改了订单信息，卖家还没有来得及处理订单时仓库已经按照流程发货了，可能导致发错货的情况。?

? ??### 卖家手动取消了订单，仓库并不知道，按流程发货了，导致多发的现象。?

解决方案(建议)：?

? ??1.仓库那边发货回传失败了，包裹就不发货，仓库对于订单重复获得做对应的修改，重复获取订单后发现退款等拦截出库的就拦截发货，及时与卖家沟通。?

? ??2.如果是先发货后同步到旺店通ERP 则需要提前拦截订单发货?

? ??? ??A. 需要抓取状态为已取消（ TradeStatus 为?0 ）的订单，抓取到之后如果在仓库系统里存在则需要在仓库系统里取消。?

? ??? ??B. 需要抓取状态为待审核和待财审（??TradeStatus?2），如果在仓库系统里存在，则需要拦截。?

? ??? ??C. 抓取状态为已审核（?TradeStatus?5）的订单，如果订单在仓库系统里存在，则需要检查货品数量和货品种类、收件人地址、姓名、联系方式，物流，仓库是否有变化，有变化，需要把新的订单信息更新到仓库系统里去。? 请求元素说明元素名称 StartTime EndTime TradeStatus 限长是否必填默认值样例 20 20 50 是是是无无无 2001-01-01 12:00:00 2001-01-02 12:00:00 check_trade 说明查询修改时间满足的起始时间查询修改时间满足的中止时间订单状态 (已取消cancel_trade) (预订单pre_trade) (待审核check_trade) (待财审finance_trade) (待发货wait_send_trade) (待打印物流单wait_print_logistics) (已完成 over_trade) (委外订单 out_send) 页码，取值范围：大于0的整数每页条数，取值范围1~40 PageNO PageSize 10 10 否否 1 40 1 10 示例 {

“StartTime”: “2001-01-01 12:00:00”, “EndTime”: “2001-01-02 12:00:00”, “TradeStatus”:”check_trade”, “PageNO”:1, “PageSize”:40 }

返回元素说明元素名称 ResultCode ResultMsg TotalCount TradeNO TradeNO2 限长 20 200 20 50 2048 必填项是是是是是默认值样例无无无无无 0 单据不存在 1 说明请求接收结果（0成功，非0失败）请求失败原因查询到的单据数 ERP内订单编号来源单号二级节点 ---订单信息 TradeList WarehouseNO 32 RegTime TradeTime PayTime ChkTime SndTime LastModifyTime TradeStatus 20 20 20 20 20 20 50 是是是是是是是是是无无无无无无无无无 BJZP 仓库编号 2001-01-01 0:0:0 订单创建时间 2001-01-01 0:0:0 交易时间 2001-01-01 0:0:0 付款时间 2001-01-01 0:0:0 审单时间 2001-01-01 0:0:0 出库时间 2001-01-01 0:0:0 发货时间 2001-01-01 0:0:0 最后修改时间 1 订单状态 (已取消cancel_trade) (预订单pre_trade) (待审核check_trade) (待财审finance_trade) 待发货wait_send_trade (已完成 over_trade) 退款状态 (未退款trade_no_refund (等待客服确认trade_wait_seller_agree) (订单部分商品已退款，请与客服确认trade_part_refunded) (订单已退款trade_refunded 是否需要抬头内容客户网名收件人姓名收件人国家收件人省份收件人城市收件人区县收件人地址收件人电话(如果顾客填写了手机和固话,则用空格隔开) 收件人邮编付款方式 (1担保交易)(2 银行收款) (3现金收款)(4货到付款) (5欠款记应收)(6客户预存款) 货品数量 StockOutTime 20 RefundStatus 50 是无 trade_no_refund bInvoice InvoiceTitle InvoiceContent NickName SndTo Country Province City Town Adr Tel Zip ChargeType 1 200 200 50 50 50 50 50 50 500 30 20 1 是是是是是是是是是是是是是无无无无无无无无无无无无无 1 个人奇峰谷张三中国北京北京海淀北京海淀 12321 10010 0 SellSkuCount 20 是无 1 GoodsTotal PostageTotal FavourableTotal AllTotal LogisticsID LogisticsName PostID CustomerRemark Remark ShopType ShopName TradeFlag ChkOperatorName SkuCode SkuName PlatformGoodsCode PlatformGoodsName PlatformSkuCode PlatformSkuName SellCount SellPrice DiscountMoney bGift 20 20 20 20 11 20 是是是是是是是是是是是是是是无无无无无无无无无无无无无无 4000 20 200 3820 无无 EMS 送点赠品早点发淘宝旗舰店急需发货客服1号货品总额应收邮费订单总优惠应收金额物流公司id 物流公司名称物流公司编码货运单号买家留言卖家备注平台店铺类型平台店铺名称 ERP中的订单标记名称审单员名称 LogisticsCode 20 50 2048 2048 10 200 200 50 三级节点 ----货品明细信息 DetailList 50 350 50 200 50 200 20 20 20 1 是否是是是否是是是是无无无无无无无无无无 HP1001 全自动洗衣机 1008 洗衣机 100841 全自动 1 4000 200 1 ERP内Sku唯一标识即商家编码货品Sku名称平台货品编号平台货品名称平台Sku编码平台Sku名称卖出数量商品零售价货品优惠金额是否赠品，是为1，否为0 示例： {

“ResultCode”: 0,

“ResultMsg”: “Success”, “TotalCount”:1, “TradeList”: {

“Trade”:

[

{

“TradeNO”: “”, “TradeNO2“: “”,

“WarehouseNO”:”BJZP”,

“RegTime“: “2001-01-01 0:0:0”, “TradeTime“: “2001-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”,

“ChargeType“: “0”, “SellSkuCount“: “1”, “GoodsTotal“: “4000”, “PostageTotal“: “20”, “FavourableTotal“: “200”, “AllTotal“: “3820”,

“LogisticsCode“: “EMS”, “PostID“: “”,

“CustomerRemark“: “送点赠品”, “Remark“: “早点发”, “ShopType”:淘宝,

“ShopName”:”旗舰店”, “TradeFlag”:”急需发货”, “ChkOperatorName”:””, “DetailList“: {

“Detail” [

{

“SkuCode“: “HP1001”,

“SkuName“: “全自动洗衣机”, “PlatformGoodsCode”:”1008”, “PlatformGoodsName”:”洗衣机”, “PlatformSkuCode“: “100841”, “PlatformSkuName“: “全自动”, “SellCount“: “1”, “SellPrice“: “4000”,

“DiscountMoney“: “200”, “bGift“: “0” } ] } } ] } }

8. 订单物流同步接口

 用途：外部系统同步更新ERP内的订单的物流信息  触发：外部系统发送请求

 业务类型：Method = SyncLogistics 说明：淘宝只支持自己联系物流(线下发货) 发货方式。更新完物流信息之后ERP会把物流信息同步到平台上去。LogisticsCode是物流方式的编码，这个要跟ERP中相对应才能同步成功

请求元素说明元素名称 TradeCode LogisticsCode LogisticsNumber Type 限长是否必填默认值样例 32 32 20 1 是是是否无无无 0 EMS 1 说明 ERP订单编号物流方式编码物流单号操作类型:默认值为0 (0,只同步发货信息不扣减库存) (1,同步发货信息并扣减库存) 示例 {

“TradeCode”: “”,

“LogisticsCode”: “EMS”, “LogisticsNumber”:””, “Type”:1 }

返回元素说明元素名称 ResultCode 限长是否必填默认值样例 20 是无 0 说明请求接收结果（0成功，非0失败） ResultMsg 200 是无订单不存在请求失败原因示例： {

“ResultCode”: 0,

“ResultMsg”: “Success” }

9. 货品信息同步接口

   

用途：外部接口同步货品信息到ERP 触发：外部接口发送请求

业务类型：Method = SyncGoods

注意：如果货品是多规格的，需要在SkuList里列出所有规格，如果货品是单规格的，则SkuList可以省略。此接口是同步接口，如果货品存在的话会更新货品信息，如果不存在则是新建。但需要保证GoodsNO和SkuCode对应请求元素说明元素名称 GoodsNO GoodsName Weight Price Barcode Sku列表--- SkuList SkuCode SkuName Price Weight Barcode 50 32 20 20 20 是是否否否无无 0.0 0.0 无 HP1001-blue 蓝色电脑 3200.0 2.4 1523654 ERP内Sku唯一标识即商家编码 Sku名称 Sku的单价 Sku的重量 Sku的条码限长是否必填默认值 20 32 32 10 32 是是否否否无无 0.0 0.0 无样例 HP1001 电脑 2.4 3200.0 HP1001 说明货品编号货品名称重量（kg）单价（元）条码（单规格时填写）货品列表--GoodsList 示例 {

“GoodsList”: {

“Goods”: [

{

“GoodsNO”:”HP1001”, “GoodsName”:”电脑”, “Weight”: “2.4”, “Price”: “3200.0”, “Barcode”:”HP1001” }, {

“GoodsNO”:”HP1002”,

“GoodsName”:”鼠标”, “Weight”: “1”, “Price”: “50”, “Barcode”:””, “SkuList”: {

“Sku”: [

{

“SkuCode”:”HP1002-blue”, “SkuName”:”蓝色鼠标”, “Prce”:”50”, “Weight”:”1”, “Barcode”:”” }, {

“SkuCode”:”HP1002-red”, “SkuName”:”红色鼠标”, “Prce”:”60”, “Weight”:”1”, “Barcode”:”” } ] } } ] } }

返回元素说明元素名称 ResultCode ResultMsg 示例 {

“ResultCode”: 0, “ResultMsg”: “” }

限长是否必填默认值样例 20 是是无 0 系统异常说明请求接收结果（0成功，非0失败）请求失败原因 10.查询详细出库单接口



  

用途：外部接口请求查询ERP出库单触发：外部接口发送请求

业务类型：Method = QueryStockoutOrder

注意：起止时间跨度最大一天，并且是最近30天内的订单信息，查询所有的出库单时,则不需要指定Type类型请求元素说明

元素名称 StartTime EndTime Type 限长是否必填默认值样例 20 20 1 是是否无无无 2013-01-01 0:0:0 2013-01-02 0:0:0 1 说明开始时间结束时间可不填,不填则是查询所有类型的出库单. 为1是查询销售出库单页码，取值范围：大于0的整数每页条数，取值范围1~30 PageNO PageSize 10 10 否否 1 10 1 10 示例：

{

“StartTime”: “2013-01-01 0:0:0”, “EndTime”: “2013-01-01 0:0:0”, “PageNO”: 1, “PageSize”:20 }

返回元素说明元素名称一级节点 ResultCode ResultMsg TotalCount OrderNO WarehouseNO Time TheCause Type TradeNO TradeNO2 RegTime TradeTime PayTime ChkTime StockOutTime SndTime LastModifyTime bInvoice InvoiceTitle InvoiceContent NickName SndTo 1 200 16 32 30 20 50 1 32 20 20 20 20 20 20 20 1 200 200 50 50 是是是是是是是是是是是是是是是是是是是是是无无无无无无无无无无无无无无无无无无无无无无 0 仓库不存在 5 BJZP 2013-01-01 0:0:0 销售出库 0 2001-01-01 0:0:0 2001-01-01 0:0:0 2001-01-01 0:0:0 2001-01-01 0:0:0 2001-01-01 0:0:0 2001-01-01 0:0:0 2001-01-01 0:0:0 1 个人奇峰谷张三请求接收结果（0成功，非0失败）请求失败时返回失败原因符合条件的单据总条数单据编号仓库编号出库时间出库原因出库单类型(0为普通单,1销售出库单) ERP内订单编号(销售出库非空) 来源单号(销售出库非空) 订单创建时间(销售出库非空) 交易时间(销售出库非空) 付款时间(销售出库非空) 审单时间(销售出库非空) 出库时间(销售出库非空) 发货时间(销售出库非空) 最后修改时间(销售出库非空) 是否需要(销售出库非空) 抬头(销售出库非空) 内容(销售出库非空) 客户网名(销售出库非空) 收件人姓名(销售出库非空) 限长是否必填默认值样例说明二级节点单据信息 OrderList 2048 是 Country Province City Town Adr Tel Zip ChargeType 50 50 50 50 255 20 20 1 是是是是是是是是无无无无无无无无中国北京北京海淀北京海淀 12321 10010 0 收件人国家(销售出库非空) 收件人省份(销售出库非空) 收件人城市(销售出库非空) 收件人区县(销售出库非空) 收件人地址(销售出库非空) 收件人电话(销售出库非空) 收件人邮编(销售出库非空) 付款方式(销售出库非空) (1担保交易)(2 银行收款) (3现金收款)(4货到付款) (5欠款记应收)(6客户预存款) 货品数量(销售出库非空) 货品总额(销售出库非空) 应收邮费(销售出库非空) 订单总优惠(销售出库非空) 应收金额(销售出库非空) 物流公司编码(销售出库非空) 货运单号(销售出库非空) 买家留言(销售出库非空) 卖家备注(销售出库非空) 平台店铺类型(销售出库非空) 平台店铺名称(销售出库非空) ERP订单标记名称(销售出库非空) 货品的唯一编号出库数量卖出数量(销售出库非空) 商品零售价(销售出库非空) 货品优惠金额(销售出库非空) 是否赠品，是为1，否为0(销售出库非空) SellSkuCount GoodsTotal PostageTotal FavourableTotal AllTotal LogisticsCode PostID CustomerRemark Remark ShopType ShopName TradeFlag 20 20 20 20 20 20 30 是是是是是是是无无无无无无无无无无无无 1 4000 20 200 3820 EMS 送点赠品早点发淘宝旗舰店急需发货 2048 是 2048 是 10 200 200 是是是三级节点货品明细 ItemList SkuCode Qty SellCount SellPrice DiscountMoney bGift 50 20 20 20 20 1 是是是是是是无无无无无无 HP1001 1 1 4000 200 1 示例： {

“ResultCode”: 0, “ResultMsg”: ””, “TotalCount”: 1, “OrderList”: {

“Order”: [

{

“OrderNO”: “”,

“WarehouseNO”: “BJZP”,

“Time”: “2013-01-01 18:13:49”, “Tyep”: 0,

“TheCause”: “其他出库”, “Remark”: “别发错货了”, “ItemList”: {

“item”: [

{“Sku_Code”: “HP1001”, “Qty”: 1} ] } } ] } }

11.查询详细入库单接口

   

用途：外部接口请求查询ERP出库单触发：外部接口发送请求

业务类型：Method = QueryStockinOrder

注意：起止时间跨度最大一天，并且是最近30天内的订单信息，查询所有的入库单时,则不需要指定Type类型请求元素说明元素名称 StartTime EndTime Type 限长是否必填默认值样例 20 20 1 是是否无无无 2013-01-01 0:0:0 2013-01-02 0:0:0 1 说明开始时间结束时间可不填,不填则是查询所有类型的入库单. 为101是查询采购入库单为103是查询退货入库单页码，取值范围：大于0的整数每页条数，取值范围1~30 PageNO PageSize 10 10 否否 1 10 1 10 示例： {

“StartTime”: “2013-01-01 0:0:0”, “EndTime”: “2013-01-01 0:0:0”, “PageNO”: 1, “PageSize”:20 }

返回元素说明元素名称一级节点 ResultCode 1 是无 0 请求接收结果（0成功，非0失限长是否必填默认值样例说明败） ResultMsg TotalCount OrderNO WarehouseNO Time TheCause Type PurchaseNO ProviderName ProviderNO GoodsTotal OtherFee TotalFee PriceDis ProviderRemark CHKData SellbackNO Days NickName CustomerName SndTo CustomerTel Adr CusArea RegTime RcvTime ChargeTime GoodsTotalPay GoodsTotalRcv PostageTotal AllTotalPay PayTotal LogisticName RcvPostID ShopName OrigTradeNO 200 16 32 30 20 50 1 32 200 50 20 20 20 20 20 32 20 50 50 50 30 255 50 20 20 20 20 20 20 20 20 30 30 50 50 是是是是是是是是是是是是是是是是是是是是是是是是是是是是是是是是是是是无无无无无无无无无无无无无无无无无无无无无无无无无无无无无无无无无无无无仓库不存在 5 BJZP 2013-01-01 0:0:0 销售出库 0 厂商 CS001 100 5 105 0 备注 2014-01-01 0:0:0 5天 shs shs bjcp bj bj 2014-08-21 16:19:23 0000-00-00 00:00:00 0000-00-00 00:00:00 10.2 45 20 -14.8 0 EMS 0000000001 suning 请求失败时返回失败原因符合条件的单据总条数单据编号仓库编号入库时间入库原因入库单类型(0为普通单,1采购入库单,3为退货入库单) 采购编号(采购入库非空) 供应商(采购入库非空) 供应商编号(采购入库非空) 货款总额(采购入库非空) 其他费用(采购入库非空) 总费用(采购入库非空) 优惠(采购入库非空) 供应商备注(采购入库非空) 采购单审核时间(采购入库非空) 退换单号(退货入库非空) 处理天数(退货入库非空) 关联客户网名(退货入库非空) 关联客户(退货入库非空) 客户姓名(退货入库非空) 客户电话(退货入库非空) 客户地址(退货入库非空) 客户区域登记时间(退货入库非空) 收货入库时间(退货入库非空) 结算时间(退货入库非空) 退货总额(退货入库非空) 换货总额(退货入库非空) 应收邮资总额(退货入库非空) 应退总额(退货入库非空) 实退金额(退货入库非空) 退货物流公司(退货入库非空) 退货物流单号(退货入库非空) 关联店铺名(退货入库非空) 关联订单号(退货入库非空) 二级节点单据信息 OrderList 2048 是三级节点货品明细 ItemList SkuCode Qty PurchaseCount Price Discount SellCount SellPrice SellDiscount 50 20 20 20 20 20 20 20 是是是是是是是是无无无无无无无无 HP1001 1 1 10 0.5 1 4000 0.5 货品的唯一编号入库数量采购数量(采购入库非空) 采购单价(采购入库非空) 折扣(采购入库非空) 退回数量(退货入库非空) 商品零售价(退货入库非空) 折扣(退货入库非空) 示例： {

“ResultCode”: 0, “ResultMsg”: ””, “TotalCount”: 1, “OrderList”: {

“Order”: [

{

“OrderNO”: “”,

“WarehouseNO”: “BJZP”,

“Time”: “2013-01-01 18:13:49”, “Tyep”: 0,

“TheCause”: “其他入库”, “ItemList”: {

“item”: [

{“Sku_Code”: “HP1001”, “Qty”: 1} ] } } ] } }

12.查询ERP货品信息

 用途：用于外部系统查询ERP内货品信息(分页查询)  触发：外部系统发送请求

 业务类型：Method=QueryGoodsInfo

 说明：如果不指定货品信息则是查询所有货品,每页大小为最大值为50 请求元素说明元素名称 StartTime EndTime 限长是否必填默认值样例 20 20 是是无无 2014-12-18 00:00:00 2014-12-18 说明查询修改时间满足的起始时间查询修改时间满足的中止时间 23:00:00 GoodsNO SkuCode PageNO PageSize 32 40 10 10 否否否否无无 1 10 88801 1 10 ERP内货品编号商家编码(旺店通内商品唯一标识) 指定页码，取值为大于1的整数指定每页大小,最大值为40 示例 {

“GoodsNO”: “88801”, “PageNO”: 1, “PageSize”:10 }

返回元素说明元素名称 ResultCode ResultMsg TotalCount GoodsNO LastModifyTime GoodsName GoodsName2 Class 限长 20 200 10 50 350 120 50 20 50 512 20 4 100 120 120 必填是是是是是是是是是是是是是是是是是是是是是是是是是是默认值样例无无无无无无无无无无无无无无无无无无无无无无无无无无 0 仓库不存在 1 说明请求接收结果（0成功，非0失败）请求失败原因查询的货品总数量编号最后修改时间二级节点货品明细 GoodsList 名称简称类别标记品牌备注 Flag Brand Remark PriceDetail PriceMember Price1 Price2 Price3 Origin Weight PackGrades GaugeCase PriceBottom PriceWholesale PricePurchase 零售价会员价价格1 价格2 价格3 产地重量(kg) 打包积分箱规最新售价批发价标准采购价最后采购价交易名1 交易名2 LastPurchasePrice TradeName1 TradeName2 TradeName3 120 11 11 11 1 1 1 1 1 256 1 是是是是是是是是是是是无无无无无无无无无无无交易名3 长(CM) 宽(CM) 高(CM) 允许负库存不走验货出库是否大件单独包裹发货出库不扫描图片是否停用 GoodsLength GoodsWidth GoodsHeight bNegativeStock bNOCheckStockout bLarge bNOScan bPackage PicUrl bBlockup 三级节点货品规格明细 SkuList SpecCode SpecName SpecPicUrl SkuCode Barcode SpecRemark SpecPriceDetail SpecPriceWholesale SpecPriceMember SpecLastPurchasePrice SpecPriceBottom SpecPricePurchase SpecPrice1 SpecPrice2 SpecPrice3 SpecLength SpecWidth SpecHeight SpecWeight bBlockUp PackGrades SalesGrades 50 50 256 50 50 50 11 11 11 11 1 11 11 是是是是是是是是是是是是是是是是是是是是是是无无无无无无无无无无无无无无无无无无无无无无规格码规格名称图片商家编码(唯一) 默认条码备注零售价批发价会员价最后采购价最低售价标准采购价价格1 价格2 价格3 长(CM) 宽(CM) 高(CM) 重量(kg) 是否停用打包积分销售积分示例: {

“ResultCode”: 0, “ResultMsg”: “”, “TotalCount”:1, “GoodsList”: {

“Goods”: [

{

.... ....

“SkuList”: {

“Sku”: [

{

“SkuCode”:.... ........... } ] } } ] } }

13.查询ERP采购退货出库单信息

   

用途：用于外部系统查询ERP内采购退货出库单信息(分页查询) 触发：外部系统发送请求

业务类型：Method=QueryStockoutOrderPurchaseReturn

说明：开始时间与结束时间之间的跨度要尽量小，这样有利于提高成功率，后续接口也会强制时间的跨度。请求元素说明元素名称 StartTime EndTime StockoutStatus PageNO PageSize 限长是否必填默认值样例 20 20 11 10 10 是是否否否无无无 1 10 2014-12-18 00:00:00 2014-12-18 23:00:00 1 10 说明查询修改时间满足的起始时间查询修改时间满足的中止时间采购单状态指定页码，取值为大于1的整数指定每页大小,最大值为40 示例 {

“StartTime”: “2016-4-14 14:00:33”,

“EndTime”: “2016-4-14 14:21:49”, “PageNO”: 1, “PageSize”:10 }

返回元素说明元素名称 ResultCode ResultMsg TotalCount StockoutID StockoutNO WareHouseID WarehouseNO WarehouseName CreateTime GoodsTotal 限长 20 200 10 11 40 11 40 20 decimal(19,4) decimal(19,4) 50 11 20 20 1 11 50 11 50 50 1000 必填是是是是是是是是是是默认值样例无无无无无无无无无无 0 仓库不存在 1 1 CK2016 1 Test001 主仓库 2016-4-28 08:37:38 1.0000 货款总额是无 0.0000 其他费用是是是是是是是是是是是是是无无无无无无无无无无无无无 “” 2016-4-28 08:38:02 1 采购退货出库采购退货出库 0 1 CG2016 2016-4-28 08:39:01 1 Test001 北京 “” 出库单备注出库单审核时间出库单当前状态 -1 已取消 0 未审核 1 已审核出库原因出库单类型是否使用sn 0 否 1 是采购单id 采购单编号采购预计到货时间供应商id 供应商编号供应商名称采购单备注说明请求接收结果（0成功，非0失败）请求失败原因满足条件的采购单总数量出库单主键id 出库单编号仓库id 仓库编号仓库名称二级节点采购单列表 StockoutOrderList 出库单创建时间 OtherFee Remark CHKTime StockoutStatus TheCause OperationType bUseSN PurchaseID PurchaseNO RegDate ProviderID ProviderNO ProviderName PurchaseRemark GoodsList 11 50 350 120 11 50 50 50 20 decimal(19,4) 200 data[] 是是是是是是是是是是无无无无无无无无无无 1 Test001 test Test2 1 测试 test Test-001 个 1.0000 出库商品列表三级节点货品列表 GoodsList GoodsID GoodsNO GoodsName GoodsName2 SpecID SpecName SpecCode SkuCode Unit 货品id 货品编号货品名称货品名称2 规格id 规格名称规格编号商家编码(ERP内商品唯一编码) 单位 GoodsCount DetailRemark 出库数量是无 “” 明细备注示例: {

\"ResultCode\": 0,

\"ResultMsg\": \"Success\ \"StockoutOrderList\": { \"StockoutOrder\": [ {

\"StockoutID\": \"849\ \"WareHouseID\": \"31\

\"WarehouseNO\": \"adnewtest\

\"WarehouseName\": \"艾顿测试仓2\ \"CreateTime\": \"2016-04-26 18:57:20\ \"GoodsTotal\": \"0.0000\ \"OtherFee\": \"0.0000\

\"Remark\": \"采购退货出库\

\"CHKTime\": \"2016-04-26 18:57:21\ \"StockoutStatus\": \"1\

\"TheCause\": \"采购退货出库\ \"OperationType\": \"采购退货出库\ \"bUseSN\": \"0\ \"PurchaseID\": \"8\

\"RegDate\": \"2014-11-26 11:28:24\ \"ProviderID\": \"3\ \"ProviderNO\": \"\

\"ProviderName\": \"戴尔北京供应商\ \"PurchaseRemark\": \"\

\"GoodsList\": { \"Goods\": [ {

\"GoodsID\": \"2\

\"GoodsNO\": \"interface-test\ \"GoodsName\": \"测试商品1\ \"GoodsName2\": \"\ \"SpecID\": \"2\

\"SpecName\": \"测试店铺\ ] } }

] } } \"SpecCode\": \"001\

\"SkuCode\": \"interface-test-001\ \"Unit\": \"\

\"GoodsCount\": \"2.0000\ \"DetailRemark\": \"\" }

因篇幅问题不能全部显示，请点此查看更多更全内容

查看全文