大麦门票供应接口
接口实现功能
合作协议
大麦门票技术配置
大麦门票系统提供参数
运营商提供参数
自我游系统发布及设置
测试环节
处理订单
订单退款
常见问题
修改日期:20190531
修改人:王佳惠
大麦门票供应接口
接口实现功能
重新发码(不支持)
主动抓取核销(不支持)
取消订单(支持,但不支持部分退款)
获取对方订单详情(支持)
查询对方接口日志(支持)
接口返码(不支持,所以不能对接到淘宝)
****温馨提示**** :API接口受网络影响较大,会存在一定风险,请运营商时刻留意接口订单状态及订单收款如有问题,请联系自我游公众号:自我游运营中心
合作协议
(运营商与大麦世园会门票之间的合作协议,需要按照文档,注册淘宝开放平台【https://open.taobao.com/】进行用户入驻,就可以提供店铺淘宝会员名称给大麦同事处理,处理好后,大麦就会将对接参数就会发到淘宝店铺的邮箱内。)
大麦门票系统提供参数
运营商需要提供参数
运营商给大麦世园会门票接口开一个供应商账号,用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通,参考该链接: http://kf.zowoyoo.cn/hc/kb/article/191732/】
大麦门票技术配置
无
自我游系统发布及设置
注意事项:此接口是一个产品编码对应多个不同票种,所以产品的票种以及包含人数必须要填写正确。因为相同产品不同票种是按照自我游系统发布的产品票种选项来进行区分。
客人资料要求,必须选择:要求输入每个客人资料
产品生成通知单需设置为:在预订(支付)成功后自动锁定订单,无需生成通知单。自我游系统的订单是在下达通知单时才同步到大麦系统。
产品短信:大麦不发送短信,可以在自我游系统设置一条【出票短信】,告知游客如何入园。$excode$【获取大麦系统数字码】,$excode2$【获取大麦系统二维码】。出票短信按照实际入园方式设置对应的代码。(基本入园方式为:刷身份证入园,具体可与大麦核实)
对应接口:选择对应的大麦接口。
产品编码:可在【产品编码参考】获取绑定编码。
价格设置注意要点:如果不同时间段有不同价格,可以在自我游系统增加多个价格规则,设置不同时期的价格。如果想享有优惠政策的话,零售价设置的是优惠后的价格,市场价设置优惠前的价格。
测试环节
产品发布完毕,用分销商账号下单测试。
处理订单
查看订单状态,若订单状态显示【已成功,已支付】且大麦那边没有订单同步,检查一下订单是否已经生成了通知单,需要生成了通知单才会下单到大麦系统。
订单退款
注意事项:不支持部分退款
1:订单状态“已出票”:分销商登录系统,【订单管理】点击【退改申请】,运营商在退改申请功能里允许取消并点击退款后,取消的申请才会下发到大麦系统。然后大麦系统返回是否取消成功的值(返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看)。大麦系统返回取消成功后,自我游系统的订单直接显示“撤单”。
2:订单状态“已完成”:分销商先线下联系运营商,然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后,取消的申请才会下发到大麦系统。然后大麦系统返回是否取消成功的值(返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看)。大麦系统返回取消成功后,自我游系统的订单直接显示“撤单”。
订单核销
核销不同步,需要手工在自我游系统验证订单,如果产品预定后就不允许退款,可以设置过了有效期自动变为已完成。
常见问题
1:问题描述:订单出现异常?
解决方法:通过点击“查看详细的接口日志”可以查看本订单的日志
2:退款申请出现返回【当前商家不允许退票】的提示,但是实际上大麦这个产品是允许退款的。
解决方案:大麦后台没有开通退款功能,需要大麦同事操作添加商户退票权限
3:下单提示【锁座异常实付金额是0分,应付金额是12000分】。
解决方案:是因为产品的市场价格没有设置好导致的。
4:不同市场价格,不同的预定时间模式,以及不同的场次是需要分开发布产品。