去哪儿酒+景分销接口文档
接口实现功能
合作协议
去哪儿系统提供参数
运营商提供参数
去哪儿系统设置及操作
自我游产品发布及设置
产品推送步骤
测试环节
处理订单
订单退款
常见问题
修改日期:20161229
修改人:张语嫣
去哪儿酒+景分销接口文档
接口实现功能
订单同步
产品属性同步
产品价格、库存同步
核销同步
退款同步
目前该接口只支持两天一晚、并只能是由一个景点+一个酒店(其中一个房型)组合的套餐。
****温馨提示**** :API接口受网络影响较大,会存在一定风险,请运营商时刻留意接口订单状态及订单收款,如有问题,请联系自我游公众号:自我游运营中心
合作协议
(运营商与去哪儿之间签订的合作协议)
去哪儿系统提供参数
运营商提供参数
运营商提供在去哪儿的店铺名称。
提供分销商编号。【该分销商编号获取方法,参考该链接:http://kf.zowoyoo.cn/hc/kb/article/1009468/】
去哪儿系统设置及操作
自我游推送产品到去哪儿后台,需要运营商手工上架产品。
自我游产品发布及设置
【合作伙伴→分销商管理】点击管理,设置接口支付方式为“授信扣除”;点击“信用授权”设置信用额度。(建议额度大一点,便于接口下单,授信不足会下单失败)
产品发布:运营商必须要在自我游系统上分别发布一个单门票和一个单酒店房型的产品,再使用【产品打包管理】-【套餐或联票】将这2个产品打包组合成套餐 (目前不支持自由行产品授权),如图:
景+酒的套餐产品里只能是一个景点和一个酒店的组合套餐,不允许出现多个景点和多个酒店的情况;另外增加套餐产品时需重视填写门票的包含数量和酒店晚数(PS:目前只支持两天一晚),如图:
产品属性设置–打包的门票产品、酒店产品及产品打包后的销售范围必选为“允许对直客销售的产品”
费用包含、退款说明及使用说明 三项必填,如图:
产品详细描述-正文中图像 必设置,如图:景点图片要求:上传优质清晰,限2M以下,仅限一张,建议尺寸640*426,格式为jpg、gif、png、bmp。
产品推送步骤
产品授权
运营商在自我游系统的【去哪儿酒+景管理】对接绑定的页面,点击【产品授权】,如图:【去哪儿酒+景】产品管理的页面,选择需要授权的产品,点击【授权酒+景】,如图:会跳出提示授权酒+景成功!说明已授权成功,去哪儿方可抓取到该产品,如需要取消授权点击“取消授权即可”。
当产品第一次授权或产品属性有改动,比如价格库存之类的有变动时,运营商需要点击【接口同步数据】通知去哪儿更新产品的最新属性,如图:
授权的产品–注意事项
产品市场价为0,去哪儿不抓取。
景+酒的套餐产品里只能是一个景点和一个酒店的组合套餐,不允许出现多个景点和多个酒店的情况,目前不支持自由行产品授权,只支持打包产品套餐。
去哪儿不支持增值项目。
系统产品下架或者取消授权,会及时同步到去哪儿系统。
自我游系统产品设置“订单确认方式”选择为“人工确认”、如图:但客人在去哪儿预订下单后还是可以正常支付订单,即不受限于自我游系统“人工确认”设置的限制。因此运营商以客人在去哪儿下单的时间为准,必须要在2个小时内给订单进行操作确认,否则去哪儿会自动退款给客人。
测试环节
在去哪儿官网上找到自己的产品,并下一个测试单。
处理订单
跟去哪儿对接的订单,如出现对接错误,可在【去哪儿酒+景管理】对接绑定的页面查询,点击【进入日志管理】进入去哪儿日志管理的页面,找到相关的订单,点击【查看日记】。查看对接错误的原因,针对该错误及时修改,避免产品处罚下架。
订单退款
常见问题
1. 问题描述:订单出现异常?
解决方法:通过点击“查看详细的接口日志”可以查看本订单的日志 ,查看错误并处理
2. 问题描述 :【去哪儿酒+景管理】给产品点击“接口同步数据”提示:酒店信息聚合失败,如图:
解决方法:在自我游系统检查该酒店的酒店名称、房型名称、酒店地址及城市的设置是否跟去哪儿网站显示的一致。
3. 问题描述:商户对接去哪儿景+酒,在去哪儿系统抓取产品信息,产品状态抓取过后显示的是下架状态,但在自我游系统中产品是正常的上架状态,推送到去哪儿也是成功的,这个是什么原因?如图
原因:在去哪儿后台将门票产品和景酒产品设定“已上锁”状态,在去哪儿后台过了日期会自动下架(如图),此时自我游后台上架重推送也是无法让产品再去哪儿上架的
解决方法:先将去哪儿后台产品解锁,然后到自我游后台重新推送
4. 问题描述:对接去哪儿景+酒的,如果酒店产品设置为人工确认的话,游客下单订单会怎样显示?
解决方法:不管这个酒店产品设置的是不是人工确认,游客在去哪儿下单还在可以支付订单,订单到自我游系统中,运营商需要在2小时内确认酒店房,如两小时不确认订单的话,订单会自动取消掉。