创建日期：2025-05-16
创建人：林树丹
特别声明
采购携程系统的产品再对接到抖音抖音/美团/飞猪/快手等渠道进行分销，订单退改申请，商家必须按时处理。目前对接所有第三方渠道（包括但不限于抖音/美团/飞猪/快手等，及未来新增加的渠道），客人发起退改申请，超过要求的期限商家未处理，第三方会直接退款给客人。如因商家逾期未处理造成损失，由商家承担，自我游不承担责任。
商家每天应登录自我游系统查看订单退改申请列表，及时联系供应商处理订单退改。
目前已知的退改时限（客人发起退改请求算起），抖音72小时，美团24小时，去哪儿24小时，飞猪24小时（部分景区产品飞猪是按即时退款执行）。
关于退改时限要求会有调整，请以各平台官方通告为准。
接口实现功能
携程价格接口支持同步结算价下单（是在下达通知单时才下单到携程门票系统）
取消订单、退单（支持）
查看携程门票系统的订单详细（支持）
查看携程门票系统的订单日志（支持）
系统自动核销订单（支持）
接口返码（不支持）
重新发码（接口不支持）
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心
合作协议
（运营商与携程系统之间的合作协议）
携程系统需要提供参数
运营商跟携程网先签订协议，获取以下参数发给自我游客服（自我游运营中心）进行备份接口 ，无论是自设价格还是携程价格接口都需要提供以下参数。
运营商需要提供参数
携程价格还是自设价格
携程发短信还是运营商发短信
携程技术配置回调地址
通知接口:https://task-api.zowoyoo.com/api/other/ctripglobal/接口id/notice
（自我游客服配置好接口，对应的回调地址客服会完整的提供）
运营商需知
自设价格和携程价格：
自设价格：运营商可以直接在自我游系统【产品管理】--【价格库存】设置对应携程产品的分销价和零售价，采购价格需要跟携程给的结算价格保持一致。携程方的产品价格发生变化后需要运营商手动及时更改自我游系统的产品价格，要不然就会导致订单的价格与携程的价格不一致的错误。
携程价格：自我游系统直接同步携程系统的价格，在客人下单前会抓取携程的最新价格，不会出现订单价格错误的情况，但是不利于设置分销价和零售价，需要通过价格规则进行设置对应的分销价和零售价。产品管理--价格库存设置的分销商价格和零售价不生效。
将携程产品导入到自我游系统
方法一：导入产品
运营商到【供应商接口管理】---【已开通接口】，找到对应的携程接口，操作同步供应商产品进入产品列表，进行同步产品到系统。PS：针对产品没有同步的属性信息需到产品管理页面进行修改后保存，如产品标志图。
可通过携程的产品id进行点击查询
①产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到携程。
②产品短信：若携程发短信
出票操作选择：需要
出票短信：不发送短信
③如需要运营商发短信：【出票操作】设置为“需要”；【短信内容】需要编辑出票短信。出票短信内容编辑加入：$excode$（验证码），$excode2$（二维码链接）
④对应接口：产品导入时自动对应接口。
⑤产品编码：导入时自动对应携程系统的产品编号
方法二：手工发布产品
运营商手工在自我游后台发布与携程后台属性一致的门票产品，将以下列出的信息严格按照下面的要求来设置。
①产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到携程。
②产品短信：若携程发短信
出票操作选择：需要
出票短信：不发送短信
③如需要运营商发短信：【出票操作】设置为“需要”；【短信内容】需要编辑出票短信。出票短信内容编辑加入：$excode$（验证码），$excode2$（二维码链接）
④对应接口：自我游配置好接口后才会显示，选择自我游配置的携程供应商接口。
⑤产品编码：产品id_套餐id_资源id （可点击接口编码参考进行获取对应的数据）
测试环节
使用分销商账号进行下单并支付。
订单退款
订单状态“已出票”：客人/分销商发起退改申请，自我游系统会自动将退改申请请求推送到天时同城系统，如存在自动推送退改申请请求到天时同城系统失败的情况，运营商需在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到天时同城系统，天时同城系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。天时同城系统返回取消成功后，自我游系统的订单直接显示“撤单”。
订单状态“已完成”：客人/分销商先线下联系运营商，然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到天时同城系统。然后天时同城系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。天时同城系统返回取消成功后，自我游系统的订单直接显示“撤单”。
注意：渠道发起退款申请时，如供应商未处理允许退款，禁止在退改申请直接操作同意退款（避免供应商此订单不退，造成亏损）
常见问题
【问题描述】：订单出现异常？
【解决方法】：通过点击“查看详细的接口日志”可以查看本订单的日志
【问题描述】供应商接口列表查询不到对应携程的产品
【解决方案】在登录自我游系统的同一个浏览器，打开此链接进行查询
系统网址/api/ctripglobal/product_list.jsp?interface_id= 接口id&product_id=携程的产品id