饿了么开放平台订单接入管理
订单接入管理
背景介绍
商户的ERP或者POS机系统,需要处理、打印饿了么订单,则需要了解饿了么订单的结构化设计以及预订单、即时单的业务模型。
支持范围
目前API已经支持订单的接单、取消、退单处理。如果您的订单管理需求现有API不能满足,可以联系我们提出API需求。
订单模型
接口推荐
以下接口所属服务的基本接口,推荐接入:
所属服务接口名称
订单服务eleme.order.getOrder 获取订单
订单服务eleme.order.confirmOrderLite 确认订单(推荐)
订单服务eleme.order.cancelOrderLite 取消订单(推荐)
订单服务eleme.order.agreeRefundLite 同意退单/同意取消单(推荐)
订单服务eleme.order.disagreeRefundLite 不同意退单/不同意取消单(推荐)
名词解释
名 词说 明
运单订单被商户确认以后,发送给物流系统后生成了配送单,可以看到订单的配送状态,称之为运单
取消单订单在完结状态之前,用户发起取消订单请求,称之为取消单,属于交易售中流程
退单订单在完结状态之后,用户发起的取消订单请求,称之为退单,类比在商场购物后退货行为,属于交易售后流程
预订单用户预订之后某一时刻送达的订单,称之为预订单
即时单用户期望下单后尽快送达的订单,称之为即时单
业务场景说明
查询订单详情,根据订单号调用eleme.order.getOrder接口,可以查询某个订单的详细信息。
当应用接收到type=217的新订单消息后,可以调用eleme.order.confirmOrderLite接口进行接单。
如果应用想要在接单前或者接单后拒绝履约订单,可以调用eleme.order.cancelOrder接口取消订单。
用户发起取消或者退单申请,应用可以调用eleme.order.agreeRefund同意退单申请。或者调用eleme.order.disagreeRefund接口拒绝退单申请,拒绝退单后,用户可以发起客服仲裁。
售中阶段,整单取消,可以调用 eleme.order.cancelOrderLite。
获取订单退款信息接口eleme.order.batchGetRefundOrders 以及用户申请退单的消息结构体中有goodsList字段,goodsList订单商品列表内添加有skuId(商品规格ID),其中skuId为-1时代表服务端没有明确的skuId信息,如赠品、餐盒等。
商家接单后用户是可以在1分钟之内直接取消订单的,如果用户1分钟内直接取消订单,开放平台会推送type=17的消息,请注意订阅此消息类型。
所有订单状态变更或运单状态变更,都可以通过订阅相关消息获取到,消息类型说明请进入消息推送文档查看。
订单流转流程
订单状态流程图:
订单配送流程图:
饿了么订单流转交易流程主要涉及如下节点:
1. 用户下单
用户饿了么APP上下单后,订单可以推送给商家进行接单,开放平台通过消息推送通道,将type=217的新订单消息推送给开发者。
2. 商户接单
开发者的应用接收到type=217的推送消息后,可以调用eleme.order.confirmOrderLite接口,进行接单或者拒单。
3. 订单配送
饿了么平台的订单配送有3种方式:
商户自配送:由商户自己的配送人员完成订单配送
众包服务配送:商户采购饿了么提供的众包配送服务,进行订单配送
饿了么专送服务:商户采购饿了么提供的专送服务,进行订单配送
关于配送的详细说明可以参考文档内关于配送部分的介绍。
4. 订单完结
订单完成配送且用户确认已送达,则订单被标记为已完结。
5. 关于订单流转流程中用户取消和退单
取消订单是发生在订单完结之前,退单是发生在订单完结之后。
6. 订单状态说明
开发者要想获取订单状态变化,建议在应用内订阅上相关消息,消息订阅后订单流转过程中任何一个状态变更我们都会以消息的方式及时推送给您,消息类型详情说明请参考文档:https://open.shop.ele.me/openapi/documents/callback