编辑人：符娇珠
编辑日期：2022年7月25日
定义：将门票和酒店产品组合成新的景酒套餐产品
一、接口实现功能
1、订单同步
2、出票同步
3、核销不同步（游客在飞猪平台点击人工确认收货或订单过期后自动收货）
4、退款同步（不支持部分退款）
5、人工推送确认状态支持
6、价格及库存同步
7、下单前校验：客人下单未支付订单就同步到码商系统，码商系统产品没有价格库存时客人在飞猪前端支付不了，所以可以避免因没价格及库存下单失败
8、客人在电脑PC端下单不支持直连订单到自我游系统
特别说明：因各个系统的运营规则，退改规则，核销方式，数据推送等机制各不相同。所有的对接，请商家必须按要求完成测试，测试方式参考http://kf.zowoyoo.cn/hc/kb/article/1541114/。如未测试，造成的后果由商户自行承担。详细见本文档最后。
二、自我游商户需提供对接参数
1.分销商id，商户(即自我游的运营商)在自我游系统添加一个分销商账号用于对接飞猪景酒接口，对该分销商接口支付方式设置为授信支付，并且设置足够的授信额度（注意该授信支付方式仅适用于商户自营飞猪店铺）
2.飞猪店铺名称
三、飞猪技术需配置数据
accesskey：
accessSecret：
这两个数据由自我游公众号客服【自我游运营中心】提供，商家再提供给飞猪技术开通景酒直连权限功能
四、自我游系统产品发布
4.1自营产品如何发布——》人工推送确认状态给飞猪
温馨提示：自我游系统的订单是以出票状态推送订单确认状态给飞猪平台
1、目前支持发布类目：
（1）打包套餐C（A门票+B酒店=C）
（2）套餐
（3）普通酒店类产品
2、订单确认方式设置：选择“自动确认”
3、生成通知单设置
产品通知单生成设置选择第三项 “在预定（支付）成功后自动锁定订单，无需生成通知单”
4、出票设置
①套餐产品
通知单生成设置选择第三项 ，“在预定（支付）成功后自动锁定订单，无需生成通知单”，出票设置为“需要”
如下图
②打包产品
A单门票产品出票设置为“需要”，B单酒店产品录入确认号设置为“需要”，A门票产品和B酒店产品生成通知单都选择第三项。组合成套餐的C产品出票模式选择“所有子订单出票后母订单出票（存在风险，谨慎使用）”。
③酒店产品
确认号选择为"需要”
4.2自动推送确认状态给飞猪产品如何设置？
①套餐产品
通知单生成设置选择第三项 ，“在预定（支付）成功后自动锁定订单，无需生成通知单”，出票设置为“不需要”②打包产品
A单门票产品出票设置为“不需要”，B单酒店产品录入确认号设置为“不需要”，A和B产品生成通知单都选择第三项。C组合成套餐的产品出票模式选择“所有子订单出票后母订单出票（存在风险，谨慎使用）”。
③酒店产品
确认号选择为"不需要”
4.3对接第三方供应系统的如何发布？
①套餐产品
产品生成通知单选择第三项，出票设置为需要，如图所示
②打包产品
A单门票和B酒店产品都对接第三方接口，两个子产品生成通知单都选择第三方，子产品门票类目出票设置选择为“需要“，子产品酒店类目录入确认号选择为“需要”，主产品出票模式选择第二项,如图所示
③酒店产品
确认号选择为“需要”
4.3：对接供应商接口+自营产品组合打包如何发布？
（1）打包套餐：A单门票对接第三方接口，B酒店是自营产品，且酒店订单不需人工操作“安排”，子产品A门票类目生成通知单选择为第三项，出票设置选择为“需要“，子产品B酒店类目生成通知单选择为第三项且录入确认号选择为“不需要”，主产品出票模式选择第二项,如图所示
（2）打包套餐：B酒店对接第三方接口，A单门票是自营产品，且门票订单不需人工操作“出票”，子产品A门票类目生成通知单选择为第三项且出票设置选择为“不需要“，子产品B酒店类目录入确认号选择为“需要”，主产品出票模式选择第二项,如图所示
五、价格及库存设置
飞猪每隔30分钟会来自动抓取自我游产品的价格及库存，如商户在自我游系统更改了产品的价格及库存，想将新的价格及库存及时同步到飞猪平台，可在自我游系统直接操作，操作步骤如下
在自我游系统左侧菜单栏的【渠道门票对接管理】——》找到对接飞猪景酒的接口点击【管理】到产品授权界面，针对对接到飞猪平台的产品点击【授权】按钮后再点击【商品价格库存通知】按钮，更改后的价格及库存预计五分钟后会同步到飞猪平台
六、飞猪后台发布产品流程
特别说明：日历套餐60分钟不回传确认状态给飞猪，飞猪会自动关单；二次预约套餐10分钟不回传确认状态给飞猪，飞猪会自动关单。二次预约套餐回传确认状态时长要加长可联系飞猪商务申请。
1、发布度假产品
产品管理——》发布度假产品——》景点门票/演艺演出/周边游——》境内玩乐——》境内景酒套餐
2、交易设置
售卖方式：日历房，预约商品（预售订单是指客人在飞猪平台下单支付成功后，且游客需在飞猪平台预约成功后，订单才会推送到自我游系统）
直连方式：系统直连
直连类型：商家PMS
资源确认方式：二次确认
可选入住日期：设置的时间范围和自我游系统的价格及库存的有效期时间一致，如设置不一致，如自我游系统的价格及库存设置的时间有效期是2022-8-2到2022-12-30，那飞猪可选入住日期也要设置2022-8-2到2022-12-30，如飞猪可选入日期有效期时间比自我游平台价格及库存有效期时间短，可能会导致价格及库存推送不过去的情况
提前预定天数：和自我游系统的产品提前天数设置一致
套餐设置：该产品要发布多个套餐关联自我游系统的多个套餐产品，可直接点击新增套餐，套餐下面的商家编码绑定自我游系统的产品编码，如下图
七、订单管理
7-1、确认状态人工推送
1、确认成功的操作步骤
套餐类目：在订单管理页面找到对应订单去点击【安排】按钮，操作安排后自我游系统会将确认状态推送给飞猪，该订单在飞猪前端状 态是【已确认，待出行】 打包套餐类目：在订单管理页面找到对应的门票子订单去点击【出票】按钮，酒店子订单点击【录入确认号】按钮，母订单是出票状态，自我游系统会将确认状态推送给飞猪，该订单在飞猪前端状态是【已确认，待出行】
2、确认失败的操作步骤
套餐类目：在订单管理页面找到对应订单去操作异常处理后点击退款按钮，自我游系统会将未确认通过状态推送给飞猪，飞猪前端状态显示关闭交易
打包套餐类目：在订单管理页面找到对应的门票子订单和酒店子订单去操作异常处理后分别点击退款按钮，母订单是撤单状态，自我游系统会将未确认通过状态推送给飞猪，飞猪前端显示关闭交易
7-2、订单退款处理—自营订单
特别提醒：客人在飞猪前端发起退改申请，选择的是拍错/不想去/个人原因无法出行才会将退款请求推送到自我游系统飞猪前端只能发起一次退改申请，如游客在飞猪前端发起退改申请，运营商操作拒绝退款后，游客再次在飞猪前端发起退改申请，该订单请求将不会再同步到自我游系统，商户需在飞猪后台做退款处理给游客。
套餐类目：客人在飞猪前端发起退改申请，运营商到退改申请界面针对订单做退改处理，如同意退款点击【同意】按钮，如拒绝退款点击【拒绝】按钮
打包类目：客人在飞猪前端发起退改申请，运营商到退改申请界面针对两个子订单做退改处理，子订单处理成功后再针对母订单做处理，如同意退款点击【同意】按钮，如拒绝退款点击【拒绝】按钮
7-3、订单退款处理—对接第三方接口订单
套餐类目：客人发起退改申请，不要直接到退改申请界面操作，订单请求会直接推送到景区系统，如订单没自动推送到景区系统需针对订单操作异常后点击退款按钮，退款请求会推送到供应商接口，供应商退款审核成功后会将退款结果推送给自我游，自我游会将退款结果推送给飞猪平台
打包类目：客人发起退改申请，不要直接到退改申请界面操作，订单请求会直接推送到景区系统，如订单没自动推送到景区系统需针对两个子订单操作异常处理后点击退款按，退款请求会推送到供应商接口，供应商退款审核成功后会将退款结果推送给自我游，自我游系统母订单是撤单状态后会将退款结果推送给飞猪平台
7-4、订单核销
核销接口暂时不同步，游客消费了，需在自我游系统操作订单验证，然后再到飞猪平台操作核销
自我游系统订单状态与飞猪订单状态对应关系
如何查看飞猪订单是否支付
在渠道门票对接管理找到对接飞猪景酒店铺，点击订单管理进去查看
特别说明
1、因各个系统的运营规则，退改规则，核销方式，数据推送等机制各不相同。 在自我游对接专家配置完接口后，商户必须按测试清单的示例测试，包括：订单支付，退款，部分退款等。超出本手册描述产品设定方式等，如未测试，导致订单退改/核销，以及由此造成的损失，商户需自行承担。测试流程：http://kf.zowoyoo.cn/hc/kb/article/1541114/
在新品上线，直播等营销活动时，重要节假日时，商户必须安排人员，处理每日退改订单。
2、客服人员因无法确认商家的产品销售规则，订单退改规则。提供的处理意见仅是系统操作层面，其他仅为参考。
3、所有的api对接，请按要求上线销售的产品，不符要求的上线销售，后果商户自行承担。
4、因为第三方系统的接口调整，规则变更，无法第一时间同步，如对接异常，商户应立即暂停销售，避免进一步造成损失。并通知自我游对相应接口进行升级。
八、常见问题
问题：游客在飞猪前端下单，订单没同步到自我游系统
解决办法：检查在飞猪平台上产品直连方式是否选择系统直连，是否绑定自我游产品编码，客人是否在电脑pc端下单