饿了么开放平台订单状态和消息类型

背景介绍

商户的ERP或者POS机系统，需要处理、打印饿了么订单，则需要了解饿了么订单的结构化设计以及预订单、即时单的业务模型。

支持范围

目前API已经支持订单的接单、取消、退单处理。如果您的订单管理需求现有API不能满足，可以联系我们提出API需求。

订单状态流转

订单状态可分为pending（未生效订单）、unprocessed（未处理订单）、refunding（退单处理中）、valid（已处理的有效订单）、invalid（无效订单）、settled（已完成订单）六种。订单在流转过程中订单状态会发生变化， 以下是订单状态变化的场景和流程，以及每种状态下推送的消息类型。

1、相关接口

所属服务接口名称

订单服务eleme.order.getOrder 获取订单

订单服务eleme.order.confirmOrderLite 确认订单(推荐)

订单服务eleme.order.cancelOrderLite 取消订单(推荐)

订单服务eleme.order.agreeRefundLite 同意退单/同意取消单(推荐)

订单服务eleme.order.disagreeRefundLite 不同意退单/不同意取消单(推荐)

订单服务eleme.order.getRefundOrder 获取订单退款信息

2、名词解释

名 词说 明

运单订单被商户确认以后，发送给物流系统后生成了配送单，可以看到订单的配送状态，称之为运单

取消单订单在完结状态之前，用户发起取消订单请求，称之为取消单，属于交易售中流程

退单订单在完结状态之后，用户发起的取消订单请求，称之为退单，类比在商场购物后退货行为，属于交易售后流程

预订单用户预订之后某一时刻送达的订单，称之为预订单

即时单用户期望下单后尽快送达的订单，称之为即时单

3、订单无效的几种场景

（1）商户拒单导致的订单无效

（2）商户取消已接单导致的订单无效

（3）用户取消已接单导致的订单无效

4、退单的流程

5、在线帮助

如您有任何疑问，欢迎加入保障宝平台，随时联系我们的保障宝daily进行咨询和反馈，让您的在线解答体验更加顺畅，我们将竭尽所能，不断改进和优化服务，为您提供更加贴心、高效的支持和服务，让您的体验更加美好！

6、FAQ

Q：到店自取的订单会自动完结吗

A：如用户取餐后微电机“确认收餐”，系统会在取餐时间后 6 个小时，自动完结订单。

 

Q：调用eleme.order.cancelOrderLite返回失败，code=BIZ_SERVICE_FAILED，message=取消订单失败:801xxx，一般有什么原因？

A：可以先查看订单状态，订单状态为配送中，不允许商家发起取消的。可以发起取消订单的状态：商家自配送或者配送状态是待配送、待取货、取货中、配送异常、配送取消、配送拒绝。不允许发起取消订单的状态：平台配送且配送中是不允许发起取消的。

Q：新订单几分钟内不接单会自动取消？

A：商户 5 分钟内不接单，订单会超时自动取消。

Q：type=14的消息会在哪些场景下推送？

A：type=14的类型只有在以下场景中推送：(1) 接单前用户取消；(2) 商户拒单；(3) 5分钟未接单系统自动取消。

Q：订单完结（type=18）的场景是？

A：以下3种情况会触发订单完结：
（1）骑手确认送达；
（2）用户确认收货；
（3）系统自动确认送达：自配送商户是预计送达时间+3小时，众包是预计送达时间+6小时。

Q：退款发生在哪个环节？

A：退款发生在：（1）用户申请取消，商家ERP调同意取消接口或商家APP端同意后（2）用户申请退单，商家ERP调同意退单或商家APP端同意后。

Q：退单和取消是否是一个流程？

A：（1）取消单：订单在完结状态之前，用户发起取消订单请求，称之为取消单，属于交易售中流程。（2）退单：订单在完结状态之后，用户发起的取消订单请求，称之为退单，类比在商场购物后退货行为，属于交易售后流程。

Q：无效订单和未生效的订单分别是什么？

A：您好，未生效订单指下单未支付的订单（这个目前已不支持从接口获取），无效订单是指用户下单后因某种原因导致订单无效（如：商家未接单、客户取消订单、商家拒单）。

Q：预订单的结算时间是什么时候，比如我在29号晚上9点下单，要求30号中午12点送达，那么最后入账是会入在下单的那一天（29号）还是送达的那一天（30号）呢？

A：结算是在订单完结后才结算，订单30号送达并完结则在30号结算。

Q：eleme.order.getOrder接口内的“未生效订单”、“无效订单”分别指什么类型？

A：您好，“未生效订单”就是用户下单未支付订单，“无效订单”指用户下单后取消订单、商家拒单、商家超时未接单所导致的无效订单类型；“已处理的有效订单”指订单已接单处于正常流转中的订单；“已完成订单”指订单已到达完结状态的订单。

Q: 退单消息推送和退款信息查询接口中的refundImages是个hash值，应该怎么解析来查看用户提交的退款申请图片？

A：您好，假如图片hash值为C85E8917A13842DC8F97A03DC52C5801JPEG，解析方式如下：固定域名：https://fuss10.elemecdn.com/ C(第一位为一级目录)/ 85(二三位为二级目录)/E8917A13842DC8F97A03DC52C5801JPEG .JPEG(格式后缀)
--> https://fuss10.elemecdn.com/C/85/E8917A13842DC8F97A03DC52C5801JPEG.JPEG