修改日期：2025052
修改人：符娇珠
特别说明
采购银科环企系统的产品再对接到抖音抖音/美团/飞猪/快手等渠道进行分销，订单退改申请，商家必须按时处理。目前对接所有第三方渠道（包括但不限于抖音/美团/飞猪/快手等，及未来新增加的渠道），客人发起退改申请，超过要求的期限商家未处理，第三方会直接退款给客人。如因商家逾期未处理造成损失，由商家承担，自我游不承担责任。
商家每天应登录自我游系统查看订单退改申请列表，及时联系供应商处理订单退改。
目前已知的退改时限（客人发起退改请求算起），抖音72小时，美团24小时，去哪儿24小时，飞猪24小时（部分景区产品飞猪是按即时退款执行）。
关于退改时限要求会有调整，请以各平台官方通告为准。
一、接口实现功能
下单（是在生成通知单后才下单到银科环企景区门票系统）；
取消订单、退单（支持）
重新发码（支持）
查看订单详细信息（支持）
查看订单日志（支持）
系统自动核销订单（支持）
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心
二、合作协议
（运营商与银科环企景区门票系统之间的合作协议）
三、银科环企景区门票系统提供参数
四、自我游商户需提供和核实的参数
供应商发码还是运营商发码。1是供应商发送短信，0是自我游商家发送短信。
五、自我游商户需提供给环企技术绑定回调地址
核销退款推送地址: http://运营商域名/api/yinkehuanqi/finish.jsp
六、添加供应商账号
运营商在系统给银科环企景区门票供应接口新增一个供应商，用于区别产品是哪个供应商系统提供的品。【供应商帐号开通，参考该链接： http://kf.zowoyoo.cn/hc/kb/article/191732/ 】
七、自我游系统产品发布流程
7.1产品导入
操作路径：运营管理——》供应商接口管理——》同步供应商产品——》导入产品
点击“导入产品”按钮自我游系统产品管理页面会自动生成一个产品，商户需针对产品去设置价格及库存之后再去操作上架
7.2产品发布时注意事项
①产品支持类型：门票、抢购、套餐，建议用门票类目发布
②产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到银科环企景区门票系统。
③出票操作及出票短信设置
【出票操作】设置为“需要”；如接口选择是商家发送短信，选择发送短信，【短信内容】需要编辑出票短信。出票短信内容编辑加入：$excode$，$excode2$这个是二维码链接，必须设置两个代码！
④如果产品是有返回二维码的，游客入园设置选择二维码凭证
⑤应到未到一定要选择默认的选项“人工做退改处理（如果支持多次验证必选这项），选择该选项供应商订单多张的多次核销，自我游才能接收到多次核销的处理
⑥发码类型根据景区的设置来，一定要和景区设置一致，不然可能会影响退款，如发码类型是一人一码，自我游系统产品的“客人必填信息”设置选择为“需要每个客人信息”
⑦发布产品时供应商接口信息注意选择“对应接口”：
⑧接口产品编码：点击“接口产品编号参考”去获取，绑定编码就是对接编码，直接将绑定编码复制到自我游接口产品编码一栏即可。
八、测试环节
使用分销商账号进行下单并支付。
九、订单退款
订单状态“已出票”：客人/分销商系统发起退改申请，自我游系统会自动将退改申请请求推送到银科环企系统，如存在自动推送退改申请请求到银科环企系统失败的情况，运营商需在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到银科环企系统，银科环企系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。银科环企系统返回取消成功后，自我游系统的订单直接显示“撤单”。
订单状态“已完成”：客人/分销商系统先线下联系运营商，然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到银科环企系统。然后银科环企系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。银科环企系统返回取消成功后，自我游系统的订单直接显示“撤单”。
注意：自我游系统跟银科环企景区门票系统接口订单退款支持部分退款。
操作异常处理：一人一码申请退款可支持部分退或者全额退，可指定需要退订的票码，退款取消数量要跟可退票码数量一致。
十、常见问题
问题描述：订单出现异常？
解决方法：通过点击“查看详细的接口日志”可以查看本订单的日志