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 行删除
@@ -6,6 +6,8 @@
> ⚠️ **破坏性变更**:`invoiceType` 删除 `ELECTRONIC`、`email` 改为始终必填 + 格式校验、专票限公司抬头 + 必填五项、删除 `mailAddress` 字段。小程序开票页与详情页均需同步改动,上线时前后端须同步发布。
> **勘误(截至 PR #4311 收口)**:抬头字段统一 `titleName`、金额 `amount` 改 JSON number(单位元,非分/x100)、票种仅 2 值(`VAT_NORMAL`/`VAT_SPECIAL`)、专票限公司抬头、入参和出参均无 `mailAddress`。关联 Issue [#4290](https://git.1814.love:8443/wx/HL/issues/4290) [#4296](https://git.1814.love:8443/wx/HL/issues/4296) [#4310](https://git.1814.love:8443/wx/HL/issues/4310) / PR [#4292](https://git.1814.love:8443/wx/HL/pulls/4292) [#4302](https://git.1814.love:8443/wx/HL/pulls/4302) [#4311](https://git.1814.love:8443/wx/HL/pulls/4311)。
---
## 接口背景
@@ -86,7 +88,7 @@
| `bankAccount` | string | `invoiceType=VAT_SPECIAL` 时必填 | 银行账号 |
| `registAddress` | string | `invoiceType=VAT_SPECIAL` 时必填 | 注册地址 |
| `registPhone` | string | `invoiceType=VAT_SPECIAL` 时必填 | 注册电话 |
| `amount` | integer | 始终必填 | 开票金额,单位**分**,须 > 0 且不超过订单总金额 |
| `amount` | number | 始终必填 | 开票金额,JSON number,单位**元**(如 `986.00`),须 > 0 且不超过订单总金额 |
| `email` | string | 始终必填 | 收件邮箱,须通过邮箱格式校验 |
| `remark` | string | 选填 | 备注 |
@@ -167,7 +169,7 @@ Content-Type: application/json
"titleType": "PERSONAL",
"titleName": "张三",
"taxNo": null,
"amount": 98600,
"amount": 986.00,
"email": "zhangsan@qq.com",
"remark": "旅游报销"
}
@@ -200,7 +202,7 @@ Content-Type: application/json
"bankAccount": "1234567890123456",
"registAddress": "上海市浦东新区XX路XX号",
"registPhone": "021-88888888",
"amount": 298000,
"amount": 2980.00,
"email": "finance@company.com"
}
```
@@ -228,7 +230,7 @@ Content-Type: application/json
"titleType": "PERSONAL",
"titleName": "李四",
"taxNo": null,
"amount": 50000,
"amount": 500.00,
"email": "lisi@example.com"
}
```
@@ -256,7 +258,7 @@ Content-Type: application/json
- 管理后台代客申请走 admin 专属接口
**特殊边界**
- 金额单位:`amount` 为整数**分**,前端显示元时需在提交前 ×100
- 金额单位:`amount` 为 JSON number,单位**元**(如 `986.00`),前端输入框以元为单位直接提交,无需 x100
- 一单一票:同一订单至多一张有效发票
- 专票抬头联动:选专票后,抬头类型需强制为单位,个人选项需禁用或隐藏
- 详情回显:`mailAddress` 字段已不存在,前端不应渲染邮寄地址块
@@ -319,7 +321,7 @@ Content-Type: application/json
2. 重开接口(reissue)入参字段矩阵与 apply 完全相同,改动同步适用
3. 专票五项(taxNo + 开户行 + 账号 + 注册地址 + 注册电话)在专票场景下全必填,缺一返回 581515
4. 详情页 `mailAddress` 字段已消失,老版本小程序读到 undefined 需做好空值守卫(不报错)
5. `amount` 单位为分,小程序展示/输入框以元为单位时,提交前须 ×100
5. `amount` 为 JSON number,单位**元**(如 `986.00`),小程序输入框直接传元值,无需 x100
---