去哪儿门票分销接口

自我游发表于:2017年01月20日 14:08:22更新于:2024年07月02日 11:46:09

去哪儿门票分销接口
接口实现功能

合作协议
去哪儿系统提供参数
运营商提供的参数
自我游品发布及设置
产品推送步骤
去哪儿系统设置及操作
测试环节
订单退款

订单状

常见问题

对文档有任何疑问,请咨询微信公众号【自我游运营中心】


接口实现功能

接口订单同步
产品价格与库存同步
产品退改属性说明信息同步
温馨提示 :API接口受网络影响较大,会存在一定风险,请运营商时刻留意接口订单状态及订单收款,如有问题,请联系自我游公众号:自我游运营中心


合作协议

(运营商与去哪儿之间的合作协议)


去哪儿系统提供参数

①sign_key: 秘匙
②user_id:用户名
③toBortoC:B端还是C端(B端是指同行,C端是指直客,该参数必须与去哪儿配置一致)

获取以上参数后,发送到微信公众号【自我游运营中心】走流程配置相关接口,接口配置完成后开通【去哪儿门票管理】功能,如无相关功能可联系微信公众号【自我游运营中心】。


运营商提供的参数

提供分销商编号。

【该分销商编号获取方法,参考该链接:http://kf.zowoyoo.cn/hc/kb/article/1009468/


自我游产品发布及设置

①分销商相关设置

【合作伙伴→分销商管理】点击管理,设置接口支付方式为“授信扣除”;

点击“信用授权”设置信用额度。(建议额度大一点,便于接口下单,授信不足会下单失败)


②发布产品

选择【门票(电子票)】类目

注意:去哪儿不支持需要快递的产品, 去哪儿不支持增值项目。
image.png

订单确认方式:必须设置自动确认。
image.png

有效期设置:

【游客选定的游玩日期当天有效】:日历票产品

【游客预定日期延后x天有效】:期票产品。(注意:期票产品去哪儿是不传游玩日期的,这样会导致有些产品获取不到价格,所以期票不要设置特定日期价格。因为在价格规则设置那里是按取最大排序的第一条价格规则去计算游玩日期的)

image.png

退款设置:

情况一:去哪儿产品设置【不退款】

该设置去哪儿游客不能直接退款,如要退款请联系运营商操作退款。但是选择自动锁定订单,如果不使用自我游验证系统或者二维码设备验证订单,容易造成漏单。
image.pngimage.png

情况二:去哪儿产品设置为【可自动退款】
退款设置及通知单生成控制的设置,如下图所示:在运营商没有手工生成通知单都可随时退单。
image.pngimage.png
退款设置,如下图所示:在订单已生成通知单后,并处于退款规则内,支持去哪儿客人申请退改,超过退改申请时间,就不能再发起申请。

image.png


image.png

销售范围设置:必须设置【对同行和直客】
image.png

产品价格库存:

注意:价格库存必须填写完整

image.png

image.png

上架产品:

image.png


产品推送步骤

需要在去哪儿进行销售的产品,必须完成产品授权步骤,去哪儿只抓取授权给他销售的产品。

注意:

①不想授权去哪儿销售的产品不要进行授权

②产品下架或者取消授权以后,去哪儿也会及时同步下架产品

推送顺序:产品授权→授权产品→接口同步数据


image.png

产品需要设置返现,如无需请忽略:
0015881dcde1fde68edb4af01b08240

点击授权B2C
0015881dd2251d0a673bcf031e173f2

产品返码类型,根据产品具体情况,设置对应的返码类型:
0015881dd654d70855016ec4351da1a

点击接口同步数据:

注意:后期自我游产品价格库存发生变更,需要点击【接口同步数据】同步相关信息给去哪儿。
0015881ddbd79399d2592bb5b23bfc0

门票产品的票种是期票:在去哪儿门票授权的界面,有个【期票本地价格同步】按钮。该功能用于运营商将已授权的期票产品的价格修改后,需要先点击【期票本地价格同步】,再点击【接口同步数据】。
0015881ddd74fe73a026cd13ff6f0eb


去哪儿系统设置及操作

运营商在去哪儿后台检查产品上架状态

①成功对接的产品,在【上架中的产品】查看,需要运营商到去哪儿后台给这个产品挂对应的票种,在进行上架。

②失败对接的产品,在【待审核的产品】查看,点击查看失败原因,直接联系去哪儿运营。


测试环节

在去哪儿官网上找到自己的产品,并下一个测试单。


订单退款

去哪儿退款申请在平台规定时间内处理,如逾期未处理造成损失,自行承担。

自营订单退款处理


①如接口要求自营产品需要人工审核,客人在去哪儿发起退款申请,自我游商户必须在自我游系统【退改申请处理】,点击【处理】。自我游商户请勿对订单做异常处理,此操作退款状态是无法同步到去哪儿。
②如产品有设置退款规则:客人发起退款申请时,系统会自动抓取退款规则,符合规则就无需审核,直接退款。

对接第三方供应商系统的订单退款处理


①客人在去哪儿发起退款申请,该订单对接的供应商接口还没升级自动推送退款请求,自我游商户需在自我游系统针对订单操作“异常处理”,选择“允许取消”保存后,再点击“退款”。接口自动将退款信息推送给供应商,等供应商返回退款处理结果。(退改申请处理里暂时不要进行任何操作,避免出现赔付) ,供应商同意退款,运营商再回到自我游【退改申请处理】,点击【处理】“同意取消”。若供应商拒绝退款,点击“拒绝取消”。状态会直接同步到去哪儿。

②该订单对接的供应商接口还没升级自动推送退款请求,商户想实现自动推送退款请求给到供应商接口,自我游系统产品可设置退款规则,客人发起退款申请时,自我游系统会自动将退款请求推送给供应商接口,等供应商返回退款处理结果。自我游会将“同意”或“拒绝”状态推送给去哪儿。PS:该设置以实际下单退款后结果为准,因不是所有供应商接口都支持,在设置之后下单测试后产品再上线。

③客人在抖音发起退款申请,该订单对接的供应商接口可实现自动推送退款请求,接口自动将退款信息推送给供应商,等供应商返回退款处理结果。(退改申请处理里暂时不要进行任何操作) ,等供应商返回“同意退款”或“拒绝退款”状态给自我游,自我游再推送给抖音。


订单状态

对接错误的订单查询及操作
【去哪儿门票管理】→【进入日志管理】→【查看日记】。
查看对接错误的原因,针对该错误修改后,再点击【忽略错误】即可。

image.png


常见问题

Q1:去哪儿发现类似“创建订单异常,库存不足”“您选的产品价格已发生变化,价格不一致”等信息同步类问题。
A:检查自我游产品是否调整产品价格库存,调整后需点击【接口同步数据】按钮。

0015881ddbd79399d2592bb5b23bfc0

 
Q2:运营商在去哪儿门票管理界面对产品授权给去哪儿同步结果返回:供应商返回产品信息为空
0015881de51c55bf2f3b01a320dfc39
A:①运营商提供的对接参数有误,需联系去哪儿核实参数后联系微信公众号【自我游运营中心】进行修改参数

②检查产品是否设置为人工确认。


Q3:关于产品“出票快”的设置
解决方法:分为两种情况:产品是否有对接供应商系统接口
第一种情况,没有对接供应商接口的产品,又分为2种:

前提是产品需要设置发送短信,产品的通知单生成设控制选择第三项“自动锁定订单,无需生成通知单”。出票操作要选择为“需要“(备注:出票短信可不设置,建议设置预定成功短信)。另外当有订单生成时,运营商必须给订单点击“出票”操作。这个点击“出票”的操作时间早与晚都不会有影响产品的出票快。
0015881de69a166f35628eb3e2cb740

前提是产品无需发送短信,产品的通知单生成设控制选择第三项“自动锁定订单,无需生成通知单”。出票操作可选择“需要“或“不需要”,但必须要给【供应商管理】的产品对应的供应商的核销验证设置勾选验证方式。优先的验证方式为:验证码password>手机号>订单号>身份证。
产品设置如下图所示:
0015881de7fa0c98eef2db8736121e5

在【供应商管理】给产品对应的供应商设置的“核销验证配置”,如下图所示:
0015881debdcc0640d776b9b39fdb21  
0015881ded5d7c399d2320d71c0aeaf  
第二种情况,对接供应商系统接口的产品,即供应商系统有返回码即可。如对接长隆系统。

对接供应商接口的产品,必须要供应商系统有验证码返回才可操作“出票快”。供应商接口没有验证码返回的无法实现出票快。
打包产品、串货产品不支持实现出票快。

当天该产品的第一个订单,符合出票快的条件后,需要等到第二天去哪儿才会显示“出票快”,打包的产品不支持出票快。

针对一些产品是对接第三方的系统,可能是网络原因造成下单失败或者是对方系统没能及时返回码(3分钟内),都不能显示出票快。特别是针对翼码对接的,翼码出票延迟时间超过3分钟的可能性大,可能会导致无法“出票快”

酷码(自我游码机验证)或者使用自我游pc端的password验证的产品,可以保证会满足“出票快”需求 。


Q4:系统后台产品修改后数据同步到去哪儿需要多长时间?

A:价格是客人在去哪儿预定时马上抓取的;

产品内容修改去哪儿那边是一小时同步一次,如果急的话,可以到去哪儿后台手动修改。


Q5:去哪儿失败订单中提示:选购产品不存在
A:很多情况下是由于自我游已经上线的产品在你们取消授权后,未同步到去哪儿平台,导致去哪儿平台依然呈现。去哪儿平台是每天凌晨抓取自我游的产品,所以在这其间取消授权后需要自己手动更新同步下,尽量避免由此问题带来的错误。


Q6:去哪儿抓取产品的价格有效日期是多久?

假设:产品设置价格有效日期为7月1日–10月31日。

A:只抓取3个月的价格。即是只抓取7月1日–9月30日


Q7:期票产品对接去哪儿是否可以设置2种价格规则
A:不支持。


Q8:运营商产品对接去哪儿门票分销接口,商户反馈推送的产品第二天的价格会变为系统上原有的价格,不是给接口分销商设置的价格规则,例子:产品原有价格70元,给接口分销商设置的价格规则是72元,推送给去哪儿价格是72元,但第二天价格就变为70元是什么原因?

A:商户去哪儿接口对接了多个去哪儿店铺,其中一个店铺授权了这个产品,另一个店铺没授权这个产品导致的。

需给接口的分销商设置白名单授权,重新推送产品。


Q9:去哪儿后台抓取自我游产品xxx时提示:失败:供应商返回产品信息为空,getProductByQunarResponseBody:nu11

blob.png

A:自我游商家没有在去哪儿门票管理页面针对此产品进行授权。需检查产品描述,预定说明是否完善,产品是否授权给去哪儿。


Q10:推送产品到去哪儿提示:无使用说明信息
图片.png
A:产品预定须知没设置导致的,产品预定须知是必须要设置的

image.png

    您需要登录后才可以回复