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,10 @@
> ⚠️ **破坏性变更**:`invoiceType` 删除 `ELECTRONIC`、`email` 改为始终必填 + 格式校验、新增 `taxNo`/银行/注册信息专票五项校验、删除 `mailAddress` 字段、专票限 `COMPANY` 抬头。前端申请表单需同步改动,上线时前后端须同步发布。
> **勘误(截至 PR #4311 收口)**:抬头字段统一 `titleName`、金额 `amount` 改 JSON number(单位元,非分/×100)、票种仅 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)。
> **勘误(截至 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)。
---
## 接口背景
@@ -65,7 +69,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 | 选填 | 申请备注 |
| `applyReason` | string | 选填 | 申请原因(与 remark 二选一或并用) |
@@ -139,7 +143,7 @@ Content-Type: application/json
"titleType": "PERSONAL",
"titleName": "李四",
"taxNo": null,
"amount": 98600,
"amount": 986.00,
"email": "lisi@example.com",
"remark": "报销使用"
}
@@ -172,7 +176,7 @@ Content-Type: application/json
"bankAccount": "6222000000000001",
"registAddress": "上海市浦东新区XX路XX号",
"registPhone": "021-12345678",
"amount": 150000,
"amount": 1500.00,
"email": "finance@company.com",
"remark": null
}
@@ -201,7 +205,7 @@ Content-Type: application/json
"titleType": "PERSONAL",
"titleName": "张三",
"taxNo": null,
"amount": 50000,
"amount": 500.00,
"email": "zhangsan@example.com"
}
```
@@ -230,7 +234,7 @@ Content-Type: application/json
**特殊边界**
- 一单一票:同一订单只允许一张有效发票(REQUESTED / ISSUED / PUSHED 状态),若已有则返回 581511,须先作废旧发票再申请
- 订单状态:仅 `COMPLETED`(已完成)状态订单可申请,其他状态返回 581510
- 金额单位:`amount` 为整数**分**(不是元),前端输入元时需在提交前 ×100
- 金额单位:`amount` 为 JSON number,单位**元**(如 `986.00`),>0,≤ 订单总金额;前端输入框以元为单位直接提交,无需 ×100
---
@@ -288,7 +292,7 @@ Content-Type: application/json
1. `ELECTRONIC` 枚举值已删除,前端下拉不可出现此选项;老订单历史数据如有该枚举值,出参展示时可显示「未知类型」或联系后端处理
2. `email` 无论票种均必填,前端不可根据票种做条件隐藏
3. 专票表单区块(税号 + 开户行 + 账号 + 注册地址 + 注册电话)共 5 个字段,在选专票时全部必填,不可缺任何一项
4. `amount` 单位为**分**,前端展示/输入框单位通常为元,提交前须乘以 100
4. `amount` 为 JSON number,单位**元**(如 `986.00`),前端输入框直接传元值,无需 ×100;后端已按元存储和校验
---