hl-api-changelog/changelogs-v2/2026-07/14_4721_房务待处理排除最终确认单-修改接口-管理后台.md
2026-07-02 14:27:50 +08:00

1.6 KiB

#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 异常

前端接入要求

房务管家「待处理」页的「全部未完成」必须传:

GET /v3/admin/order/grab-pool/my-claims/hotel?status=unfinished&page=1&pageSize=20

不要用空 status 表示「全部未完成」。空 status 仍表示历史「全部」口径,可能包含已完成/已确认记录。

验收点

  • 「待处理/全部未完成」不展示 DONE + CONFIRMED 的最终确认订单。
  • 「订单列表/全部」仍可展示历史已确认记录。
  • 「配房中 / 待最终确认 / 异常」三个单态筛选保持原逻辑。