docs(changelog): order-v3 每日审查修正 发票金额String序列化(admin)+售后mp归属校验(mp)
这个提交包含在:
@@ -0,0 +1,50 @@
|
||||
# 【修正·管理后台】发票管理接口金额字段改 String 序列化(对齐平台金额约定)
|
||||
|
||||
> 模块:order-v3 发票(invoice)管理后台
|
||||
> 类型:契约修正(每日审查驱动,非新增端点)
|
||||
> 影响端点:`/v3/admin/order/invoice/**`(发票申请/开票/重传/分页列表)
|
||||
> 关联:发票补齐 PR1-4(#4171/#4172/#4173/#4174)的每日审查修正
|
||||
> 测试服已部署验证(9443 真 token 实测 200,金额字段确认为字符串)
|
||||
|
||||
## ⚠️ 关键说明
|
||||
|
||||
发票管理后台部分响应 VO 的金额字段(`BigDecimal`)此前漏标 `@JsonSerialize(ToStringSerializer)`,会被全局 Jackson 序列化成 **JSON 数字**(如 `0`),与平台「所有金额一律 String」约定不一致。本次修正后统一返回**字符串**(如 `"0"`、`"1280.00"`)。
|
||||
|
||||
前端按平台惯例**以字符串解析金额**即可,无需改动;若此前已按数字解析这几个字段,请改回字符串。
|
||||
|
||||
## 1. 受影响字段
|
||||
|
||||
| VO | 字段 | 修正前 | 修正后 |
|
||||
|----|------|--------|--------|
|
||||
| InvoicePageStatsVO(分页统计) | requestedAmount / issuedAmount / pushedAmount / currentMonthIssuedAmount | 数字 `0` | 字符串 `"0"` |
|
||||
| InvoicePageItemRespVO(分页行) | amount | 数字 | 字符串 |
|
||||
| AdminInvoiceApplyRespVO(代客申请响应) | amount | 数字 | 字符串 |
|
||||
|
||||
## 2. 实测样例
|
||||
|
||||
请求:`GET /v3/admin/order/invoice/page?pageNo=1&pageSize=5`(Bearer admin token)
|
||||
|
||||
响应(节选,金额均为字符串):
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "成功",
|
||||
"data": {
|
||||
"records": [],
|
||||
"total": 0,
|
||||
"stats": {
|
||||
"requestedCount": 0,
|
||||
"requestedAmount": "0",
|
||||
"issuedCount": 0,
|
||||
"issuedAmount": "0",
|
||||
"pushedCount": 0,
|
||||
"pushedAmount": "0",
|
||||
"currentMonthIssuedCount": 0,
|
||||
"currentMonthIssuedAmount": "0"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
count 类计数字段仍为数字(非金额,不受影响)。
|
||||
在新工单中引用
屏蔽一个用户