修改日期：2025-05-28
修改人：邓媚娜

特别说明

 1、采购泰久系统的产品再对接到抖音抖音/美团/飞猪/快手等渠道进行分销，订单退改申请，商家必须按时处理。目前对接所有第三方渠道（包括但不限于抖音/美团/飞猪/快手等，及未来新增加的渠道），客人发起退改申请，超过要求的期限商家未处理，第三方会直接退款给客人。如因商家逾期未处理造成损失，由商家承担担，自我游不承担责任。
 2、商家每天应登录自我游系统查看订单退改申请列表，及时联系供应商处理订单退改。
 3、目前已知的退改时限（客人发起退改请求算起），抖音72小时，美团24小时，去哪儿24小时，飞猪24小时（部分景区产品飞猪是按即时退款执行）。
 4、关于退改时限要求会有调整，请以各平台官方通告为准。

接口实现功能

下单（订单在生成通知单时才下单到泰久系统）
取消订单（支持）
重发短信（支持）
查看泰久订单详细（支持）
查看订单日志（支持）
系统自动核销订单（支持）
接口返码（支持，也可支持回传二维码）
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心

合作协议

（运营商与景区系统之间的合作协议）

泰久系统提供参数

运营商系统提供参数

运营商给泰久接口开一个供应商账号，用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通，参考该链接： http://kf.zowoyoo.cn/hc/kb/article/191732/】

泰久技术配置回调地址

订单创建结果、退订结果、核销回调地址： http://运营商域名/api/huaqiaocheng2/orderNotice.jsp

自我游系统发布及设置

方法一：产品导入

运营商到【供应商接口管理】---【已开通接口】，找到对应的泰久接口，操作同步供应商产品进入产品列表，搜索泰久后台的商品id，进行同步产品到系统。导入产品成功后会进入到产品发布编辑界面，产品基本信息都会同步，但是产品景点标志图等还有其他信息需要手工完善跟供应商产品设置一致即可。

①产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到泰久。 

②发码类型根据景区的设置来，一定要和景区设置一致，不然可能会影响退款如，发码数量是一人一码的，那么产品的客人资料要求：“要求输入每个客人资料”

③【出票操作】设置为“需要”；如自我游商家想发送短信，出来短信选择“发送短信”，【短信内容】需要编辑出票短信。出票短信内容编辑加入：$excode$，$excode2$这个是二维码链接，必须设置两个代码！

④如果产品是有返回二维码的，游客入园设置选择二维码凭证

⑤应到未到一定要选择默认的选项“人工做退改处理（如果支持多次验证必选这项）

⑥发码类型：根据景区产品返码类型选择对应的设置

⑦接口信息
  对应接口：产品导入时会自动对应泰久接口。
  产品编码：导入时自动对应泰久系统查询产品编号。

方式二：手工绑定产品编码

①产品对应接口信息（景区编码需要联系泰久系统人员提供）

 对应接口：选择对应泰久接口

 接口产品编码格式：景区编码_供应商产品编码

例如：S0002_P000001110

②价格及库存
 在产品管理中，点击【价格与库存】，设置价格和库存。

测试环节

使用分销商账号进行下单并支付。

订单退款

订单状态“已出票”：客人/分销商系统发起退改申请，自我游系统会自动将退改申请请求推送到泰久系统，如存在自动推送退改申请请求到泰久系统失败的情况，运营商需在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到泰久系统，泰久系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。泰久系统返回取消成功后，自我游系统的订单直接显示“撤单”。

订单状态“已完成”：客人/分销商系统先线下联系运营商，然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到泰久系统。然后泰久系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。泰久系统返回取消成功后，自我游系统的订单直接显示“撤单”

常见问题

问题描述：订单出现异常？
解决方法：通过点击“查看详细的接口日志”可以查看本订单的日志