蜂窝平台门票分销接口文档
接口实现功能
合作协议
蚂蜂窝需提供参数
运营商需提供参数
自我游需提供给马蜂窝参数
自我游产品发布及设置
蚂蜂窝平台设置及操作
产品推送步骤
测试环节
订单退款
常见问题
修改日期:2018.09.30
修改人:阿一
蚂蜂窝平台门票分销接口文档
接口实现功能
产品名称同步;
价格同步(只同步分销价即是运营商与蚂蜂窝之间的结算价);
订单、退款和核销同步。
****温馨提示**** :API接口受网络影响较大,会存在一定风险,请运营商时刻留意接口订单状态及订单收款,如有问题,请联系自我游公众号:自我游运营中心
合作协议
(运营商需与蚂蜂窝先达成合作并签署合作协议)
蚂蜂窝平台需提供参数
运营商需提供参数
【该分销商编号获取方法,参考该链接:http://kf.zowoyoo.cn/hc/kb/article/1009468/】
运营商提供给蚂蜂窝平台参数
action:push.order.sync
配置地址:http://saas.zowoyoo.com/channel/mafengwopt/mafengwoptPushOrderSync.jsp
蚂蜂后台上单流程
1.登录蚂蜂窝管理系统:产品管理——》新建产品——》销售模式(平台)——》产品类型(景点门票),然后会自动调整到产品详情页面,商家需要完善好一些产品的基本属性后直接操作保存;
2.保存产品成功后点击编辑进去,将产品的票种关联好,并且设置好对应的价格,并且将自我游产品编号跟蚂蜂窝产品进行绑定;
自我游产品绑定
1.该蚂蜂窝平台商品绑定功能只支持之前在蚂蜂窝平台后台成功发布过的商品;
2.运营商在蚂蜂窝平台没有绑定自我游商家的产品编号,游客下单后订单是失败。针对此种情况,运营商可以在自我游后台直接操作绑定产品,然后再点击重新下单;
测试环节
在蚂蜂窝上找到自己的产品,并下一个测试单;
订单退款
一. 游客在蚂蜂窝申请退款,会同步到自我游系统;
关于退改时限要求,请以平台官方通告为准。如逾期未处理造成损失,自行承担。
1:自营订单退款处理
①如接口要求自营产品需要人工审核,客人在蚂蜂窝发起退款申请,自我游商户必须在自我游系统【退改申请处理】,点击【处理】。自我游商户请勿对订单做异常处理,此操作退款状态是无法同步到蚂蜂窝。
2:对接第三方供应商系统的订单退款处理
①客人在蚂蜂窝发起退款申请,该订单对接的供应商接口还没升级自动推送退款请求,自我游商户需在自我游系统针对订单操作“异常处理”,选择“允许取消”保存后,再点击“退款”。接口自动将退款信息推送给供应商,等供应商返回退款处理结果。(退改申请处理里暂时不要进行任何操作)
,供应商同意退款,运营商再回到自我游【退改申请处理】,点击【处理】“同意取消”。若供应商拒绝退款,点击“拒绝取消”。状态会直接同步到蚂蜂窝。
②该订单对接的供应商接口还没升级自动推送退款请求,商户想实现自动推送退款请求给到供应商接口,自我游系统产品可设置退款规则,客人发起退款申请时,自我游系统会自动将退款请求推送给供应商接口,等供应商返回退款处理结果。自我游会将“同意”或“拒绝”状态推送给蚂蜂窝。PS:该设置以实际下单退款后结果为准,因不是所有供应商接口都支持,在设置之后下单测试后产品再上线
③客人在蚂蜂窝发起退款申请,该订单对接的供应商接口可实现自动推送退款请求,接口自动将退款信息推送给供应商,等供应商返回退款处理结果。(退改申请处理里暂时不要进行任何操作) ,等供应商返回“同意退款”或“拒绝退款”状态给自我游,自我游再推送给蚂蜂窝。
二.对于部分退款的,建议运营商手工在蚂蜂窝上操作退款,蚂蜂窝平台推送申请退款信息没有提供退款金额。
常见问题
1.如只在蚂蜂窝后台操作绑定自我游产品编号,需要取消授权的话怎么操作?
A:在蚂蜂窝后台操作取消绑定自我游产品编号即可;
2.如只在自我游后台操作绑定蚂蜂窝商品编号,需要操作取消授权的话怎么操作?
A:直接在自我游后台蚂蜂窝门票管理页面针对此产品操作删除绑定;
3.如在蚂蜂窝后台操作绑定自我游产品编号,并且在自我游后台操作绑定蚂蜂窝产品编号,如果取消授权的话需要怎操作?
A:在蚂蜂窝后台操作取消绑定自我游产品编号并且要在自我游后台蚂蜂窝门票管理页面针对此产品操作删除绑定;