美团外卖开放平台对接经验总结（一）

2017-06-21 司想君司想君

两个月的时间，在除官方文档之外的资源极其匮乏的条件下，项目组群策群力完成了美团和饿了么的外卖开放平台对接，在这里对团队成员表示感谢，也把项目中填过的坑，淌过的河分享给大家。这注定是一篇受众极少的文章，但是希望能够对需要的人有所帮助。

如果能回到两个月前，我会告诉刚刚开始开发这个项目的团队，开发之前，认真看文档。在后续的开发过程中，60%的坑是因为我们没有认真研究官方文档而产生的。

要相信，由程序员属性的人产出的文档，能写出来的，都是干货。

今天作为开头第一篇，先整理一些开发人员关注较多的问题进行回答，后续会慢慢深入进去。

首先简单介绍一下我们的项目，方便大家寻找技术上的共通点（其实是为了打广告）。

我们的项目全称是海信外卖聚合平台。

项目的重点在聚合。对接多家外卖平台不是我们的目的，对接的再多，也不过是API的搬运工而已。我们要做的，是消化各平台之间的差异，真正帮商户实现“一套配置，多平台可用”的目的。

市场上有很多竞品，有的不提供门店管理，有的不提供菜品管理，为什么呢？因为各平台的实现差异太大，消化不了，干脆不做了。

这些不能闭环的系统，都是耍流氓。让商户用你的部分功能，还得去操作美团饿了么百度，不光实现不了三合一，反而成了三变四。还收人家的钱，不是耍流氓是啥。

当然，要做聚合，首先也要先对接。我们第一个面对的问题就是，先对接美团还是先对接饿了么（百度资质要求太高，我们不达标，目测拿到开发者资质的都是认识他们领导的）。下面从接口丰富程度，易读性和支持度三方面进行一下小小的对比。

丰富程度	各有千秋。举个例子：饿了么对退款状态的维护极其精细，而美团颗粒较粗；美团配送相关的接口十分丰富，饿了么却少之又少。
易读性	美团完胜。订单、退款、配送，美团都有详细的流程图，哪个节点应该调用哪个接口，标的一清二楚，而饿了么，一个看似高大上的动态流程图显得十分NB，然而并没有什么卵用。
支持度	美团完胜。官方讨论组，上线支持群。客户人员很热心。饿了么，呵呵，我开发完了以后也不确定他们是不是有人工支持。

综上所述，如果你对外卖的业务不太熟悉，建议先对接美团。

接下来就先回答几个美团对接的问题。

是。如果你觉得哪个不需要，只能说明你对外卖的业务还没有了解透彻。我们也是开发到一个地方，仔细研究过才发现，奥，原来这个地方确实需要一个回调。

测试门店为一个坐标位于南极洲、配送范围为西藏昌都的线上测试门店，开发者可使用美团外卖APP定位到西藏昌都气象局，根据测试门店名称搜索到测试门店进行下单。注意加粗字体就好。

如何测试在线支付。

联系运营同学帮你开通。
门店映射，请牢记AuthToken，否则5个门店都用完了只能联系客户解绑。
测试美团专送需要提前申请。
先上传菜品图片，再上传菜品。这个顺序不能颠倒。
更新菜品信息要注意：isSoldOut字段设为0，否则菜品为下架状态，官方文档此处有误，请注意。
上传菜品图片接口，文档描述与实际使用有出入，实测并不支持文件流。
自配送即时单需要手动调用配送接口，美团专送即时单和预订单自动呼叫骑手；美团专送预订单可以提前手动调用配送接口。

以上是我们在美团对接中曾经遇到的问题，如果有我没有回答到的，欢迎回复公众号信息反馈给我。下一篇，介绍饿了么对接流程中遇到的问题。欢迎关注，欢迎转发，更欢迎用以下方式进行打赏，鞭笞作者！