# 5.5 寸手持端适配 —— 后端接口补充清单

适配手机端时，设计稿要求展示/筛选的部分内容，现有接口没有提供或未生效。
以下为**实机联调（内网真实数据）验证过**的结论，客户端侧已按设计稿把 UI 与参数都做好，
后端补齐后即可直接生效，客户端基本无需再改。

整理时间：2026-07-29　　验证环境：内网 `192.168.1.250:8093`，账号 ADMIN

---

## 一、参数已发送但后端未生效（客户端已就绪，等后端支持）

| 接口 | 参数 | 用途 | 实测现象 |
|------|------|------|----------|
| `IntExpOutHandover/pageQuery`<br>`IntExpOutHandover/pageQueryTotal` | `hoState`<br>（"0" 待交接 / "1" 已交接） | 出库交接页「待交接 / 已交接」Tab 过滤与角标计数 | 请求体确认携带 `"hoState":"0"` / `"1"`，但两个 Tab 返回**完全相同**的数据；`pageQueryTotal` 的 `wbNumber` 也不随之变化 |
| `IntExpMove/pageQuery`<br>`IntExpMove/pageQueryTotal` | `spCode`<br>（特码，如 "PER"） | 出港移库页筛选弹层「特码」 | 请求体确认携带 `"spCode":"PER"`，但返回结果中仍含特码为 `PEF` 的记录，角标计数也无变化 |

> 对照参考：同一接口的 `moveState`、`by1`（承运人）、`awbType`（运单类型）**均正常生效**
> （实测承运人填 MU 后待移库数量 67 → 60），因此可以排除客户端传参方式的问题。
>
> 若贵方使用的参数名与上表不同，请告知正确名称，客户端改一处常量即可。

---

## 二、接口未返回、设计稿需要展示的字段

以下字段目前接口完全不返回，或恒为 `null`。客户端已按设计稿保留完整 UI 结构，
数据为空时统一占位 `-`，后端补齐后自动显示。

### 2.1 `IntExpMove/pageQuery`（出港移库）

| 设计稿位置 | 需要的字段 | 当前状况 |
|------------|-----------|----------|
| 列表卡片第二行「航班信息：20260709/MU2311」 | 航班日期 + 航班号（如 `fdate` / `fno`） | **接口无任何航班相关字段** |
| 详情页「移库信息」卡片 —— 移库人 | 移库人**姓名**（现只有 `opId`） | `opId` 恒为 `null`，且即便有值也是 ID 而非姓名 |
| 详情页「移库信息」卡片 —— 移库时间 | `opdate` | 恒为 `null`，**已移库记录也是 null** |
| 详情页蓝色表头右侧时间戳 | 同上 `opdate` | 同上 |
| 详情页类型行右侧「普通货物运输」 | `businessType` 或 `cargoType` | 两者均恒为 `null` |

### 2.2 说明

- 出库交接页的详情所需字段（板型、库位、复磅人/时间等）接口均已返回，无需补充。
- 移库详情页红色标签绑的是 `awbTypeName`（真实值形如「国际出港（国际直航）」），已正常。
  设计稿上写的「国际进港」经判断为设计稿笔误（该页属国际出港），未按字面实现。

---

## 三、附：字典接口调用口径（客户端已按此对齐，仅作备忘）

`typeCode/getSpecialCodeByParam`（特码字典）：

- `flag=1`（国际）+ `ieFlag=""`（**留空**）→ 正常返回 RXE/PER/PEM/PEF/LDP/GJJ/DGR 等
- `flag=1` + `ieFlag="E"` → 返回 `"data": []` 空数组

国际出港各页面统一使用 `ieFlag=""`。如该行为非预期，请后端确认 `ieFlag` 的取值约定。
