饿了么开放平台口袋分装订单场景接入方案

一、文档说明

本文档面向对象为需要接入口袋分装类型订单的服务商与商家，开发者可根据文档内容进行接入。

二、背景介绍

开发者通过 type=217 类型的消息推送，或者 API 接口eleme.order.getOrder、eleme.order.mgetOrders、eleme.order.getAllOrders 获取订单信息时，需要对口袋分装订单做额外处理，以便后厨能够区分不同口袋的商品，然后进行分装。目前使用OpenAPI 的商家，饿了么 APP 不会透出口袋分装功能，只有接入验收通过后，平台打开开关，C 端才会透出口袋分装功能。

三、改造范围

已接入或者未接入下述场景的应用可根据自身业务需求选择是否接入

需要改造的应用业务描述对应接口/消息推送改造备注

需要判断口袋分装订单的应用eleme.order.getOrder、eleme.order.mgetOrders、eleme.order.getAllOrders、type=217使用 bagOrder判断是否是口袋分装订单

四、涉及接口、消息及变更

SDK依赖版本：Java SDK ≥ V1.30.57

接口/消息名称变更前变更后

eleme.order.getOrder、eleme.order.mgetOrders、eleme.order.getAllOrders、type=217无新增bagOrder字段

eleme.order.getOrder、eleme.order.mgetOrders、eleme.order.getAllOrders、type=217、218无当bagOrder为 true时，groups.name文案会展示为：包装盒X，当bagOrder为 false时，仍为之前文案：x号篮子

五、一句话概述

如果bagOrder为 true，则为口袋分装订单。groups.name 会展示“包装盒X”，后厨联打印需醒目标注，以便后厨能够区分不同口袋的商品，然后进行分装，groups.type 枚举标识不变，仍为normal，其他结构不变。

六、口袋分装订单展示

八、开发联调

8.1 完成时间

请务必于 2024 年 12 月 3 日前改造完毕，届时会进行抽查。

8.2 灰度策略

沙箱门店默认加入白名单内，可直接用沙箱门店进行功能测试。非沙箱门店（指的是非应用自动开出的测试门店）若想要支持口袋分装功能，需应用完成开发并上线后，以灰度门店设置的方式支持线上环境的灰度测试，申请项目验收时可提供对应门店 shopId 发送给保障宝daily，额外进行灰度设置。

线上门店只有开放平台验收通过后，用户端才会透出此功能（应用维度开放）

九、验收标准

整体流程：保障宝提交集成项目 -> 申请技术支持 -> 开发者进入开发阶段 -> 开发完成 -> 联系保障宝 daily 进行平台验收 -> 验收通过 -> 开发者系统发布完成 -> 平台打开应用维度开关

9.1 申请技术支持

在保障宝的「集成项目」入口进行提交，选择订单场景-口袋分装订单场景接入方案，提交后如需要技术支持，提供【对接ID】给保障宝daily后，会有专人拉群进行技术支持，操作方法：集成项目使用说明。