修改日期：2020-03-30
修改人：符娇珠
特别声明
采购携程系统的产品再对接到抖音抖音/美团/飞猪/快手等渠道进行分销，订单退改申请，商家必须按时处理。目前对接所有第三方渠道（包括但不限于抖音/美团/飞猪/快手等，及未来新增加的渠道），客人发起退改申请，超过要求的期限商家未处理，第三方会直接退款给客人。如因商家逾期未处理造成损失，由商家承担，自我游不承担责任。
商家每天应登录自我游系统查看订单退改申请列表，及时联系供应商处理订单退改。
目前已知的退改时限（客人发起推该请求算起），抖音72小时，美团24小时，去哪儿24小时，飞猪24小时（部分景区产品飞猪是按即时退款执行）。
关于退改时限要求会有调整，请以各平台官方通告为准。
接口实现功能
携程价格接口支持同步结算价下单（是在下达通知单时才下单到携程门票系统）
取消订单、退单（支持）
查看携程门票系统的订单详细（支持）
查看携程门票系统的订单日志（支持）
系统自动核销订单（支持）
接口返码（不支持）
重新发码（接口不支持）
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心
合作协议
（运营商与携程系统之间的合作协议）
携程系统需要提供参数
运营商跟携程网先签订协议，拿取以下参数交由自我游运营配置 ，无论是自设价格还是携程价格接口都需要提供以下两个参数。
运营商需要提供参数
携程技术配置回调地址
携程回调:http://域名/api/ctripticket/orderNotice.jsp
（携程配置回调后，需要提供回调key给自我游配置，正常与安全码一致，可与携程BD核实。）
运营商需知
携程门票供应接口的新版1.1与旧版的区别：订单支付状态的同步
旧版接口：接口又称为“押金模式” 订单在自我游系统下达通知单到携程后，运营商需要线下打款给携程，需要等到携程方查收到款项后才会给订单回调审核支付结果。
新版接口：接口又称为“透明代理” 运营商用自己的帐号登录携程后台，提前用支付宝充值一定的金额。只要订单在自我游系统下达通知单到携程后订单直接在商户的携程帐号上扣款即可。
携程门票新版1.1供应接口又分为2种：自设价格和携程价格：
自设价格：运营商在自我游系统可以直接设置对接携程产品的分销价和零售价。但是携程方的产品价格发生变化后需要运营商手动及时更改自我游系统的产品价格，要不然就会导致订单的价格与携程的价格不一致的错误。
携程价格：自我游系统直接同步携程系统的价格，在客人下单前会抓取携程的最新价格，不会出现订单价格错误的情况，但是不利于设置分销价和零售价，需要通过价格规则进行设置对应的分销价和零售价。（运营商对接前一定要跟自我游运营部说明需要配置是哪一个接口）。
将携程产品导入到自我游系统
方法一：运营商到【供应商接口管理】---【已开通接口】，找到对应的携程接口，操作同步供应商产品进入产品列表，进行同步产品到系统。PS：产品基本信息都会同步，同步成功之后，针对产品没有同步的属性信息需到产品管理页面进行修改后保存，如产品标志图。
点击【管理门票资源】进入的产品列表可以通过输入景点id或景点名称进行搜索
方法二：配置好接口过后在自我游【携程门票供应管理】中同步携程产品，必须建立携程的供应商，在携程门票供应商产品管理页面输入并定位这个供应商，点击保存后，商家需要到携程系统找到携程景点id，输入携程景点id，点击提交后，再进行【导入产品】。这样操作后自我游系统就会自动生成新产品到【产品管理】。【供应商帐号开通，参考该链接： 
http://kf.zowoyoo.cn/hc/kb/article/191732/
携程门票系统产品的资源ID获取方法：登录携程旅行网上找到相关产品然后在浏览器的地址栏可查到该产品对应的景点id或者资源id，如下图中的scenicID即为景点id，ticketID即为资源id。
自我游系统发布及设置
产品的【通知单生成控制】的设置，自我游系统的订单是在下达通知单时才同步到携程门票系统。建议此项选择为“在预订(支付)成功后自动锁定订单，无需生成通知单”
出票设置：如由运营商发送短信，需设置出票短信，短信内容包含的代码$excode$获取对应携程的数字码，$excode2$获取对应携程的二维码
短信内容参考：您已预订成功xxx门票$dnum$张，凭$excode$验证码或二维码$excode2$入园消费
测试环节
使用分销商账号进行下单并支付。
订单核销
该接口订单的核销状态是自我游系统主动去抓取，订单会自动变成已完成状态。但是有时也存在是抓取不到核销信息的可能，所以运营商要留意订单的状态。
订单退款
订单状态“已出票”：客人/分销商发起退改申请，自我游系统会自动将退改申请请求推送到携程系统，如存在自动推送退改申请请求到携程系统失败的情况，运营商需在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到携程系统，携程系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。携程系统返回取消成功后，自我游系统的订单直接显示“撤单”。
订单状态“已完成”：分销商先线下联系运营商，然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到携程系统。然后携程系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。携程系统返回取消成功后，自我游系统的订单直接显示“撤单”。
常见问题
问题描述：订单出现异常？
解决方法：通过点击“查看详细的接口日志”可以查看本订单的日志