| 饿了么美团开放平台接入 | 您所在的位置：网站首页 › 饿了吗开发 › 饿了么美团开放平台接入 |
饿了么美团开放平台接入
|
最近在做一个外卖平台订单的接入，跳了好多个坑～～这里做个简单的记录，欢迎交流 一 要解决的问题 1 运营问题门店有三个终端 自有开发的收银系统饿了么收银系统美团收银系统解决方案：将三端统一为一端
有三份数据 1 自有平台的订单数据（买了什么，消耗多少物料等）2 饿了么订单数据（买了什么，消耗多少物料等）3 美团订单数据（买了什么，消耗多少物料等）解决方案：将美团饿了么订单数据接入自有平台
饿了么美团分别有对应的开放平台，来为商家提供支持 饿了么：要对外提供服务的可申请平台应用或者企业应用 自有门店或连锁门店可申请个人应用 中间趟了几个大坑，最后申请的是个人应用，接口什么的都一样饿了么入口 : open.shop.ele.me/openapi 登录弹窗下方有一个切换” 商家账号登录 “ 美团：在美团外卖开放平台申请注册即可 美团对接流程：developer.waimai.meituan.com/home/… 三 数据对接外卖平台的商品可填入一个叫sku编码的字段，可在这里做文章，与自有平台的商品一一对应。 1 商品的对接
注意： 外卖平台的商品数据结构录入时，要有选择的有倾向的将结构保持为可与自有平台商品结构对应起来，规则定下来后，不可改变外卖适配成自有订单后，在前台显示用户所购商品，要和外卖平台的所购商品显示一致 三 架构设计 1 外卖平台->自有平台外卖订单进来后，先进入redis队列，根据算法，可将对应门店的订单，推送到相应的redis队列。多个门店可以使用同一个，或者不同的队列，但要保证，一个门店推送的队列是同一个（防止订单状态流转错误）。
自有平台操作外卖订单比如，退单，退款等
对于自有平台->外卖平台也可直接请求外卖平台接口进行操作，这里做成异步，队列消费完成后，再通知前端，操作行为完成。因为运营人员也可直接在外卖平台的后台操作退款退单等，这时就是走外卖平台->自有平台同步订单状态到自有平台的流程，保持外卖操作的一致性。 四 业务设计对于外卖订单的适配，订单状态的流转是非常重要的。一个是自有平台的订单状态，另外一个是外卖平台一方的订单状态。这里对订单状态的流转做个说明。 1 模型关系外卖平台适配成自有平台的订单order（数据源从waimai_order中取出，展示给前端）,记录外卖的源数据到waimai_order中，将order和waimai_order做个对应。
order状态字段 state表示订单状态 已支付，已接单，制作中，制作完成，配送中，订单完成，退款中，退款完成，部分退款 ,订单取消等waimai_order状态字段 state 表示外卖推送的订单状态，可参考饿了么推送的订单状态order_state 记录 order 退款中之前的订单状态，在运营人员发生操作行为后，恢复order状态至该状态（比如，自有平台的订单状态为制作中，此时用户申请退单order state流转为退款中，商家拒绝退款，恢复order state 状态为制作中。实际开发时，可参考饿了么推送的订单状态（饿了么推送的订单状态节点，比较清晰） ，将其作为基准，美团推送的订单状态转换成和饿了么一样的，记录在 waimai_order的 state中 饿了么推送的订单状态预览
开发中比较重要的几个订单状态节点，实现下列的订单状态流转，主流程的可正常运行 waimai_order推送状态 对应 order 状态 说明 订单生效(type=10) 未入库 用户支付 商户接单(type=12) 已支付 一分钟后的延迟队列，防止用户一分钟之内取消的订单入库 订单被取消(type=14) 不会入库 用户一分钟之内取消的订单不入库 订单置为无效(type=15) 不会入库 用户一分钟之内取消的订单不入库 订单强制无效(type=17) 退款成功 商家取消订单 订单已完成(type=18) 订单完成 部分退款（美团专有） 美团用户确认送达之前申请过部分退款，订单状态为部分退款 用户申请取消(type=20) 退款中 用户点击确认送达之前，申请取消订单，饿了么全取消，美团可申请部分取消,记录退款中之前的状态至waimai_order的order_state中 用户撤回取消(type=21) 已支付，已接单，制作中，制作完成，配送中 从waimai_order的order_state中 恢复订单状态 门店拒绝取消(type=22) 已支付，已接单，制作中，制作完成，配送中 从waimai_order的order_state中 恢复订单状态 门店同意取消(type=23) 已支付（美团专有），已接单（美团专有），制作中（美团专有），制作完成（美团专有），配送中（美团专有），退款成功 美团部分取消的情况下，从waimai_order的order_state中恢复订单状态，否则订单状态为退款成功 用户申请退单(type=30) 退款中 用户点击确认送达之后，饿了么可申请一次退款，美团可申请两次退款 用户取消退单(type=31) 订单完成 部分退款（美团专有） 对于美团的第二次申请退款，然后取消退单的时候，订单状态为部分退款 门店拒绝退单(type=32) 订单完成 部分退款（美团专有） 对于美团用户申请过一次部分退款，订单状态为部分退款 门店同意退单(type=33) 退款成功 部分退款 饿了么退一次，要么是 退款成功 ，要么是部分退款。美团可以申请两次第一次部分退款，第二次退款成功 配送员待取餐(type=53) 制作完成 order中的rider_state会同步配送的实时状态，可根据此联合判断 配送员已到店(type=54) 制作完成 order中的rider_state会同步配送的实时状态，可根据此联合判断 配送员配送中(type=55) 配送中 order中的rider_state会同步配送的实时状态，可根据此联合判断 配送成功(type=56) 配送中 order中的rider_state会同步配送的实时状态，可根据此联合判断 五 风险点必须保证外卖平台商品通过sku编码对应自有平台商品（如果不需要商品的对应，此条可忽略，实现的时候，去除改规则，但自己研发系统很可能不仅仅是为了订单的同步，商品的同步很可能也在考虑之中），增加了运营的人为风险（可通过商家上架操作流程化降低风险）。 系统崩溃外卖接单风险（可通过多终端备用降低风险）。 六 需注意的问题1、美团确认送达之前用户操作申请退款后，在等待商家处理结果时，用户还可以操作确认送达按钮。此时自有平台的订单状态还应为退款中，拒绝之后，订单状态流转为订单完成（或部分退款用户之前申请过一次退款），同意之后,订单状态流转为退款成功(或部分退款用户之前申请过一次退款)。 2、上面的退款成功可能会有疑惑，为什么用户取消订单，同意后，也是退款成功，不应该是取消订单吗。这需要，根据自有的业务进行定义，用户支付完成后，进行的订单取消或退款，统一定义为退款成功 3、对于优惠的计算，饿了么，可对比 shopPrice和 price的不同，是否参加优惠,userPrice是用户看到的价格，shopPrice是该商品商家实际收入（具体多看看文档，其他人遇到的价格问题）。美团就比较坑了。。。它只有一个字段price，订阅前后表示的不一样，不订阅表示折扣价格，订阅表示原价，为什么不两个一起返回来呢？。 本作品采用《CC 协议》，转载必须注明作者和本文链接 Make everything simple instead of making difficulties as simple as possible |
【本文地址】