把网页分享给身边的朋友
标准接口2.0发布
huadog
头像
等级: 店铺主管 店铺主管
身份: 管理员 管理员
帖子: 2362
经验: 13408
威望: 303
称号:
注册时间: 2005-09-30
最后登陆: 2016-07-17
收藏 加为好友 消息 引用 修改 回复 1楼

主要改进是,将下载订单的控制点放在客户端,服务器端不需要做读取标记,以降低对环境的依赖。另外,发货同步增加原始订单号参数,便于对应网店系统的订单。

 

《网店管家》网络商城接口 2.0

 

 

《网店管家》商城接口包括两个部分,一是订单下载接口,由《网店管家》的附件“网店蜘蛛”实现,二是订单状态、库存同步、客户资料、发货通知接口,由《网店管家》的附件“管家助理”实现。接口采用Post方法实现,采用UTF8编码。

一.   订单下载接口

1.机制

    《网店蜘蛛》或《网店管家》主动发起获取订单请求,网店系统验证请求后,返回信息。结果信息为XML格式,每次返回一个。

 


2.消息格式

1)订单查询

参数

说明

uCode

接入码,用于验证请求的有效性。接入码的值在网店系统和网店蜘蛛中设置。

mType

请求类别。订单查询时该值为:mOrderSearch

TimeStamp1

起始时间(时间戳),0表示不限制起始时间

TimeStamp2

截止时间(时间戳),0表示不限制截止时间

OrderStatus

0:表示所有,1:表示已经付款,2:表示未付款,3:表示已经取消,4:已经发货

接口文件接收消息后,将符合条件的订单按照如下格式返回

标记

定义

说明

OrderCount

订单数量

 

OrderNO

订单号

不能重复

例如,要查询当前所有已经付款的订单:

http://www.XShop.com/interface.asp? uCode=123456& mType=mOrderSearch&TimeStamp1=0&TimeStamp2=0&OrderStatus=1

返回结果示例如下:

<?xml version='1.0' encoding='gb2312'?>

<OrderList>

<OrderCount>3</ OrderCount >

<OrderNO>07081001</OrderNO>

<OrderNO>07081002</OrderNO>

<OrderNO>07081003</OrderNO>

</OrderList>

2)订单下载

参数

说明

uCode

接入码,用于验证请求的有效性。接入码的值在网店系统和网店蜘蛛中设置。

mType

请求类别。订单查询时该值为:mGetOrder

OrderNO

订单号

接口文件接收消息后,将符合条件的订单按照如下格式返回

标记

定义

说明

OrderNO

订单号

不能重复

DateTime

成交日期

 

BuyerID

买家用户名

 

BuyerName

买家姓名

 

Country

国家

 

Province

/州

 

City

/县

 

Town

/镇

 

Adr

地址

 

Zip

邮编

 

Email

Email

 

Phone

联系电话

 

Total

货款总额

 

Postage

货运费用

 

PayAccount

支付方式

 

PayID

支付编号

 

CustomerRemark

客户备注

 

Remark

客服备注

 

Item

成交商品集

 

 

GoodsID

库存编码

 

GoodsName

货品名称

 

GoodsSpec

货品规格

 

Count

数量

 

Price

单价

 

 

需要说明的是,为了避免特殊字符的干扰,对于字符型数据建议增加CDATA标记("<![CDATA["作为前缀,并以"]]>"结束。)。

一个符合规范的订单描述:

<?xml version='1.0' encoding='gb2312'?>

<Order>

<OrderNO>07081001</ OrderNO >

<DateTime>2006-06-08 12:30</DateTime>

<BuyerID>huadog</BuyerID>

<BuyerName>张三</BuyerName>

<Country>中国</Country>
<Province>浙江</Province>

<City>杭州</City>
<Town>西湖区</Town>

<Adr>文三路90号</Adr>

<Zip>310012</Zip>

<Email>zhangsan@163.com</Email>

<Phone>0571-85642212</Phone>

<Total>250</Total>

<Postage>10</Postage>

<CustomerRemark>用申通快递</CustomerRemark>

<Remark></Remark>

<Item>

    <GoodsID>YF001</ GoodsID>

<GoodsName>衣服</GoodsName>

    <Price>1.0</Price>

        <Count>2</Count>

</Item>

 <Item>

    <GoodsID>PJ002</ GoodsID>

<GoodsName>皮带</GoodsName>

    <Price>76.5</Price>

    <Count>1</Count>

</Item>

</Order>

 

二.   货品和库存同步

当库存发送变化时,《网店管家》会产生一条库存同步消息。参数如下:

参数

说明

uCode

接入码,用于验证请求的有效性。接入码的值在网店系统和《网店管家》中设置,必须一致。

mType

请求类别,同步库存时,该值为“mUpdateStock”。

GoodsNO

货品编号

GoodsSpec

货品规格

Stock

库存量

成功:<rsp><result>1</result></rsp>

失败:<rsp><result>0</result><cause>拒绝原因</cause></rsp>

 

初始建立货品时,可以先同步一条货品信息:

参数

说明

uCode

接入码,用于验证请求的有效性。接入码的值在网店系统和《网店管家》中设置,必须一致。

mType

mNewGoods

GoodsNO

货品编号

GoodsName

货品名称

GoodsSpec

货品规格

GoodsUnit

货品单位

dPriceDetail

零售价

dPricewholesale1

批发价1

dPricewholesale2

批发价2

dPricewholesale3

批发价3

Stock

库存量

bMultiSpec

是否存在多规格

Remark

备注

成功:<rsp><result>1</result></rsp>

失败:<rsp><result>0</result><cause>拒绝原因</cause></rsp>

 

同步规格信息:

参数

说明

uCode

接入码,用于验证请求的有效性。接入码的值在网店系统和《网店管家》中设置,必须一致。

mType

mNewGoodsSpec

GoodsNO

货品编号

GoodsSpec

货品规格

Stock

库存量

成功:<rsp><result>1</result></rsp>

失败:<rsp><result>0</result><cause>拒绝原因</cause></rsp>

 

删除货品:

参数

说明

uCode

接入码,用于验证请求的有效性。接入码的值在网店系统和《网店管家》中设置,必须一致。

mType

mDelGoods

GoodsNO

货品编号

成功:<rsp><result>1</result></rsp>

失败:<rsp><result>0</result><cause>拒绝原因</cause></rsp>

 

删除货品的规格:

参数

说明

uCode

接入码,用于验证请求的有效性。接入码的值在网店系统和《网店管家》中设置,必须一致。

mType

mDelGoods

GoodsNO

货品编号

GoodsSpec

货品规格

成功:<rsp><result>1</result></rsp>

失败:<rsp><result>0</result><cause>拒绝原因</cause></rsp>

 

 

三.   发货通知

当订单发货时,《网店管家》会产生对应的发货通知消息。参数如下:

参数

说明

uCode

接入码,用于验证请求的有效性。接入码的值在网店系统和《网店管家》中设置,必须一致。

mType

请求类别,发货通知时,该值为“mSndGoods”。

OrderID

订单编号

OrderNO

原始订单编号

CustomerID

客户网名

SndStyle

发货方式

BillID

货运单号

SndDate

发货时间

成功:<rsp><result>1</result></rsp>

失败:<rsp><result>0</result><cause>拒绝原因</cause></rsp>

 

四.   订单状态同步

当订单状态发生变化时,《网店管家》会产生对应的同步消息。参数如下:

参数

说明

uCode

接入码,用于验证请求的有效性。接入码的值在网店系统和《网店管家》中设置,必须一致。

mType

请求类别,发货通知时,该值为“mChgStatus”。

OrderID

订单编号

sStatus

状态

成功:<rsp><result>1</result></rsp>

失败:<rsp><result>0</result><cause>拒绝原因</cause></rsp>

 

五.   客户资料同步

客户资料接口用于同步客户的积分和预存款资料。

参数

说明

uCode

接入码,用于验证请求的有效性。接入码的值在网店系统和《网店管家》中设置,必须一致。

mType

请求类别,发货通知时,该值为“mCustomerInfo”。

CustomerID

客户编号

sScores

积分

sBalance

预存款

成功:<rsp><result>1</result></rsp>

失败:<rsp><result>0</result><cause>拒绝原因</cause></rsp>

 

六.   接口测试

《网店管家》启动消息同步之前,会测试接口有效性,务必接受该消息。参数如下:

参数

说明

uCode

接入码,用于验证请求的有效性。接入码的值在网店系统和《网店管家》中设置,必须一致。

mType

请求类别,测试时,该值为“mTest”。

 

成功:<rsp><result>1</result></rsp>

失败:<rsp><result>0</result><cause>拒绝原因</cause></rsp>

 

例子

返回订单的asp例子

<%

    str = "<?xml version='1.0' encoding='gb2312'?>" & chr(13)

        str = str & "<Order>" & chr(13)

        str = str & "<Ver>1.0</Ver>" & chr(13)

        str = str & "<OrderID>a4fd5a4fda1f2a1d</OrderID>" & chr(13)

    str = str & "<DateTime>2006-06-08:12:30</DateTime>" & chr(13)

    str = str & "<BuyerID>huadog</BuyerID>" & chr(13)

    str = str & "<BuyerName>张三</BuyerName>" & chr(13)

    str = str & "<Country>中国</Country>" & chr(13)

str = str & "<Province>浙江省</Province>" & chr(13)

str = str & "<City>杭州</City>" & chr(13)

str = str & "<Town>西湖区</Town>" & chr(13)

str = str & "<Adr>文三路90号</Adr>" & chr(13)

    str = str & "<Zip>310012</Zip>" & chr(13)

    str = str & "<Email>zhangsan@163.com</Email>" & chr(13)

    str = str & "<Phone>0571-85642212</Phone>" & chr(13)

str = str & "<Total>250</Total>" & chr(13)

str = str & "<Postage>10</Postage>" & chr(13)

    str = str & "<Remark></Remark>" & chr(13)

    str = str & "<Item>" & chr(13)

        str = str & "<GoodsID>YF001</GoodsID>" & chr(13)

str = str & "<GoodsName>衣服</GoodsName>" & chr(13)

        str = str & "<Price>185.00</Price>" & chr(13)

        str = str & "<Count>1</Count>" & chr(13)

    str = str & "</Item>" & chr(13)

    str = str & "<Item>" & chr(13)

        str = str & "<GoodsID>PJ002</GoodsID>" & chr(13)

str = str & "<GoodsName>皮带</GoodsName>" & chr(13)

        str = str & "<Price>65.00</Price>" & chr(13)

        str = str & "<Count>2</Count>" & chr(13)

    str = str & "</Item>" & chr(13)

    str = str & "</Order>" & chr(13)

        Response.write str

%>

 

 

------该帖子于2010-8-6 12:32:25被作者编辑过------

------该帖子于2011-11-9 21:57:52被作者编辑过------

------该帖子于2011-11-9 22:02:44被作者编辑过------

签名
守刚毅,戒机巧
Time:2010-8-6 12:27:49 IP:115.198.222.215
huadog
头像
等级: 店铺主管 店铺主管
身份: 管理员 管理员
帖子: 2362
经验: 13408
威望: 303
称号:
注册时间: 2005-09-30
最后登陆: 2016-07-17
加为好友 消息 引用 修改 回复 2楼

100805以上版本的蜘蛛支持新接口,设置接口时,选择:

 

 

签名
守刚毅,戒机巧
Time:2010-8-6 12:30:16 IP:115.198.222.215
wubo
头像
等级: 实习生 实习生
身份: 会员 会员
帖子: 7
经验: 170
威望: 100
称号:
注册时间: 2010-03-15
最后登陆: 2016-04-11
加为好友 消息 引用 修改 回复 3楼
看不明白
签名
Time:2010-8-20 12:56:46 IP:183.0.236.206
泰州人家 微博首页
头像
等级: 助理 助理
身份: 版主 版主
帖子: 884
经验: 19263
威望: 168
称号:
注册时间: 2009-02-10
最后登陆: 2018-09-07
加为好友 消息 引用 修改 回复 4楼
哈哈,这个好啊,对独立商城来说太有帮助了,相当于管家和蜘蛛开放对外二次开发的接口了,赞一个哦~
签名
畅捷网店管家客户服务QQ群:226017712 新浪微博:http://weibo.com/cntzrj 《网店管家》爱好者淘宝帮派地址(欢迎自学):http://bangpai.taobao.com/group/1340092.htm QQ:1034619058 E-Mail:cntzrj[at]gmail.com Web:http://tzrj.taobao.com/
Time:2010-8-20 23:49:49 IP:122.193.11.56
王瑜
头像
等级: 实习生 实习生
身份: 会员 会员
帖子: 7
经验: 119
威望: 100
称号:
注册时间: 2009-09-23
最后登陆: 2015-05-28
加为好友 消息 引用 修改 回复 5楼

请问到哪里下载接口代码?

签名
Time:2010-8-21 14:43:47 IP:122.226.36.50
网店管家华南总代理 微博首页
头像
等级: 经理 经理
身份: 版主 版主
帖子: 2331
经验: 37472
威望: 661
称号:
注册时间: 2010-08-15
最后登陆: 2020-04-02
加为好友 消息 引用 修改 回复 6楼

 

赞一个!

签名
包教包会! 为您提供全方位的商品管理,采购管理,库存管理,客户管理,营销管理,员工管理等电子商务解决方案。 网店管家销售指导热线:13544208560 QQ1: 2645945112 网店管家淘宝店: http://es86.taobao.com 旺旺:衣貌倾城:灰太狼 欢迎联系我们购买。 管家爱好者QQ群: 178762760【可以加入】 淘宝网店: http://es86.taobao.com
Time:2010-9-3 8:17:48 IP:61.141.177.43
pang3675
头像
等级: 实习生 实习生
身份: 会员 会员
帖子: 3
经验: 60
威望: 100
称号:
注册时间: 2010-07-02
最后登陆: 2012-04-11
加为好友 消息 引用 修改 回复 7楼
没有下载地址啊,官方网站还是1.0的文件
签名
Time:2010-9-4 21:50:10 IP:222.133.247.155
笛佛panda 微博首页
头像
等级: 经理 经理
身份: 会员 会员
帖子: 1074
经验: 20224
威望: 1118
称号:
注册时间: 2009-04-30
最后登陆: 2013-11-13
加为好友 消息 引用 修改 回复 8楼

回复:7楼 pang3675

         这个不需要下载什么东西的,而是用户的网站建设人员根据我们上面的接口标准编写网站程序代码就可以了的。

签名
.e商部落华东商盟2群:139226170 .e商部落华南商盟2群:139767569 .e商部落华中商盟:116087513 .e商部落华北商盟:116087873 .e商部落西南商盟:116087170 .e商部落西北商盟:116086935 .e商部落东北商盟:116087324
Time:2010-9-10 8:43:24 IP:115.198.220.85
pang3675
头像
等级: 实习生 实习生
身份: 会员 会员
帖子: 3
经验: 60
威望: 100
称号:
注册时间: 2010-07-02
最后登陆: 2012-04-11
加为好友 消息 引用 修改 回复 9楼
我用的是独立网店ecshop,网点管家的网店接口spider的文件包(1.0)已经上传到ecshop的admin目录下。在网店蜘蛛中选择“标准接口”的时候,可以正常抓单,但是选择“标准接口2.0”的时候,无法抓单,请问什么原因呢?会不会存在不匹配的问题??
签名
Time:2010-9-11 14:08:26 IP:221.2.220.194
intkids
头像
等级: 实习生 实习生
身份: 会员 会员
帖子: 2
经验: 70
威望: 100
称号:
注册时间: 2010-10-26
最后登陆: 2010-11-30
加为好友 消息 引用 修改 回复 10楼

我通过1.0改写了一下 在浏览器上输入网址可正确返回XML 但是用蜘蛛抓不到 我的是ecshop 不知到谁可以解答一下

参数

说明

uCode

接入码,用于验证请求的有效性。接入码的值在网店系统和网店蜘蛛中设置。

mType

请求类别。订单查询时该值为:mGetOrder

OrderNO

订单号

还有订单下载中参数OrderNo是干什么用的?

------该帖子于2010-11-1 20:39:45被作者编辑过------

签名
Time:2010-11-1 20:39:09 IP:222.174.221.98
topit 微博首页
头像
等级: 正式员工 正式员工
身份: 会员 会员
帖子: 54
经验: 1196
威望: 104
称号:
注册时间: 2010-12-28
最后登陆: 2016-04-30
加为好友 消息 引用 修改 回复 11楼
适用于ecshop《网店管家》网络商城接口已发布,暂不免费,需要的商家可以到淘宝里拍一下:
http://item.taobao.com/auction/item_detail.htm?item_num_id=8926243518
签名
提供网店管家接口开发,需要的联系qq:40499756,顶亿ecshop开发网http://www.topit.cn
Time:2010-12-30 0:45:02 IP:123.114.36.153
zchenxi
头像
等级: 实习生 实习生
身份: 会员 会员
帖子: 2
经验: 40
威望: 100
称号:
注册时间: 2011-02-09
最后登陆: 2019-10-19
加为好友 消息 引用 修改 回复 12楼

订单下载快递方式是哪个参数?怎么没有写出来?

 

我看管家支持匹配快递的。

签名
Time:2011-3-9 8:51:15 IP:60.211.206.235
a1982
头像
等级: 实习生 实习生
身份: 会员 会员
帖子: 2
经验: 40
威望: 100
称号:
注册时间: 2011-04-26
最后登陆: 2011-04-26
加为好友 消息 引用 修改 回复 13楼
要大公司才会有人才用起这些数据。官方还是那个1.O文件,强烈要求官方免费给一下ECSHOP接口。我前期已花了几千元了。这接口还花五千,实在是无法接受。
签名
Time:2011-4-26 17:32:34 IP:113.106.101.66
睿麟
头像
等级: 实习生 实习生
身份: 会员 会员
帖子: 3
经验: 40
威望: 100
称号:
注册时间: 2011-04-06
最后登陆: 2011-05-15
加为好友 消息 引用 修改 回复 14楼

我用的shopex程序,花了5000大洋

签名
Time:2011-5-15 14:23:07 IP:219.130.60.229
蒙亮
头像
等级: 试用员工 试用员工
身份: 会员 会员
帖子: 46
经验: 686
威望: 100
称号:
注册时间: 2010-04-14
最后登陆: 2021-05-15
加为好友 消息 引用 修改 回复 15楼
管家3.0支持 shopex 和ecshop的订单抓取么?
签名
Time:2012-2-22 16:49:03 IP:116.114.51.58
luzhiwei
头像
等级: 实习生 实习生
身份: 会员 会员
帖子: 2
经验: 2
威望: 100
称号:
注册时间: 2013-07-17
最后登陆: 2013-07-17
加为好友 消息 引用 修改 回复 16楼
订单无法下载:mGetOrder返回的xml如下,各位帮我看一下xml有没有错误,谢了
<?xml version='1.0' encoding='gb2312'?><Order><OrderNO>201307179580638</OrderNO><DateTime>2013/7/17 15:30:52</DateTime><BuyerID><![CDATA[luzhiwei]]></BuyerID><BuyerName><![CDATA[luzhiwei]]></BuyerName><Country><![CDATA[中国]]></Country><Province><![CDATA[浙江省]]></Province><City><![CDATA[嘉兴市]]></City><Town><![CDATA[南湖区]]></Town><Adr><![CDATA[adssadasdasd]]></Adr><Zip></Zip><Email><![CDATA[luzw@qq.com]]></Email><Phone><![CDATA[18912341234]]></Phone><Total>159.2000</Total><Postage>0</Postage><CustomerRemark><![CDATA[]]></CustomerRemark><Remark><![CDATA[]]></Remark><Item><GoodsID><![CDATA[1001-01]]></GoodsID><GoodsName><![CDATA[测试商城数据]]></GoodsName><GoodsSpec><![CDATA[尺码:L; 颜色:黑色; ]]></GoodsSpec><Price>159.2000</Price><Count>1</Count></Item></Order>

------该帖子于2013-7-17 15:55:08被作者编辑过------

签名
Time:2013-7-17 15:52:57 IP:115.229.140.36
隶陇 微博首页
头像
等级: 实习生 实习生
身份: 会员 会员
帖子: 6
经验: 21
威望: 100
称号:
注册时间: 2013-10-30
最后登陆: 2015-10-30
加为好友 消息 引用 修改 回复 17楼

ecshop+网店管家+网店蜘蛛1.9接口已经更新到最新版,需要请联系QQ:37196213

 

商城系统为 ECshop 2.73
网店管家为企业版3.1或者3.0均可
网店蜘蛛1.9(新版本网店蜘蛛1.9整合了库存、发货同步功能,已经不需要开启管家助理了)


接口要求与网店数据打通可以实现:

1.订单抓取
2.发货同步
3.库存同步

该接口已实现,附带相关使用说明和视频教程!

案例图片为已经交易成功的截图!

该功能本人亲自开发,绝不是没有售后的盗版插件,保持持续更新到最新版!

升级内容:

1、订单抓取更新版本:

     可以抓取未付款和已付款的订单,自带订单状态标志位;

     抓取的订单内的商品包括属性规格时,可自动发送规格货品编号直接同网店管家匹配

2、库存同步更新:

     带属性规格的商品在网店管家内盘点时,可对应更新ecshop商城中对应的货品库存

3、修正网店蜘蛛1.9在抓取和同步时,误报错的问题;

------该帖子于2013-10-30 15:17:57被作者编辑过------

签名
出售:晒单功能+DIY装机大师+CPS网店联盟+服装试衣间+多货币转换+组合销售+凡客多相册放大镜 QQ:37196213+淘宝:http://37196213.taobao.com
Time:2013-10-30 15:17:07 IP:222.161.137.246
我是飞叶
头像
等级: 实习生 实习生
身份: 会员 会员
帖子: 6
经验: 6
威望: 100
称号:
注册时间: 2014-12-05
最后登陆: 2014-12-20
加为好友 消息 引用 修改 回复 18楼

*********该贴作者被锁定,内容自动屏蔽*********
签名
Time:2014-12-20 9:56:58 IP:211.136.233.161
yanggg1133
头像
等级: 实习生 实习生
身份: 会员 会员
帖子: 35
经验: 88
威望: 100
称号:
注册时间: 2014-11-07
最后登陆: 2015-07-31
加为好友 消息 引用 修改 回复 19楼

ecshop+网店管家+网店蜘蛛1.9接口已经更新到最新版,需要请联系

http://item.taobao.com/item.htm?_u=o1p5r35d48a5&id=42225281691

 

商城系统为 ECshop 2.73
网店管家为企业版3.1或者3.0均可
网店蜘蛛1.9(新版本网店蜘蛛1.9整合了库存、发货同步功能,已经不需要开启管家助理了)


接口要求与网店数据打通可以实现:

1.订单抓取
2.发货同步
3.库存同步

该接口已实现,附带相关使用说明和视频教程!

案例图片为已经交易成功的截图!

该功能本人亲自开发,绝不是没有售后的盗版插件,保持持续更新到最新版!

升级内容:

1、订单抓取更新版本:

     可以抓取未付款和已付款的订单,自带订单状态标志位;

     抓取的订单内的商品包括属性规格时,可自动发送规格货品编号直接同网店管家匹配

2、库存同步更新:

     带属性规格的商品在网店管家内盘点时,可对应更新ecshop商城中对应的货品库存

3、修正网店蜘蛛1.9在抓取和同步时,误报错的问题;

签名
Time:2015-1-24 19:41:34 IP:113.214.210.14
yanggg1133
头像
等级: 实习生 实习生
身份: 会员 会员
帖子: 35
经验: 88
威望: 100
称号:
注册时间: 2014-11-07
最后登陆: 2015-07-31
加为好友 消息 引用 修改 回复 20楼
此接口不全。而且有错误的地方

补充。
<logisticsName>发货方式 
<chargetype>结算方式方式 支付方式   原来的payAcount 其实是支付账号
<TradeNO>订单号 
<TradeStatus>订单状态

修改 
payAcount 其实是支付账号

技术支持
http://item.taobao.com/item.htm?_u=o1p5r35d48a5&id=42225281691

------该帖子于2015-1-24 19:59:18被作者编辑过------

签名
Time:2015-1-24 19:58:37 IP:113.214.210.14
[回复]
内容*
验证码* 看不清楚,点击更换 输入图片中看见的4位字符.
发表回复需要[登陆]