深大智游宝门票接口 - 广州自我游 - 自我游客户支持服务平台

修改日期：2022-10-11
修改人：符娇珠

特别说明

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

接口实现功能

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

合作协议

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

智游宝系统提供参数

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

选填参数（商家根据实际对接情况选取）

智游宝技术配置回调地址

订单完结回调地址
http://运营商域名/api/zhiyoubao/finish.jsp

退票回调地址
http://运营商域名/api/zhiyoubao/refund.jsp

自我游系统发布及设置

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

2、发布产品注意事项

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

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

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

产品编号：到智游宝系统查询，输入智游宝对应的产品编号。

3、及格及库存
在产品管理中，点击价格与库存，设置价格和库存。
图片.png

4、分时预约产品设置

固定时间段产品编码格式：智游宝产品编码,固定时间段

场景1：智游宝产品编码为PST2021012550000。现在要对接场次时间为10:00到11:00的，那么产品编码填写：PST2021012550000,1000_1100

上午场次产品编码格式：智游宝产品编码,0

下午场次产品编码格式：智游宝产品编码,1

全部产品场次产品编码格式：智游宝产品编码,2

测试环节

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

订单退款

【订单退款流程只能通过自我游系统操作退款，运营商不能直接到供应商系统进行退款】，智游宝接口支持部分订单退票但是只能退一次，退多次需要人工处理。

订单状态是已安排：分销商登录系统，【订单管理】点击【退改申请】，运营商在退改申请功能里允许取消并点击退款后，取消的申请才会下发到智游宝系统。然后智游宝系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。智游宝系统返回取消成功后，自我游系统的订单直接显示“撤单”。

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