广之旅票券门票供应接口
接口实现功能
合作协议
广之旅票券技术配置
广之旅票券系统提供参数
运营商提供参数
自我游系统发布及设置
测试环节
处理订单
订单退款
常见问题

修改日期：20190524
 修改人：王佳惠

广之旅票券供应接口

接口实现功能

重新发码(不支持)
主动抓取核销(支持)
取消订单(不支持)
获取对方订单详情(支持)
查询对方接口日志(支持)
接口返码（支持，并支持回传二维码）

****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心

合作协议

（运营商与广之旅票券之间的合作协议）

广之旅票券系统提供参数

运营商需要提供参数

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

广之旅票券技术配置

出票/核销通知地址：http://运营商域名/api/piaoquan/orderNotice.jsp

自我游系统发布及设置

运营商到【供应商接口管理】---【已开通接口】，找到对应的广之旅票券接口，操作同步供应商产品进入产品列表，搜索广之旅票后台的商品id，进行同步产品到系统。同步成功之后，在当前页面可以直接点击修改产品进入到产品详情完善产品资料（产品基本信息都会同步，但是产品景点标志图等还有其他信息需要手工完善跟供应商产品设置一致即可）。同步到自我游系统的产品在【产品管理】中也可以看到。

注意事项：此接口是一个产品编码对应多个不同票种，所以产品的票种以及包含人数必须要填写正确。因为相同产品不同票种是按照自我游系统发布的产品票种选项来进行区分。

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

产品短信：若是使用广之旅票券的出票短信，在发布产品的时候就无需设置短信。

如需要运营商发短信：【出票操作】设置为“需要”；【短信内容】需要编辑出票短信。出票短信内容编辑加入：$excode$，$excode2$这个是二维码链接

对应接口：选择广之旅供应券票接口。

产品编码：点击接口产品编号参考，可以选择产品，如下图。

测试环节

产品发布完毕，用分销商账号下单测试。

处理订单

查看订单状态，若订单状态显示【已成功，已支付】且广之旅票券那边没有订单同步，检查一下订单是否已经生成了通知单，需要生成了通知单才会下单到广之旅票券系统。

订单退款

此接口不支持退款，如需退款需在两边系统分别操作，先在广之旅票券系统操作退款，退款成功后再自我游系统操作退款。

常见问题

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