饿了么美团开放平台接入

最近在做一个外卖平台订单的接入,跳了好多个坑~~这里做个简单的记录,欢迎交流

一 要解决的问题

1 运营问题

门店有三个终端

  • 自有开发的收银系统
  • 饿了么收银系统
  • 美团收银系统

解决方案:将三端统一为一端

1

2 数据问题

有三份数据

  • 1 自有平台的订单数据(买了什么,消耗多少物料等)
  • 2 饿了么订单数据(买了什么,消耗多少物料等)
  • 3 美团订单数据(买了什么,消耗多少物料等) 解决方案:将美团饿了么订单数据接入自有平台

1

二 外卖开放平台调研

饿了么美团分别有对应的开放平台,来为商家提供支持

饿了么

要对外提供服务的可申请平台应用或者企业应用

自有门店或连锁门店可申请个人应用

中间趟了几个大坑,最后申请的是个人应用,接口什么的都一样

美团

在美团外卖开放平台申请注册即可

三 数据对接

外卖平台的商品可填入一个叫sku编码的字段,可在这里做文章,与自有平台的商品一一对应。

1 商品的对接

1

2 订单的对接

1

注意:

  • 外卖平台的商品数据结构录入时,要有选择的有倾向的将结构保持为可与自有平台商品结构对应起来,规则定下来后,不可改变
  • 外卖适配成自有订单后,在前台显示用户所购商品,要和外卖平台的所购商品显示一致

三 架构设计

1 外卖平台->自有平台

外卖订单进来后,先进入redis队列,根据算法,可将对应门店的订单,推送到相应的redis队列。多个门店可以使用同一个,或者不同的队列,但要保证,一个门店推送的队列是同一个(防止订单状态流转错误)。

1

2 自有平台->外卖平台

自有平台操作外卖订单比如,退单,退款等

1

对于自有平台->外卖平台也可直接请求外卖平台接口进行操作,这里做成异步,队列消费完成后,再通知前端,操作行为完成。因为运营人员也可直接在外卖平台的后台操作退款退单等,这时就是走外卖平台->自有平台同步订单状态到自有平台的流程,保持外卖操作的一致性。

四 业务设计

对于外卖订单的适配,订单状态的流转是非常重要的。一个是自有平台的订单状态,另外一个是外卖平台一方的订单状态。这里对订单状态的流转做个说明。

1 模型关系

外卖平台适配成自有平台的订单order(数据源从waimai_order中取出,展示给前端),记录外卖的源数据waimai_order中,将orderwaimai_order做个对应。

1

2 订单状态流转

order状态字段

  • state表示订单状态 已支付已接单制作中制作完成配送中订单完成退款中退款完成部分退款 ,订单取消

waimai_order状态字段

  • state 表示外卖推送的订单状态,可参考饿了么推送的订单状态
  • order_state 记录 order 退款中之前的订单状态,在运营人员发生操作行为后,恢复order状态至该状态(比如,自有平台的订单状态为制作中,此时用户申请退单order state流转为退款中,商家拒绝退款,恢复order state 状态为制作中)。

实际开发时,可参考饿了么推送的订单状态(饿了么推送的订单状态节点,比较清晰) ,将其作为基准美团推送的订单状态转换成和饿了么一样的,记录在 waimai_orderstate

饿了么推送的订单状态预览

1

开发中比较重要的几个订单状态节点,实现下列的订单状态流转,主流程的可正常运行

waimai_order推送状态 对应 order 状态 说明
订单生效(type=10) 未入库 用户支付
商户接单(type=12) 已支付 一分钟后的延迟队列,防止用户一分钟之内取消的订单入库
订单被取消(type=14) 不会入库 用户一分钟之内取消的订单不入库
订单置为无效(type=15) 不会入库 用户一分钟之内取消的订单不入库
订单强制无效(type=17) 退款成功 商家取消订单
订单已完成(type=18) 订单完成 部分退款(美团专有) 美团用户确认送达之前申请过部分退款,订单状态为部分退款
用户申请取消(type=20) 退款中 用户点击确认送达之前,申请取消订单,饿了么全取消,美团可申请部分取消,记录退款中之前的状态至waimai_orderorder_state
用户撤回取消(type=21) 已支付已接单制作中制作完成配送中 waimai_orderorder_state中 恢复订单状态
门店拒绝取消(type=22) 已支付已接单制作中制作完成配送中 waimai_orderorder_state中 恢复订单状态
门店同意取消(type=23) 已支付(美团专有)已接单(美团专有)制作中(美团专有)制作完成(美团专有)配送中(美团专有)退款成功 美团部分取消的情况下,从waimai_orderorder_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、对于优惠的计算,饿了么,可对比 shopPriceprice的不同,是否参加优惠,userPrice是用户看到的价格,shopPrice是该商品商家实际收入(具体多看看文档,其他人遇到的价格问题)。美团就比较坑了。。。它只有一个字段price,订阅前后表示的不一样,不订阅表示折扣价格,订阅表示原价,为什么不两个一起返回来呢?。

Posted in 后端 on Apr 18, 2020

请登录 登录 评论!

遇到问题?