去哪儿酒店分销接口
接口实现功能
合作协议
去哪儿提供参数
运营商提供参数
自我游提供参数
自我游产品发布及设置
产品推送步骤
注意事项
测试环节
处理订单
订单退款
对接错误的订单查询及操作
常见问题
修改日期:20161229
修改人:语嫣
去哪儿酒店分销接口
接口实现功能
产品基础属性,价格房态同步
订单同步
****温馨提示**** :API接口受网络影响较大,会存在一定风险,请运营商时刻留意接口订单状态及订单收款,如有问题,请联系自我游公众号:自我游运营中心
合作协议
(运营商与去哪儿之间的合作协议)
去哪儿提供参数
注意事项:
运营商需要跟自我游运营部说明对接的是哪个渠道state。如果需要开通马上到店功能的,也要说明清楚。
recive_url、push_url、sign_key这3个参数是需要去哪儿测试对接成功后,才会提供给运营商。如商户还没有正式对接去哪儿(也就是商户还没有删除以前在去哪儿手工维护的酒店报价信息之前),即使去哪儿已经提供这三个参数,自我游运营部也先不要在接口上配置,以免程序将非接口对接的订单给拒绝。
运营商提供参数
提供分销商编号。【该分销商编号获取方法,参考该链接:http://kf.zowoyoo.cn/hc/kb/article/1009468/】
自我游提供参数
酒店静态数据接口URL:http://14.17.112.52:8080/qunarHotel/gzsf/hotelInfo.jsp
酒店报价接口URL:http://14.17.112.52:8080/qunarHotel/gzsf/hotelPriceInfo.jsp
变价推送URL:http://14.17.112.52:8080/qunarHotel/gzsf/hotelMovement.jsp
订单同步IP白名单地址:
14.17.112.56,112.90.153.59,14.17.112.58,112.90.153.58,183.232.79.198,
14.17.112.57,112.90.153.61,183.232.79.195,14.17.112.52,14.17.112.59,14.17.112.54
备注:以上参数运营商可以填写在去哪儿提供的“正式信息登录表”,然后再提供给去哪儿。表格的格式如下图。
自我游产品发布及设置
【合作伙伴→分销商管理】选择对接去哪儿的分销商账号,点击管理,设置接口支付方式为“授信扣除”;点击“信用授权”设置信用额度。(建议额度大一点,便于接口下单,授信不足会下单失败)
酒店产品的“销售范围”设置为允许对同行和直客销售。
产品推送步骤
去哪儿只抓取授权给他销售的产品。不想授权去哪儿销售的产品不要进行授权。
【去哪儿酒店管理】&【产品授权】&【授权TTS】
备注:“同步订单”的功能要慎用,主要是用于去哪儿的订单同步不到自我游系统的情况下才需要手动点同步。如遇到同步后订重出现重复的情况,需要取消一个订单,避免因系统对接第三方系统造成损失。目前房型的匹配如下图来设置。
产品下架或者取消授权以后,去哪儿也会及时同步下架产品
去哪儿网站客人下单和支付时会校验产品的库存
针对去哪儿分销商进行全局价格授权或者是单独的价格授权来控制在去哪儿的售价(零售价授权)
【分销全局价格授权】&【增加新的全局价格授权】【产品管理】&【分销授权】&【个别分销商价格授权】
注意事项
酒店类产品,只能由去哪儿主动抓取数据。
去哪儿TTS的酒店原理是这样:一次抓取,哪一家店铺能卖哪些酒店就缓存到他们服务器内存了,在去哪儿更新这个缓存之前,新加入的酒店怎么都无法在tts展示的,除非去哪儿再次通过“抓取酒店全量接口”来更新酒店名录的缓存
酒店全量接口,去哪儿可能是一天只来抓取一次,所以有的时候产品看起来什么问题都没有,但是在tts就是不展示;原因就在于去哪儿上一次过来抓取酒店全量接口的时候,这个酒店还没有授权tts。建议只要是想销售的酒店,都先至少有一个产品在售,方便去哪儿一次性把酒店都抓取过去。
关于对接去哪儿订单的处理逻辑:
客人下单,运营商拒单,算综合评分。
客人下单,客人担保,运营商拒单,算综合评分。
客人下单,客人担保,运营商确认,后推翻,赔偿。
客人下单,客人担保,运营商确认,运营商安排房间,后推翻,赔偿。
客人入住当天运营商推翻,赔100%;在客人入住的日期提前推翻,赔30%。
测试环节
在去哪儿官网上找到自己的产品,并下一个测试单。
处理订单
已发送、确认中:
去哪儿下单,自我游系统订单还没发通知单。订单确认:
去哪儿下单,在自我游系统给订单操作生成通知单,推送订单确认给去哪儿。自我游系统的订单是在生成通知单时才推送确认信息给去哪儿。订单拒绝
去哪儿下单,在自我游系统没有给订单生成通知单,点击“取消” ,推送订单拒绝给去哪儿。
订单退款
运营商可直接在自我游系统对去哪儿的订单进行操作。点击订单编号进去详情页面,在【去哪儿订单操作】里,点击【订单操作】,在操作类别里选择所需的操作,填写好相应信息后,点击【提交处理】。
对接错误的订单查询及操作
跟去哪儿对接的订单,如出现对接错误,可在【去哪儿酒店管理】对接绑定的页面查询。点击【进入日志管理】进入去哪儿日志管理的页面,找到相关的订单,点击【查看日记】。查看对接错误的原因,针对该错误修改后,再点击【忽略错误】即可。
常见问题
问题描述:为什么去哪儿对接到系统的酒店订单,去哪儿支付成功了,但对接到系统的订单还是“待确认”状态?
解决方法:
如果产品设置的确认方式为“人工确认”,而产品又设置了库存的情况下,会导致订单在去哪儿后台是支付成功,但是同步到自我游系统时却是“待确认”状态无法支付,过了订单支付时间就会自动取消的情况。
建议设置为“人工确认”的产品,自我游系统的产品库存就设置为0。因为去哪儿那边下单是先看库存的,如果有库存的话,不管自我游系统产品设置是人工确认还在自动确认,去哪儿都是默认自动确认,而客人下单后就直接支付了。对于自我游系统上的订单自动取消后,处理的方法如下:在订单管理里,延长支付时间,然后进订单详情界面点“重新支付”的按键即可。
问题描述:系统上的酒店产品,授权成功后,哪些产品属性是同步到去哪儿后台?
解决方法:产品标题名称、对应酒店、房型、床型、早餐会同步,预定说明不会同步。
题描述:对接去哪儿的酒店订单,能部分退款吗?
解决方法:可以,客人在去哪儿发起退款的申请,运营商可以输入部分退款的金额。
问题描述:怎么开通“马上到店”功能?
解决方法:去哪儿酒店接口增加新版本2.2,原旧版本继续使用,新版本去哪儿接口需对应去哪儿新版系统才行;
(去哪儿新版系统请咨询去哪儿方,有必要升级新系统的客户,去哪儿会在给商家从(去哪儿)旧系统迁移到(去哪儿)新系统时做视频培训),新版系统与旧版系统的区别是多了马上到店,"马上到店"的去哪儿订单,订单管理里会多出"加急处理"提示。
问题描述:当运营商在【去哪儿酒店管理】授权产品时,找不到对应的产品?但是检查了产品酒店产品相关的属性设置正确的。
解决方法:出现这个原因有可能是运营商发布产品时,选择的对应酒店里的城市、地址、电话是不对的。解决的方法是:联系自我游运营人员800008785把对应酒店的城市、地址、电话完善正确。
问题描述:当运营商在【去哪儿酒店管理】授权产品时,同步“去哪儿信息设置”时,可以批量推送吗?如下图
解决方法:目前系统只支持同一个酒店多种房型,只要推送其中某一个房型,那个该酒店所有的房型信息都会推送了。
问题描述:对接去哪儿酒店运营商在自我游系统已经确认,去哪儿还未同步状态,请问该怎么操作?(特殊订单在以下截图页面处理)
解决方法:点击订单编号进去,去哪儿订单操作选择确认有房,如图: