酷秀旅游票务系统供应接口(10000302).md
酷秀旅游票务供应接口
接口实现功能
合作协议
酷秀系统提供参数
酷秀技术配置回调地址
运营商提供参数
运营商需知
自我游系统发布及设置
测试环节
订单退款
常见问题
修改日期:20161230
修改人:小菲
酷秀旅游票务供应接口
接口实现功能
取消订单(支持)
重发短信(支持)
查看酷秀订单详细信息(支持)
查看订单日志(支持)
系统主动抓取核销信息(支持)
接口返码(支持)
****温馨提示**** :API接口受网络影响较大,会存在一定风险,请运营商时刻留意接口订单状态及订单收款如有问题,请联系自我游公众号:自我游运营中心
合作协议
(运营商与酷秀系统之间的合作协议)
酷秀系统提供参数
酷秀技术配置回调地址
核销推送地址 http://运营商域名/api/kuxiu/finish.jsp
反码推送地址 http://运营商域名/api/kuxiu/print.jsp
退款推送地址 http://运营商域名/api/kuxiu/refund.jsp
运营商提供参数
无
运营商须知
自设价格:运营商在自我游系统可以直接设置对接酷秀产品的采购价和零售价。但是采购价要与酷秀的结算价价格一致,需要运营商手动及时更改自我游系统的产品价格,要不然就会导致订单的价格与酷秀的价格不一致的错误,导致下单失败。
酷秀价格:自我游系统直接同步酷秀系统的采购价和零售价,在客人下单前会抓取酷秀的最新价格,不会出现订单价格错误的情况,但是不利于设置分销价和零售价,需要通过价格规则进行设置 。
因此,运营商对接前一定要跟自我游运营部说明需要配置是哪一个接口。
自我游系统发布及设置
配置好接口过后在自我游【门票供应产品管理】中同步酷秀产品,必须建立酷秀的供应商,在门票供应产品管理页面输入并定位这个供应商,点击保存后,再进行导入产品。这样操作后自我游系统就会自动生成新产品到【产品管理】
运营商在系统给酷秀供应接口新增一个供应商,用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通,参考该链接: http://kf.zowoyoo.cn/hc/kb/article/191732/ 】
产品生成通知单需设置为:在预订(支付)成功后自动锁定订单,无需生成通知单。自我游系统的订单是在下达通知单时才同步到酷秀。
预定成功短信、生成通知单短信、出票短信都设置为不发送短信(备注:酷秀系统发短信)。
对应接口:由自我游配置好接口后才会显示。
产品编码:对应酷秀系统上的产品编码,直接填入即可
测试环节
使用分销商账号进行下单并支付。
订单退款
订单状态“已出票”:分销商登录系统,【订单管理】点击【退改申请】,运营商在退改申请功能里允许取消并点击退款后,取消的申请才会下发到酷秀系统。然后酷秀系统返回是否取消成功的值(返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看)。酷秀系统返回取消成功后,自我游系统的订单直接显示“撤单”。
订单状态“已完成”:分销商先线下联系运营商,然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后,取消的申请才会下发到酷秀系统。然后酷秀系统返回是否取消成功的值(返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看)。酷秀系统返回取消成功后,自我游系统的订单直接显示“撤单”。
常见问题
问题描述:订单出现异常?
解决方法:通过点击“查看详细的接口日志”可以查看本订单的日志。