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