diff --git a/changelogs-v2/2026-07/14_4721_房务待处理排除最终确认单-修改接口-管理后台.md b/changelogs-v2/2026-07/14_4721_房务待处理排除最终确认单-修改接口-管理后台.md new file mode 100644 index 0000000..f7fc775 --- /dev/null +++ b/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` 的最终确认订单。 +- 「订单列表/全部」仍可展示历史已确认记录。 +- 「配房中 / 待最终确认 / 异常」三个单态筛选保持原逻辑。