# 订单 IM 群聊标识（2026-10-26）

App/IM 创建群聊、维护商家/骑手/用户成员后，将群标识保存到真实订单。后端不代建群。

## 保存接口

`POST /system/order/imGroup`，请求头 `token: <App 登录 Token>`、`Content-Type: application/json`。

```json
{
  "ddId": "176000000000000001",
  "imGroupId": "im-order-room-001"
}
```

- `ddId`：真实子单业务订单号，字符串；多店批次父单号、配送组 ID 不能代替。
- `imGroupId`：非空字符串，最长 200 字符，原样保存。
- 仅下单用户、当前接单骑手以及有门店访问权限的商家可保存。方法使用 `@Anonymous` 放行后台 Spring Security，同时由 `@Auth` 校验 App 登录，**不属于免登录接口**。
- 成功返回 `code=200`。同一标识重复保存成功；传入新值会更新已有标识。无清空操作。订单无群聊时字段为空，历史订单兼容。
- 接口只修改 `im_group_id`，不修改履约/支付状态，不调用 IM 外部接口。

## 查询返回位置

| 接口 | 群标识位置 |
| --- | --- |
| `GET /system/order/getorderxq?ddid=...` | `data.imGroupId` |
| `GET /system/order/{id}` | `data.imGroupId` |
| `GET /system/orderQsOprate/getOrderDetial?ddId=...` | `data.imGroupId` |
| `GET /system/orderQsOprate/orderList` | `data.records[].imGroupId` |
| `GET /system/order/getqsorderlist`、`/getqishouorderlist` | `data[].imGroupId` |
| `GET /system/multiStoreCheckout/rider/tasks` 普通单 | `data.records[].imGroupId`、`legacyOrder.imGroupId` |
| 同接口的多店组、`GET /system/multiStoreCheckout/groups/{groupId}` | `members[].imGroupId`、`members[].legacyOrder.imGroupId` |

多店组没有单一群聊标识，每个真实子单关联自己的群。数据库部署前需人工执行 `updatesql/sql.md` 的本次新增列语句；本地测试不代替实际 IM 建群、邀请成员及 App 打开群聊的联调。