docs(发票): PR #4311 收口——4份发票 changelog 勘误(amount 改 JSON number 元)

修正范围:
- 23_4290_发票申请入参票种修正-修改接口-管理后台.md
- 23_4290_发票申请票种修正-修改接口-小程序端.md
- 23_4258_发票详情接口-新增接口-管理后台.md
- 23_4265_发票列表page结构调整-修改接口-管理后台.md

主要变更(4份文件均已对齐最终线上契约):
1. amount 入参/出参全部改为 JSON number(单位元,如 986.00),
   原「integer 分/字符串分/×100」描述已作废
2. 各文件顶部勘误节追加「截至 PR #4311 收口」条目,
   关联 Issue #4290/#4296/#4310、PR #4292/#4302/#4311
3. 详情接口边界示例:专票 email 由 null 改为始终有值(全电子交付)
4. 列表接口:records.amount 和 stats.amount 均改为 number 类型
这个提交包含在:
yaosutu
2026-06-23 17:09:06 +08:00
父节点 3e00271082
当前提交 f85aa74eb5
共修改 4 个文件,包含 44 行新增和 35 行删除
@@ -10,6 +10,7 @@
> 1. `invoiceType` 枚举已删除 `ELECTRONIC`(电子发票),只保留 `VAT_NORMAL`(增值税普通发票)和 `VAT_SPECIAL`(增值税专用发票)
> 2. 出参已删除 `mailAddress` 字段(无纸质邮寄,全电子交付)
> 3. `email` 字段始终有值(全电子交付),不再是"电子发票为 null"
> 4. `amount` 字段改为 JSON number(单位**元**,如 `986.00`),原「字符串/单位分」均已作废;边界示例专票 `email` 由 null 改为始终有值(全电子交付)。关联 PR [#4311](https://git.1814.love:8443/wx/HL/pulls/4311),Issue [#4290](https://git.1814.love:8443/wx/HL/issues/4290) [#4310](https://git.1814.love:8443/wx/HL/issues/4310)。
## 接口背景
@@ -77,7 +78,7 @@
| `bankAccount` | string / null | 银行账号,**仅专票**有值,其余 null |
| `registAddress` | string / null | 注册地址,**仅专票**有值,其余 null |
| `registPhone` | string / null | 注册电话,**仅专票**有值,其余 null |
| `amount` | string | 开票金额,单位**分**,字符串防精度丢失,如 `"98600"` |
| `amount` | number | 开票金额,JSON number,单位**元**(如 `986.00`) |
| `email` | string | 收件邮箱(始终有值,全电子交付) |
| `applyReason` | string / null | 备注(申请原因) |
@@ -185,7 +186,7 @@ Authorization: Bearer <token>
"bankAccount": null,
"registAddress": null,
"registPhone": null,
"amount": "98600",
"amount": 986.00,
"email": "finance@hulalv.com",
"applyReason": "报销使用",
"status": "REQUESTED",
@@ -235,8 +236,8 @@ Authorization: Bearer <token>
"bankAccount": "6222 0000 0000 0001",
"registAddress": "上海市浦东新区XX路XX号",
"registPhone": "021-12345678",
"amount": "150000",
"email": null,
"amount": 1500.00,
"email": "finance@company.com",
"applyReason": null,
"status": "ISSUED",
"statusText": "已开票(待推送)",
@@ -292,14 +293,14 @@ Authorization: Bearer <token>
- 专票五项字段(`taxNo` / `bankName` / `bankAccount` / `registAddress` / `registPhone`):taxNo 普票公司抬头也需填,专票四项仅 `invoiceType=VAT_SPECIAL` 时有值,前端按 invoiceType 决定是否展示
- 开票痕迹字段(`invoiceNo` / `fileUrl` / `pdfName` / `pdfSize` / `issuedBy` / `issuedAt`):状态为 `ISSUED` 或 `PUSHED` 时有值,`REQUESTED` 和 `VOIDED` 时为 null
- 推送痕迹字段(`pushedAt` / `pushedChannels`):仅 `PUSHED` 时有值
- `amount` 单位为**分**,前端展示时除以 100 转为元
- `amount` 为 JSON number,单位**元**(如 `986.00`),前端直接渲染,无需除以 100
---
## 注意事项
1. `id` / `orderId` 为 Long 雪花 ID,前端必须以**字符串**接收,不可用 JS number 类型(会丢失精度)
2. `amount` 单位为**分**,字符串格式,展示时除以 100 转为元
2. `amount` 为 JSON number,单位**元**(如 `986.00`),前端直接渲染,无需除以 100
3. `pdfSize` 单位为**字节**,字符串格式,展示时自行换算为 KB / MB
4. `pushedChannels` 未推送时为 null,不是空数组 `[]`,前端判断时注意区分