美团酒+景渠道接口
接口实现功能
合作协议
美团系统提供参数
运营商提供参数
自我游产品发布及设置
产品推送步骤
美团系统设置及操作
测试环节
处理订单
订单退款
常见问题

修改日期：20161229
修改人：张语嫣

美团酒+景渠道接口

接口实现功能

美团酒加景接口支持多种产品发布方式。门票套餐、打包1（组合套餐由单酒店跟单门票进行打包）、支持打包2自由行产品。
订单同步
产品属性同步
产品价格、库存同步
退款同步
核销同步
****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款，如有问题，请联系自我游公众号：自我游运营中心

合作协议

（运营商与美团之间的合作协议）

美团系统提供参数

运营商提供参数

运营商需要在自我游系统新增美团景+酒的分销商账号，然后提供对应分销商的商户ID
 
提供分销商编号。【该分销商编号获取方法，参考该链接：http://kf.zowoyoo.cn/hc/kb/article/1009468/】

运营商须知

要说明订单在自我游系统是以生成通知单状态确认给美团还是订单支付状态就确认订单给美团。

自我游产品发布及设置

1. 【合作伙伴→分销商管理】点击管理，设置接口支付方式为“授信扣除”；点击“信用授权”设置信用额度。（建议额度大一点，便于接口下单，授信不足会下单失败）
    
   产品发布（支持三种发布方式）

2. 套餐类别：发布门票+酒店的套票，支持两个景点。
   
   

3. 【产品打包管理】-【套餐或联票】：运营商必须要在自我游系统上分别发布一个单门票(最多支持两个景点)和一个单酒店房型的产品，再使用产品打包功能将这2个产品组合成套餐。
   
   

4. 【产品打包管理】-【自由行产品】：运营商必须要在自我游系统上分别发布门票单产品和酒店房型的单产品，再使用产品打包功能将这些产品组合成套餐。
     自由行打包支持：
     (1)一个景点的单门票+一个酒店的多个房型的组合套餐,
     (2)一个景点的多种门票+一个酒店的单个房型的组合套餐,
     (3)两个景点的门票+一个酒店的单个房型的组合套餐,
     (4)两个景点的门票+一个酒店的多个房型的组合套餐。  
     注意：景+酒的套餐产品里不允许出现多个景点和多个酒店的情况。
   【自由行打包产品推送到美团，系统就会自动组合推送套餐产品给美团。套餐产品的售价是两个子产品的零售价之和。】
   
   

5. 在发布打包产品对应描述，按照需求进行填写。注意事项：使用打包方式发布产品的，套餐产品的属性必须要与子产品的属性一致，否则属性有矛盾会被美团驳回。

6. 提前预订时间设置，取产品的最大天数进行推送；（推送产品设置天数中最大的天数）例如：酒店需要提前3天预订，门票需要提前2天。推送到美团就会读取需要提前3天预订。

7. 产品属性设置–打包的门票产品、酒店产品及产品打包后的销售范围必选为“允许对同行和直客销售的产品”，如图：
        

8. 产品必须有首图（详情描述中进行上传图片点击标志图）。图片规范如下：①：  图片像素为640*360，宽高比例为4:3，大小不超过10M，格式为jpg、png、jpeg； ②：图片不得含有水印/LOGO/文字/边框/PS痕迹
   
   

9. 系统的客人资料要求和信息：对应宙斯系统的联系人信息。
    

产品推送步骤

1. 商户需要在【美团酒+景旅游管理】页面添加宙斯系统对应的POI。点击【宙斯POI匹配】
   
   

2. 选择相应的景点/酒店后，点击【匹配POI】

3. 填写宙斯系统POI id：若ID已存在，直接点击保存即可。
      

4. 若宙斯系统POI id 为空，则需要商户自行填写。填写对应的景点/酒店ID有两种方式：
   方法1:商户可直接先去大众点评官网上找对应的景点/酒店ID，将对应的景点/酒店ID直接填写，保存即可。如下图：
        
   方法2:商户可点击“匹配宙斯系统POI”，系统自动进行ID匹配。但是必须美团审核通过后才能匹配成功。可点击“查询宙斯POI匹配”查看匹配状态。如下图：
   
   

5. POI匹配成功，匹配状态会出现点评POI id数值，成功状态如下图：
   
   

6. 匹配宙斯POI后，点击【授权酒+景】，然后点击【美团景酒模板】，必须先将相关的产品信息完善。必须要按照绿色字体提示内容范本要求填写，否则美团编审会进行驳回处理。美团酒景模板里面的相关内容只需在此界面进行完善，无需在产品管理中再进行产品属性设置。
    
    

7. 若需要授权自由行打包产品给美团。系统就会自动组合推送套餐产品给美团。美团景酒模板会自动显示相应的组合套餐，商家需要针对套餐内容相关信息按照范本进行完善。如下图：
   
   

8. 完善产品信息后 ，点击【同步基础数据】（更改产品说明描述等需要点击此推送按钮）—【同步价格库存】（自动触发美团审核）；

9. 【查询产品状态】：可以通过点击该按钮查询运营商推送的产品在美团是否在线售卖。如下图，显示制作中时，可点击【发起审核】，触发美团审核。
   
   

10. 已经授权的产品，如需下架，点击【取消授权（下架）】。

11. 新授权推送的产品，系统的美团状态默认都是未上线，需要点击【查询宙斯已上线产品】才能把所有上线的状态更新。
    
    

12. 如产品被美团驳回下线，美团是不会主动推送下线状态给自我游。需要商家在自我游后台找到相应的产品点击【取消授权（下架）】或者点击【查询宙斯已上线产品】，将美团的状态更新为“未上线”。否则自我游的产品依然显示为上线状态，系统会不停的推送价格库存给美团，这时候美团的产品会变为待审核状态，产品就会不断的上线再下线。

13. 如已在宙斯系统上了产品，必须先与自我游的产品进行关联。在下图宙斯系统页面填写“供应商套餐ID”（否则会导致下单失败）
    宙斯老单子迁移的流程：商家先在宙斯后台找到迁移的产品，将自我游的套餐产品ID写入对应的商品ID保存，对应关联后，在自我游后台推送这个产品，   提交美团审核这样就可以了，也保留之前的产品销量。
    产品ID对应如下3种情况：
    (1)如产品是直接通过套餐发布的，直接在宙斯系统填写套餐的产品ID。
    (2)如是通过系统打包一【套餐或联票】发布的产品，填写打包套餐的产品ID。
    (3)如是通过系统打包二【自由行产品】发布的产品，宙斯系统的商品ID对应自我游系统套餐ID。
    宙斯系统的套餐ID对应自我游：填写多个（门票ID_酒店房型ID）
    
    

美团系统设置及操作

推送产品到美团后台被驳回，需要到美团后台查看驳回原因，到自我游系统修改在进行推送。

测试环节

在美团官网上找到自己的产品，并下一个测试单。

处理订单

订单退款

1. 订单一旦确认，美团客人是无法发起退改申请。需要运营商在自我游系统进行退款操作。

2. 订单确认后，客人需要退款。需要跟运营商进行协商，协商后运营商同意退款的话，运营商可以直接给该订单进行处理退款操作。
   (1)打包订单:运营商需要先对子订单做异常处理，选择“允许取消”保存后，点击“退款”。子订单退款成功，母订单的状态会自动变为撤单。同时将退款结果推送给美团。
   (2)针对系统对接了第三方供应商系统的订单，运营商需要对子订单做异常处理，选择“允许取消”保存后，点击“退款”。接口自动将退款信息推送给供应商，等供应商返回退款处理结果。供应商返回同意退款结果，母订单的状态会自动变为撤单。同时将退款结果推送给美团。

3. 如需部分退款，运营商需要跟美团联系，线下给客人退款。然后在系统里直接针对订单进行部分退款操作。

常见问题

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

2. 问题描述：对方订单情况如何查询
解决问题：可以查看到美团订单酒加景状态

3. 问题描述：能否把美团的券号反应到我们系统订单详情中?
解决问题：接口不支持。

4. 问题描述：为什么设置了套餐id，同步还是提示产品不存在
解决问题：对接美团景+酒，除了套餐id还需要填写商品id。

5. 问题描述：自我游系统里订单管理提示子订单拆单失败，是什么原因？
 
解决问题：子订单拆单失败要点击进去查看订单日志和订单操作日志
可能原因是：子产品的游客信息是需要填写证件号码的，但母产品游客信息又设置为不需要，这样在拆单时肯定是失败的。如果子产品是需要证件号码的，母产品也要设置为要证件号码。

6. 问题描述：推送产品到美团提示“商品合同缺失”如下图，该如何解决呢?
 
处理方法：请联系美团人员查看是否合同编号填写错误。

7. 问题描述：推送产品到美团提示出现null以下截图：
解决方法：请检查产品设置是否完善，必填项目是否都有填写。

8. 问题描述：对接美团景+酒，商户产品已对接成功，在美团上线售卖，但游客下单时订单没有进入系统，这个是什么原因？
解决方法：让商户联系美团业务开通接口下单功能，如打开下单接口过后，商户订单还是没有进入系统，请检查以前对接的老产品有没有迁移完毕，美团设置老产品没迁移完是不能打开下单接口的，产品没迁移完直接下单，订单会下单失败。

9. 问题描述：推送产品到美团时提示“供应商商品在点评不存在”，如图
解决方法：这个是因为商户没有同步这个产品的数据过去，就直接点击审核，美团那边没有这个产品的信息，接口就会返回商品不存在。
推送产品的正确步骤：点击【同步基础数据】（更改产品说明描述等需要点击此推送按钮）——【同步价格库存】（自动触发美团审核）