修改日期：20250528
修改人：方块
特别声明
采购同程系统的产品再对接到抖音抖音/美团/飞猪/快手等渠道进行分销，订单退改申请，商家必须按时处理。目前对接所有第三方渠道（包括但不限于抖音/美团/飞猪/快手等，及未来新增加的渠道），客人发起退改申请，超过要求的期限商家未处理，第三方会直接退款给客人。如因商家逾期未处理造成损失，由商家承担，自我游不承担责任。
商家每天应登录自我游系统查看订单退改申请列表，及时联系供应商处理订单退改。
目前已知的退改时限（客人发起退改请求算起），抖音72小时，美团24小时，去哪儿24小时，飞猪24小时（部分景区产品飞猪是按即时退款执行）。
关于退改时限要求会有调整，请以各平台官方通告为准。
一、接口实现功能
下单（是在下达通知单时才下单到同程门票系统）
重新发码（支持）
取消订单、退单（不支持部分退款）
查看同程门票系统的订单详细（支持）
查看同程门票务系统的订单日志（支持）
系统自动核销订单（支持）
接口返码（支持）
订单的核销状态是由自我游系统主动去抓取，订单会自动变成已完成状态。但是有时也存在是抓取不到核销信息的可能，所以运营商要留意订单的状态，抓取核销是半小时抓取一次，订单过了游玩日期系统将不在抓取。
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心
二、合作协议
（运营商与同程系统之间的合作协议）
三、同程系统提供参数
反码：选择需要
运营商提供参数
四、同程技术配置回调地址
同程门票退款回调接口：http://运营商域名/api/tongcheng/RefundCallback.jsp
同程门票返码回调接口：http://运营商域名/api/tongcheng/orderNotice.jsp
同程门票核销回调接口: http://运营商域名/api/tongcheng/finish.jsp
五、运营商须知
同程门票供应接口价格分为2种：同程价格和自设价格
自设价格：运营商在自我游系统可以直接设置对接同程产品的分销价和零售价。但是同程的产品价格发生变化后需要运营商手动及时更改自我游系统的产品价格，要不然就会导致订单的价格与同程的价格不一致的错误。
同程价格：自我游系统直接同步同程系统的采购价和零售价，在客人下单前会抓取同程的最新价格，不会出现订单价格错误的情况，但是不利于设置分销价和零售价。需要通过价格规则进行设置
因此，运营商对接前一定要跟自我游运营部说明需要配置是哪一个接口。
六、将产品导入到自我游系统
方法一：运营商到【供应商接口管理】---【已开通接口】，找到对应的同程接口，操作同步供应商产品进入产品列表，进行同步产品到系统。PS：产品基本信息都会同步，同步成功之后，针对产品没有同步的属性信息需到产品管理页面进行修改后保存，如产品标志图。
进入的产品列表可以通过输入景点id或景点名称进行搜索
七、自我游产品发布注意事项
①产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到景区门票系统。
②【出票操作】设置为“需要”；如自我游商家想发送短信，出来短信选择“发送短信”，【短信内容】需要编辑出票短信。出票短信内容编辑加入：$excode$，$excode2$这个是二维码链接，必须设置两个代码！
③如果产品是有返回二维码的，游客入园设置选择二维码凭证
④应到未到一定要选择默认的选项“人工做退改处理（如果支持多次验证必选这项）
测试环节
使用分销商账号进行下单并支付。
订单退款
订单状态“已出票”：客人/分销商系统发起退改申请，自我游系统会自动将退改申请请求推送到同程系统，如存在自动推送退改申请请求到同程系统失败的情况，运营商需在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到同程系统，同程系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。同程系统返回取消成功后，自我游系统的订单直接显示“撤单”。
订单状态“已完成”：客人/分销商系统先线下联系运营商，然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到同程系统。然后同程系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。同程系统返回取消成功后，自我游系统的订单直接显示“撤单”。
常见问题
问题描述：对接同程门票供应商接口，对接失败，失败提示“取票人数量不等于票数数量(4024)“
原因：同程这个订单是自我游商户打包拆单的其中一个子订单，下单数量是1，但是游客信息是两个人的，所以导致对接失败
解决办法：打包产品的包含人数设置为1，不能设置为2，不然下单数量是1张，客人信息资料是2个人，目前子订单的客人资料还是根据母订单的客人资料同步也是2个人