蚂蜂窝门票分销接口文档
接口实现功能
1.产品属性同步
2.价格及库存同步
3.订单核销同步
4.订单取消同步
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款，如有问题，请联系自我游公众号：自我游运营中心
相关视频培训资料：
http://pan.baidu.com/s/1pLa66RT
密码：6t5q
合作协议
（运营商需与蚂蜂窝先达成合作并签署合作协议）
蚂蜂窝需要提供参数
无
运营商需提供参数
系统id和分销商id 组合
运营商id 获取办法如截图
【该分销商编号获取方法，参考该链接：http://kf.zowoyoo.cn/hc/kb/article/1009468/】
运营商需要提供参数给马蜂窝
arentordercustid：系统id+分销商id
自我游系统操作及设置
【合作伙伴→分销商管理】点击“管理”，设置接口支付方式为“授信扣除”；点击“信用授权”设置信用额度。（建议额度大一点，便于接口下单，授信不足会下单失败）。
分销价：分销价是商家跟蚂蜂窝的结算价，设置分销价时要根据与蚂蜂窝的返佣点，如果跟蚂蜂窝签订的返佣点是6个点，那么可以针对对接蚂蜂窝的分销商设置分销商全局价格授权，分销价=零售价*0.94
poI可以直接在蚂蜂窝网站查询，先输入目的地，然后再在目的地上找到具体的POI ，如查询不到对应的pio需联系马蜂窝人员添加
2.包含项目与票种说明——>（产品发布页面）
产品退款设置
1.第一个选项对应不可退 ，第二个选项对应随时可退，第三个对应有条件退
注意：此时间为用户预订时间+产品有效期时间，例如客户预订是5.1号 的票，有效期选择为游客选定日期延后2天有效，那么游客在5.3号14:00之前都是可以退款的。
退款手续费：可以根据产品属性来设置是否要扣取手续费。
部分退款：退款类型要选择第三项有条件退款时，部分退款才生效。
2.如果退款时间选择为无时间限制和退款手续费为0时，系统会读取产品属性里面的退款规则，如果满足条件的话系统会自动退款
产品推送
1.【渠道（串货）管理】→【蚂蜂窝门票】→【产品授权】→【产品推送】。
（1）产品属性修改时，必须点【产品变化通知】推送。
（2）已经授权的产品如需下架，点【产品下线】，营商除了在自我游系统点击【蚂蜂窝门票】——【取消授权】 外，建议运营商最好是线下跟蚂蜂窝业务联系，让蚂蜂窝业务将产品在蚂蜂窝网站下架。因为点击【取消授权】的功能后，只是客人无法在蚂蜂窝网站预订下单，但产品还是可以正常显示在蚂蜂窝网站上
（3）产品如果修改了价格必须要点击【更新价格日历】，价格才会立即同步到蚂蜂窝
订单处理
未支付状态：客人在蚂蜂窝取消，或运营商在系统取消。
已支付、未出票：客人在蚂蜂窝操作取消订单直接退款；或是运营商在系统直接取消。
已出票：客人在蚂蜂窝发起取消申请，运营商在系统退改申请处理-同意，订单直接退款；运营商在系统用蚂蜂窝分销商账号登陆，发起退改申请，运营商在系统退改申请处理-同意。
已完成：客人联系蚂蜂窝客服，蚂蜂窝客服线下找到运营商，运营商线下退款给客人，同时在系统里把订单做异常把订单取消。
关于退改时限要求，请以平台官方通告为准。如逾期未处理造成损失，自行承担。
一：自营订单退款处理
①如接口要求自营产品需要人工审核，客人在蚂蜂窝发起退款申请，自我游商户必须在自我游系统【退改申请处理】，点击【处理】。自我游商户请勿对订单做异常处理，此操作退款状态是无法同步到蚂蜂窝。
二：对接第三方供应商系统的订单退款处理
①客人在蚂蜂窝发起退款申请，该订单对接的供应商接口还没升级自动推送退款请求，自我游商户需在自我游系统针对订单操作“异常处理”，选择“允许取消”保存后，再点击“退款”。接口自动将退款信息推送给供应商，等供应商返回退款处理结果。（退改申请处理里暂时不要进行任何操作） ，供应商同意退款，运营商再回到自我游【退改申请处理】，点击【处理】“同意取消”。若供应商拒绝退款，点击“拒绝取消”。状态会直接同步到蚂蜂窝。
②该订单对接的供应商接口还没升级自动推送退款请求，商户想实现自动推送退款请求给到供应商接口，自我游系统产品可设置退款规则，客人发起退款申请时，自我游系统会自动将退款请求推送给供应商接口，等供应商返回退款处理结果。自我游会将“同意”或“拒绝”状态推送给蚂蜂窝。PS：该设置以实际下单退款后结果为准，因不是所有供应商接口都支持，在设置之后下单测试后产品再上线
③客人在蚂蜂窝发起退款申请，该订单对接的供应商接口可实现自动推送退款请求，接口自动将退款信息推送给供应商，等供应商返回退款处理结果。（退改申请处理里暂时不要进行任何操作） ，等供应商返回“同意退款”或“拒绝退款”状态给自我游，自我游再推送给蚂蜂窝。
常见问题
【问题描述】针对蚂蜂窝渠道的产品授权时提示“合作方未授权产品”
原因：1.pio填写有空格
2.没有填写项目包含或者副标题
2.【问题描述】在自我游系统修改了价格并且点击更新价格，提示更新价格成功，但是马蜂窝那边价格没有变化。
原因：蚂蜂窝那边有做价格缓存，如想要价格显示修改过后最新的价格联系蚂蜂窝人员处理。
3.【问题描述】针对蚂蜂窝渠道的产品授权时提示“不同供应商出现重复的sku碰撞”
原因：这是蚂蜂窝内部返回的报错
解决办法：咨询蚂蜂窝人员
【问题描述】针对蚂蜂窝渠道的产品授权时提示“获取合作方库存数据为空”
4. 原因：产品没有价格和库存。
【问题描述】针对蚂蜂窝渠道的产品授权时提示“，蚂蜂窝pio_id校验失败”
原因：蚂蜂窝那边pio挂靠错误，需要联系蚂蜂窝人员处理。