阿里旅行度假直连分销接口
接口实现功能
对接前提条件
合作协议
天猫系统提供参数
运营商提供参数
天猫系统设置及操作
自我游产品发布及设置
产品推送步骤
测试环节
处理订单
订单退款
常见问题

修改日期：20170222
 修改人：张语嫣

阿里旅行度假直连分销接口

接口实现功能

1. 目前只支持在线支付的团队线路产品和打包产品的套餐或联票。

2. 产品库存（包含产品有效日期、房态和价格等信息）到天猫商城，天猫商城订单直连到B2B系统。

3. 统一控制库存(天猫下单支付，有库存才发货，实现灵活的库存控制)，注意半个小时内确认订单，否则会自动取消订单。
   ****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款，如有问题，请联系自我游公众号：自我游运营中心

对接前提条件

     运营商淘宝店铺必须是B店才能进行对接，解释如下：

      淘宝B店是指淘宝商城，B2C   。B店需要是公司认证账户才可以呢开店，也就是说B店是针对公司企业。

      淘宝C店是指集市店，C2C。C店只要是个人都能注册认证开店的。

1. 运营商必须拥有淘宝天猫店铺(申请开通度假类目权限)，并提供对接参数配置的相关信息(如：天猫店的网址，服务商所在地/详细地址，客服旺旺，客服邮箱，客服电话，服务商简介 )给自我游运营部。

2. 运营商等待天猫店小二审核通过对接权限。

3. 商户自己申请创建应用：商家入驻去啊平台–>成为开发者–>创建引用（选度假）–>发布上线–>把app应用参数给自我游配置即可。

4. 对接有强制要求订阅的消息服务。如不订阅，接口将无法正常使用。订阅消息服务，淘宝会收取相关费用。此费用与自我游无关。

5. 运营商将要对接的产品发给有天猫商城的分销商，分销商通过接口发布到天猫商城产品。

合作协议

（运营商与天猫之间的合作协议）

天猫系统提供参数

无

运营商提供参数

1. 在天猫后台获取应用id、应用密码及临时key；获取方法参考该文档的【天猫系统设置及操作】这一章节。
   

2. 提供店铺名称、店铺旺旺号及联系电话。
   
   

3. 提供分销商编号和APIkey。【该分销商编号获取方法，参考该链接：http://kf.zowoyoo.cn/hc/kb/article/1009468/】

天猫系统设置及操作

1. 运营商自己申请入驻阿里旅行度假，申请对接权限店铺具备接入条件，申请度假对接审核通过。

2. 商户登陆天猫对接接口地址：http://open.taobao.com/business.htm?spm=a219a.7629065.1.13.ZRzEb2&cid=10

3. 点击登陆，选择【控制台】，填写申请开发者的相关资料。
   

4. 创建应用选择开发者中心，创建应用，填写应用内容。
   
   
    
   
   进入第四步，点击安全扫描即可。
   
   应用需要提交上线。

5. 申请sesionkey：获取sessionkey地址 http://open.taobao.com/apitools/sessionPage.htm?spm=0.0.0.0.TEztdU  。运营商使用主账户登陆后，把appkey填入登陆授权，把返回的页面session复制给客服配置。
   
   
   

6. 白名单添加ip地址：联系自我游运营部提供ip地址，然后运营将自我游的ip地址在此处添加。
   
   

7. 订阅服务，在应用选择消息服务，在订阅消息那选择订阅消息。具体是下面这几个消息订阅的消息服务：
   消息名称                      中文名称                               消息类型×    状态    操作
   taobao_trade_TradeCreate    创建淘宝交易消息                       From 淘宝    已订阅          取消订阅
   taobao_trade_TradeClose        关闭交易消息                           From 淘宝    已订阅      取消订阅
   taobao_trade_TradeBuyerPay    买家付完款，或万人团买家付完尾款    From 淘宝    已订阅      取消订阅
   taobao_trade_TradeSuccess    交易成功消息                           From 淘宝    已订阅          取消订阅
   taobao_refund_RefundCreated    退款创建消息                          From 淘宝    已订阅      取消订阅
   taobao_refund_RefundClosed    退款关闭消息                          From 淘宝    已订阅      取消订阅
   taobao_refund_RefundSuccess    退款成功消息                           From 淘宝    已订阅      取消订阅
   
   订阅完成之后，在【我的消息】看看订阅是否准确。订阅消息服务，淘宝会根据订阅内容收取费用。为避免产生过多的费用，请订阅要求的消息服务即可，其余的消息不要订阅。
   

自我游产品发布及设置

1. 【合作伙伴→分销商管理】点击管理，设置接口支付方式为“授信扣除”；点击“信用授权”设置信用额度。（建议额度大一点，便于接口下单，授信不足会下单失败）

2. 发布线路产品时，产品必须设置目的地以及行程细化。
   

3. 发布打包产品–套餐或联票时，产品必须设置主图。上传的图片，尺寸不能大于400*400，否则会推送失败。图片支持png、jpg、gif格式,3M以内。
   

产品推送步骤

1. 【阿里旅行度假管理】找到对应的店铺，点击“产品授权管理”进行产品推送。
   

2. 产品的推送分为两种情况：新产品 和 店铺已有的产品
   情况一，新产品的推送步骤：点击授权产品→ 同步价格库存。
   
    
   情况二，店铺已有产品的推送步骤：登陆天猫外网获取天猫的产品ID→ 登录自我游系统点击“产品绑定”→ 同步价格库存。
   
   
   在天猫店铺外网获取到天猫产品ID后，再
   
   

3. 
   

   
   

4. 产品下线的设置，找到对应的已授权的产品，点击“取消授权”，会把天猫店铺对应的产品下架。
   

测试环节

在天猫店铺找到自己的产品，并下一个测试单。

处理订单

1. 订单对接流程：客人在天猫商城预订支付→自游云系统3分钟一次抓取天猫订单信息→抓到订单后自动在自我游系统进行下单支付。

2. 有库存可以出行，运营商在自我游系统给订单操作生成通知单后，再到天猫后台给订单操作发货。

订单退款

1. 如有订单需退款，运营商需先在自我游系统操作退款后，再到天猫后台给订单处理退款。

常见问题

问题描述：订单出现异常？  
解决方法：通过点击“查看详细的接口日志”可以查看本订单的日志 ，查看错误并处理。

问题描述：商家在阿里旅行度假管家页面授权产品时提示：

解决方法：是因商家在天猫的应用没有上线导致sesionkey过期；把http://open.taobao.com/apitools/sessionPage.htm?spm=0.0.0.0.TEztdU
链接发给商户输入应用id重新获取新的sesionkey给自我游配置。