去哪儿门票供应接口 - 广州自我游 - 自我游客户支持服务平台

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

特别说明

采购去哪儿系统的产品再对接到抖音抖音/美团/飞猪/快手等渠道进行分销，订单退改申请，商家必须按时处理。目前对接所有第三方渠道（包括但不限于抖音/美团/飞猪/快手等，及未来新增加的渠道），客人发起退改申请，超过要求的期限商家未处理，第三方会直接退款给客人。如因商家逾期未处理造成损失，由商家承担，自我游不承担责任。
商家每天应登录自我游系统查看订单退改申请列表，及时联系供应商处理订单退改。
目前已知的退改时限（客人发起推该请求算起），抖音72小时，美团24小时，去哪儿24小时，飞猪24小时（部分景区产品飞猪是按即时退款执行）。
关于退改时限要求会有调整，请以各平台官方通告为准。

接口实现功能

下单（是在下达通知单时才下单到去哪儿门票供应系统）
取消订单（支持）
查看去哪儿供应系统订单详细（支持）
查看订单日志（支持）
重复发码（不支持）
接口返码（支持）
自动核销验证（去哪儿推送核销状态）
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心

合作协议

（运营商与去哪儿之间的合作协议）

去哪儿提供参数

00158c7a95328d99bafdaad889a1759

去哪儿技术配置回调地址

出票通知推送的地址：

http://运营商域名/api/qunar/printTicket.jsp

退款审核结果推送的地址：

http://运营商域名/api/qunar/refundOrderReturn.jsp

返码推送的地址：

http://运营商域名/api/qunar/syncCode.jsp

消费推送的地址：

http://运营商域名/api/qunar/finish.jsp

运营商提供参数

Ip地址列表：
114.17.112.54
14.17.112.56/112.90.153.59/183.232.79.196
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.59
14.17.112.50

运营商需知

去哪儿门票供应接口为分二种：

“自设价格”接口：即运营商发布产品时，需要自己设置价格与库存，分销商下单就按运营商设置的价格支付。但是去哪儿的产品价格发生变化后需要运营商手动及时更改自我游系统的产品价格，要不然就会导致订单的价格与去哪儿的价格不一致的错误。
“去哪儿价格”接口：会引用去哪儿门票系统的采购价，在客人下单前会抓取去哪儿的最新价格，不会出现订单价格错误的情况，但是不利于设置分销价和零售价。需要通过价格规则进行设置。

自我游系统发布及设置

运营商给去哪儿接口开一个供应商账号，用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通，参考该链接： http://kf.zowoyoo.cn/hc/kb/article/191732/】
产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到去哪儿。
发布产品的时候，客人必填信息需要选择“姓名”、“手机号码”、“身份证号码”。
1. 对应接口：选择自我游配置的接口【去哪儿门票供应接口】（由自我游配置好接口后才会显示）。
产品编码：即去哪儿门票供应的“产品ID”，运营商获取“产品ID”可点击“接口产品编号参考”进行参考，方法是先查出对应景点名称，然后再点击景区名称的链接查询景点的产品列表。
产品短信：产品可以不用设置预订成功等短信，客人下单支付成功后会下达到去哪儿门票供应系统，客人就会收到去哪儿门票供应系统那边发送的信息。
系统【产品管理】→【价格及库存】设置价格。
价格也可以在【接口产品编码参考】进行参考。

测试环节

使用分销商账号进行下单并支付。

订单退款

订单状态“已出票”：客人/分销商系统发起退改申请，自我游系统会自动将退改申请请求推送到去哪儿系统，如存在自动推送退改申请请求到去哪儿系统失败的情况，运营商需在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到去哪儿系统，去哪儿系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。去哪儿系统返回取消成功后，自我游系统的订单直接显示“撤单”。

订单状态“已完成”：客人/分销商系统先线下联系运营商，然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到去哪儿系统。然后去哪儿系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。去哪儿系统返回取消成功后，自我游系统的订单直接显示“撤单”。