changelog: 房务待处理排除最终确认单

changelogs-v2/2026-07/14_4721_房务待处理排除最终确认单-修改接口-管理后台.md

@@ -0,0 +1,47 @@
+# #4721 房务待处理排除最终确认单
+
+## 背景
+
+房务管家「待处理」页的「全部未完成」筛选不能展示已经最终确认/已完成配房的订单。
+后端原先未定义「全部未完成」专用状态值，前端传未知值时会落到默认全部口径，可能把 `DONE` + `CONFIRMED` 单带入待处理列表。
+
+## 修改接口
+
+- `GET /v3/admin/order/grab-pool/my-claims/hotel`
+
+## 入参变更
+
+字段：`status`
+
+新增兼容取值：
+
+| 取值 | 含义 | 后端筛选 |
+| --- | --- | --- |
+| `unfinished` | 全部未完成，推荐前端使用 | `CLAIMING` + `PENDING_FINALIZE` + `EXCEPTION` |
+| `allUnfinished` | 全部未完成，兼容别名 | `CLAIMING` + `PENDING_FINALIZE` + `EXCEPTION` |
+| `todo` | 全部未完成，兼容别名 | `CLAIMING` + `PENDING_FINALIZE` + `EXCEPTION` |
+
+已有取值保持不变：
+
+| 取值 | 含义 |
+| --- | --- |
+| `claiming` / `inProgress` / `inInquiry` | 配房中 |
+| `pendingConfirm` | 待最终确认 |
+| `confirmed` | 已确认 |
+| `exception` | 异常 |
+
+## 前端接入要求
+
+房务管家「待处理」页的「全部未完成」必须传：
+
+```http
+GET /v3/admin/order/grab-pool/my-claims/hotel?status=unfinished&page=1&pageSize=20
+```
+
+不要用空 `status` 表示「全部未完成」。空 `status` 仍表示历史「全部」口径，可能包含已完成/已确认记录。
+
+## 验收点
+
+- 「待处理/全部未完成」不展示 `DONE` + `CONFIRMED` 的最终确认订单。
+- 「订单列表/全部」仍可展示历史已确认记录。
+- 「配房中 / 待最终确认 / 异常」三个单态筛选保持原逻辑。