饿了么开放平台订单修改送达时间接入文档
版本说明
版本更新时间更新内容
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