hl-api-changelog/changelogs-v2/2026-05/27_3090_HOUSE文档代码对齐-加急错误码+staff结构+分页_PR3096.md

二期 v3 HOUSE 文档-代码对齐：加急错误码迁移 + staff 响应结构 + 分页一致性

服务: hl-order-service-v3 PR: #3096 Issue: #3090 日期: 2026-05-27 影响: 🟡 加急(escalate)错误码值变更(前端错误码映射需同步) + 转单候选员工接口响应结构变更 + 分页行为修复(向后兼容)

---

⚠️ 关键变化(前端 mmg 必读)

1. 询房加急(escalate)4 个错误码迁移：808280-808283 → 808815-808818

POST /v3/admin/order/inquiry/{inquiryId}/escalate(§3.6 加急/催办)相关的 4 个业务错误码，按 API 文档 §11.8 规定从 808280-808283 段迁移到 808815-808818 段。

• message 中文文案不变(动态返回)。
• 前端若按数字 code 做错误提示映射：请把这 4 个码从 8082xx 更新为 8088xx。
• 前端若直接展示 message 字段：无需任何改动。

2. 转单候选员工 staff 响应结构：裸数组 → {list,total}

GET /v3/admin/house/staff 出参从裸数组改为带分页包装，对齐文档 §6.6：

// 之前
"data": [ {...}, {...} ]
// 之后
"data": { "list": [ {...} ], "total": 12 }

前端请改读 data.list / data.total。 （注：该接口数据源依赖 user-service H07 工单，当前返回空列表 {list:[],total:0}，结构已就位，待 H07 上线后有数据。）

3. 「我的接单」分页一致性修复(行为修复，无需前端改动)

GET /v3/admin/order/grab-pool/my-claims/hotel 带筛选条件(keyword / 出行日 等)时，total 与 list 现在保持一致。原实现是 SQL 分页后再内存过滤，导致带筛选时 total 偏大、跨页漏数据，现已下沉到 SQL。前端分页页数/条数将更准确。

---

📌 备注

• 已部署测试服(dev-v3)并经真 admin token API 验证：staff 返 {list,total} 结构正确、加急接口路径连通(返 HOUSE 错误码)。
• 加急错误码 808815-818 的具体触发场景由后端单测覆盖，需真实询房数据触发；前端按上述 code 段更新映射即可。