# 提现审核 — 功能需求说明

> 本文档在《提现审核功能需求-草稿》基础上整理，并关联 **《关联需求分析.md》** v1.6、平台侧 **《订单管理功能需求》** v1.0.1、**《支付流程》**、《商户管理功能需求》** v1.5、**《店铺管理功能需求》** v1.3.5，以及商家侧 **《资金概览功能需求》** v1.0、《提现管理功能需求-草稿》、《账户管理功能需求-草稿》、《商家端店铺上下文接口说明》** 做边界与流程对齐。  
> 范围：**平台管理端 · 财务管理 · 提现审核** 对 **全平台** 商家 **提现申请** 的 **列表、检索、审核（通过/驳回）**；**不含** 商家发起提现、收款账户维护、微信自动打款。  
> **说明：** 本文档 **仅描述功能需求与业务规则**；不涉及数据库结构、接口定义及技术实现细节。  
> **命名区分：** **提现状态**（待审核 / 审核不通过 / 提现完成）为本模块 **单据状态**；商家 **资金流水 · 变动原因** 中 **提现驳回** 与 **审核不通过** **语义等价**（见 §3.3）。

---

## 1. 模块定位

### 1.1 业务目标

在农资商城 **平台管理端（Web）· 财务管理** 提供 **提现审核** 能力，使 **平台管理员**（及被授予财务审核权限的角色）能够：

- 浏览 **全平台** **已入驻商户** 旗下店铺的 **提现申请** 列表；
- 按 **申请时间、提现状态** **检索** 历史申请；
- 对 **待审核** 申请执行 **审核**：**通过**（记 **提现完成**）或 **驳回**（记 **审核不通过**），并填写 **提现处理说明**；
- 审核结果 **同步** 至 **商家 · 提现管理** 与 **商家/平台 · 资金流水**（§6），完成 **虚拟余额冻结** 的 **释放或出账**。

**不包含（本期或与它模块分工）：**

| 能力 | 说明 |
|------|------|
| **商家提交提现** | 见 **商家 · 提现管理** |
| **维护收款账户** | 见 **商家 · 账户管理** |
| **平台 · 资金概览**（全店排行/总余额） | 见 **平台 · 资金概览** 专册（草稿）；本模块 **不替代** 其汇总视图 |
| **微信/银行自动打款** | **非本期**；**通过** 表示 **运营确认已线下/渠道打款** |
| **批量审核** | **非本期**（草稿 **未要求**） |
| **商家端查看平台操作日志** | 商家 **仅见** 提现状态与 **提现处理说明** |
| **C 端买家退款** | 见 **订单/支付/售后** 专册 |
| **导出 / 打印** | **非本期** |

### 1.2 与草稿的对应关系

| 草稿条目 | 定稿处理 |
|----------|----------|
| §1 提现申请列表字段 | §5 |
| §2 高级检索 | §5.3 |
| §3 审核通过/不通过 + 处理说明 | §7、§8 |
| §4 对入驻商户提现审核 | §1.4、§2.4 |
| §5 异常返回 | **不纳入** |
| §6 技术栈 | **不纳入** |

### 1.3 在财务链中的位置

```text
【商家 · 提现管理】提交申请 → 生成提现编号
    → 店铺资金：余额提现（余额↓ 冻结↑）
    → 单据状态：待审核
            ↓
【本模块 · 平台】提现审核
    ├── 审核通过 + 处理说明 → 提现完成 → 资金流水：提现完成（冻结↓）
    └── 审核驳回 + 处理说明 → 审核不通过 → 资金流水：提现驳回（余额↑ 冻结↓）
            ↓
【商家 · 提现管理】列表同步状态与处理说明
【商家 · 资金概览】收支概况可见对应流水
【平台 · 资金概览】（另册）可按店查看流水
```

| 关联模块 | 关系 | 边界说明 |
|----------|------|----------|
| **商家 · 提现管理** | **上游写入** | 商家 **唯一** 提交入口；本模块 **唯一** 审核入口 |
| **商家 · 账户管理** | **只读引用** | 列表展示 **申请时** 绑定的 **提现账号** 快照 |
| **商家 · 资金概览** | **下游流水** | 审核结果写 **提现驳回 / 提现完成** 流水（§6） |
| **平台 · 资金概览** | 并列 | 全平台 **汇总/排行**；本模块为 **单据作业** |
| **店铺管理 / 商户管理** | 间接 | 列表展示 **店铺名称**；**冻结/删店** 与在审提现 **另约定**（§2.4） |
| **支付流程** | 间接 | C 端 **平台代收**；打款 **非** 系统自动回调本模块 |

### 1.4 数据范围

- **纳入：** **全平台** 全部 **已提交** 的提现申请（含 **待审核、审核不通过、提现完成**）；
- **排除：** **尚未提交** 的商家端草稿；**非本平台入驻体系** 的外部提现（**不做**）；
- **对象：** 草稿 §4「**平台入驻商户**」的店铺提现——即 **商户管理/入驻审核** 已建档、**店铺管理** 中 **未逻辑删除** 的店铺（**已删除店铺** 历史单 **仍展示**，见 §8.4）。

### 1.5 使用端与角色

| 端 | 可操作角色 | 能力 |
|----|------------|------|
| **平台管理端** | 平台管理员 / 财务运营 | 列表、检索、**审核** |
| **店铺经营管理端** | 商户经营账号 | **无** 本菜单；在 **提现管理** 提交与 **只读** 结果 |
| **C 端** | 买家/访客 | **不可** 访问 |

---

## 2. 关联需求分析

### 2.1 与《关联需求分析》— 供给链

| 关联点 | 定稿 |
|--------|------|
| 供给链 | 须 **商户 + 店铺** 已存在，商家才有 **可提现余额** 与 **收款账户** |
| 商户冻结/注销 | **不自动** 撤销 **待审核** 提现；运营 **可照常审核** 或 **驳回**（**不** 在本模块写商户状态） |
| 店铺停业 | **不阻断** 审核；停业 **不影响** 已冻结提现的 **处理义务** |
| 删店 O10 | 删店前须无 **未完成订单**；**待审核提现** 与删店 **冲突处理** 见 §2.4 |

### 2.2 与平台《支付流程》

| 项 | 定稿 |
|----|------|
| 资金层级 | C 端支付入 **平台商户号**；店铺 **可用余额** 为 **虚拟账** |
| 本模块 | **审核通过** = 运营确认 **已向商家收款账户打款**（**人工**）；**非** 微信 API 自动回调 |
| 微信入驻审核 | **支付入驻**（`biz_shop_wechat_pay`）与 **提现审核** **独立**；**互不替代** |

### 2.3 与平台《商户管理》《店铺管理》

| 项 | 定稿 |
|----|------|
| 店铺名称 | 列表 **店铺名称** 取 **店铺管理** 当前名称；**申请快照** **非本期** 单独存店名 |
| 商户主体 | **不** 在本列表维护商户认证状态 |
| 删店 | 店铺 **逻辑删除** 后 **不可** 新提现；**已有待审核单** 平台 **应处理完** 或 **驳回**（产品 **建议** 删店前 **清零待审**） |
| 冻结中提现 | 商家 **资金概览** 已记 **余额提现** 冻结；**须** 本模块 **闭环** |

### 2.4 与商家《资金概览功能需求》v1.0

| 项 | 定稿 |
|----|------|
| 提交后 | 商家已写 **余额提现** 流水；**待审核** 期间 **冻结金额** 含本笔 |
| 审核通过 | 写 **提现完成**：**余额不变**，**冻结减少**（释放本笔）；资金 **离开** 店铺虚拟可提现池 |
| 审核驳回 | 写 **提现驳回**：**余额恢复**，**冻结减少**；与流水 **变动原因** **提现驳回** **一致** |
| 时点 | 流水 **变动时间** = 本模块 **审核操作成功时间** |
| 业务编号 | 流水 **业务编号** = **提现编号** |

### 2.5 与商家《提现管理功能需求-草稿》

| 项 | 定稿 |
|----|------|
| 提交 | 商家填 **提现账户、金额、备注** → **待审核** |
| 编号 | **提现编号** 在 **提交成功** 时生成；**全平台唯一** |
| 商家列表状态 | **待审核 / 审核不通过 / 提现完成** 与 **本模块同名** |
| 商家检索 | 商家端可按 **审核不通过、提现完成** 筛选；**待审核** 默认可 **全列表** 见 |
| 处理说明 | 审核后 **提现处理说明** **回写** 商家列表 **只读** 展示 |
| 写操作 | 商家 **不可** 撤销 **待审核** 申请（**非本期** 撤销 **不做**，除非产品 **另定**） |

### 2.6 与商家《账户管理功能需求-草稿》

| 项 | 定稿 |
|----|------|
| 提现账号 | 列表 **提现账号** 展示 **申请时** 所选账户 **摘要**（如 **银行卡尾号 / 支付宝账号脱敏 / 微信昵称** 等，与 **账户管理** 类型 **一致**） |
| 账户变更 | 申请 **提交后** 商家 **编辑/删除** 该账户 **不影响** 本单 **已存快照** |
| 平台 | **不可** 在本模块 **改** 收款账户 |

### 2.7 与平台《订单管理功能需求》（间接）

| 项 | 定稿 |
|----|------|
| 可提现余额来源 | **订单完成结算**（O7）→ **订单收支** 入 **可用余额** |
| 本模块 | **不审订单**；**仅** 审 **提现单据** |
| 已支付关单/退款 | **非本期** 与提现 **联动规则** |

---

## 3. 业务概念与状态

### 3.1 核心概念

| 概念 | 说明 |
|------|------|
| **提现申请** | 商家 **一次** 提现 **单据**；含 **提现编号、店铺、账户、金额、备注** |
| **提现编号** | 系统生成；**全平台唯一**；列表与 **业务编号** **同源** |
| **提现金额** | 商家 **申请** 金额；**正数**；**两位小数** |
| **提现账号** | 商家在 **账户管理** 中维护的 **收款账户**；申请时 **选定** |
| **提现处理说明** | 平台审核时填写的 **说明**（通过/驳回 **均须**）；商家 **可见** |
| **审核** | 平台对 **待审核** 单 **二选一**：**通过** 或 **驳回** |

### 3.2 提现状态（单据 · 与草稿一致）

| 状态 | 含义 | 可审核 |
|------|------|--------|
| **待审核** | 商家 **已提交**，等待平台处理 | **是** |
| **审核不通过** | 平台 **驳回** | **否** |
| **提现完成** | 平台 **审核通过** 且 **确认打款完成** | **否** |

> **定稿：** 草稿 **无**「审核中以外中间态」；**审核通过** **直接** 置 **提现完成**（**一步办结**）。

### 3.3 与资金流水「变动原因」映射

| 提现状态（本模块） | 商家资金流水 · 变动原因 | 发生时机 |
|--------------------|-------------------------|----------|
| （提交后，非本模块写状态） | **余额提现** | 商家 **提交成功** |
| **审核不通过** | **提现驳回** | 平台 **驳回** 成功 |
| **提现完成** | **提现完成** | 平台 **通过** 成功 |

### 3.4 状态流转

```text
【商家 · 提现管理】提交成功
    → 待审核
    → （已发生余额提现流水，冻结↑）

【平台 · 本模块】审核
    ├── 通过 + 处理说明 → 提现完成 → 提现完成流水，冻结↓
    └── 驳回 + 处理说明 → 审核不通过 → 提现驳回流水，余额↑ 冻结↓

终态（审核不通过 / 提现完成）不可再次审核
```

---

## 4. 功能结构

```text
提现审核（平台 · 财务管理）
├── 提现申请列表（含高级检索）
├── 审核（待审核行 · 通过 / 驳回）
└── （非本期）详情抽屉、批量审核、导出
```

---

## 5. 提现申请列表

### 5.1 列表字段

| 列名 | 说明 |
|------|------|
| **提现编号** | 系统唯一编号 |
| **申请时间** | 商家 **提交成功** 时间；格式 **yyyy-MM-dd HH:mm:ss** |
| **店铺名称** | 申请所属 **店铺** |
| **提现账号** | **申请时** 收款账户 **摘要**（§2.6） |
| **提现金额** | **两位小数**；单位 **元** |
| **备注** | 商家填写；无则 **—** |
| **提现状态** | **待审核 / 审核不通过 / 提现完成** |
| **提现处理说明** | 平台审核后填写；**待审核** 时 **—** |
| **操作** | **待审核** 展示 **审核**；终态 **无** 操作或 **—** |

**默认排序：** **申请时间倒序**（最新在前）。

**建议默认 Tab/筛选：** 进入页 **优先展示待审核**（**非强制**；与 **入驻审核/商品审核** 工作台习惯 **一致**，产品可 **默认筛待审核**）。

### 5.2 分页

| 项 | 定稿 |
|----|------|
| 分页 | **支持** 分页 |
| 空列表 | 空态 + 友好提示 |

### 5.3 高级检索（与草稿一致）

| 条件 | 类型 | 说明 |
|------|------|------|
| **申请时间** | 日期区间 | **开始日期**～**结束日期**（含边界，按 **申请时间** 过滤） |
| **提现状态** | 下拉 | **全部** / **待审核** / **审核不通过** / **提现完成** |

**操作按钮：** **搜索**、**重置**。

---

## 6. 资金协作规则（审核写流水）

与 **《资金概览功能需求》** v1.0 §3.3、§6.2 **一致**：

| 审核动作 | 店铺可用余额 | 店铺冻结金额 | 流水变动原因 |
|----------|--------------|--------------|--------------|
| 商家已提交（前置） | **−** 申请额 | **+** 申请额 | **余额提现**（商家提交时） |
| **审核通过** | **不变** | **−** 申请额 | **提现完成** |
| **审核驳回** | **+** 申请额 | **−** 申请额 | **提现驳回** |

**规则：**

- 每笔提现 **至多** 产生 **两条** 资金流水：**余额提现** +（**提现完成** 或 **提现驳回**）。
- **多笔并行** 待审核：冻结为 **各笔之和**；**单笔** 审核 **仅释放/完成本笔** 对应冻结。
- 流水 **变更值 + 变更后** 展示规则见 **商家 · 资金概览** §3.4。

---

## 7. 审核通过（提现完成）

### 7.1 入口与前置

| 项 | 定稿 |
|----|------|
| 入口 | 列表行 **「审核」** → 选择 **通过**（或等价 **审核通过** 按钮） |
| 前置状态 | **仅待审核** |
| 形态 | **弹窗** 或 **抽屉**（与平台审核类 UI **一致**） |

### 7.2 表单

| 字段 | 必填 | 说明 |
|------|------|------|
| **审核结果** | 是 | **通过** |
| **提现处理说明** | **是** | 多行文本；**最多 200 字**（建议与商家 **备注** 上限 **一致**）；占位如「请输入处理说明」 |

### 7.3 提交后

```text
运营确认已通过线下/渠道向提现账号打款
    → 填写提现处理说明
    → 确认
        → 校验：状态仍为待审核
        → 提现状态 → 提现完成
        → 记录审核人、审核时间
        → 写入资金流水：提现完成
        → 同步商家 · 提现管理列表
    → 列表刷新；该单 **不可再审**
```

### 7.4 业务含义

| 项 | 定稿 |
|----|------|
| 打款 | **运营责任** 在 **审核前/时** 完成 **真实打款**；系统 **仅** 记 **提现完成** |
| 余额 | **不再** 扣减（提交时已扣）；**冻结释放** |
| 重复审核 | **禁止** |

---

## 8. 审核驳回（审核不通过）

### 8.1 入口与前置

| 项 | 定稿 |
|----|------|
| 入口 | 列表行 **「审核」** → 选择 **驳回** |
| 前置状态 | **仅待审核** |

### 8.2 表单

| 字段 | 必填 | 说明 |
|------|------|------|
| **审核结果** | 是 | **驳回** |
| **提现处理说明** | **是** | 须填写 **驳回原因/说明**；**最多 200 字**；商家 **可见** |

### 8.3 提交后

```text
运营选择驳回
    → 填写提现处理说明（必填）
    → 确认
        → 校验：状态仍为待审核
        → 提现状态 → 审核不通过
        → 记录审核人、审核时间
        → 写入资金流水：提现驳回（余额恢复、冻结释放）
        → 同步商家 · 提现管理
    → 商家 **可用余额** 恢复，可 **重新发起** 新提现申请
```

### 8.4 边界

| 场景 | 定稿 |
|------|------|
| 店铺已删除 | **仍允许** 对 **待审核** 单 **驳回**（释放冻结）；**通过** 须 **运营判断** 账户 **是否仍可打款** |
| 商家重复申请 | **驳回后** 可 **新单** 重新提交；**原单不可改** |
| 并发 | 两人同时审同一单 → **仅一人成功**；另一 **提示状态已变更** |

---

## 9. 端到端流程

### 9.1 主路径（通过）

```text
商家 · 账户管理 · 添加收款账户
    → 商家 · 资金概览 · 可用余额 > 0
    → 商家 · 提现管理 · 提交提现
        → 待审核 + 余额提现流水
    → 平台 · 本模块 · 列表见待审核
    → 运营线下打款至提现账号
    → 审核通过 + 填写处理说明
        → 提现完成 + 提现完成流水
    → 商家 · 提现管理 · 见提现完成与说明
```

### 9.2 驳回路径

```text
商家 · 提现管理 · 提交 → 待审核
    → 平台 · 审核驳回 + 处理说明
        → 审核不通过 + 提现驳回流水
    → 商家 · 可用余额恢复 → 可再次申请
```

### 9.3 与平台其他审核模块对照

| 维度 | 商户入驻审核 | 商品审核 | **提现审核（本模块）** |
|------|--------------|----------|------------------------|
| 对象 | 入驻申请单 | 商品 | **提现申请单** |
| 待审操作 | 通过/驳回 | 通过/驳回 | **通过/驳回** |
| 驳回说明 | **必填** | **必填** | **处理说明必填** |
| 通过后 | 公示/建档 | 出售中 | **提现完成+流水** |
| 数据范围 | 全平台申请 | 全平台商品 | **全平台提现** |

---

## 10. 权限与菜单

| 项 | 定稿 |
|----|------|
| 菜单路径 | **财务管理 → 提现审核**（与 UI 一致） |
| 权限粒度 | **列表查看**、**审核** 可 **分权**（由 **角色管理** 配置） |
| 数据权限 | **全平台** 提现单；**无** 按店铺 **数据隔离**（平台端） |

---

## 11. 异常与提示（功能口径）

| 场景 | 期望提示（示例） |
|------|------------------|
| 非待审核单点击审核 | 当前状态不可审核 |
| 处理说明为空 | 请填写提现处理说明 |
| 处理说明超长 | 处理说明不能超过200字 |
| 并发审核失败 | 提现状态已变更，请刷新后重试 |
| 审核成功 | 操作成功（或等价文案） |
| 列表无数据 | 暂无提现申请 |

---

## 12. 非本期与待建设

| 项 | 说明 |
|------|------|
| **批量审核** | **非本期** |
| **独立详情页** | **非本期**；列表 + 审核弹窗 **足够** |
| **商家撤销待审核** | **非本期** |
| **微信企业付款 API 对接** | **非本期** |
| **审核通过后「打款中」中间态** | **不做**；**一步** 到 **提现完成** |
| **站内消息/短信** 通知商家 | **非本期**（可后续与 **提现管理** 一并建设） |
| **按店铺名称/商户名/提现编号** 关键词检索 | 草稿 **未要求**；**非本期** |
| **导出** | **非本期** |
| **手续费扣除** | **非本期** |

---

## 13. 业务规则汇总

| 编号 | 规则 |
|------|------|
| **WDA-A1** | 本模块为 **全平台** 提现 **唯一审核入口** |
| **WDA-A2** | **仅待审核** 可 **通过/驳回** |
| **WDA-A3** | 状态 **三态**：待审核 / 审核不通过 / 提现完成 |
| **WDA-A4** | **通过** **直接** 为 **提现完成**（**无** 中间态） |
| **WDA-A5** | **通过、驳回** 均 **必填** **提现处理说明** |
| **WDA-A6** | **通过** → 流水 **提现完成**；**驳回** → 流水 **提现驳回** |
| **WDA-A7** | 与 **商家 · 资金概览** 冻结/余额规则 **一致** |
| **WDA-A8** | 商家 **提交** 时 **已写** **余额提现**；本模块 **不写** 该条 |
| **WDA-A9** | 终态 **不可再审**、**不可改** |
| **WDA-A10** | 列表字段、检索条件与 **草稿 §1～§2** **一致** |
| **WDA-A11** | **对象** 为 **平台入驻商户** 旗下店铺提现 |

---

## 14. 版本记录

| 版本 | 说明 |
|------|------|
| **v1.0** | 首版定稿：对齐草稿 §1～§4；补全状态机/审核表单/资金流水协作/与商家提现·资金概览·账户·支付边界；《提现审核功能需求-草稿》**保持不变** |

---

*文档版本：v1.0（定稿）· 关联《关联需求分析.md》v1.6、平台/商家财务相关需求 · 草稿《提现审核功能需求-草稿.md》保持不变。*
