这篇文章主要讲述如何通过API连接美团-大众点评的系统。
提示: 阅读本文章大概需要5分钟
主要操作步骤:
4.Booking Meta技术团队完成在美团Sandbox沙箱环境技术验证;
一、前期准备工作
- 联系美团侧申请对接API ;
- 创建微信群聊邀请美团侧相关人员(BD、运营、技术)及BookingMeta相关人员;
- 提供美团后台的子账号 (有创建商品和操作订单权限) 及密码,提供两个邮箱地址和两个手机号 (国内手机号) 用于接收订单异常和系统异常报警通知,一起发送给BookingMeta邮箱support@bookingmeta.com 并抄送至:weiyuan.yang@bookingmeta.com
二、在BookingMeta系统中创建分销商
1. 在【代理商管理】 -> 【代理商列表】 ->【新建代理商】中选项【美团大众点评】
- 务必选择美团大众点评,否则API无法实现对接
- 分销结算币种只支持人民币,如需配置其他结算币种可联系support@bookingmeta.com
- 验证美团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生产环境配置相关信息,操作步骤如下:
1.首先美团的Sandbox沙箱环境与Online正式环境所配置的信息是不同的,包括以下所有信息可能均不一样,所以需要分别配置。当Sandbox测试通过后,美团的技术同事会进行验收,验收完成后才会开启Online正式环境的API对接
2.电话列表,一般建议您留多个电话,目前美团要求至少3个电话号码,用于在API对接过程中出现问题时可及时发短信提醒。通常我们建议预留您的OP、运营、售前等同事的电话
3.邮件列表,一般建议预留多个邮箱地址用于接收API对接过程中出现的报警提醒,建议预留support@bookingmeta.com邮箱,以便我们可第一时间收到报警提示
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、
在收到您上一步中的相关信息后,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系统后台订单管理中。
对接商品注意事项
每个对接映射的商品,在 bookingmeta 设置的预定规则中,用户信息中出行人和联系人的必填项要少于等于在 OTA (美团)后台设置的预定规则,否则订单进入 bookingmeta 后,需要补全信息。