去啊酒店2.0分销接口
接口实现功能
合作协议
运营商申请对接
运营商提供参数
去啊酒店提供参数
自我游配置参数
自我游产品发布及设置
对接天猫店铺已发布的酒店
自我游发布新酒店到去啊
测试环节
订单退款取消
订单处理
常见问题

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

去啊酒店2.0分销接口

接口实现功能

目前只支持酒店在线支付产品。
产品有效日期、房态和价格等信息支持同步
统一控制库存支持同步
订单支持同步
取消订单支持同步

****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款，如有问题，请联系自我游公众号：自我游运营中心

合作协议

（运营商与去啊酒店之间的合作协议）

运营商申请对接

1. 运营商打开连接购买接口酒店服务，连接如下：https://fuwu.taobao.com/ser/detail.html?service_code=FW_GOODS-1000305150。

2. 注意：运营商购买过后必须在购买合同点击使用，否则接口无法上线：

3. 点击使用会直接跳转到商家系统登录页面，无须登录，提供对接的淘宝店铺名称给自我游人员，然后再通知自我游人员获取sessionkey

   
   

运营商提供参数

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

2. 运营商提供在飞猪店铺名称。
   
   
   

去啊酒店提供参数

无（由自我游运营配置）

自我游配置参数

 
该参数固定值为：(不可变动)
appkey：23606100
secretkey：1faea120d85675eb1287b7d6f0967588  
 
该参数由自我游技术获取。

自我游产品发布及设置

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

2. 酒店产品的“销售范围”设置为允许对同行和直客销售。

对接天猫店铺已发布的酒店

1. 配置对接接口前，商家已经在天猫店铺发布过酒店产品。商家需要登录天猫后台，把天猫店所有的酒店、房型、价格政策导出来，将这3份表格给自我游技术进行匹配。
   
   
   

2. 自我游技术匹配完成后。商家在自我游后台，点击【去啊酒店管理】——【价格政策匹配】，先将自我游系统的产品和天猫的价格政策匹配对应起来，看能否同步报价到天猫。
   
   

1. 通过酒店、房型名称进行搜索对应。如果自我游里面同一酒店的同一房型有好几个编码，可点击自我游产品的编号，进去可以看到价格，可选择报价有优势的产品进行匹配。
   
   
   

2. 与天猫的价格政策匹配完，点击【产品同步管理】
   点击【发布】，可【变更】直接修改天猫宝贝显示的名称。然后点击【同步】即可推送信息到天猫。 
   
   
   

自我游发布新酒店到去啊

1. 发布新酒店。 酒店是发布自我游系统上的酒店信息。

1. 
   
   
   

2. 发布新房型。房型是获取产品中与房型描述相关的信息（填写一部分信息，名称必填，默认选择第一个）。  
   
   
   
   
   
   

3. 发布新产品。

4. 
   
   
   

5. 产品信息为系统上产品的一些描述信息（发布产品后到天猫后台修改）。

6. 系统支持推送人工确认的产品到天猫售卖，商户可以自己设置默认申请房数量。（例如下图：申请房填写为3，产品库存为0时，推送给去啊酒店库存为3：如产品的库存为1时，推送给去啊的库存为1.）
   
   授权产品价格调整：进入产品价格调整  
    
   点击相关的产品进入价格调整页面，调整价格后点击同步价格 立刻同步到去啊酒店。  
    
   每天都会有自动同步，把系统设置的价格同步到去啊酒店对应的产品。
   去啊酒店多个产品管理

自我游系统一个房型对应天猫多个房型产品管理，下架产品–》发布新产品，选择别的房型就会得到多个产品，如下图  
 
价格计划只有一个，所以按上下架价格计划会一起操作几个对接产品；同步产品，上下架产品是操作对应的一个对接天猫产品（对应天猫一个房型的产品）。对应天猫那的这几个产品下单到我们系统是一个产品。  
批量上下架，批量同步属于单个对接产品操作，勾选的产品才会被操作。

测试环节

在去啊酒店官网上找到自己的产品，并下一个测试单。

订单退款取消

1. 已安排：客人在去啊酒店发起退款申请，运营商在系统退改申请中进行处理。

2. 运营商使用自我游系统开通天猫商城对接功能后，天猫商城订单直连到自我游（实现直连订单控制）。天猫下单支付，确认是否有房，有房才发货，实现灵活的库存控制，注意半个小时内确认订单，否则会自动取消订单。
   ** 注意：去啊酒店确认方式，在对接时就必须进行确认酒店订单确认方式 **
   点击待处理的进去处理订单，要确认的就确认有房，如果无房则点无房撤单。  
   取消订单处理，退款处理，这些要到天猫后台进行处理，我们后台也要对该订单处理，处理完后点击忽略错误。

3. 下单后未支付，淘宝30分钟后会自动关闭订单。

4. 下单支付 30分钟没确认订单（手动确认），淘宝会做退单处理。

5. 下单支付后，如果无房则点击取消，淘宝会关闭订单。

6. 退单退款处理，接到通知在待处理对接订单处会显示，看到待取消订单后需要到天猫后台进行（人工退单）处理。
   
   
   

订单处理

1. 人工确认订单操作流程： 客人在天猫下单–>系统下单—>天猫客人支付—>系统支付–>人工确认房（** 此步骤可以在系统操作也可以在天猫后台上确认 **）–>天猫自动发货。
   
   
   

2. 即时确认： 客人在天猫下单–>系统下单—>天猫客人支付—>系统支付–>已出票–>天猫自动发货。

3. 按生成通知单（对接供应酒店接口除外）： 客人在天猫下单–>系统下单—>天猫客人支付成功（待商家发货）—>系统待确认（支付失败）—>系统确认订单—>系统生成通知单–>天猫自动发货。

4. 严格按照通知单来：客人在天猫下单–>系统下单—>天猫客人支付成功（待商家发货）—>系统待确认（支付失败）—>系统确认订单—>人工生成通知单–>天猫自动发货 。
   注：系统指的是在自我游的管理系统； 订单状态是已安排的状态下才会去调度天猫发货，为了更快的发货可以在待处理订单进去点击确认“有房”进行发货。

5. 对接订单日志，看到要处理的订单，去天猫后台核对一下订单是否正常，如果已经确认订单天猫未发货则可以在系统【去啊酒店对接订单日志】中点击确认有房或重新执行等操作；如果天猫后台还显示待确认，则点击“确认”有房状态再次推送； 系统已经取消的订单，天猫未同步取消，也可以在这处理，点击“撤单”按钮。
   
   
   

常见问题

问题描述：

目前飞猪接口只支持针对房型推送含早或者是不含早去飞猪，假设某个房型是含早的，只能是针对房型含早，不能针对改房型设置某天或者是某段时间不含早。

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

问题描述：产品上架后又会自动下架？  
解决方式：在我们系统上下架产品，看看价格是否同步，查看日志是否有报错，如有报错及时反馈给技术处理。如果没报错，则天猫产品业务逻辑有关，详细请咨询天猫店小二。

问题描述：无法自动下架价格策略？
解决方式：在我们系统上下架产品，查看日志是否有报错，如有报错及时反馈给技术处理。如果没报错，则天猫产品业务逻辑有关，详细请咨询天猫店小二。

问题描述：发布新酒店和新房型，不能接着发布产品？
解决方式：发布新产品要在酒店和房型确认通过后才能发布，发布酒店要到天猫后台匹配、天猫店小二审核通过后在我们系统点击确认成功才算通过（房型也一样）。

问题描述：session key 时长问题
解决方式：到淘宝后台查询，如图  

 
 
如下图显示时长：  

 
问题描述：价格库存更新成功，但是天猫页面没有变化，下单还是原来的？
解决方式：更新价格库存是否一致，查看产品的价格计划

问题描述：分销商设置渠道价格？
解决方式：分销商设置的渠道价格只针对该分销商起作用，不会影响到别的分销商。

问题描述：这2个产品是同一个房型的2种不同的价格，公用1个gid，也都同步价格了，但是去啊界面只展示一个价格，是什么情况？
解决方式：先查看同一天有价格库存的，再到去啊页面对比查看。

问题描述：如果在发布酒店出现失败原因，提示Invalid session:session-not-exist ,即sessionkey不存在，如图
 
解决方式：是因为sessionkey不存在，联系自我游运营检查sessionkey

问题描述：发布酒店失败原因，如图展示
 
解决方式：上图表示没开通top2.0权限，请登录淘宝开通

问题描述：产品无法上架,提示同步价格库存失败？
解决方式：没获取到该产品的价格库存

问题描述：名字太长等问题？
解决方式：酒店名字，房型名字：30字内，产品名字，产品价格计划名字：60字内，  
注意一下不要太长就行了。

 
问题描述：修改产品授权报错， 提示定价信息不存在，如下图
 
解决方式：因为在天猫后台删除产品造成的，请重新发布产品

问题描述：去啊搜索酒店时发现产品匹配的房型不一致？
解决方式：发布新产品时注意选择房型，不要乱选。发布成功后房型就不能修改，只能是从新发布一个产品。
问题描述：产品已经同步成功，但是天猫店铺没有显示？
解决方式：找天猫店小二处理，
问题描述：去啊酒店的订单，客人离店后，店铺商家需要多久才会收到该订单的款项？
解决方式：是在订单的离店日期后第三天收到款项。
问题描述：在自我游系统上如何将产品推送到天猫店铺？  
解决方式：回复：操作步骤1）运营商登录自我游系统，“去啊酒店→酒店同步管理”，选择对应的酒店，点击发布酒店→发布酒店到天猫；这一步骤的操作只是将酒店推送到天猫店铺。 2）“去啊酒店→房型同步管理”，选择对应的酒店，将需要发布的房型输入后点击发布新房型到天猫；这一步骤的操作只是将房型推送到天猫店铺。PS：如需发布的新房型，是天猫的房型库存没有的，运营商发布后需联系淘宝小二进行审核。 3）“去啊酒店→产品同步管理”，选择对应的产品，点击同步产品，这一步骤是将产品的所有信息推送到天猫店铺。 4）产品推送到天猫店铺后，运营商需要再登录天猫后台，将该产品点击“上架”。
问题描述：如何将天猫后台的酒店跟自我游系统酒店绑定？网站：hotel.alitrip.com 点击酒店商品管理：  
解决方式：如图，把酒店房型和价格全部导出来，发送给自我游技术进行配置

问题描述：产品对接选择房型错误的解决方法  
解决方式：将该产品下架，然后在【去啊酒店管理】→选择该产品的【发布为新产品】中重新选择房型并发布。
问题描述：商家在去啊酒店同步产品到天猫经常提示价格推送失败 ，如下图 
解决方式：这是因为sessionkey过期了。一般是由于酒店应用没有在天猫上线，在天猫将应用提交上线后。商户通过链接：http://open.taobao.com/apitools/sessionPage.htm?spm=0.0.0.0.TEztdU 输入自己店铺的APPKEY，重新去获取新的sessionkey，然后发给自我游运营配置。

问题描述：如商户对接飞猪酒店想要开通订单接口，以下信息如何填写？
 
解决方式：联系自我游客服拿取订单接口参数
订单服务地址为固定的：http://14.17.112.59/channel/alitrip/alitripNewOrder.jsp
账号为：接口渠道ID-分销商ID  
密码为：该接口分销商的APIKEY