网店蜘蛛网络商城接口规范(1)
版本 1.0
最后修订 2007-01-08 LIU YI
申明 《网店管家》正式用户可以根据接口规范对自己的商城进行改造,自由使用。在未取得授权
情况下,“商城(网店)系统”开发商不得将该接口用于商业行为。 版权所有 杭州笛佛软件有限公司
《网店蜘蛛》是《网店管家》的订单采集接口程序,配合《网店管家》使用,可以实现订单的自动
采集,大大提高订单的录入效率。
《网店蜘蛛》目前可以采集ebay、淘宝以及部分网店系统的订单。该文档定义了《网店蜘蛛》和网
店系统的订单采集接口规范。
《网店蜘蛛》主动发起获取订单请求,网店系统验证请求后,返回订单信息。订单为XML格式,每次返回一个。
网店 HTTP
系统
XML 网店 蜘蛛
《网店蜘蛛》会定时向接口文件发出一个http请求。参数如下:
参数 说明
sID 接入码,用于验证请求的有效性。接入码的值在网店系统和网店蜘蛛中设置,必须一致。 sType 请求类别,获取订单时,该值为“newOrder”。
如:;sType=newOrder
接口收到请求后,验证合法性,如果接入码错误,返回:Error,否则返回订单信息。订单信息采用
XML格式,收到一个请求后返回一个订单。
为了确保订单不会重复,需要在网店系统的订单字段里面,增加一个布尔型字段,例如:
download(bool),当订单开始建立时,置成false,递交给《网店蜘蛛》后,置为true,收到订单下载请求的时候,取该值为“true”的订单返回。每次返回一个订单,当没有新订单的时候,返回:Empty。
订单格式如下:
标记 定义 说明
Ver 版本
OrderID 订单号 不能重复
DateTime 成交日期
BuyerID 买家用户名
BuyerName 买家姓名
Country 国家
Province 省/州
City 市/县
Town 区/镇
Adr 地址
Zip 邮编
Email Email
Phone 联系电话
Total 货款总额
Postage 货运费用
Remark 备注
Reserved1 预留1
Reserved2 预留2
GoodsID 库存编码
GoodsName 货品名称
Count 数量
Price 单价
Reserved3 预留3
Reserved4 预留4 一个符合规范的订单描述:
1.0
a4fd5a4fda1f2a1d
2006-06-08:12:30
huadog
张三 中国 浙江 杭州
西湖区 文三路90号 310012
zhangsan@163.com
250
10
-
YF001 GoodsID>
衣服
1.0
2
-
PJ002 GoodsID>
皮带
76.5
1
验证失败,返回错误的asp例子 <%
Response.write "Error"
%>
没有新订单的asp例子
<%
Response.write "Empty"
%>
返回订单的asp例子
<%
str = "" & chr(13)
str = str & "
" & chr(13)
str = str & "1.0" & chr(13)
str = str & "a4fd5a4fda1f2a1d" & chr(13)
str = str & "2006-06-08:12:30" & chr(13)
str = str & "huadog" & chr(13)
str = str & "张三" & chr(13)
str = str & "中国" & chr(13)
str = str & "浙江省" & chr(13)
str = str & "杭州" & chr(13)
str = str & "西湖区" & chr(13)
str = str & "文三路90号" & chr(13)
str = str & "310012" & chr(13)
str = str & "zhangsan@163.com" & chr(13)
str = str & "" & chr(13)
str = str & "250" & chr(13)
str = str & "< Postage>10" & chr(13)
str = str & "" & chr(13)
str = str & "" & chr(13)
str = str & "" & chr(13)
str = str & "- " & chr(13)
str = str & "YF001" & chr(13)
str = str & "衣服" & chr(13)
str = str & "185.00" & chr(13)
str = str & "1" & chr(13)
str = str & "" & chr(13)
str = str & "" & chr(13)
str = str & "
" & chr(13)
str = str & "- " & chr(13)
str = str & "PJ002" & chr(13)
str = str & "皮带" & chr(13)
str = str & "65.00" & chr(13)
str = str & "2" & chr(13)
str = str & "" & chr(13)
str = str & "" & chr(13)
str = str & "
" & chr(13)
str = str & "" & chr(13)
Response.write str
%>