hl-api-changelog/changelogs/2026-03/2026-03-23_balance_proof_optional.md
API Changelog Bot 4f32aab4a8 changelog: 尾款凭证图片改为选填
后端proofUrl是选填,前端不应强制要求上传。

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 15:42:01 +08:00

28 行
619 B
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 尾款凭证图片应为选填
**日期**: 2026-03-23
**页面**: 订单详情 → 尾款收取
**类型**: 前端 BUG
---
## 问题
"确认收到尾款"按钮要求必须上传凭证图片才能提交,但后端 `proofUrl` 是选填字段。
## 后端接口
```
PUT /admin/order/{orderId}/record-balance
{
"proofUrl": "https://...", // 选填凭证图片URL
"remark": "客户微信转账" // 选填:备注
}
```
两个字段都是选填。请求体可以为空 `{}`,也可以只传 remark。
## 前端修复
去掉凭证图片的必填校验,允许不上传图片直接确认收款。