订单消息服务介绍
我们提供了消息推送服务,可以让交易数据通过消息实时通知到开发者,帮助引导成交应用的开发者做售后服务,个性化营销推荐等,同时也可以让消费者在对应APP渠道查看自己的订单列表。在使用上,百川项目的第三方app可以直接通过在消息后台订阅相关消息,从而获取订单基本信息(比如主订单Id、订单状态、购买者混淆nick、宝贝标题、宝贝id、宝贝图片以及实际付款等)。
在客户端SDK中,唤起淘宝详情页的方法中,还支持isv_code入参(只支持数字和英文,不多于50个字符,不要用特殊字符),通过客户端SDK成交的交易订单,消息通知中还可以获取到这个isv_code。具体传入方法参考文档:
客户端SDK使用说明 。
前置条件
使用百川客户端SDK功能,在百川SDK内唤起的淘宝商品详情页并下单产生的订单。
订单相关的消息
1、taobao_tae_BaichuanTradeCreated
创建订单消息(下单未付款),订单状态(order_status)是7
2、taobao_tae_BaichuanTradeSuccess
交易成功消息(确认收货后),订单状态(order_status)是6
3、taobao_tae_BaichuanTradeRefundCreated
买家点击退款按钮后促发
4、taobao_tae_BaichuanTradeRefundSuccess
退款成功,没有订单状态
5、taobao_tae_BaichuanTradePaidDone
付款成功(下单已付款),订单状态(order_status)是2
6、taobao_tae_BaichuanTradeClosed
交易关闭(包括退款后交易关闭和创建订单后交易关闭),order_status为4是退款后交易关闭,order_status为8是创建订单后交易关闭
使用说明
权限申请
目前跟订单消息相关的权限包都位于”高级电商能力”增值权限包内,要订阅商品变更相关的消息,首先请在应用管理后台申请该增值权限包。
订阅淘宝消息
可以在分类中选择“导购平台”快速筛选消息
点击消息名称,就能查看具体的返回信息字段
返回数据实例
付款成功:
{"buyer_id":"AAE8g3trABpL86adzOb7d948","extre":"","paid_fee":"0.02","order_id":"887450175487518","order_status":"2","auction_infos":[{"detail_order_id":"887450175497518","auction_id":"AAH3g3toABpL86adzOzgP5-G","auction_pict_url":"i1/TB1YZ_QGVXXXXcmXVXXXXXXXXXX_!!0-item_pic.jpg","auction_title":"0s-女装-发货合约8hrs-测试宝贝-拍下无效","auction_amount":"2"},{"detail_order_id":"887450175507518","auction_id":"AAH3g3toABpL86adzOzgP5-G","auction_pict_url":"i1/TB1YZ_QGVXXXXcmXVXXXXXXXXXX_!!0-item_pic.jpg","auction_title":"0s-女装-发货合约8hrs-测试宝贝-拍下无效","auction_amount":"2"}]}
创建订单:
{"buyer_id":"AAFDg3trABpL86adzOb7GpFt","extre":"","paid_fee":"1333332.00","order_id":"887450175256640","order_status":"7","auction_infos":[{"detail_order_id":"887450175256640","auction_id":"AAFAg3toABpL86adzO6Hh49u","auction_pict_url":"i1/263660307/TB2dM.OapXXXXaoXXXXXXXXXXXX_!!263660307.jpg","auction_title":"自动化测试宝贝不要改不要买","auction_amount":"2"}]}
交易成功:
{"buyer_id":"AAGwg3trABpL86adzObh0qil","extre":"","paid_fee":"503.88","order_id":"814255897503474","order_status":"6","auction_infos":[{"detail_order_id":"814255897513474","auction_id":"AAGag3toABpL86adzO43mH-X","auction_pict_url":"i3/TB1bG_fGpXXXXbwXpXXXXXXXXXX_!!0-item_pic.jpg","auction_title":"软妹子 纯白钉珠毛绒上衣","auction_amount":"2"},{"detail_order_id":"814255897523474","auction_id":"AAEJg3toABpL86adzO9yUatl","auction_pict_url":"i4/TB1S9kQGXXXXXXUXXXXXXXXXXXX_!!0-item_pic.jpg","auction_title":"睫毛蕾丝衫","auction_amount":"2"}]}
退款成功:
{"buyer_id":"AAE8g3trABpL86adzOb7d948","refund_id":"39347310141875","refund_fee":"0.01","extre":"{}","oid":"891474117497518","tid":"891474117517518","seller_nick":"c测试账号85"}
交易关闭:
{"buyer_id":"AE8g3trABpL86adzOb7d268","extre":"","paid_fee":"1817.00","order_id":"876888661036832","is_eticket":false,"order_status":"4","auction_infos":[{"auction_id":"1","detail_order_id":"876888661046832","auction_pict_url":"i3/T1q2uAXftIXXXXXXXX-50-50.png","auction_title":"配送服务","auction_amount":"13"},{"auction_id":"2","detail_order_id":"876888661056832","auction_pict_url":"i2/T1lvuAXghIXXXXXXXX-50-50.png","auction_title":"搬楼服务","auction_amount":"13"},{"auction_id":"3","detail_order_id":"876888661066832","auction_pict_url":"i4/T1OLuAXc4IXXXXXXXX-50-50.png","auction_title":"安装服务","auction_amount":"13"},{"auction_id":"36391354501","detail_order_id":"876888661076832","auction_pict_url":"i1/TB1.xFGFVXXXXaLaXXXXXXXXXXX_!!0-item_pic.jpg","auction_title":"翡戈家具客厅简约现代全橡木实木功夫茶几大理石茶几配电视柜包邮","auction_amount":"13"}]}
返回值:buyer_id、paid_fee、order_id、order_status、auction_id(商品混淆ID)、auction_title、auction_pict_url、topic、detail_order_id(子订单号)、auction_amount(商品数量)
注意:其中商品图片需要拼接上CDN地址:http://img02.taobaocdn.com/bao/uploaded/
商品消息服务介绍
商品信息更新通知服务主要用于当商品信息发生变更时,通过消息通道通知给订阅此消息的开发者。
由于商品每个字段的变更源于不同的消息源头和时间,所以商品信息变更的消息内,即可能包含所有相关的变更字段,也可能只包含某一个字段。
例如商品价格和状态同时变更,接收到的消息,可能是一条:
{"auction_change_info":"{"itemStatus":"-1","itemPrice":"99900"}","open_iid":"AAG2vgyDV4MXr_m2Lly9mzGD"}
也可能是两条分别包含状态和价格的消息:
{"auction_change_info":"{"itemStatus":"-1"}","open_iid":"AAG2vgyDV4MXr_m2Lly9mzGD"} ;{"auction_change_info":"{"itemPrice":"99900"}","open_iid":"AAG2vgyDV4MXr_m2Lly9mzGD"} ;
前置条件
2、如果不是通过选品中心获取的商品,可以通过TOP接口(taobao.iselect.tae.itempool.change)添加了相关商品变更的监控;
商品相关的消息
1、taobao_tae_BaichuanAuctionChange 商品变更消息
使用说明
权限申请
目前跟商品变更消息相关的权限包都位于”高级电商能力”增值权限包内,要订阅商品变更相关的消息,首先请在应用管理后台申请该增值权限包。
订阅From淘宝消息
可以在分类中选择“导购平台”快速筛选消息
点击消息名称,就能查看具体的返回信息字段。

代码实现详见消息推送的代码实现
返回数据实例
{"auction_change_info":"{"itemStatus":"-1"}","open_iid":"AAG2vgyDV4MXr_m2Lly9mzGD"}
{"auction_change_info":"{\"itemDiscountPrice\":\"128000\",\"itemDiscountWapPrice\":\"138000\",\"itemOriginalPrice\":\"128000\",\"itemPrice\":\"128000\",\"itemPriceAll\":\"itemDiscountPrice:128000itemOriginalPrice:128000itemDiscountWapPrice:138000\"}","open_iid":"AAEgjH6AACJzn7XZkcyWnroh"}, time=Tue Jan 12 10:26:07 CST 2016, nick=null, userid=null, __kind=3, dataid=526150942342, publisher=12497914},properties:{topic=taobao_tae_BaichuanAuctionChange, QUEUEIDS=52778, time=1452565567018, WAIT=true, dataid=526150942342, traceid=07mOAuSK8gx}
{"auction_change_info":"{"itemPic":"i2/TB15o2.HFXXXXcbaXXXXXXXXXXX_!!0-item_pic.jpg"}","open_iid":"AAG2vgyDV4MXr_m2Lly9mzGD"}
{"auction_change_info":"{"itemTitle":"变了之后的标题"}","open_iid":"AAG2vgyDV4MXr_m2Lly9mzGD"}
topic:taobao_tae_BaichuanAuctionChange
其中,auction_change_info对应的是一个由Map转换为的json串,key:itemStatus表示 商品状态,对应的value有两个:-1(商品状态不可用)和1(商品状态可用);
key:itemPrice表示商品的最优惠价格(不同身份的买家看到的价格可能不同,这里是最优惠的一种价格),value是变更后的价格,单位分;
key:itemPic表示商品变更后的主图地址;
key:itemTitle表示商品变更后的标题;
目前key包含itemStatus、itemPrice、itemPic和itemTitle,后续会继续添加。
FAQ
isv_code