跳到主内容

与美团-大众点评通过API连接

  • 更新

这篇文章主要讲述如何通过API连接美团-大众点评的系统。

提示: 阅读本文章大概需要5分钟

主要操作步骤：

1.前期准备工作；

2.在BookingMeta系统中创建分销商；

3.在美团系统后台做好配置；

4.Booking Meta技术团队完成在美团Sandbox沙箱环境技术验证；

5.在美团系统后台设置需做对接的商品；

 

一、前期准备工作

  • 联系美团侧申请对接API ；
  • 创建微信群聊邀请美团侧相关人员(BD、运营、技术)及BookingMeta相关人员；
  • 提供美团后台的子账号 (有创建商品和操作订单权限) 及密码，提供两个邮箱地址和两个手机号 (国内手机号) 用于接收订单异常和系统异常报警通知,一起发送给BookingMeta邮箱support@bookingmeta.com  并抄送至：weiyuan.yang@bookingmeta.com

  

二、在BookingMeta系统中创建分销商

1.  在【代理商管理】 -> 【代理商列表】 ->【新建代理商】中选项【美团大众点评】

注意：
  • 务必选择美团大众点评，否则API无法实现对接

01.jpg

02.jpg

03.jpg

  • 验证美团API并添加报警邮箱
    在【代理商管理】 -> 【代理商列表】 -> 选择对应的美团代理商【编辑】代理商

         进入编辑页面后，选择【API设置】

         填写【otaID】和【secretCode】后保存成功, 如何获取【otaID】和【secretCode】 

 

         添加报警邮箱。勾选报警邮箱并填写对应对应的接收报警邮件的邮箱地址，点击【保存报警邮箱】；
         -当订单通过 API 通道进入 Booking系统出错时，系统会自动给您输入的报警邮箱发报警邮件，提醒您及时处理问题，并通过手动下单避免遗漏订单

 

2.什么是otaID/secretCode？

使用美团账号登录美团开放平台,地址:https://www.dianping.com/overseas/openplatform/mt/orderActivity

在平台的【注册中心】-> 选择【Online】-> 【生成securityCode】
-如果从生成 secretCode,可点【生成securityCode】生成securityCode；
-如果已经有 secretCode,可以使用已经生成好的securityCode；

 

 

三、在美团系统后台做好配置

请务必与美团商务同事确认清楚，美团是否已允许您接入API。对方同意后，可登录美团开放平台，账号密码与登录美团后台管理商品、订单的信息相同。

美团开放平台地址：https://www.dianping.com/overseas/openplatform/mt/register

登录后需要分别在Sandbox沙箱环境及Online生产环境配置相关信息，操作步骤如下：

 

04.jpg

 

1.首先美团的Sandbox沙箱环境与Online正式环境所配置的信息是不同的，包括以下所有信息可能均不一样，所以需要分别配置。当Sandbox测试通过后，美团的技术同事会进行验收，验收完成后才会开启Online正式环境的API对接

2.电话列表，一般建议您留多个电话，目前美团要求至少3个电话号码，用于在API对接过程中出现问题时可及时发短信提醒。通常我们建议预留您的OP、运营、售前等同事的电话

3.邮件列表，一般建议预留多个邮箱地址用于接收API对接过程中出现的报警提醒，建议预留support@bookingmeta.com邮箱，以便我们可第一时间收到报警提示

 

05.jpg

 

4.生成securityCode，点击此按钮，会生成otaId及secretCode，请务必牢记此信息，后续会填写到BookingMeta系统中对应的位置

5.参照上述截图，在对应的位置勾选“支持幂等”功能

6.在Sandbox环境中填写以下URL地址信息。

注意：Sandbox沙箱环境的URL信息如下，不要填写错误，否则API无法对接成功

供应商英文名：您可以使用您自己的公司或品牌英文名称

占位接口URL：https://seller-meituan.uat.bookingmeta.tech/xmdapi/occupy

清位接口URL：https://seller-meituan.uat.bookingmeta.tech/xmdapi/close

确认并发货接口URL：https://seller-meituan.uat.bookingmeta.tech/xmdapi/confirm

取消接口URL：https://seller-meituan.uat.bookingmeta.tech/xmdapi/cancel

确认并发货查询接口URL：https://seller-meituan.uat.bookingmeta.tech/xmdapi/confirmquery

取消查询接口URL：https://seller-meituan.uat.bookingmeta.tech/xmdapi/refundQuery

推送价格库存结果查询URL：https://seller-meituan.uat.bookingmeta.tech/xmdapi/stockPriceLog

心跳接口URL：https://seller-meituan.uat.bookingmeta.tech/xmdapi/alive

 

注意：以下信息为Online正式环境信息，请务必在注册中心最上方确保为online字样

邮件列表中可继续增加support@bookingmeta.com邮箱

占位接口URL：https://seller-meituan.bookingmeta.com/xmdapi/occupy

清位接口URL：https://seller-meituan.bookingmeta.com/xmdapi/close

确认并发货接口URL：https://seller-meituan.bookingmeta.com/xmdapi/confirm

取消接口URL：https://seller-meituan.bookingmeta.com/xmdapi/cancel

确认并发货查询接口URL：https://seller-meituan.bookingmeta.com/xmdapi/confirmquery

取消查询接口URL：https://seller-meituan.bookingmeta.com/xmdapi/refundQuery

推送价格库存结果查询URL：https://seller-meituan.bookingmeta.com/xmdapi/stockPriceLog

心跳接口URL：https://seller-meituan.bookingmeta.com/xmdapi/alive

 

四、Booking Meta技术团队完成在美团Sandbox沙箱环境技术验证

请确保您已发送美团的相关信息给到BookingMeta技术团队，包括：

  • 美团系统中新创建的子账号登录名及密码；
  • Sandbox沙箱环境的otaId及secretCode信息；
  • 用于接收订单异常和系统异常报警通知的两个邮箱地址、两个手机号 (国内手机号)。

以上信息可发送邮件至 rd@bookingmeta.com 并抄送给到 CS 团队 support@bookingmeta.com、

weiyuan.yang@bookingmeta.com，请务必注明您在 BookingMeta 系统中的签约名称或品牌名称。

 

在收到您上一步中的相关信息后，BookingMeta 技术团队完成 Sandbox 沙箱环境的测试及对接工作，通常会在 3 个工作日内完成。通过后，会发送邮件给您反馈结果。 

 

五、在美团系统后台设置需做对接的商品

特别注意事项

由于美团API规则限制,为减少API对接订单失败比例,建议您做如下配置

美团API规则:

1.24小时内异常订单占总订单的占比超过10%,美团就会自动关闭API对接；

2.同一个美团商品,超过(包含)两笔订单API下单失败，美团商品会下架。

 

1. 设置商品白名单
将您要走API对接的美团商品ID(如何获取美团商品ID) 设置在美团开放平台后台 【API开关】-->【商品白名单(美团商品id)】中,如果您有多个商品对接API,使用英文分号";"隔开,配置完毕后,只有在商品白名单中的商品才会走API对接流程.

2. 如何获取美团商品ID

在美团后台 【商品管理】-> 【商品列表】可以获取美团商品ID

3.美团API,如何开启或关闭

在美团开放平台后台 【API开关】中,将【全局开关】设置为1为开启状态,0为关闭状态

4、映射要对接订单的商品

在美团大众商家后台，进入商品管理，点击要对接订单的商品后面的编辑，在“价格库存”，找到“供应商skuid”，把BM中该规格 skuid 填写到这里，重新发布。该品订单后期就可对接到BM系统后台订单管理中。

API对接mapping编码.png

对接商品注意事项

每个对接映射的商品，在 bookingmeta 设置的预定规则中，用户信息中出行人和联系人的必填项要少于等于在 OTA （美团）后台设置的预定规则，否则订单进入 bookingmeta 后，需要补全信息。

 

 

 

相关文章