docs(v2): 对接总览补转单字段契约+我的接单totalAmount+stats空态/productType徽标说明
这个提交包含在:
父节点
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 标"已修订") |
|
||||
| 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(串) | ✅ | 接收人房务 ID(admin_id) |
|
||||
| reason | String | ✅ | 原因(普通房务 ≥1 字 / 超管 ≥10 字,1~200) |
|
||||
| skipUpperLimit | Boolean | 否 | 跳过 30 单上限(仅超管有效,默认 false) |
|
||||
|
||||
## 2.3 候选酒店 `GET /v3/admin/hotel-candidates`
|
||||
|
||||
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户