饿了么开放平台订单修改送达时间接入文档

版本说明

版本更新时间更新内容

V1.02024.12.3预订单修改送达时间对接说明，支持范围是平台配送订单修改时间

V1.12025.3.6修改沙箱门店测试内容，增加改签回自配送服务包的方法

 

一、文档说明

支持通过开放平台接单的商户，门店的预订单也能修改预计送达时间，以挽回因预订单送达时间不可调整而带来的订单流失。（本期2024.12月仅支持预订单，即时单当前暂不支持，未来会支持）

 

二、接入对象

所有需要接单、打印的开发者。

 

二、修改范围

消息/接口名称变更/新增是否必接

233开放平台订单修改送达时间消息新增是

223预订单备餐提醒通知新增否

接口eleme.order.getOrder时间变更后，重查订单详情时
1、deliverTime（预订单预计送达时间）或  instantOrderDeliverTime（即时单预计送达时间）内容会变
2、daySn店铺当日订单流水号可能会变否

接口eleme.order.mgetOrders同上否

接口eleme.order.getAllOrders同上否

 

开发者需要的修改list操作【请开发者参考评估】：

（一）接入新消息233，接收消息

（二）接收233消息后，建议开发者进行如下操作：

订单展示：订单展示上要表达新的送达时间（若开发者有自己的POS机需展示订单）。

【必做】小票：重新打印小票，小票突出时间已修改，小票样式可参考下图，顾客联、后厨联、修改备注联、商家联都需要重新打印。

【必做】流水号变更：店铺当日订单流水号daySn可能会变更：23日的预订单改时间后还是23日，则daySn不变；23日的预订单改时间后是24日，则daySn会变，为了避免与24日已下的预订单流水号冲突。

语音提醒：需要对商户进行时间修改语音提醒（若开发者有播报能力的）。

饿侧的商家端NAPOS订单上展示的预订单备餐提醒时间会重算：送达时间修改后，饿了么会重新计算订单的备餐提醒时间点，若希望商家出餐时间和骑手取餐时间能够有较好的咬合，推荐接入「预订单备餐时间提醒消息」。（若开发者有自己POS机或者需要做备餐提醒的）

开发者的系统若下游涉及物流配送的操作，新的送达时间需要同步您的下游系统。

三、小票样式示例

修改预计送达时间后，顾客联、后厨联、修改备注联、商家联都需要重新打印

 

四、沙箱环境测试

1、门店需要开启支持预订单下单后修改预计送达时间，修改路径：

饿了么商家版后台-订单管理-订单设置-顾客下单-预订单相关设置-是否【允许顾客修改送达时间】

2、截止当前只支持平台配送预订单修改预计送达时间，沙箱测试门店目前均签约的自配送无法直接测试，可提项目集成单后，找技术支持同学人工协助改签平台配送服务包进行测试。

3、沙箱门店如何进行下单测试？详见https://open.shop.ele.me/base/documents/testaccount

4、提交订单页面的【需要配送入校】，需要选择否。订单下单成功后，可通过订单上“改订单信息”入口，对“配送时间”做修改，有个灰色箭头点击后可重选时间。

5、测试完成后，需要改签回自配送服务包的，需要再次联系技术支持同学人工协助改签。

五、验收标准

整体流程：

1. 无需技术支持：保障宝->日常保障->任务改造->接口改造任务提交验收申请

2. 需要技术支持：保障宝->日常保障->集成项目->选择【支持用户修改预订单送达时间】-提交后提供【对接ID】给保障宝daily后，会有专人拉群进行技术支持->开发完毕后提交验收

 

提交验收申请可能存在以下几种情况【必读】：

该应用接单和打印小票均不涉及：选择“不需要开发”，并备注该应用不涉及接单和打印小票即可。请开发者务必仔细确认，此验收关联商户端灰度开关，商户授权应用均验收通过，该商户将自动开启支持用户修改预订单送达时间，如暂不支持，可不提交验收申请。

该应用涉及打印小票，且已完成改造：选择“需要开发”，并上传补打小票的图片。

该应用涉及打印小票，但未完成改造：待改造完成后再提交验收申请。

 

验收申请时开发者需提供的内容：

1.测试通过的订单号

2.重打的小票截图

FAQ

Q：用户什么时候都可以修改预订单时间吗？

A：最晚用户可修改时间：备餐提醒之前，用户都可以进行修改。注意：此处备餐提醒时间点是饿了么计算的备餐提醒时间点。推荐接入「预订单备餐时间提醒消息」。建议开发者接入这个消息

Q：因单独修改地址导致的送达时间变化，地址修改，是否也会推送233消息？

A：不会推送233，修改地址推的是214

Q：预订单修改送达时间后，是否还会再次推送217消息？

A：不会，只有233

Q：开发者的应用没有支持处理233消息时，napos上可以打开【是否允许修改预订单的时间】吗？

A：可以操作打开，但实际饿了么客户端app侧订单上依然不能修改时间。

Q：即时单以后也能支持修改送达时间的话，会增加新的消息类型吗？

A：不会，还是233