美团酒店-直连平台

对接方内部的供应商。

当对接方为服务提供商，且美团和对接方内部提供商进行结算时，需要在美团为每个供应商分配partnerId。注意：同一个供应商接入海外酒店与国内酒店，可能需要视情况设置2个partnerId。

一种活动，每个供应商默认只对应一个正价活动，保存默认的销售规则、取消规则、佣金（率）。

正价活动没有活动码。目前平台只支持正价活动。

我们将酒店这个概念分成2个层次，分别是物理酒店和逻辑酒店；

物理酒店这个概念中，我们会存储具体的酒店（门店、分店）的相关信息，比如酒店地址、酒店的经纬度等，这些信息不会由于合作商（供应商）的不同而发生变化；

逻辑酒店这个概念中，我们会存储那些由于合作商的不同，导致物理酒店上的一些信息发生了变化，我们将这些变化的信息保存在逻辑酒店上，比如酒店的预约电话，上海某国际大酒店门店自己的预约电话是：(8621) 68888888-8888，而当合作商是要某旅行网时，预约电话就变成了：4008888888；

逻辑酒店也叫虚拟酒店，在美团的系统中，用 合作商ID＋POI id 来唯一标示；

5个基本信息：酒店城市、名称、地址、电话、经纬度

1. 如何进行POI新增？

   答：先将对接方的门店ID导入白名单，在POI同步接口中传输POI信息，5个基本维度都匹配上，就能成功上线。

2. 如何进行POI的下线？

   答：如果想将对接方某酒店的数据全部下线， 在房态同步接口中，将syncType设置为1， roomPriceDetail中将该酒店的value置为[]空数组即可。如将对接方酒店ID为 1635201下的所有数据下线，则roomPriceDetail的值为{ "1635201":[]}

3. POI定时推送频率以及时间点？新增POI是否立即推送？

   答：每天0点定时推送。新增POI不需要立即推送，只需在POI定时同步任务中添加即可。

4. breakfastNum参数问题。如：调用产品上下线接口，为什么提示产品不存在？

   答：类似的接口还有，产品销售规则同步、产品价格同步、产品库存同步等。美团酒店平台，通过poiId、roomType、breakfastNum唯一确定产品。如果你想下线早餐数为2的产品，那么必须传参数breakfastNum并且设置为2，否则默认是操作早餐数为0的产品，可能会提示产品不存在或者错误操作产品。

5. 产品上下线接口只能操作单个产品，对接方想批量操作怎么办？

   答：使用房态全量同步接口，房态参数中只需不包括下线产品，平台会根据POI下产品的变化自动下线。

6. 全量房态定时推送频率及时间点？

   答：房态定时任务每天每个POI请求次数小于4次，建议同步每个POI 60天内的房态数据。而诸如价格、库存等的变化，使用相应的增量同步接口进行实时同步。

7. 如何进行产品与房型的新增？

   答：在全量同步的接口中推送新增的产品与房型信息即可。

8. 如何进行房型的下线？

   答：全量同步时，不带上想要下线的房型即可。

9. 单门店的房型传输，单次的上限是传100个？

   答：是的。若供应商的单个门店中，价格计划中有100个以上的，也希望供应商选择其中优质的房型传输至美团平台进行售卖。

10. 房型名称如果含有供应商的字样没有关系吗？

    答：具体的规则可以双方协商，可以由供应商提供一些具体的房型名称案例，美团会将规则告诉到供应商。

11. 房型名称过长？比如99个字以上？

    答：接口的接收规则是最多传输33个汉字。

12. 房型是否含窗的信息，可以不提供吗？

    答：可以。非必填信息。

13. 床型描述无法提供，可以不提供吗？

    答：可以。非必填信息。

14. 宽带信息如何传输？

    答：美团目前对于房型的宽带信息，有4种显示选项：1、无法上线。2、含无线WIFI。3、含有线宽带。4、含无线WIFI与有线宽带。但并不能区别是否为收费的宽带服务。实际对接中有特殊情况可协商。

15. 含早餐信息的房型，如果是部分天数含早，部分天数不含早，如何传输？

    答：按照每天的实际情况传输即可。

16. POI静态信息如何传？

    答：6月目前使用excel线下传输，同时美团内部资料库会进行POI信息匹配。7月会上线POI静态信息传输接口，届时使用接口传输。

17. 目前是否支持礼品活动？

    答：目前不支持，有支持的话会第一时间在官网发出通告。

18. 如果使用的是房态定制接口，美团的房间价格传的是售卖价格还是底价？

    答：在对接中协商确认。

19. 房态信息的变量同步时间的间隔是多少？

    答：美团建议使用实时信息推送，如果推送的数量过大，可以先只同步10天的变量房态。

20. 顾客预订的间夜数是否有上限？

    答：目前的上限是180个间夜。

21. 顾客的入住基本时间点，是否为18点？如果14点入住的客户在18点之前申请取消，怎么办？

    答：在顾客从APP端申请取消订单时，美团会调用供应商的接口，以接口信息为准。

22. 顾客下单时，如果房态信息已变更怎么办？

    答：在顾客下单前，美团都会校验信息，查到信息变更之后就会展示更新的信息，并且提示顾客下单失败需重新下单。

23. 客户发票由哪方开？

    答：美团建议由入住门店即时给顾客开具发票。具体特殊情况可在对接时协商。

24. 非即时确认的订单，在预订中顾客是否可以无条件发起取消操作？

    答：美团建议：在非即时订单中，顾客可以预订中的时候取消。有特殊情况可以在对接中协商。

25. 如果有退款操作，是只有美团的客服才能操作退款吗？

    答：是的，只有美团的客服才能操作退款。客户致电美团客服，由美团客服确认后进行中断操作并退款,需与酒店的双方运营人员线下确认。入住门店的人员是不能进行退款操作的。

26. 如果有少数酒店，需要凭借酒店的order/confirm ID来办理入住，怎么办?

    答：优先合作不必order/confirm ID来办理入住的酒店，具体情况可以协商。

27. poi同步出现“转换POI请求参数”失败，如何处理?

    答：请注意POI同步接口参数的必填项和参数类型，并以http消息体方式传参，可以使用https://openplatform-hotel.meituan.com/portal/poi进行测试。

28. 是否支持一个多间夜订单的部分间夜取消?

    答：不支持，目前只能整单取消后，重新下单。

29. 订单结算时间如何归并,是否按照离店日期?

    答：按照离店日期。如月结结算中，一个订单从6月15日住到7月15日，则整单都在7月账单中结算。

30. 入住人电话下单时可以提供么?

    答：暂时不可以,后续会逐步优化。

31. 增量同步房态接口，对未同步的产品有影响吗？

    答：没有影响。如价格接口，只会修改指定产品给定时间的价格，不会影响诸如库存、销售规则等。

32. 价格、库存等不符合条件，导致校验订单失败，需要返回最新房态吗？

    答：需要，与校验结果一同返回，避免订单校验重复失败。

33. 订单的创建和取消是否都是及时确认?

    答：创建订单有及时确认和非及时确认两种方式，但是取消订单只有及时确认，即无取消中状态，必须明确返回取消操作的状态（成功或失败）。

34. 美团用户取消订单，对接方返回取消失败，订单状态应该是什么？

    答：若对接方订单取消失败时，订单状态应该保持为“预定成功”，不要将订单状态置为“预定失败”。

1. 对接方开发阶段使用什么partnerId和clientSecret？ 

   答：刚开始对接阶段,美团会随机分配测试用的partnerId和clientSecret，测试完成后，美团会分配全新的partnerId和clientSecret，用新分配的partnerId和clientSecret在staging环境选择一个或多个poi进行POI、房态、订单相关接口的测试，测试完成后即可正式上线。

2. 访问http://openplatform.hotel.test.meituan.com/open为什么404？

   答：要使用美团酒店直连平台对接文档-3.3在线测试工具中的URL进行测试。如需要测试认证加密结果，可以访问：http://openplatform.hotel.test.meituan.com/open/test/auth

3. 我是技术服务提供商，如何补充partner来添加旗下合作供应商范围？

   答：由美团运营人员进行对接处理。

4. API文档更新后，是否还是使用V1地址，或者有新的地址？

   答：除非接口有重大变动且无法向下兼容了，才会使用新版本号，否则依然使用版本v1。

5. belongPartnerId是否是通过美团设置，又或者是在POI同步时进行设置？

   答：目前不管是POI同步还是房态同步，美团都不会保存belongPartnerId的值，但会使用belongPartnerId来区分是哪个供应商，因此在接口中每次都需将belongPartnerId的值传过来。

6. 接口对应的contenType是什么？

   答：application/json。

7. poi同步出现“转换POI请求参数”失败，如何处理？

   答：请注意POI同步接口参数的必填项和参数类型，并以http消息体方式传参，可以使用https://openplatform-hotel.meituan.com/portal/poi进行测试。

8. 权限认证以及加密解密问题

   答：若不使用SDK开发的对接方，权限认证和加密解密的相关逻辑和验证，可参照美团酒店平台对接文档—3.2工具类部分。

9. POI同步的城市ID怎么填写？

   答：参考https://openplatform-hotel.meituan.com/portal/cityId.xls，填写正确的cityId。如经纬度、cityId填写错误，会影响POI在期望城市的展示。8月会上线查询cityId的接口。

10. 测试环境，同步过房态，为什么订单测试还是提示无对应房态？

    答：测试环境下，房态时效只有2小时、容量只有100，因此房态可能会过期失效或者被覆盖。建议订单测试前，全量同步一次房态。

11. 订单测试工具的测试用例没有通过怎么办？

    答：订单测试工具会根据同步的房态，生成请求参数，需要保证对接方房态和同步的一致。另外，参考订单测试工具的提示信息，核对订单相关接口逻辑以及返回结果。注：订单测试工具的测试用例，会在短时间内调用多次对接方订单相关接口。

12. 测试环境，调接口400或504怎么办？

    答：HTTP 504：一般原因是服务超时，请联系运营处理。
    HTTP 400：一般是参数错误。

13. 平台白名单端口默认是25,80,110,143,443,8080,587

    答：注意订单相关接口的端口号配置。

1. 线上遇到问题，对接方的处理流程是什么？

   答：1.登录数据平台，查询相关POI、产品（价格、库存等）是否同步成功或订单在美团的状态；(销售规则相关问题直接联系运营)
   2.如果POI、产品信息不相符，请重新同步POI和房态；如果同步依然不成功，请参考相关文档核对参数；
   3.订单问题，请核对订单请求参数、对接方产品信息、美团产品信息的一致性；
   4.如依然还有问题，请与美团酒店平台运营反馈。

2. 线上环境的切换，请及时反馈给美团酒店

   答：订单相关接口URL等变更。请及时通知美团平台的运营同学。

3. 如何把POI添加到白名单？

   答：由美团运营人员进行对接处理。

4. 白名单是否可由对接方控制？

   答：目前这个还在等排期开发。希望大家关注官网API的更新记录。

5. 关于请求次数超限问题
   
   答：如价格接口的限速为每分钟60次，实际使用时间窗口：按秒计算。例如：3秒内发送50次请求，1分钟也只发送50次请求，但实际上还是会算超限的。平台限速策略：
   1. 每个供应商都有默认的独享接口限速(默认每分钟60次)。若请求未超限，则能正常访问；若请求超限，启用累计限速策略。
   2. 累计限速策略，累计阈值为200次。若请求超限，启用10分钟拒绝访问，返回CODE=62，10分钟后累计次数清0;累计次数未达200次，启用API接口级别限速策略。
   3. API接口级别限速默认20次/秒。若请求未超限，则允许访问；若请求超限，则启用API拒接访问，返回CODE=61。
   4. 如果默认的限速的策略确实不能满足业务需求，可以和运营沟通，考虑调整独享接口限速上限。

6. 全量同步接口提示请求成功，为什么查询不到房态？

   答：只有创建新产品的接口是同步请求，其他诸如POI同步、房态全量同步接口等为异步请求，提示房态同步成功仅仅表明通过平台的校验，已经成功添加到同步队列中。过一段时间，依然查不到产品，可能是由于参数或者系统原因，实际上房态并没有同步成功。

7. 配置的服务结束时间为18:00，为什么还没到18:00产品就不展示?

   答：美团服务时长策略：例如，配置供应商18:00停止服务，那么到17:00开始美团酒店就开始陆续不展示产品。

8. 预定中状态的订单，为什么会被美团认定为预定失败？

   答：非及时确认订单返回预定中时，美团酒店会轮询订单状态，如果超过配置的订单确认时长（如：2小时）后，将订单状态置为预定失败状态。注：非及时确认订单1分钟轮询一次，异常订单5分钟轮询一次。

1. 如何进行POI新增？

   答：先将对接方的门店ID导入白名单，在POI同步接口中传输POI信息，5个基本维度都匹配上，就能成功上线。

2. 如何进行POI的下线？

   答：如果想将对接方某酒店的数据全部下线， 在房态同步接口中，将syncType设置为1， roomPriceDetail中将该酒店的value置为[]空数组即可。如将对接方酒店ID为 1635201下的所有数据下线，则roomPriceDetail的值为{ "1635201":[]}

3. poi同步出现“转换POI请求参数”失败，如何处理？

   答：请注意POI同步接口参数的必填项和参数类型，并以http消息体方式传参，可以使用https://openplatform-hotel.meituan.com/portal/poi进行测试。

4. POI定时推送频率以及时间点？新增POI是否立即推送？

   答：每天0点定时推送。新增POI不需要立即推送，只需在POI定时同步任务中添加即可。

5. POI同步的城市ID怎么填写？

   答：参考https://openplatform-hotel.meituan.com/portal/cityId.xls，填写正确的cityId。如经纬度、cityId填写错误，会影响POI在期望城市的展示。8月会上线查询cityId的接口。

1. POI静态信息如何传？POI查询时获得的参数中有很多是POI同步并没有给到的，这些数据从哪里传递呢？

   答：由专门的POI扩展信息推送接口（POI扩展信息可能近期不会在app端展示。目前推送POI扩展信息的接口还在内测阶段，预计近期上线，上线后会在官网公布），对接方可通过这个接口将POI的扩展信息推送给美团。

房型同步

1. 单门店的房型传输，单次的上限是传100个？

   答：是的。若供应商的单个门店中，价格计划中有100个以上的，也希望供应商选择其中优质的房型传输至美团平台进行售卖。

2. 房型名称如果含有供应商的字样没有关系吗？

   答：具体的规则可以双方协商，可以由供应商提供一些具体的房型名称案例，美团会将规则告诉到供应商。

3. 房型名称过长？比如99个字以上？

   答：接口的接收规则是最多传输33个汉字。

4. 房型是否含窗的信息，可以不提供吗？

   答：可以。非必填信息。

5. 床型描述无法提供，可以不提供吗？

   答：可以。非必填信息。

6. 宽带信息如何传输？

   答：美团目前对于房型的宽带信息，有4种显示选项：1、无法上线。2、含无线WIFI。3、含有线宽带。4、含无线WIFI与有线宽带。但并不能区别是否为收费的宽带服务。实际对接中有特殊情况可协商。

7. 含早餐信息的房型，如果是部分天数含早，部分天数不含早，如何传输？

   答：按照每天的实际情况传输即可。

8. 如何进行产品与房型的新增？

   答：在全量同步的接口中推送新增的产品与房型信息即可。

9. 如何进行房型的下线？

   答：全量同步时，不带上想要下线的房型即可。

POI白名单

1. 如何把POI添加到白名单？

   答：由美团运营人员进行对接处理。

房态同步

1. 目前是否支持礼品活动？

   答：目前不支持，有支持的话会第一时间在官网发出通告。

2. 如果使用的是房态定制接口，美团的房间价格传的是售卖价格还是底价？

   答：在对接中协商确认。

3. 房态信息的变量同步时间的间隔是多少？

   答：美团建议使用实时信息推送，如果推送的数量过大，可以先只同步10天的变量房态。

4. 顾客预订的间夜数是否有上限？

   答：目前的上限是29个间夜。

5. 为什么逻辑房型下的预订规则和取消规则的数据要一致？ 

   答：事先没法确定逻辑房型下哪一天（roomDate）的数据会最终通过校验，有可能逻辑房型下5天的数据只有其中两天的数据通过了校验 。生成规则时会随机取通过校验的两天数据中的其中一天的规则数据。

6. 如何进行产品与房型的新增？

   答：在全量同步的接口中推送新增的产品与房型信息即可。

7. 如何进行房型的下线？

   答：全量同步时，不带上想要下线的房型即可。

8. 增量同步房态接口，对未同步的产品有影响吗？

   答：没有影响。如价格接口，只会修改指定产品给定时间的价格，不会影响诸如库存、销售规则等。

9. breakfastNum参数问题。如：调用产品上下线接口，为什么提示产品不存在？

   答：类似的接口还有，产品销售规则同步、产品价格同步、产品库存同步等。美团酒店平台，通过poiId、roomType、breakfastNum唯一确定产品。如果你想下线早餐数为2的产品，那么必须传参数breakfastNum并且设置为2，否则默认是操作早餐数为0的产品，可能会提示产品不存在或者错误操作产品。

10. 产品上下线接口只能操作单个产品，对接方想批量操作怎么办？

    答：使用房态全量同步接口，房态参数中只需不包括下线产品，平台会根据POI下产品的变化自动下线。

11. 全量房态定时推送频率及时间点？

    答：房态定时任务每天每个POI请求次数小于4次，建议同步每个POI 60天内的房态数据。而诸如价格、库存等的变化，使用相应的增量同步接口进行实时同步。

12. B10.全量同步接口提示请求成功，为什么查询不到房态？

    答：只有创建新产品的接口是同步请求，其他诸如POI同步、房态全量同步接口等为异步请求，提示房态同步成功仅仅表明通过平台的校验，已经成功添加到同步队列中。过一段时间，依然查不到产品，可能是由于参数或者系统原因，实际上房态并没有同步成功。

订单流程

1. 顾客的入住基本时间点，是否为18点？如果14点入住的客户在18点之前申请取消，怎么办？

   答：在顾客从APP端申请取消订单时，美团会调用供应商的接口，以接口信息为准。

2. 顾客下单时，如果房态信息已变更怎么办？

   答：在顾客下单前，美团都会校验信息，查到信息变更之后就会展示更新的信息，并且提示顾客下单失败需重新下单。

3. 客户发票由哪方开？

   答：美团建议由入住门店即时给顾客开具发票。具体特殊情况可在对接时协商。

4. 非即时确认的订单，在预订中顾客是否可以无条件发起取消操作？

   答：美团建议：在非即时订单中，顾客可以预订中的时候取消。有特殊情况可以在对接中协商。

5. 如果有退款操作，是只有美团的客服才能操作退款吗？

   答：是的，只有美团的客服才能操作退款。客户致电美团客服，由美团客服确认后进行中断操作并退款,需与酒店的双方运营人员线下确认。入住门店的人员是不能进行退款操作的。

6. 如果有少数酒店，需要凭借酒店的order/confirm ID来办理入住，怎么办?

   答：优先合作不必order/confirm ID来办理入住的酒店，具体情况可以协商。

7. 订单的短信发送，是美团负责吗？比如入住信息、用户安抚等等。

   答：是美团负责发送相关的短信服务。

8. 是否支持一个多间夜订单的部分间夜取消?

   答：不支持，目前只能整单取消后，重新下单。

9. 订单结算时间如何归并,是否按照离店日期?

   答：按照离店日期。如月结结算中，一个订单从6月15日住到7月15日，则整单都在7月账单中结算。

10. 入住人电话下单时可以提供么?

    答：暂时不可以,后续会逐步优化。

11. 价格、库存等不符合条件，导致校验订单失败，需要返回最新房态吗？

    答：需要，与校验结果一同返回，避免订单校验重复失败。

12. 预定中状态的订单，为什么会被美团认定为预定失败？

    答：非及时确认订单返回预定中时，美团酒店会轮询订单状态，如果超过配置的订单确认时长（如：2小时）后，将订单状态置为预定失败状态。注：非及时确认订单1分钟轮询一次，异常订单5分钟轮询一次。

1. 线上遇到问题，对接方的处理流程是什么？

   答：1.登录数据平台，查询相关POI、产品（价格、库存等）是否同步成功或订单在美团的状态；(销售规则相关问题直接联系运营)
   2.如果POI、产品信息不相符，请重新同步POI和房态；如果同步依然不成功，请参考相关文档核对参数；
   3.订单问题，请核对订单请求参数、对接方产品信息、美团产品信息的一致性；
   4.如依然还有问题，请与美团酒店平台运营反馈。

2. 关于请求次数超限问题
   
   答：如价格接口的限速为每分钟60次，实际使用时间窗口：按秒计算。例如：3秒内发送50次请求，1分钟也只发送50次请求，但实际上还是会算超限的。平台限速策略：
   1. 每个供应商都有默认的独享接口限速(默认每分钟60次)。若请求未超限，则能正常访问；若请求超限，启用累计限速策略。
   2. 累计限速策略，累计阈值为200次。若请求超限，启用10分钟拒绝访问，返回CODE=62，10分钟后累计次数清0;累计次数未达200次，启用API接口级别限速策略。
   3. API接口级别限速默认20次/秒。若请求未超限，则允许访问；若请求超限，则启用API拒接访问，返回CODE=61。
   4. 如果默认的限速的策略确实不能满足业务需求，可以和运营沟通，考虑调整独享接口限速上限。

3. 对接方开发阶段使用什么partnerId和clientSecret？ 

   答：刚开始对接阶段,美团会随机分配测试用的partnerId和clientSecret，测试完成后，美团会分配全新的partnerId和clientSecret，用新分配的partnerId和clientSecret在staging环境选择一个或多个poi进行POI、房态、订单相关接口的测试，测试完成后即可正式上线。

4. 访问http://openplatform.hotel.test.meituan.com/open为什么404？

   答：要使用美团酒店直连平台对接文档-3.3在线测试工具中的URL进行测试。如需要测试BA认证加密结果，可以访问：http://openplatform.hotel.test.meituan.com/open/test/auth

5. 我是技术服务提供商，如何补充partner来添加旗下合作供应商范围？

   答：由美团运营人员进行对接处理。

6. API文档更新后，是否还是使用V1地址，或者有新的地址？

   答：除非接口有重大变动且无法向下兼容了，才会使用新版本号，否则依然使用版本v1。

7. 接口对应的contenType是什么？

   答：application/json。

8. 配置的服务结束时间为18:00，为什么还没到18:00产品就不展示?

   答：美团服务时长策略：例如，配置供应商18:00停止服务，那么到17:00开始美团酒店就开始陆续不展示产品。