飞猪码平台分销门票接口

自我游发表于:2022年08月01日 19:36:08更新于:2024年08月05日 14:45:17

重要提示

配置完飞猪码平台接口,请按照电子凭证接口操作手册提供对应的参数给自我游公众号客服【自我游运营中心】进行配置
电子凭证操作手册: http://kf.zowoyoo.cn/hc/kb/article/1636025/

对接须知

1、十分钟不推送出票返码给飞猪,飞猪平台会自动退款给游客
2、为了提高服务质量,提升用户体验,规范飞猪渠道平台返码要求。对接飞猪渠道接口商户必须遵循以下要求。
(1)不能通过手工出票等方式违规操作发假码给飞猪平台。
(2)通过第三方供应票务系统的产品想再分销到飞猪平台,必须保证供应商票务系统有码返回才能将产品直连到飞猪平台
(3)如商户存在发假码情况下,自我游有权限停用该飞猪店铺接口直连权限

 温馨提示:退改申请需在24小时内处理,未处理飞猪会自动退款,如逾期未处理造成损失,自行承担。关于退改时限要求会有调整,请以平台官方通告为准。

特别说明因各个系统的运营规则,退改规则,核销方式,数据推送等机制各不相同。所有的对接,请商家必须按要求完成测试,测试方式参考:http://kf.zowoyoo.cn/hc/kb/article/1541114/
如未测试,造成的后果由商户自行承担。详细见本文档最后。

一、实现功能

(1)订单同步
(2)出票同步(支持数字码、二维码、pdf)
(3)核销同步
(4)退款同步

二、飞猪码平台接口配置流程

2.1、购买应用
登录自我游系统,在浏览器(必须与登录自我游系统的是同一个浏览器)中新建一个标签页,然后在新打开窗口复制以下链接进行购买应用,在服务信息界面的下面两个方框一定要打钩,不然应用到期不及时重新购买应用会导致订单同步失败。https://fuwu.taobao.com/ser/detail.htm?spm=a1z13.pc_search_result.1234-fwlb.5.7acd5acaYeEeCR&service_code=FW_GOODS-1001088842&tracelog=search&from_key=%E8%87%AA%E6%88%91%E6%B8%B8
购买成功可以进行对接,如没办法购买成功说明该店铺不能进行对接
图片.png
图片.png

2.2、自我游商户提供对接参数

飞猪店铺名称
分销商id,商户(即自我游的运营商)在自我游系统添加一个分销商账号用于对接飞猪门票接口,对该分销商接口支付方式设置为授信支付,并且设置足够的授信额度(注意该授信支付方式仅适用于商户自营飞猪店铺
手机号码和邮箱:提供格式,手机号码|邮箱(手机号码和邮箱是接收发码异常的订单消息)
支持设置钉钉群机器人通知,发码异常时系统会自动发送钉钉消息通知http://kf.zowoyoo.cn/hc/kb/article/1575973/?from=draft

2.3、飞猪店铺授权

自我游商户需到【渠道门票对接管理】操作【飞猪店铺授权】
图片.png
图片.png
2.4、飞猪后台配置对接数据
首次关联出票码商【请使用谷歌浏览器配置】,配置流程如下图
选择对应的官方码商(“自我游”)
账号:自定义,建议名称为“自我游核销”,方便搜索就行
accesskey(联系自我游公众号客服:自我游运营中心获取)
accessSecret(联系自我游公众号客服:自我游运营中心获取)
图片.png

image.png


三、自营产品自我游系统发布流程

自营产品定义:景区使用自我游系统核销,客人在飞猪前端下单,且客人能凭借自我游系统返回给飞猪平台的码入园消费。

3.1、添加供应商账号
在左侧菜单栏找到功能【合作伙伴】—》【供应商管理】,找到产品对应的供应商后,对该供应商点击【管理】按钮进入到核销验证配置界面进行设置
图片.png


3.2、产品发布整体流程概述

自我游后台产品编辑-->设置价格与库存 -->上架-->飞猪后台产品编辑-->绑定自我游产品编码-->设置价格及库存-->产品上架

3.21、产品对应供应商选择:选择刚刚添加好的供应商账号,产品可返回码给淘宝以及产品对应的订单该供应商账号都可核销

图片.png

3.22、订单确认方式选择为“自动确认”
图片.png

3.23、产品有效期设置:自我游平台产品的有效期设置必须与飞猪平台的设置一致,如两边系统有效期设置不一致会出现下单失败或核销没法同步的情况

图片.png

3.24、生成通知单及出票设置:生成通知单选择第三项,出票设置选择为“不需要”图片.png
3.25、产品入园设置:产品是二维码入园的,产品入园方式要选择二维码凭证。产品没码返回,凭证身份证入园,游客入园设置要勾选身份证。PDF入园的就选择PDF

图片.png
3.26二维码的源代码是数字码生成,游客入园设置可选择二维码,支持票号(验证码)生成的二维码入园
image.png

3.27、应到未到:人工做退改处理(如果支持多次验证必选这项)
图片.png

3.28、销售对象及销售范围:选择同行和直客,PC版本(b2b版本),H5手机版本(包含b2b和b2c两个版本)
图片.png


四、对接第三方票务系统发布流程

定义:通过自我游系统采购第三方票务系统的产品,例如智游宝系统


4.1、直接同步导入产品流程
在左侧菜单栏找到【运营管理】—>【供应商接口管理】—>【同步供应商产品】—>导入产品—>设置价格及库存在自我游系统【产品管理页面】会生成一个新产品,因两个系统之间某些字段不同,做不到完全同步,产品需点击“修改”按钮完善产品信息

4.2、手工产品发布整体流程概述
自我游后台产品编辑-->设置价格与库存 -->上架-->飞猪后台产品编辑-->绑定自我游产品编码-->设置价格及库存-->产品上架

4.21、订单确认方式选择为“自动确认”
图片.png

4.22、产品有效期设置:自我游平台产品的有效期设置必须与飞猪平台的设置一致,如两边系统有效期设置不一致会出现下单失败或核销没法同步的情况
图片.png

4.23、生成通知单及出票设置:生成通知单选择第三项,出票设置选择为“需要”

图片.png

4.24、产品入园设置:产品是二维码入园的,产品入园方式要选择二维码凭证。产品没码返回,凭证身份证入园,游客入园设置要勾选身份证。
图片.png
4.25、景区只返回数字码,但是数字码生成的二维码可入园,商户要将数字码转换成二维码的设置
图片.png

4.26、销售对象及销售范围:选择同行和直客,PC版本(b2b版本),H5手机版本(包含b2b和b2c两个版本)
图片.png


五、飞猪平台发布流程

5.1、发布宝贝

选择景点门票/演绎演出/周边游-国内票务

图片.png

5.2、交易设置

(1)门票类型:直连电子票
(2)出票方式:飞猪码平台
(3)出票系统商选择“自我游”
(4)出票系统账号:“自我游核销”,选择飞猪平台的【门票系统商管理】模块针对自我游系统直连设置的账号
(5)支持身份证:产品支持刷身份证入园的就打钩,不支持就不打钩
(6)核销提供服务商:填写乐乐酷
图片.png

如出票系统商模块没“自我游”这个选项,自我游商家想添加该选项,需提供
飞猪店铺名称、景区名称、景点id、收费项目名称(若有多个收费项目要配置以表格方式提供)、景区分销协议、等数据给自我游公众号客服【自我游运营中心】,自我游会将商户提供的数据发给飞猪平台进行添加,提交后1-2个工作日内飞猪平台会配置完成,商家可在发布页-交易设置-点击飞猪码平台查看是否已配置完成。
①景点id商家端查询流程:
  https://www.yuque.com/docs/share/774e8d0a-59f4-48fa-b1c5-945599d0898f?#1
②收费项目流程查询界面如下图
图片.png

③如果是境外产品没有码平台选项,商家联系小二进行切流添加

5.3、产品编码绑定

自我游系统跟飞猪系统产品关系绑定设置如下图
图片.png

六、订单处理

6.1、自营订单退款处理

客人在淘宝发起退款申请,退款请求会直接推送到自我游系统,自我游商户在自我游系统【退改申请处理】点击【处理】。

6.2、第三方供应商系统订单退款处理
客人发起退改申请,不要直接到退改申请界面操作,订单请求会直接推送到景区系统,如该景区系统没实现自动推送退款请求的操作,自我游商户需针对订单操作异常后且点击“退款”按钮,退款请求会推送到供应商接口,供应商退款审核成功后会将退款结果推送给自我游,自我游会将退款结果推送给飞猪平台。

特别说明1:
订单不支持先部分退款后再部分核销,只支持先部分核销后部分退款
【情景】、游客购买5张票,客人想申请退2张票,必须先消费核销3张,再去申请退改剩余未消费的2张。

特别说明2客人发起的退款申请,商家必须在24小时内处理,如不及时处理,逾期后飞猪(宝淘)系统将自动处理同意退款给客人,如逾期未处理造成损失,自行承担。关于退改时限要求会有调整,请以各平台官方通告为准。。

3、如何查看订单对接失败原因
a )出票系统商是“乐乐酷”的订单
在自我游系统左侧菜单栏找到“去阿门票”功能,点击“进入订单管理日志”按钮,输入对应的淘宝单号去查询
图片.png|

b)出票系统商是“自我游”的订单
自我游系统左侧菜单栏找到“渠道门票管理”功能,找到对接飞猪店铺,点击“管理”按钮进入到订单处理界面

图片.png
图片.png

特别说明

1、因各个系统的运营规则,退改规则,核销方式,数据推送等机制各不相同。 在自我游对接专家配置完接口后,商户必须按测试清单的示例测试,包括:订单支付,退款,部分退款等。超出本手册描述产品设定方式等,如未测试,导致订单退改/核销,以及由此造成的损失,商户需自行承担。
测试流程:http://kf.zowoyoo.cn/hc/kb/article/1541114/
2、在新品上线,直播等营销活动时,重要节假日时,商户必须安排人员,处理每日退改订单。
3、客服人员因无法确认商家的产品销售规则,订单退改规则。提供的处理意见仅是系统操作层面,其他仅为参考。
4、所有的api对接,请按要求上线销售的产品,不符要求的上线销售,后果商户自行承担。
5、因为第三方系统的接口调整,规则变更,无法第一时间同步,如对接异常,商户应立即暂停销售,避免进一步造成损失。并通知自我游对相应接口进行升级。


    您需要登录后才可以回复