饿了么开放平台降级转自配送场景方案
文档说明
本文档面向对象为第三方开发者服务的商家或自研商家是由蜂鸟专送和蜂鸟快送配送降级为自配送的场景。
背景说明
当前平台送订单存在因各种原因蜂鸟拒单的场景,蜂鸟拒单后商户有2个小时的操作转自配送的时间,在服务商系统侧操作转自配送或商家后台手动操作,如未及时操作转自配送,此订单将会超时被平台自动取消。
为了保护用户地址隐私,现平台针对使用蜂鸟专送和蜂鸟快送运力的商户,平台会对订单中的用户地址做脱敏处理。降级为自配送后,才能获取到用户真实地址。
接口详情
针对蜂鸟专送和蜂鸟快送的订单,以下查询接口中返回的用户地址为脱敏地址。涉及字段 address 和 deliveryPoiAddress,为:【隐私保护】顾客地址已隐藏,您可登录饿了么商家端或骑手端查看。降级为自配送后,涉及字段 address 和 deliveryPoiAddress变为真实地址。
所属服务接口名称描述
订单服务eleme.order.getOrder获取订单
订单服务eleme.order.mgetOrders批量获取订单
订单服务eleme.order.getAllOrders查询全部订单
订单服务eleme.order.deliveryBySelfLite配送异常或者物流拒单后选择自行配送
消息推送
针对蜂鸟专送和蜂鸟快送的订单,平台推送的 type=217 消息中,用户地址 address 字段会做脱敏处理,不透出真实地址。
推送消息示例
{ "signature": "3B4B85AC76ECADB9D7C132D49336241E", "requestId": "6133333358975950251", "appId": 64166637, "shopId": 500166638, "type": 217, "message": "{\"address\":\"崇明森林公园上海市崇明区秀林路188号崇明森林公园\",\"book\":false,\"consignee\":\"张**\",\"consigneePhones\":[\"177****9927\"],\"createdAt\":\"2023-06-20T19:57:19\",\"daySn\":2,\"deliverTime\":null,\"deliveryGeo\":\"121.48506,31.669408\",\"deliveryPackageFee\":0.4,\"deliveryProductId\":0,\"description\":\"依据餐量提供餐具\",\"downgraded\":false,\"extraJson\":\"{\\\"deliveryActivityFee\\\":\\\"0.0\\\"}\",\"fulfillServiceFee\":0.0,\"groups\":[{\"items\":[{\"activities\":[],\"additions\":[],\"attributes\":[],\"barCode\":\"\",\"categoryId\":1,\"coupons\":[],\"extendCode\":\"\",\"foodGroup\":null,\"foodType\":0,\"id\":2000000012436081,\"ingredients\":[],\"name\":\"宫保鸡丁-1\",\"newSpecs\":[],\"price\":0.02,\"quantity\":1,\"shopPrice\":0.0,\"skuId\":300000012715860037,\"total\":0.02,\"uniqueId\":\"065163278-e8f3-45fc-b805-e8e5b4f7dfb3\",\"userPrice\":0.0,\"vfoodId\":2000000007387564,\"weight\":100.0}],\"name\":\"1号篮子\",\"relatedItems\":[],\"type\":\"normal\"},{\"items\":[{\"activities\":[],\"additions\":[],\"attributes\":null,\"barCode\":\"\",\"categoryId\":102,\"coupons\":[],\"extendCode\":\"\",\"foodGroup\":null,\"foodType\":0,\"id\":-70000,\"ingredients\":[],\"name\":\"餐盒\",\"newSpecs\":null,\"price\":0.4,\"quantity\":1,\"shopPrice\":0.0,\"skuId\":-1,\"total\":0.4,\"uniqueId\":null,\"userPrice\":0.0,\"vfoodId\":0,\"weight\":null}],\"name\":\"其它费用\",\"relatedItems\":[],\"type\":\"extra\"}],\"id\":\"8051680043478269422\",\"income\":0.4,\"instantOrderDeliverTime\":\"2023-06-20T20:57:19\",\"invoice\":null,\"invoiceEmail\":null,\"invoiceType\":null,\"invoiced\":false,\"openId\":\"yuzi\",\"orderBusinessType\":0,\"phoneList\":[\"13020146247,774\"],\"pickUpNumber\":0,\"pickUpTime\":\"1970-01-01T08:00:00\",\"shopId\":500166638,\"shopName\":\"饿了么测试店铺\",\"specUserPart\":0.0,\"status\":\"unprocessed\",\"superVip\":\"ELEME_SUPER_VIP\",\"taxpayerId\":\"\",\"totalActivityAmount\":0.0,\"totalAmount\":0.42,\"totalPrice\":0.42,\"userExtraInfo\":{\"giverPhone\":\"\",\"greeting\":\"\"},\"xyPackFlag\":false}", "userId": "6817383211736308630", "timestamp": 1687262239775 }
对接方案
蜂鸟专送和蜂鸟快送
针对蜂鸟配送的订单,订单处理流程不变,接单小票中展示订单推送中脱敏处理过的用户地址。
降级转自配场景
在呼叫蜂鸟专送或者快送的过程中,如果运力不足,饿了么商家版 APP 和 商家后台 会展示是否转自配送的按钮,或者调用
eleme.order.deliveryBySelfLite 接口,都会触发推送 type=71 的消息给开发者,调用流程如下:
以上降级转自配场景中,订单在转自配送后,平台会推送一条 type=71 的消息给开发者,告知配送状态变更,推单消息示例如下:
{ "orderId": "50377000000000000", "shopId": 2080111111, "state": "selfDelivery", "subState": "noSubstate", "name": "", "phone": "", "updateAt": 1632656830000 }
基于此,ISV 需要重点关注:
订阅 type=60-70 的共计11中蜂鸟拒单消息
订阅 type=71 的消息,在订单转自配送时可以感知到
收到 type=71 的消息之后,重新查询订单获取用户的真实地址(这里建议增加重试机制,可以使用隐私保护关键字做逻辑判断,如果获取到的地址还是脱敏的,间隔 1s 重新获取)
上一步拿到真实地址后重新打印小票(建议只重新打印带地址的票据,一般是商家联、顾客联),完成自配送流程
开发联调
完成时间
请务必于 2025 年 8 月 1 日前改造完毕,届时会进行抽查。
需要使用脱敏地址的业务场景(只涉及蜂鸟专送和蜂鸟快送)
页面交互中需要展示脱敏后的地址;
商家打印小票需要展示脱敏后的地址;
其他可展示、存储订单明文地址的业务场景都需要使用脱敏地址。
需要降级自配送的业务场景
蜂鸟拒单后,商户在商家后台或是服务商在系统侧操作转自配送。
上线要求
开发完成后,使用沙箱门店进行功能测试。
测试步骤:
1、由于需要测试订单降级转自配送链路,所以沙箱门店地址需要修改到澳门,且服务包签约专送。需要测试时,联系保障宝daily进行沙箱门店修改。
2、使用保障宝中的测试账号,在沙箱门店进行下单,等待15分钟后,商家后台订单状态出现“转自配”选项。
3、使用API调试台模拟发送一条“60“消息
4、收到“60”消息后,即可调用eleme.order.deliveryBySelfLite 接口转自配送
5、转自配送成功后,触发推送 type=71 的消息给开发者,调用getorder接口获取用户真实地址并重新打印小票
在线帮助
如您有任何疑问,欢迎加入保障宝平台,随时联系我们的保障宝daily进行咨询和反馈,让您的在线解答体验更加顺畅,我们将竭尽所能,不断改进和优化服务,为您提供更加贴心、高效的支持和服务,让您的体验更加美好!
FAQ
Q:调用eleme.order.getOrder获取自配送订单信息,为什么address、deliveryPoiAddress 没有返回明文地址?
A:自配送订单未完结的时候,会返回明文地址;已完结的情况下,则会返回如下文案:为保护顾客隐私已隐藏地址。
Q:哪些配送方式会把用户地址隐藏?
A:所有蜂鸟专送、快送的订单,都会把用户地址隐藏。如果订单转自配送,请在收到 type=71 的消息后调用查询接口获取完整收货地址。
Q:如果转自配送获取不到用户地址怎么办?
A:如果因系统异常等其他极端原因导致查询订单时无法获取用户地址,请引导商户去饿了么商家端查看。
Q:订单详情和推送消息中哪个字段用于区分蜂鸟专、快配送?
A:字段里面不会区分,推送的订单会在平台侧直接做判断,判断后再推送给服务商, 蜂鸟专、快配送方式的订单地址将直接隐藏,自配送的会显示地址信息。
Q:什么情况会发生订单降级?
A:当运力不足的时候,B 端会展示是否自配送按钮,商户可以选择自配送或者不再配送,或者服务商调用接口eleme.order.deliveryBySelfLite转自配送。如果订单降级为自配送了,就会推送 type=71 的消息,如果没收到就是没有降级为自配送。
Q:是否只有涉及蜂鸟专快的服务才需要改造,自配送不需要改造?
A:首先,需要确认你服务的商户是否都是自配送场景,如果都是自配送则不需要改造。但如果有一个商户存在蜂鸟转送/蜂鸟快送,则需要改造;根据平台经验,除个别品牌商可确认自配送场景外,其他服务商无法保证所有商户均为自配送。