docs(v2): 对接总览补转单字段契约+我的接单totalAmount+stats空态/productType徽标说明

这个提交包含在:
API Changelog Bot 2026-06-20 15:06:56 +08:00
父节点 80088ae7d1
当前提交 0182ffff67

查看文件

@ -199,7 +199,17 @@ curl -k -X PUT "https://api.test.1814.love:9443/v3/admin/order/60001/hotel-requi
| requirementVersion | Integer | 需求版本(>1 时 UI 标"已修订" | | requirementVersion | Integer | 需求版本(>1 时 UI 标"已修订" |
| createTime | LocalDateTime | 创建时间 | | createTime | LocalDateTime | 创建时间 |
> **我的接单** `GET .../my-claims/hotel` 响应为 `{list, total, stats}``stats={inProgress,pendingConfirm,confirmed,exception}`;行 VO 同样含 `consultantId` + `unreadMessageCount`(聊天未读红点,见模块三)。 > **我的接单** `GET .../my-claims/hotel` 响应为 `{list, total, stats}``stats={inProgress,pendingConfirm,confirmed,exception}`;行 VO 同样含 `totalAmount`#4123 新增,String,与抢单池同口径+ `consultantId` + `unreadMessageCount`(聊天未读红点,见模块三)。
> **stats 空态说明**`pendingConfirm`(待确认=PENDING_FINALIZE) / `exception`(异常=EXCEPTION) 计数随真实数据出,库里这两态 0 行时即为 0空态,非 bug,**勿隐藏 tab**),订单走到配房全确认 / 拒单超时即出数。
> **productType 筛选与徽标**`productType` 跨服务字段不下推 SQL当页内存精筛,故筛选时 `total` 仍是池总数(= 待抢徽标语义=池内总数),筛 productType 时前端弱化该徽标即可。
**转单 `POST /v3/admin/order/hotel-requirements/{requirementId}/transfer`** 请求体 `HouseTransferReqVO`
| Key | 类型 | 必填 | 说明 |
|---|---|---|---|
| toUserId | Long(串) | ✅ | 接收人房务 IDadmin_id |
| reason | String | ✅ | 原因(普通房务 ≥1 字 / 超管 ≥10 字,1~200 |
| skipUpperLimit | Boolean | 否 | 跳过 30 单上限(仅超管有效,默认 false |
## 2.3 候选酒店 `GET /v3/admin/hotel-candidates` ## 2.3 候选酒店 `GET /v3/admin/hotel-candidates`