云旅擎门票供应接口

接口实现功能

下单同步（运营商发送通知单给云旅擎时才下单至云旅擎系统）
取消订单时同步（同步）
订单退款时同步(同步）
查看对方订单详情（支持）
查看对接订单日志（支持）
发码（支持）
重新发码（不支持）
系统自动核销订单（不支持）
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心

合作协议

（运营商与云旅擎门票之间的合作协议）

云旅擎提供给运营商的参数

云旅擎技术配置回调地址

退款通知地址：http://运营商域名/api/yunlvqing/cancelReturn.jsp

运营商须知

由于云旅擎没有验证接口，自我游系统不会自动抓取订单验证状态，需要运营商关注云旅擎后台的订单状态（也可通过在自我游后台订单详情界面查看对方订单信息），及时在自我游系统手工验证订单。建议运营商验证环节设置为订单过了有效日期自动设置为完成状态。（针对过期可退产品可不设置为自动完成）

自我游系统发布及设置

1、运营商给云旅擎接口开一个供应商账号，用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通，参考该链接：http://kf.zowoyoo.cn/hc/kb/article/191732/】
2、客人资料要求选择【只需要输入一个客人资料】，客人必填信息选择【姓名】、【手机号码】、【身份证号码】，如图：
3、产品生成通知单控制设置为：在预付（支付成功后自动锁定订单，无需生成通知单，自我游系统的订单是生成通知单时才同步到云旅擎系统，如图：

4、产品详情界面接口信息的设置：由自我游配置好接口之后才会显示
5、产品编号：点击【接口从编号参考】进去查询，产品编号填写产品列表的商品ID

测试环节

下单：使用分销商账号进行下单并支付，需定位相关分销商并填写上相关的游玩日期、预定票数、游玩客人姓名、手机号、身份证号码，如图；

下单成功之后，可以通过自我游后台订单详情界面查看对方订单详细内容

订单退款

【订单退款流程只能通过自我游系统操作退款，运营商不能直接到供应商系统进行退款】自我游系统先发起退款申请，发起了退款申请后运营商处理退改申请，退款的要求会下达到云旅擎系统那边，需要等待云旅擎系统审核，该接口支持部分退款。

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

常见问题

问题描述：订单出现异常
解决办法：通过点击【查看详细的接口日志】可以查看本订单的日志，如图：

上一篇票工厂门票供应接口

下一篇携龙门票供应接口