修改日期：20190130
修改人：阿一
特别说明
采购长隆系统的产品再对接到抖音抖音/美团/飞猪/快手等渠道进行分销，订单退改申请，商家必须按时处理。目前对接所有第三方渠道（包括但不限于抖音/美团/飞猪/快手等，及未来新增加的渠道），客人发起退改申请，超过要求的期限商家未处理，第三方会直接退款给客人。如因商家逾期未处理造成损失，由商家承担，自我游不承担责任。
商家每天应登录自我游系统查看订单退改申请列表，及时联系供应商处理订单退改。
目前已知的退改时限（客人发起退改请求算起），抖音72小时，美团24小时，去哪儿24小时，飞猪24小时（部分景区产品飞猪是按即时退款执行）。
关于退改时限要求会有调整，请以各平台官方通告为准。
接口实现功能
重新发码(支持)
主动抓取核销(支持)
取消订单(支持)
获取对方订单详情(支持)
查询对方接口日志(支持)
接口返码（支持，不支持二维码）
退款（不支持部分退款）
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心
合作协议
（运营商与长隆系统之间的合作协议）
对方系统提供参数
注：①退改申请默认同步到供应商
②退改申请想人工处理的需要找运营配置（人工处理有一定的风险，渠道如果有超时自动退款时间，需要在这个时间内处理掉退改申请）
配置完成后，将自我游提供的公钥和回调地址给到长隆那边配置。联系【自我游运营中心】配置参数时获取。
自我游系统发布及设置
1.运营商给长隆接口开一个供应商账号，用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通，参考该链接： http://kf.zowoyoo.cn/hc/kb/article/191732/】
方法一：
1.运营商到【供应商接口管理】---【已开通接口】，找到对应的长隆供应接口，操作同步供应商产品进入产品列表，搜索长隆后台的商品id，进行同步产品到系统。同步成功之后，在当前页面可以直接点击修改产品进入到产品详情完善产品资料（产品基本信息都会同步，但是产品景点标志图等还有其他信息需要手工完善跟供应商产品设置一致即可）。同步到自我游系统的产品在【产品管理】中也可以看到。
2.产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到长隆。
3.产品短信：若是使用长隆的出票短信，在发布产品的时候就无需设置短信。
如需要运营商发短信：【出票操作】设置为“需要”；【短信内容】需要编辑出票短信，出票短信内容编辑加入：$excode$。
4.对应接口：产品导入时自动对应接口。
5.产品编码：导入时自动对应长隆系统查询产品编号。
方法二：
运营商手工在自我游后台发布属性一致的门票产品，将以下列出的信息严格按照下面的要求来设置。
1.产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到长隆。
2.产品短信：若是使用长隆的出票短信，在发布产品的时候就无需设置短信。
3.如需要运营商发短信：【出票操作】设置为“需要”；【短信内容】需要编辑出票短信。出票短信内容编辑加入：$excode$
测试环节
产品发布完毕，用分销商账号下单测试。
处理订单
1.查看订单状态，若订单状态显示【已成功-已支付-待出票】且长隆那边没有订单同步，检查一下订单是否已经生成了通知单，需要生成了通知单才会下单到长隆系统。
2.出票无误之后，测试验证，系统是会自动抓取核销信息的，观察一下长隆核销之后自我游系统的订单状态是否变成【已完成】。
一旦出现错误：让运营商截图，点击重新执行，查看失败原因；查看接口详细日志，是出现什么异常；查看产品编号是否已经填写正确。
订单退款
【订单退款流程只能通过自我游系统操作退款，运营商不能直接到供应商系统进行退款】，新版长隆接口不支持部分订单退款，但支持部分改票，由供应系统修改后，发新码给客人验证入园。
订单状态“已出票”：客人/分销商系统发起退改申请，自我游系统会自动将退改申请请求推送到长隆系统，如存在自动推送退改申请请求到长隆系统失败的情况，运营商需在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到长隆系统，长隆系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。长隆系统返回取消成功后，自我游系统的订单直接显示“撤单”。
订单状态“已完成”：客人/分销商系统先线下联系运营商，然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到长隆系统。然后长隆系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。长隆系统返回取消成功后，自我游系统的订单直接显示“撤单”
常见问题
问题描述：订单出现异常？
解决方法：通过点击“查看详细的接口日志”可以查看本订单的日志 。