51 行
1.9 KiB
Markdown
51 行
1.9 KiB
Markdown
# 【修正·管理后台】发票管理接口金额字段改 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 类计数字段仍为数字（非金额，不受影响）。
|