48 行
1.4 KiB
Markdown
48 行
1.4 KiB
Markdown
# 尾款凭证上传按钮显示条件修正
|
||
|
||
**日期**: 2026-03-23
|
||
**页面**: 订单详情 → 尾款凭证上传按钮
|
||
**类型**: 前端修正
|
||
|
||
---
|
||
|
||
## 问题
|
||
|
||
当前前端尾款凭证上传按钮的显示条件不准确，需要与后端逻辑对齐。
|
||
|
||
## 正确的显示条件
|
||
|
||
```js
|
||
// 尾款凭证上传按钮显示条件
|
||
const showBalanceProofBtn =
|
||
order.paymentType === 'DEPOSIT'
|
||
&& (
|
||
(order.status === 'CONFIRMED' && order.processStatus === 'READY')
|
||
|| order.status === 'PENDING_DEPARTURE'
|
||
);
|
||
```
|
||
|
||
### 条件说明
|
||
|
||
| 条件 | 说明 |
|
||
|------|------|
|
||
| `paymentType === 'DEPOSIT'` | 必须是定金模式（定金+尾款） |
|
||
| `status === 'CONFIRMED' && processStatus === 'READY'` | 已确认 + 内部流程全部完成（清单确认后进入就绪） |
|
||
| `status === 'PENDING_DEPARTURE'` | 待出行状态（允许补传凭证） |
|
||
|
||
### 注意
|
||
|
||
- **不需要判断 `PENDING_BALANCE` 状态** — 后端不校验此状态
|
||
- `CONFIRMED` 状态必须同时判断 `processStatus === 'READY'`，确保清单确认已完成后才能上传
|
||
- 上传成功后，如果原状态是 `CONFIRMED`，后端会自动将订单状态转为 `PENDING_DEPARTURE`（待出行）
|
||
|
||
## 涉及接口
|
||
|
||
**上传尾款凭证**: `POST /admin/order/{orderId}/balance`
|
||
|
||
请求体 (`RecordBalanceRequest`):
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
|------|------|------|------|
|
||
| proofUrl | String | 否 | 尾款凭证图片URL（OSS地址） |
|
||
| remark | String | 否 | 备注 |
|