修改日期：2025-03-10
修改人：符娇珠

一、特别说明

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

二、接口实现功能

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

三、合作协议

（运营商与智游宝剧院系统之间的合作协议）

四、智游宝剧院系统提供参数

必填参数（由智游宝提供）

场次抓取：
1抓取  ：选择抓取，那自我游对接智游宝剧院的是获取该产品的所有场次信息，下单也显示该产品的所有场次信息，自我游只需要发布一个产品去对接） 

0不抓取：选择不抓取，那自我游对接智游宝剧院的是获取该产品的固定场次信息，下单也显示该产品的固定场次信息，如该产品有多个场次，自我游要发布多个产品对接智游宝多个场次） 

五、智游宝剧院系统的技术需配置回调地址

核销通知地址：http://运营商域名/api/zhiyoubaojuyuan/finish.jsp

退款审核通知地址：http://运营商域名/api/zhiyoubaojuyuan/refundNotice.jsp

六、自我游系统发布及设置

6.1、供应商账号添加
运营商给智游宝接口开一个供应商账号，用于区别产品是哪个供应商系统提供的产品，并且该供应商账号结算方式选择为按周期生成应付款，结算周期为自定义。【供应商帐号开通，参考该链接： http://kf.zowoyoo.cn/hc/kb/article/191732/】

6.2、发布产品注意事项

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

②【出票操作】设置为“需要”；出票短信内容编辑加入：$excode$ 获取智游宝数字码代码，$excode2$  获取智游宝二维码代码。

③应到未到处理：人工做退改处理(如果支持多次验证必选这项)

④发码类型：根据供应商那边的来选择，如果是一个订单不管几张票只有一个码选择“一单一码”，如果一个订单几张票就几个码选择“一人一码”

对应接口：选择自我游配置好的智游宝剧院供应商接口

接口产品编号：到产品列表查询
①接口配置选择是抓取场次的，必须要输入智游宝系统的“剧院编码”才能抓取场次的真正编码

②接口配置的是不抓取场次的，可直接输入智游宝系统的“节目编码”或“剧院编码”去查询

6.3、及格及库存
 在产品管理中，点击价格与库存，设置价格和库存。

七、测试环节

①产品分销到哪个渠道，可直接在对应的分销渠道下单进行测试
②产品只售卖自我分销同行，可代客录单测试
③测试订单的部分退款，全部退款
④测试订单的部分核销，全部核销

八、订单退款

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

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

九、常见问题

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