# 费用管理 PRD

| 项 | 内容 |
| --- | --- |
| 所属产品 | ASA |
| 版本 | v2.1.0 |
| 页面 | 05-费用管理 |
| 涉及功能 | 费用管理（feature 台账由总控登记） |
| 编制日期 | 2026-10-19（2026-10-21 总控代改：按会议清单 v2 回写） |
| 文档状态 | 待评审 |
| 目标读者 | 研发、测试、AI 实现助手（本文件可直接整份投喂给 AI 作为实现依据） |
| 关联文档 | 本目录 spec.yaml、mocks/；版本 [index.md](../index.md)；原型 `html/费用管理.html`（V2.1 注释 :4848、:4856、:4864）、`html/费用明细.html`（:3612）、`html/审批详情-费用管理.html` |

## 0 前置说明

- 本页覆盖版本记录第 13 项（费用管理）、第 14 项（费用明细）、第 15 项（费用管理审批详情，只写「审批内容」区）。
- 本页**主管**：账户余额与分桶、授信额度与停投判定、充值 / 退款 / 余额分配的计费口径、5 类费用审批的业务单据、提成规则、交易明细。06（结算单支付）、07（返点、客情）往交易明细里写，11 按本页提成规则版本算提成。
- 引用 03-规则配置：某天适用哪条规则、消耗首日、服务费落行、阶梯落档都调用 03（R-03-003、R-03-005、R-03-006、R-03-009），本页只写「用提交当天的规则怎么折算钱」。
- 引用 04-客户管理：计费模式、币种、付款主体（R-04-002、R-04-028）；「新增付款主体」直接调起 04 的付款主体弹窗和审批。
- 引用 12-审批配置与审批中心：审批引擎、撤回、通知渠道、审批详情框架与变更高亮都按 12；本页只写提交参数、审批内容区和结束后的数据变化。
- 引用 06-账单与结算单：「费用明细」tab 复用 06 账单信息（R-06-032）；后付未结清消耗按账单流转计费模式（R-06-012）与状态取；「结算单支付」交易明细由 06 按 R-06-051 写入；预付账单逐张按分桶覆盖判结清（D-00-11）；后付结算单的「余额抵扣」用本页分桶（D-00-73、R-05-118），「余额抵扣账单」交易明细在 06 结算单审批通过时调用 05 写入（R-05-095）；后付返点结转额出账时客户已转预付的，按本页 R-05-004 ④ 入余额（D-00-81）。
- 引用 09-收付款中心：收款单 / 付款单的生成（R-09-001～R-09-004）、确认汇款 / 确认到账与回写（R-09-042、R-09-071）归 09，本期收付款单不作废，只有 sys 兜底撤回两种情形（D-00-69、R-05-085）。本页写到「审批通过 → 生成收 / 付款单」「收 / 付款单完成或被 sys 撤回 → 到账 / 交易明细变化」两个接口点为止。
- 引用 13-导航与权限：费用管理、费用明细两页按「费用管理（查看）」权限点显示（D-00-78）；有「收付款中心」权限点的人可只读查看 4 类费用审批详情（R-13-050）。
- 版本级口径：D-00-07、D-00-08、D-00-11、D-00-13、D-00-14、D-00-19、D-00-38～D-00-41、D-00-33、D-00-51～D-00-54、D-00-57、D-00-58、D-00-62、D-00-69、D-00-71、D-00-73～D-00-79、D-00-81、D-00-82。
- 存量数据（期初余额、老额度等）处理方式单独列在第 4 节：2026-10-22 已按闭环清单 C01～C03 定（D-05-53），剩余执行细节随 Q-05-01，**上线前必须定**。

## 1 整体概述

### 1.1 背景与目标

现状：账户上只有一个「授信额度」字段；充值、退款靠线下对账，服务费按客户上的一个比例手算，规则变了说不清某笔钱按什么算；没有账户间调余额的手段，也没有统一的资金流水。

目标：
- 预付款客户的每个账户有一个随消耗实时变化的余额；充值、退款、账户间余额分配、授信额度都走审批，钱按 03 的规则在提交那一刻算清并锁定。
- 余额不足（含额度）时自动停投并通知销售与优化师，快用完时提前 7 天、3 天提醒。
- 一个客户的所有资金变动在「交易明细」里一行一笔，可追溯到审批单。
- 在客户上配置销售 / 优化师的提成规则，提交时选生效日期（当月 1 号起），审批通过后按所选日期生效，能看历史提成规则，供 11 计算。

可证伪的判定：给账户 A 充值 8,000.00 USD（第 2 行阶梯落 5.00%），审批通过后余额不变、交易明细出现「待完成」；09 确认收款后 A 余额 +8,000.00、额度清零、交易明细「已完成」；之后再退款 4,000.00，应退金额按 A 两笔充值各自的费率分别倒推。

### 1.2 本页范围

- ✅ 包含：
  - 余额（动态计算）、分桶、锁定、欠费；授信额度、剩余额度、停投与提醒。
  - 计费口径：取规则、落行、正算 / 反算落档、舍入、结算币种与汇率、提交锁定。
  - 费用管理页：费用信息列表、已提交审批 tab；5 个弹窗。
  - 5 类审批的提交、复核、结果处理、审批内容区。
  - 费用明细页：入口与 tab、交易明细。
  - 提成规则配置、生效日期、版本与历史提成规则。
- ❌ 不包含：
  - 「费用明细」tab 的账单口径、状态、出账、导出（06，D-05-01）。
  - 收款 / 付款确认（09）；提成计算与展示（11）；规则配置（03）；付款主体编辑（04）。
  - 费用信息「导出」（原型：本期不做）。
  - 停投的执行动作（沿用后端现有）；自动恢复投放（本期不做，靠人工，D-05-46）。

### 1.3 角色与权限

| 角色 | 能做什么 | 不能做什么 | 权限来源 |
| --- | --- | --- | --- |
| 有「账户费用管理」的用户 | 充值、退款、余额分配、调整额度 | 操作没有查看权限的账户 | 新增权限点（D-05-37） |
| 申请人 | 撤回自己提交的审批中单（只校验本人且审批中，不校验业务权限点，D-00-79②） | — | 12 |
| 有「审批配置」的用户 | 作废任何审批中的单，效果同撤回（D-00-79③） | — | 12、13 |
| 有「提成规则管理」的用户 | 提成规则配置；只读查看提成规则配置审批详情 | — | 新增权限点（D-05-37） |
| 有「费用管理（查看）」且能看到某账户的用户 | 在费用管理看到该客户与该账户；进费用明细页；只读查看涉及该账户的 4 类费用审批详情 | 看没有权限的账户；没有「费用管理（查看）」时看不到两页菜单 | 「费用管理（查看）」（D-00-78）+ 现有账户查看权限（R-05-035） |
| 审批人 | 通过、驳回 | 修改审批内容 | 12（R-12-023） |
| 有「收付款中心」的用户 | 只读查看账户充值、充值退款、额度调整、余额分配的审批详情（R-05-086） | 通过 / 驳回 / 撤回；不能因此进入费用管理操作，也不能看到无权限账户的列表数据 | 13（R-13-050、D-00-71） |

### 1.4 术语定义

| 术语 | 释义 |
| --- | --- |
| 账户余额 | 资金入账 − 资金出账 − 累计消耗，动态算，可为负（R-05-001、R-05-009） |
| 分桶 | 每一笔进入余额的钱单独一桶，带当时的费率快照，退款 / 取出按它倒推（R-05-004、R-05-005） |
| 锁定金额 / 可用余额 | 审批中的退款、取出占住的钱 / 余额减去它（R-05-008） |
| 授信额度 / 剩余额度 | 客户打款慢时我们给的兜底 / 兜底还剩多少（R-05-010、R-05-013） |
| 充值金额 / 充值余额 | 进入账户余额的净额（充值弹窗叫充值金额，余额分配转入叫充值余额），记作 B |
| 应收金额 / 应退金额 / 实际金额 | B + 税费 + 服务费 + 服务费税费（R-05-021） |
| 结算币种 | 客户实际打款 / 收退款的币种，默认客户币种（R-05-024） |
| 账户消耗币种 | 账户在投放渠道里消耗的币种，余额、额度都用它（R-05-002） |
| 余额抵扣（后付） | 预付改后付后，剩余分桶在后付结算单里按退款口径抵应收（D-00-73、R-05-118）；与 07 的「返点抵扣」是两件事 |
| 日汇率 | 当天 UTC 00:17 从系统汇率源取的那一次价格；结算类单据锁 4 位（D-00-74、R-05-024） |

### 1.5 核心流程

| 步骤 | 操作者 | 系统行为 | 产物 |
| --- | --- | --- | --- |
| 1 | 有权限的用户 | 在费用信息列表点充值 / 退款 / 余额分配 / 调整额度 / 提成规则配置 | 弹窗，按提交当天规则与汇率实时计算 |
| 2 | 同上 | 填写、提交审批并确认 | 12 审批单（业务单据 = 计算快照）；退款、取出锁定余额 |
| 3 | 审批人 | 审批详情看内容（额度变更标红），通过或驳回 | 审批结果 |
| 4 | 系统 | 通过：充值 → 09 收款单 + 交易明细待完成；退款 → 扣余额 + 09 付款单 + 交易明细待完成；余额分配 → 两侧立即生效 + 交易明细已完成；额度 → 写入；提成 → 按所选生效日期写入版本。驳回 / 撤回：释放锁定 | 收付款单、交易明细、额度、提成版本 |
| 5 | 财务（09） | 确认收款 / 付款完成 | 充值到账生成分桶、额度清零；交易明细已完成 |
| 6 | 系统 | 按消耗动态算余额、剩余额度；锁定、到账、额度、消耗变化时即时判停投（R-05-014）；每天按昨日消耗发可用天数提醒 | 停投、通知 |

## 2 详细需求

### 2.1 账户余额与分桶（定义）

#### 2.1.1 功能描述

定义余额怎么来、钱分几桶、消耗和退款先扣哪桶、什么叫可用余额。本节没有界面，是列表、弹窗、06 出账（预付款期末余额）的共同口径。

#### 2.1.2 核心字段

账户资金（account_funds，计算值）：

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 账户余额 | balance | decimal(2)，账户消耗币种 | 是 | 可为负 | — | R-05-001、R-05-009；后付款不计 |
| 锁定金额 | locked | decimal(2)，账户消耗币种 | 是 | ≥ 0 | 0 | R-05-008 |
| 可用余额 | available | decimal(2)，账户消耗币种 | 是 | 可为负 | — | R-05-008 |
| 剩余额度 | credit_remaining | decimal(2)，账户消耗币种 | 是 | 预付款 ≥ 0 | — | R-05-013 |

分桶（balance_bucket，页面不展示）：

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 分桶ID | bucket_id | string | 是 | 系统生成 | — | 唯一 |
| 账户 | account_id | 关联 02 账户 | 是 | — | — | — |
| 来源 | source | enum | 是 | 账户充值 / 余额分配转入 / 返点余额抵扣 / 账单结转 | — | R-05-004 |
| 来源单据 | source_doc | 关联审批单 | 是 | — | — | 返点抵扣为 07 的审批单；结转为产生结转额的 06 结算单审批单 |
| 入账时间 | arrived_at | datetime（UTC0，秒） | 是 | 系统写入 | — | 先进先出依据（R-05-006） |
| 入账金额 | amount | decimal(2)，账户消耗币种 | 是 | > 0 | — | R-05-004 |
| 服务费率 / 税率 / 承担方快照 | fee_rate / tax_rate / fee_tax_bearer | decimal(2)% / decimal(2)% / enum | 是 | — | — | R-05-005 |

#### 2.1.3 业务规则

- **R-05-001** 账户余额 = 该账户已到账的资金入账合计 − 已扣减的资金出账合计 − 截至当前的累计消耗；累计消耗只算该账户计费模式为预付款的结算期里的消耗（计费模式按结算期，D-00-73），后付款结算期的消耗不扣余额；消耗按最新消耗数据动态计算，历史某天的消耗被修正（如 10-21 发现 10-18 的消耗变了）时，余额随之变化，不另做冲正单据（D-05-02）；例外：预付改后付生效后，切换前的预付结算期已按 R-06-074 冻结欠费、或账单已结算冻结的，此后该结算期的消耗修正不再进入余额，也不再参与分桶覆盖，线下处理（R-05-118②、§5 已知限制）；计算实现由技术定
- **R-05-002** 余额、充值金额、退款余额、取出余额、额度一律用账户消耗币种（D-05-09）；同一客户下所有账户消耗币种相同（D-05-11），正常流程不会产生同一客户多币种，02 开户时服务端校验客户与账户的账户系统一致（会议清单 D88）；账户消耗币种 = 账户所属账户系统的币种（技术答复 T07，原开放问题第 4 条关闭）；客户上的「币种」是客户给我们结算的币种，只用作充值 / 退款结算币种的默认值（R-05-028）
- **R-05-003** 预付款客户的账户计余额、产生分桶，可充值、退款、余额分配。后付款客户（以当前结算期的计费模式为准，D-00-73）不能充值、退款、余额分配（D-05-03），账户不再产生新的分桶（在途单与结转见 R-05-118；生效时仍在审批中的 07 预付返点余额抵扣通过后照常成桶，R-05-118③）；仍有未用完分桶（账户余额 > 0）的账户，列表「账户余额」照常显示，否则显示「-」；剩余分桶按 R-05-118 用于后付结算单余额抵扣
- **R-05-004** 资金入账有四种，每一笔按账户各生成一个「分桶」：①账户充值，09 收款单确认收款时到账（R-05-085）；②余额分配转入，审批通过时到账；③预付客户返点余额抵扣，07 审批通过时到账（D-00-19）；④账单结转：后付返点结转额挂起期间新出账的账单为预付款时，结转额充进对应账户余额（R-06-078、D-00-81）。分桶的入账时间 = 到账时间，金额 = 该账户本次进入余额的金额
- **R-05-005** 每个分桶带一份费率快照（服务费率、税率、服务费税费承担方），退款、取出、余额抵扣时按它倒推（R-05-027）：账户充值、余额分配转入 = 提交时锁定的那套（R-05-029），提交当天没有适用规则时快照为服务费率 0、税率 0（R-05-017）；返点余额抵扣、账单结转 = 服务费率 0、税率 0（D-05-21），先去覆盖欠费时同样按 0（会议清单 D100，税务口径待财务确认）；上线前存量期初余额 > 0 的账户按 §4.1 建期初桶，快照按服务费率 0、税率 0（闭环清单 C01，D-05-53）
- **R-05-006** 消耗从分桶里先进先出扣：按入账时间从早到晚，先扣满最早一桶再扣下一桶；入账时间相同按入账先后（D-05-07）；只扣预付款结算期的消耗（R-05-001），后付款期间分桶不被消耗扣，改回预付款后剩余分桶恢复按本条先进先出扣（D-00-73）；预付改后付生效后，切换前最后一个预付月在出账判结清或欠费冻结之前，分桶照常按本条覆盖该月消耗（含期间补报的消耗；释放的锁定分桶、新到账的充值同样参与），欠费冻结之后的该月消耗以及生效月起的消耗不再被分桶覆盖（R-05-118①、D-05-50）
- **R-05-007** 退款、余额分配取出在提交审批时，06 后付结算单的余额抵扣在结算单提交时（D-00-73），按先进先出从「未锁定且尚有剩余」的分桶里锁定对应金额（D-05-06）：锁定部分不再被消耗占用，也不参与 06 预付账单的覆盖判定（D-00-11）；审批驳回、撤回或作废时释放；审批通过时从这些分桶里正式扣减（退款审批通过即扣，不等 09 确认汇出），扣减位置固定，之后消耗修正也不改它
- **R-05-008** 锁定金额 = 该账户所有审批中的退款单、余额分配单与后付结算单余额抵扣锁定的合计；可用余额 = 账户余额 − 锁定金额；退款余额、取出余额的上限都是可用余额（D-00-52、D-00-54）
- **R-05-009** 余额可以为负，为负即欠费（D-05-12）：消耗超出全部未锁定分桶的部分不属于任何分桶；之后新入账的分桶按先进先出先被这部分消耗占用。消耗修正导致余额变负时，不回退已完成的退款、余额分配。某日消耗是否已被分桶覆盖 = 本条与 R-05-006 先进先出的结果（锁定中的分桶不参与），06 据此逐张判断预付账单是否结清（D-00-11）；预付改后付后按 R-06-074 冻结欠费时，不属于任何分桶的那部分消耗按 R-05-118② 从余额计算中剔除
- **R-05-118** 计费模式切换对余额的影响（D-00-73）：客户计费模式变更从确定时刻的次月 1 日（UTC0）生效（R-04-066）。预付改后付生效后：①该客户各账户未锁定的剩余分桶保留，生效月起的消耗不再扣它（R-05-006），账户余额照常显示（R-05-003）；切换前最后一个预付月在出账判结清或欠费冻结之前，分桶照常按先进先出覆盖该月消耗，包括期间补报的消耗、释放的锁定分桶、新到账的充值，欠费冻结之后不再覆盖（D-05-50）；06 生成后付结算单时按 R-06-076 自动带出「余额抵扣」（每账户上限为剩余应收，按先进先出取分桶，按 R-05-027 换算；余额抵扣金额以剩余应收为准，最后一桶本金 P = round2(所需金额 ÷ 该桶倍率)、不超过该桶剩余，倍率 = 1 + 税率 + 服务费率 + 服务费率 × 税率（公司承担时不加末项，R-05-021），税费、服务费、服务费税费按 R-05-027 正算，与所需金额的尾差计入该账户行余额抵扣的服务费，同 R-05-022；D-05-47④）；结算单提交时锁定所取分桶（R-05-007），审批通过时扣减，「余额抵扣账单」交易明细由 06 结算单审批通过时调用 05 写入（R-05-095），驳回、撤回、作废时释放；抵不完的留到下一张后付账单。②按 R-06-074 冻结欠费时，该账户该月不属于任何分桶的那部分消耗从余额计算中剔除，之后入账的分桶不再被它占用，这部分改由后付账单收取（D-05-47）；冻结的欠费在该客户下一张后付账单生成时挂上（R-06-074），挂上前客户又改回预付款的，解除冻结，欠费退回余额（这部分消耗重新计入余额，按 R-05-009 由分桶先进先出覆盖），原账单由 06 重新按 R-06-022 判结清；已冻结转入后付账单、或已结算冻结的切换前预付结算期，之后的消耗修正不再进入余额，也不再参与分桶覆盖，线下处理（§5 已知限制）（D-05-50）。③生效时仍在审批中的退款、余额分配照常走完，驳回、撤回释放的分桶按①保留；仍在途的账户充值照常走完，到账后成桶按①保留，后付款额度不因充值清零（R-05-012，D-05-47）；生效时仍在审批中的 07 预付返点余额抵扣，通过后按提交时的快照成桶（服务费率 0、税率 0），之后按①保留（D-05-50）。④改回预付款生效后，剩余分桶恢复按先进先出被消耗扣，可照常充值、退款、余额分配。⑤授信额度：切换生效时额度值、有效期、来源审批单原样保留；预付期设的有效期照常到期清零（R-05-011）；后付期不新设有效期（R-05-062）；跨切换生效才通过的额度调整，按通过那一刻客户当前结算期的计费模式写入，是后付款就丢弃有效期、只写额度，通过时为后付、有效期被丢弃的，不做 R-05-082 的有效期校验；改回预付款后按 R-05-011 判断「额度生效之后才提交的充值」时，额度生效时刻仍取写入该额度的原审批通过时刻（D-05-51）

#### 2.1.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 历史消耗被修正 | 某天消耗变大或变小 | 余额重算，分桶占用重排；已扣减的退款 / 取出位置不动（R-05-001、R-05-007） | 余额数字变化，无新交易明细 |
| 消耗超过全部分桶 | 余额为负 | 超出部分不属于任何分桶，后入账先填它（R-05-009） | 余额标红负数 |
| 退款审批中又发生消耗 | 锁定部分不被消耗 | 消耗只占未锁定分桶，可用余额照常减少（R-05-007） | 可用余额继续下降，可能变负 |
| 驳回 / 撤回 / 作废 | — | 释放锁定（R-05-083）；账户停投且释放后可用资金 > 0 时通知人工恢复 | 可用余额回升；投放状态不自动恢复 |
| 预付改后付生效 | 客户进入后付款结算期 | 剩余分桶保留、生效月起的消耗不扣它，用于后付结算单余额抵扣；切换前最后一个预付月出账判结清或冻结前仍被分桶覆盖；按 R-06-074 冻结时不属于任何分桶的消耗从余额计算中剔除（R-05-118①②） | 有剩余分桶的账户照常显示余额 |
| 欠费冻结后、挂上后付账单前改回预付 | 冻结解除 | 欠费退回余额，原账单由 06 重新按 R-06-022 判结清（R-05-118②） | 账户余额重新出现负数 |
| 切换前月份冻结或已结算后又有消耗修正 | — | 不进入余额、不参与分桶覆盖，线下处理（R-05-001、R-05-118②） | 余额不变 |
| 后付结算单余额抵扣审批中 | 分桶被锁定 | 计入锁定金额（R-05-008） | 可用余额减少 |
| 存量账户期初余额 ≤ 0 | — | 不建期初桶，余额从 0 起，负数部分出清单交财务线下追收（§4.1） | 余额从 0 起算 |

#### 2.1.6 验收标准

- **G-05-001** 前置：公共前置；账户 A 分桶 ①2026-09-15 到账 3,000.00（第 4 天提交，快照 服务费 8.00%、税率 6.00%、客户承担）②2026-10-14 提交、2026-10-16 到账 12,000.00（第 33 天，落第 2 行第 2 档，快照 3.00%、6.00%、客户承担）；截至 2026-10-18 累计消耗 2,000.00 USD。操作：打开费用管理看账户 A。期望：账户余额 13,000.00 USD；分桶①剩 1,000.00、②剩 12,000.00（技术自测核对，页面不展示分桶）。
- **G-05-002** 前置：G-05-001 的数据。操作：2026-10-21 消耗数据修正：10-18 的消耗由 300.00 改为 800.00。期望：账户 A 余额自动变为 12,500.00 USD，不产生任何交易明细；分桶①剩 500.00、②仍 12,000.00。
- **G-05-003** 前置：G-05-001 的数据；王敏为 A 提交退款 4,000.00 USD 审批中。操作：查看 A 的可用余额；再打开余额分配看取出列表。期望：锁定 4,000.00（分桶①1,000.00 + 分桶②3,000.00）；可用余额 9,000.00；余额分配取出列表 A 的可用余额显示 9,000.00 USD。
- **G-05-004** 前置：预付账户 A 余额 -500.00 USD（欠费）。操作：一笔 2,000.00 的账户充值到账。期望：余额变为 1,500.00；新分桶先被那 500.00 的超出消耗占用、剩 1,500.00。
- **G-05-062** 前置：G-05-003 的数据（A 退款 4,000.00 审批中）。操作：王敏看费用信息列表 A 行，悬浮账户余额。期望：账户余额仍显示 13,000.00 USD；悬浮「其中锁定 4,000.00、可用 9,000.00 USD」。
- **G-05-072** 前置：星海 2026-10-25 提交预付改后付，2026-11-03 审批通过；A 当时只剩分桶②5,000.00（快照 3.00% / 6.00% / 客户承担），没有在途单。操作：11 月查看列表；2026-12-01（UTC0）起再看；12 月 A 消耗 8,000.00；2027-01-02 出账后 12 月账单 A 行可结算应收 8,000.00，生成结算单并审批通过。期望：11 月计费模式显示「预付款（2026-12-01 起改为后付款）」，操作列仍有充值、退款、余额分配；12-01 起显示「后付款」，没有充值、退款、余额分配，A 账户余额仍显示 5,000.00 USD，12 月消耗不扣它；结算单 A 行自动带出余额抵扣 5,459.00（5,000.00 + 税费 300.00 + 服务费 150.00 + 服务费税费 9.00），提交时 A 锁定 5,000.00，通过后 A 余额为 0、列表显示「-」，交易明细新增「余额抵扣账单·已完成」，充值金额 -5,000.00 USD。
- **G-05-073** 前置：星海账户 B 余额 -2,000.00（10 月消耗中 2,000.00 没被分桶覆盖，10 月账单待结算，11 月 B 无消耗）；预付改后付 2026-12-01 生效；之后又改回预付款，2027-02-01 生效。操作：12-01 起看 B；2027-02 起 B 一笔 1,000.00 账户充值到账。期望：12-01 起 B 的欠费按 D-00-73 转入第一张后付账单（06 核对），B 账户余额不再显示负数（显示「-」）；改回预付后 1,000.00 到账，B 余额 1,000.00，不被那 2,000.00 先占用。

### 2.2 授信额度、停投与提醒（定义）

#### 2.2.1 功能描述

额度是兜底：预付款余额花完后还能用额度投；额度也用完就停投。后付款没有余额，额度是「未结清消耗」的上限。每天根据前一天消耗估算还能撑几天，快用完提前提醒。

#### 2.2.2 核心字段

账户额度（account_credit）：

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 额度 | credit | decimal(2)，账户消耗币种 | 是 | ≥ 0，不设上限 | 0 | 0 = 无额度（R-05-064） |
| 额度有效期 | expire_date | date（UTC0） | 否 | ≥ 今天 | 空 = 长期 | 仅预付款期间设置（R-05-011、R-05-118⑤） |
| 额度状态 | state | enum | 是 | 生效中 / 已到期 / 充值清零 / 已替换 | 生效中 | 系统流转，见 2.2.4 |
| 来源审批单 | source_approval_id | 关联审批单 | 是 | 系统写入 | — | R-05-082 |

#### 2.2.3 业务规则

- **R-05-010** 每个账户最多一条当前生效额度，额度只能通过「额度调整」审批写入（R-05-082）；没有额度或额度为 0 = 没有授信额度。账户上原有的「授信额度」老字段保留不用（D-02-02），存量老额度按 §4.2 导入（D-05-53）
- **R-05-011** 预付款账户的额度有效期为空 = 长期有效；有效期到期（UTC0 有效期当天 23:59:59 之后）额度自动清零（预付期设的有效期，切换为后付款后照常到期清零，R-05-118⑤）；「账户充值」到账时，只有该充值单是在当前额度生效之后才提交的、且到账后该账户可用余额 > 0，额度才清零，否则额度保留，直到之后有一笔满足条件的充值到账或有效期到期（D-00-53）。余额分配转入、返点余额抵扣、账单结转不清零额度（D-05-20）；改回预付款后，「在当前额度生效之后才提交」中的额度生效时刻仍取写入该额度的原审批通过时刻（R-05-118⑤）
- **R-05-012** 后付款期间不新设额度有效期（R-05-062），额度不因充值清零；没有有效期的额度不会自动清零，预付期设的有效期切换为后付款后照常到期清零（R-05-118⑤）
- **R-05-013** 剩余额度：预付款 = max(0, 额度 + min(可用余额, 0))，即余额为正时等于额度，欠费后按欠费额递减；后付款 = max(0, 额度 − 未结清消耗)，不显示负数。未结清消耗按账户算、只算原始消耗（不含服务费、税费、服务费税费，不扣返点，不看结算单改过的应付）= 该账户在流转计费模式为后付款（R-06-012，即该结算期的计费模式，D-00-73）且尚未「已结算」的账单里的消耗，加上该账户尚未出账、且所属结算期计费模式为后付款的日子的消耗（含出账日前的上月日子）；切换前最后一个预付月在出账前由分桶覆盖（R-05-118①），不计入后付未结清消耗；承接了「上期预付欠费」（D-00-73②）的后付账单，其中欠费的消耗部分同样计入，直到该账单已结算；账单状态按 06（D-00-59、D-05-17）
- **R-05-014** 停投条件（D-05-12）：预付款账户 可用余额 + 额度 ≤ 0；后付款账户 额度 > 0 且剩余额度 ≤ 0（未结清消耗按 R-05-013 的原始消耗）；后付款账户额度为 0 视为不限制、不因额度停投（D-05-24）；不另扣其他未到款项。判断时机：锁定与释放（退款、余额分配、后付结算单余额抵扣的提交、驳回、撤回、作废）、到账、额度写入与到期、消耗数据更新时即时判断，另有定时兜底（D-05-46）。满足条件时触发停投，停投执行动作沿用后端现有逻辑；条件不再满足时不自动恢复投放，由人工恢复（D-05-46，通知见 R-05-083）。停投不直接改客户状态，客户状态按 D-00-07 由消耗判定
- **R-05-015** 触发停投时通知该客户的销售和该账户的优化师（D-05-18），通知渠道按 12（R-12-039），文案见 notifications「停投通知」；同一账户一次停投只通知一次
- **R-05-016** 可用天数提醒：每个 UTC0 自然日拿到前一天消耗后计算一次 可用天数 = 可用资金 ÷ 昨日消耗（预付款可用资金 = 可用余额 + 额度；后付款只算额度 > 0 的账户，可用资金 = 剩余额度）；可用天数首次 < 7 时提醒一次，首次 < 3 时再提醒一次，同一天同时跨过两条线只发「不足 3 天」；可用天数回到 ≥ 7（或 ≥ 3）后对应那条线重新计数；昨日消耗为 0 或已停投不提醒（D-05-18）。收件人、渠道同 R-05-015，文案见 notifications「可用天数提醒」

#### 2.2.4 状态与流转

本页**定义**额度的状态，全部由系统推动：

| 当前状态 | 触发动作 | 操作者 | 目标状态 | 前置条件 |
| --- | --- | --- | --- | --- |
| 无 | 额度调整审批通过 | 系统 | 生效中 | R-05-082 |
| 生效中 | 有效期当天 UTC0 23:59:59 过后 | 系统 | 已到期 | 预付期设的有效期，切换后付后照常（R-05-011、R-05-118⑤） |
| 生效中 | 该账户一笔账户充值到账 | 系统 | 充值清零 | 仅预付款；该充值单在额度生效后提交，且到账后可用余额 > 0（R-05-011） |
| 生效中 | 新的额度调整审批通过 | 系统 | 已替换 | R-05-082 |

逆向：额度调整被驳回 / 撤回时不改动额度（R-05-083）；本期没有手工作废额度，要取消就提交额度 0。

#### 2.2.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 昨日消耗为 0 | 可用天数无穷大 | 不提醒（R-05-016） | — |
| 同一天跨过 7 天和 3 天 | — | 只发「不足 3 天」（R-05-016） | 一条提醒 |
| 停投后又充值 / 调额度 / 释放锁定 | 条件不再满足 | 不自动恢复投放，靠人工；释放锁定时通知（R-05-083、D-05-46） | 投放状态仍为暂停 |
| 后付未结清消耗超过额度 | 公式为负 | 剩余额度取 0（R-05-013），按 R-05-014 停投 | 剩余额度 0.00 |
| 欠费时到账一笔不够补齐的充值 | 到账后可用余额仍 ≤ 0 | 额度保留（R-05-011） | 授信额度不变 |
| 后付款额度为 0 | — | 不因额度停投（R-05-014、D-05-24） | 剩余额度显示 0.00 |
| 销售或优化师为空 / 账号禁用 | 收件人缺失 | 只发给有的那位；都没有则不发，记日志 | — |

#### 2.2.6 验收标准

- **G-05-005** 前置：账户 A 余额 13,000.00，当前生效额度 5,000.00、有效期 2026-10-31。操作：查看列表；到 2026-11-01 UTC0 再看。期望：10 月内授信额度 5,000.00 USD、剩余额度 5,000.00 USD；2026-11-01 起授信额度 0.00 USD、剩余额度 0.00 USD。
- **G-05-006** 前置：账户 A 当前生效额度 5,000.00（2026-10-01 生效，长期），余额 -1,200.00。操作：查看列表；然后一笔 2026-10-05 提交的账户充值 3,000.00 到账；另一种情况改为余额分配转入 3,000.00。期望：欠费时剩余额度 3,800.00 USD；账户充值到账后可用余额 1,800.00 > 0，授信额度变 0.00、余额 1,800.00；余额分配转入时额度仍为 5,000.00。
- **G-05-007** 前置：账户 A 可用余额 -4,800.00、额度 5,000.00；第二天消耗 300.00。操作：当天消耗数据更新后系统即时判断。期望：可用余额 + 额度 = -100.00 ≤ 0 → A 停投；张伟（销售）和 周宁（优化师）各收到一条停投通知；同一次停投不重复通知。
- **G-05-008** 前置：后付客户「橙子出行科技有限公司」账户「橙子-iOS-CN」（人民币）额度 100,000.00；9 月账单待结算，其中消耗 60,000.00（加上服务费、税费后 63,600.00）；10 月截至目前未出账消耗 38,000.00。操作：查看列表。期望：账户余额「-」；授信额度 100,000.00 人民币；剩余额度 2,000.00 人民币（只算原始消耗，不算服务费、税费）；操作列只有 费用明细、调整额度、提成规则配置。
- **G-05-009** 前置：同一后付客户另一个账户额度 0.00，未结清消耗 80,000.00。操作：系统按日计算。期望：不因额度停投，不发停投通知。
- **G-05-010** 前置：账户 A 可用资金（可用余额 + 额度）3,000.00，昨日消耗 500.00；次日可用资金 2,400.00、昨日消耗 600.00；再次日 1,500.00、昨日消耗 600.00。操作：连续三天系统计算。期望：第 1 天可用 6 天 → 发「不足 7 天」提醒；第 2 天 4 天 → 不发；第 3 天 2.5 天 → 发「不足 3 天」提醒；收件人张伟、周宁。
- **G-05-063** 前置：后付账户「橙子-iOS-CN」额度 100,000.00，9 月账单已结算；今天 2026-11-01（UTC0），10 月账单还没出账，10 月消耗 38,000.00，11-01 已有消耗 1,000.00；同客户账户「橙子-Android-CN」额度 50,000.00、未出账消耗 98,000.00。操作：查看列表。期望：橙子-iOS-CN 剩余额度 61,000.00 人民币（38,000.00 与 1,000.00 都计入）；橙子-Android-CN 剩余额度显示 0.00 人民币（不显示负数），并按 R-05-014 停投。另一情况——前置：星海预付改后付 2026-12-01（UTC0）生效；A 额度 20,000.00 USD（长期）；A 在 11-01 前只有一个未锁定分桶 6,000.00、没有在途单，11 月消耗 5,000.00，11 月账单尚未出账；今天 2026-12-01，12-01 已有消耗 1,000.00。操作：查看列表。期望：A 剩余额度 19,000.00 USD（只计 12-01 的 1,000.00；11 月是切换前最后一个预付月，出账前由分桶覆盖，不计入后付未结清消耗）；A 账户余额显示 1,000.00 USD（11 月消耗照常按先进先出扣分桶，R-05-118①）；不停投。
- **G-05-065** 前置：G-05-001 的数据（A 可用余额 13,000.00，没有额度），期间无新消耗。操作：王敏打开充值退款点「全部」后提交审批；确认后审批人驳回。期望：确认框加一句「提交后 星海-iOS-US 可用资金将 ≤ 0，账户会立即停投；审批驳回或撤回后不会自动恢复投放，需人工恢复。」；建单后 A 锁定 13,000.00、立即停投，张伟、周宁收到停投通知；驳回后 A 可用余额恢复为 13,000.00，投放状态仍为暂停，张伟、周宁收到「星海网络科技有限公司-星海-iOS-US 的充值退款单已驳回，可用资金恢复为 13,000.00 USD，可人工恢复投放。」。
- **G-05-070** 前置：A 额度 5,000.00（2026-10-10 生效，长期），可用余额 -3,000.00；有一张 2026-10-08 提交的账户充值 500.00 和一张 2026-10-12 提交的 1,000.00；期间无新消耗。操作：2026-10-14 两张先后到账；2026-10-16 再提交一笔 3,000.00，10-18 到账。期望：10-08 那张到账：早于额度生效提交，额度保留；10-12 那张到账：可用余额 -1,500.00 仍 ≤ 0，额度保留 5,000.00，剩余额度 3,500.00，不停投；10-18 到账后可用余额 1,500.00 > 0，额度清零。

### 2.3 计费口径（充值 / 退款 / 余额分配共用）

#### 2.3.1 功能描述

钱怎么算：用哪天的哪条规则、哪一行、哪一档；已知净额正算、已知含费金额反算；四舍五入和尾差；账户币种转结算币种；退款 / 取出按分桶倒推；提交时全部锁定。弹窗只负责展示和收集，计算一律按本节。

公式（每个账户一行）：

- 正算：税费 = B × 税率，服务费 = B × 服务费率，服务费税费 = B × 服务费率 × 税率（公司承担时为 0），应收 = B + 三项。
- 反算：B = Y ÷（1 + 税率 + 服务费率 + 服务费率 × 税率），公司承担时分母不含最后一项。
- 例（G-05-012）：A 第 38 天落第 2 行，应收 11,000.00；试高档 3.00%：B = 11,000.00 ÷ 1.0918 = 10,075.11 ≥ 10,000.00 成立；低档也成立，取高档。税费 604.51、服务费 302.25、服务费税费 18.14，合计 11,000.01，尾差 -0.01 计入服务费 → 302.24。

#### 2.3.3 业务规则

- **R-05-017** 取哪条规则：账户通过所绑登记表（02 registration_id）取 03 的规则，用「提交当天（UTC0）」的适用规则（R-03-003）。没有适用规则（账户没绑在线登记表，或提交当天早于第一条规则起始日期）时，服务费率、税率一律按 0 计算，该行税费、服务费、服务费税费均为 0.00，应收 / 实际金额 = 充值金额 / 充值余额；照常可提交，页面不另加提示（D-00-57、D-05-38）
- **R-05-018** 服务费取哪一行时间区间：按提交当天是该账户消耗首日后的第几天，用 R-03-006 落行；账户还没有消耗首日时用第一行（D-00-58）
- **R-05-019** 正算落档（已知充值金额 / 充值余额 B）：在该行服务费率里，固定比例直接用；阶梯比例用本次这一笔、这一个账户的 B 按 R-03-009 落档（左闭右开，不累进），「按月 / 按日统计」不作用于此（D-00-51）
- **R-05-020** 反算落档（已知应收金额，或余额分配转入的实际金额 Y）：从最高档往最低档逐档试，按该档费率算 B = Y ÷（1 + 税率 + 服务费率 + 服务费率 × 税率）（公司承担服务费税费时不加最后一项），B 按 R-05-022 先舍入，落在该档 [下限, 上限) 内即用该档；高档、低档都成立时取高档（D-00-51，按到账净额判档，原「按应付判档」作废）；没有一档成立时该行标红、不能提交，提示「该金额无法对应服务费阶梯，可填小于 {甲} 或不小于 {乙}」（D-05-15）：甲 = 低档能成立的最大应收 + 0.01，乙 = 高档能成立的最小应收，由服务端试算接口按分求出返回，前端只展示（会议清单 D04）
- **R-05-021** 金额拆分（每个账户一行）：税费 = B × 税率；服务费 = B × 服务费率；服务费税费 = B × 服务费率 × 税率（客户承担），公司承担时为 0（R-03-028）；应收 / 实际金额 = B + 税费 + 服务费 + 服务费税费
- **R-05-022** 舍入：B、税费、服务费、服务费税费各自四舍五入到 2 位小数（D-00-13）；正算时应收 = 四项舍入后相加。反算时 B 先舍入，再按 R-05-021 算三项并舍入，四项之和与输入的 Y 差出的尾差全部计入服务费，Y 以输入为准；服务费率为 0 的行也照此计入，可能出现 ±0.01 的服务费（D-05-19）
- **R-05-023** 所有金额输入框只接受数字和一个小数点：负号、字母输不进去，小数第 3 位按不下去；粘贴或自动填充的非法内容不写入，保留原值，并就地标红「请输入不小于 0、最多 2 位小数的金额」；任何情况下都不静默四舍五入或截断。其他校验（超过可用余额、反算无解等）一律在对应框就地标红（D-00-82）
- **R-05-024** 结算币种（充值、退款弹窗）：必选，下拉单选 人民币 / USD / USDT，默认取客户的币种，客户币种为空时没有默认值（R-04-011）；客户币种修改后立即生效，只影响之后新打开的弹窗默认值。与账户消耗币种相同时汇率为 1，不显示汇率；不同时显示「汇率：1 {账户币种} = x {结算币种}（yyyy-mm-dd）」：x = 提交当天（UTC0）的日汇率四舍五入到 4 位小数，显示与计算都用这 4 位；当天没有向前取最近一天，日期显示实际取到的那一天；汇率与汇率日期随单进快照（D-00-74、D-00-62、D-05-10、D-05-16）
- **R-05-025** 结算币种总额 = 账户币种总额 × 4 位汇率（R-05-024），四舍五入到 2 位小数；取不到任何汇率时不能提交，提示「未取到 {账户币种}→{结算币种} 汇率，请稍后再试」
- **R-05-026** 账户充值、余额分配转入侧：弹窗打开时按当天规则与汇率实时计算展示，提交时服务端按提交时刻重新计算。规则、落行、落档变化导致结果与页面展示不同时，不创建审批单、弹窗不关，按最新数据就地重载：用户输入的金额、结算币种、付款主体、凭证、备注保留；值没变的行原样保留；值变了的计算格标黄「系统计算值已由 X 变为 Y」；顶部提示「数据已更新，请核对后重新提交」，用户再点一次提交才建单。只有汇率不同时先不建单，弹确认框「汇率已更新为 1 {账户币种} = x {结算币种}（yyyy-mm-dd），换算后金额 Y，是否按新汇率提交？」，确定后按新汇率建单（D-05-48）。退款与余额分配取出侧按 R-05-114
- **R-05-027** 退款、取出按分桶倒推（D-00-52、D-00-54）：按 R-05-007 先进先出锁定的每个分桶部分 P，用该分桶的费率快照算 P × 税率、P × 服务费率、P × 服务费率 × 税率；一个账户内各分桶的同类金额先相加再四舍五入到 2 位；应退金额 / 实际金额 = 退款余额 / 取出余额 + 税费 + 服务费 + 服务费税费。前端只展示账户合计，不展示分桶；这里与 06 按段 / 按天舍入不同是有意的，因为分桶不展示（D-00-13）。提交前的服务端预算与回显见 R-05-114
- **R-05-028** 客户的「币种」字段由 04 维护（R-04-002），本页只读取作结算币种默认值；改了客户币种不影响已提交的单
- **R-05-029** 提交的那一刻锁定全部计算结果：适用规则与起始日期、服务费行、落档、费率、税费、服务费、服务费税费、充值金额 / 充值余额、汇率（4 位）与汇率日期、结算币种总额都写进审批单业务单据快照；之后不论规则、汇率、消耗首日怎么变，到账时都按快照执行，不重算（D-05-14、D-00-58）
- **R-05-113** 试算时机与状态：金额输入框失焦或回车时触发试算（由服务端计算）；试算期间该行计算列显示「计算中」，「提交审批」置灰；试算失败时该行标红「试算失败，请重试」并清空旧结果；焦点还在输入框里就直接点「提交审批」的，先跑完这次试算再走校验，这次点击不作废（会议清单 D34）

#### 2.3.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 账户没有适用规则 | 没绑在线登记表 / 早于首条规则 | 按 0 费率计算、0 快照入桶（R-05-017、R-05-005） | 税费、服务费为 0.00，无提示 |
| 账户还没有消耗首日 | 相对区间不对应日期 | 用第一行（R-05-018） | 正常计算 |
| 反算哪档都不成立 | 高档费率更贵时的缝隙 | 标红、不能提交（R-05-020） | 「可填小于甲或不小于乙」 |
| 弹窗跨零点 / 期间规则生效 | 提交时结果不同 | 不建单、弹窗不关，就地重载并标黄（R-05-026） | 「数据已更新，请核对后重新提交」 |
| 只有汇率更新 | 提交时汇率不同 | 先不建单，确认后按新汇率建单（R-05-026） | 「汇率已更新为…是否按新汇率提交？」 |
| 试算失败 | — | 该行标红、清空旧结果（R-05-113） | 「试算失败，请重试」 |
| 粘贴非法金额 | — | 不写入、保留原值（R-05-023） | 就地标红 |
| 取不到汇率 | 日汇率表没有任何数据 | 不能提交（R-05-025） | 「未取到…汇率」 |
| 客户币种为空 | 没有默认结算币种 | 必须手选（R-05-024） | 「请选择结算币种」 |

#### 2.3.6 验收标准

公共前置：预付款客户「星海网络科技有限公司」（客户别名 星海，币种 人民币，销售 张伟，付款主体 Starfish Ltd、星海网络科技有限公司）；账户 A「星海-iOS-US」（orgid 4521873，消耗币种 USD，优化师 周宁）绑定登记表的规则：起始 2026-10-01（另有 2026-09-01 起同内容的旧规则），相对日期，第 1 行「消耗首日 - 第30天」固定 8.00%，第 2 行「第31天 - 永久」阶梯 [0, 10,000.00) 5.00%、[10,000.00, 不限) 3.00%，税率 6.00%，服务费税费 客户承担，消耗首日 2026-09-12；账户 B「星海-iOS-JP」（orgid 4521906，消耗币种 USD）规则固定 4.00%、税率 6.00%、公司承担；今天 2026-10-19（UTC0，A 第 38 天）；当日日汇率 1 USD = 7.1234 人民币；各用例操作人都有「费用管理（查看）」；操作人 王敏 有「账户费用管理」「提成规则管理」「客户管理-读写」，能看 A、B

- **G-05-011** 前置：公共前置。操作：王敏打开星海网络科技有限公司的账户充值，A 填充值金额 8,000.00、B 填 5,000.00。期望：A：税费 480.00、服务费 400.00、服务费税费 24.00、应收 8,904.00；B：税费 300.00、服务费 200.00、服务费税费 0.00、应收 5,500.00；应收金额总计 14,404.00 USD；汇率显示「汇率：1 USD = 7.1234 人民币（2026-10-19）」；应收金额总计（结算币种）102,605.45 人民币；A 行服务费悬浮「服务费率 5.00%（第 2 行，[0.00, 10,000.00)）/ 税率 6.00% / 服务费税费客户承担」。
- **G-05-012** 前置：公共前置。操作：账户充值切到应收金额计算，A 填应收 11,000.00。期望：高档、低档都成立，取高档 3.00%：充值金额 10,075.11、税费 604.51、服务费 302.24（含 -0.01 尾差）、服务费税费 18.14，四项相加 11,000.00。
- **G-05-013** 前置：账户 B 的当前生效规则改为阶梯 [0, 10,000.00) 5.00%、[10,000.00, 不限) 10.00%，税率 0，公司承担。操作：应收金额计算，B 填 10,800.00；再改为 10,400.00。期望：填 10,800.00 时该行标红「该金额无法对应服务费阶梯，可填小于 10,500.00 或不小于 11,000.00」，不能提交；改 10,400.00 后落第一档，充值金额 9,904.76。
- **G-05-014** 前置：客户下另有账户「星海-iPad-US」（orgid 4522017，USD），没绑在线登记表。操作：账户充值给它填 1,000.00 并提交；审批通过、确认收款后再给它退款 1,000.00。期望：充值行税费、服务费、服务费税费都是 0.00，应收 1,000.00，没有任何提示，可正常提交；审批内容区该行规则起始日期「-」、服务费率与税率 0.00%；到账后分桶快照为 0 费率，退款时应退金额 = 1,000.00。
- **G-05-015** 前置：公共前置（A 消耗首日 2026-09-12）。操作：2026-10-11（第 30 天）给 A 提交充值 1,000.00；审批 2026-10-13 通过、2026-10-15 确认收款。期望：提交时落第 1 行固定 8.00%：服务费 80.00、税费 60.00、服务费税费 4.80、应收 1,144.80，随单锁定；到账时按快照 8.00% 入桶，不按到账日（第 34 天）的第 2 行重算。
- **G-05-016** 前置：王敏在 2026-10-19 23:59（UTC0）打开账户充值，A 填充值金额 8,000.00、B 填 5,000.00；2026-10-20 起 A 有一条新规则生效，第 2 行改为固定 4.00%（其余不变）；10-20 与 10-19 的日汇率相同。操作：2026-10-20 00:01（UTC0）点提交审批并确定。期望：不创建审批单，弹窗不关；A 填的 8,000.00 保留，A 行服务费标黄「系统计算值已由 400.00 变为 320.00」、服务费税费标黄（24.00 → 19.20）、应收金额标黄（8,904.00 → 8,819.20）；B 行原样；顶部提示「数据已更新，请核对后重新提交」；再点提交审批才建单。
- **G-05-017** 前置：任一金额输入框，当前值 100.00。操作：清空后依次键入「-」、字母「a」、「12.345」；再粘贴「12.345」、粘贴「abc」；最后改填 0。期望：「-」和字母输不进去，键入到 12.34 后第 3 位小数按不下去；两次粘贴都不写入，框内保留 12.34 并标红「请输入不小于 0、最多 2 位小数的金额」，金额从不被静默四舍五入或截断；填 0 不报错，视为该行不参与。
- **G-05-061** 前置：同 G-05-013 的 B 规则（阶梯 [0, 10,000.00) 5.00%、[10,000.00, 不限) 10.00%，税率 0，公司承担）。操作：应收金额计算，B 依次填 10,499.99、10,999.99、11,000.00。期望：10,499.99：落第一档，充值金额 9,999.99、服务费 500.00；10,999.99：标红「该金额无法对应服务费阶梯，可填小于 10,500.00 或不小于 11,000.00」，应收金额总计显示「—（有错误行，暂不计算）」；11,000.00：落第二档，充值金额 10,000.00、服务费 1,000.00。
- **G-05-071** 前置：账户 B 的规则改为固定 0.00%、税率 6.00%、客户承担。操作：应收金额计算，B 填 1,000.20。期望：充值金额 943.58、税费 56.61、服务费 0.01（尾差计入服务费）、服务费税费 0.00，四项相加 1,000.20。
- **G-05-082** 前置：公共前置。操作：账户充值 A 输入 8,000.00 后不移开焦点，直接点「提交审批」；另一次让试算接口返回失败。期望：先试算：A 行计算列显示「计算中」、「提交审批」置灰，试算完成后接着校验并弹确认框，这次点击不作废；试算失败时 A 行标红「试算失败，请重试」、计算列清空，不弹确认框。

### 2.4 费用信息列表

#### 2.4.1 功能描述

费用管理页默认 tab。一个客户一条，客户下嵌其账户；看余额、额度、消耗，从这里发起 5 类操作和进费用明细。

#### 2.4.2 核心字段

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 公司名称 | 04 company_name | string | — | — | — | 超长省略，悬浮全称 |
| 所属账户系统 | 账户系统 | string | — | — | — | 沿用 |
| 计费模式 | 04 billing_mode | enum | — | 预付款 / 后付款 | — | 04 |
| 客户别名 / 销售 | 04 company_alias / sales_user_id | string | — | — | — | 04 |
| 账户名称 | 02 account_name | string | — | — | — | — |
| 授信额度 | account_credit.credit | decimal(2)，账户消耗币种 | — | — | 0.00 | R-05-033 |
| 剩余额度 | credit_remaining | decimal(2)，账户消耗币种 | — | — | — | R-05-013 |
| 账户余额 | balance | decimal(2)，账户消耗币种 | — | 后付款「-」 | — | R-05-033 |
| 投放类型 | 02 delivery_type | enum | — | 自投 / 代投 | — | R-05-034 |
| 投放状态 | 现有字段 | enum | — | 开启 / 暂停 | — | R-05-034 |
| 昨日 / 今日 / 本月消耗、累计花费 | 消耗数据 | decimal(2)，账户消耗币种 | — | — | — | UTC0（R-05-033） |

#### 2.4.3 业务规则

- **R-05-030** 费用管理页顶部「费用信息 / 已提交审批」两个切换，默认费用信息；页面标题「费用管理」
- **R-05-031** 搜索框按公司名称或账户名称包含匹配，命中账户名称时展示该客户及其下全部可见账户；「所属账户系统」下拉默认全部，选项为现有账户系统列表；「计费模式」下拉 全部 / 预付款 / 后付款，默认全部；「导出」本期不做，不显示
- **R-05-032** 列表一个客户一条：客户级列 公司名称（超长省略，悬浮显示全称）、所属账户系统、计费模式、客户别名、销售；客户下按行列账户：账户名称、授信额度、剩余额度、账户余额、投放类型、投放状态、昨日消耗、今日消耗、本月消耗、累计花费；右侧客户级操作列。「计费模式」显示当前结算期的计费模式，有待生效的计费模式变更时显示为「{当前生效值}（{yyyy-mm-dd} 起改为{目标值}）」，同 R-04-067，如「预付款（2026-12-01 起改为后付款）」；「销售」为已禁用账号时显示「姓名（已禁用）」（D-00-83）；「计费模式」筛选按当前结算期的计费模式（D-00-73）
- **R-05-033** 账户级金额列一律账户消耗币种、千分位、2 位小数、后缀币种代码（如「12,000.00 USD」，人民币显示「人民币」，D-00-08）：授信额度 = 当前生效额度（R-05-010），没有为「0.00」；剩余额度按 R-05-013；账户余额按 R-05-001，后付款账户按 R-05-003（有剩余分桶时显示余额，否则「-」），负数前加「-」并标红；锁定金额 > 0 时账户余额悬浮「其中锁定 {x}、可用 {y} {币种}」；昨日 / 今日 / 本月消耗按 UTC0 自然日 / 自然月，累计花费 = 该账户全部历史消耗，消耗数据来源沿用现有
- **R-05-034** 投放类型显示 自投 / 代投（02 delivery_type）；投放状态 开启 / 暂停，沿用现有账户投放状态
- **R-05-035** 数据权限跟账户查看权限走：用户对某客户下任一账户有查看权限才展示该客户，且只展示他有权限的账户；一个账户都没权限的客户、名下没有账户的客户都不出现（费用管理.html:4848 §3.1.3）；本页按账户查看权限过滤，不另按 D-00-77 的客户范围过滤；客户销售对其名下账户的查看权限按 02 的销售授权（R-02-027：开户时授权、换销售生效时同步，上线补授一次）。费用管理、费用明细（含交易明细）两页按「费用管理（查看）」权限点显示菜单，没有该点就没有菜单、直接访问显示「无权限访问」（D-00-78、D-05-43）；「账户费用管理」「提成规则管理」只控制对应写操作
- **R-05-036** 排序：客户按其下可见账户昨日消耗合计降序，合计相同按公司名称升序；客户内账户按昨日消耗降序；不同客户币种不同时直接按数值比较，不折算（D-05-25）
- **R-05-037** 分页 10 / 50 / 100 / 300 条每页，默认 10；一个客户算一条
- **R-05-038** 客户级操作：费用明细（能看到该客户即可见）；充值、退款、余额分配、调整额度（有「账户费用管理」权限点才显示）；提成规则配置（有「提成规则管理」权限点才显示）；「账户费用管理」「提成规则管理」都以有「费用管理（查看）」为前提，没有查看点时即使有写权限点也看不到页面、服务端同样拒绝（D-13-01）；当前结算期为后付款的客户不显示充值、退款、余额分配（R-05-003）；没权限的按钮直接隐藏，服务端按 R-05-079 复核
- **R-05-039** 点「费用明细」在当前页跳转到该客户的费用明细页（2.12）
- **R-05-040** 没有可见客户、或筛选后没有结果时，列表显示「暂无数据」

#### 2.4.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 没有任何可见账户 | — | 列表为空（R-05-040） | 「暂无数据」 |
| 有同类型审批中单 | 点按钮 | 不打开弹窗（R-05-077）；提成规则配置例外，只读打开 | 提示框，含审批单号与申请人 |
| 名下没有账户的客户 | — | 不出现（R-05-035） | — |
| 没有「费用管理（查看）」 | — | 无菜单（R-05-035） | 直接访问显示「无权限访问」 |
| 没有权限点 | — | 按钮隐藏（R-05-038） | 只剩「费用明细」 |
| 后付款客户 | — | 不显示充值 / 退款 / 余额分配（R-05-003） | 有剩余分桶的账户照常显示余额 |
| 有待生效的计费模式变更 | — | 按当前结算期的计费模式处理（R-05-032） | 「预付款（yyyy-mm-dd 起改为后付款）」 |
| 消耗数据延迟 | 今日消耗还没拉到 | 沿用现有消耗数据刷新机制 | 显示已拉到的值 |

#### 2.4.6 验收标准

- **G-05-018** 前置：公共前置；另有客户「橙子出行科技有限公司」昨日消耗合计 300.00 人民币；星海两个账户昨日消耗 A 1,200.00、B 800.00。操作：王敏打开费用管理。期望：默认「费用信息」；星海排第一（2,000.00 > 300.00，不折算）；星海下 A 在 B 前；金额列都带币种代码；没有「导出」按钮。
- **G-05-019** 前置：陈思远只有账户 A 的查看权限，有「账户费用管理」，没有「提成规则管理」。操作：打开费用管理。期望：星海下只显示 A；操作列有 费用明细、余额分配、充值、退款、调整额度，没有提成规则配置；他看不到任何账户的客户不出现。
- **G-05-020** 前置：公共前置。操作：搜索「iOS-JP」；再把计费模式选为后付款。期望：搜索后显示星海及其下 A、B 两行；选后付款后星海不出现，只剩后付客户。
- **G-05-021** 前置：有「费用管理（查看）」、没有「账户费用管理」也没有「提成规则管理」的用户，能看 A。操作：打开费用管理并点「费用明细」。期望：操作列只有「费用明细」；点击后当前页跳到星海的费用明细页。
- **G-05-069** 前置：客户「云帆科技有限公司」名下没有账户；星海另有账户「星海-iPad-US」与已停用账户「星海-Mac-US」（王敏都能看）。操作：王敏打开费用管理；打开星海的账户充值与提成规则配置。期望：云帆科技不出现；充值弹窗账户行按名称升序：星海-iOS-JP、星海-iOS-US、星海-iPad-US、星海-Mac-US，星海-Mac-US 名称后有灰字「已停用」；提成规则适用账户选项里星海-Mac-US 同样标「已停用」、排在最后。
- **G-05-078** 前置：周婷没有「费用管理（查看）」；赵磊有「费用管理（查看）」但没有任何账户的查看权限。操作：两人分别登录看侧栏，并直接访问费用管理页地址。期望：周婷侧栏没有「费用管理」菜单，直接访问显示「无权限访问」；赵磊有菜单，列表显示「暂无数据」。

<!-- mock: mocks/01-费用信息列表.html | 费用管理 · 费用信息列表（预付 + 后付客户、欠费、额度） -->

### 2.5 账户充值

#### 2.5.1 功能描述

给预付款客户的一个或多个账户充值。按「充值金额」或「应收金额」两种方向算，按结算币种转出应收总计，提交审批；审批通过后 09 收款，收款确认才到账。

#### 2.5.2 核心字段

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 公司名称 | customer_id | 关联 04 客户 | 是 | 只读 | 当前客户 | — |
| 付款主体 | payer | string | 是 | 客户当前生效付款主体 | 空 | R-05-042 |
| 结算币种 | settle_currency | enum（下拉单选） | 是 | 人民币 / USD / USDT | 客户币种 | R-05-024 |
| 计算方式 | calc_mode | enum | 是 | 充值金额计算 / 应收金额计算 | 充值金额计算 | R-05-043 |
| 充值金额 / 应收金额（每账户） | lines[].net_amount / gross_amount | decimal(2)，账户消耗币种 | 至少一行 > 0 | ≥ 0 | 空 | R-05-045、R-05-046 |
| 应收金额总计 | total_account_ccy | decimal(2)，账户消耗币种 | 是 | > 0 | — | R-05-047 |
| 汇率 / 汇率日期 / 应收金额总计（结算币种） | fx_rate / fx_date / total_settle_ccy | decimal(4) / date（UTC0） / decimal(2) | 币种不同时 | — | — | R-05-024、R-05-025 |
| 打款凭证 | vouchers | 文件列表 | 否 | ≤ 10 个、每个 ≤ 5MB | 空 | R-05-048 |
| 备注 | remark | text | 否 | 长度沿用现有备注框 | 空 | 即发起备注（R-05-080） |

#### 2.5.3 业务规则

- **R-05-041** 账户充值弹窗字段依次：公司名称（只读）、付款主体*、结算币种*、计算方式*、账户列表*、应收金额总计、打款凭证、备注；底部「提交审批」
- **R-05-042** 付款主体为必选单选，选项 = 该客户当前生效的付款主体（04 R-04-028）；下拉底部「+ 新增付款主体」，旁边灰字「需审批通过后可选」，点击打开 04 的付款主体弹窗，按 R-04-029～R-04-032 提交「付款主体变更」审批，成功后弱提示「已提交审批，审批通过后重新打开本弹窗即可选择」，审批通过前新主体不在选项里（D-05-13）；只有有「客户管理-读写」的用户看得到「+ 新增付款主体」（R-04-063，D-05-22）。客户没有付款主体时：有「客户管理-读写」的提示「该客户暂无付款主体，请先新增」，没有的提示「该客户暂无付款主体，请联系有客户管理读写权限的同事在客户管理中新增」；该客户有审批中的付款主体变更单时，下拉下方灰字「有 1 张付款主体变更审批中，通过后可选（审批单号 {SPxxxx}）」。退款弹窗的「收款主体」同样适用（R-05-050）
- **R-05-043** 计算方式单选 充值金额计算 / 应收金额计算，默认充值金额计算；切换时清空账户列表里已填的金额
- **R-05-044** 账户列表按 R-05-115 列出账户，每个账户一行；金额框留空或填 0 表示本次不给该账户充值
- **R-05-115** 弹窗账户范围与排序：账户充值、充值退款、余额分配（取出与转入两侧）、调整额度弹窗的账户行 = 该客户下当前用户有查看权限的全部账户，含已停用、投放暂停的账户，已停用账户在名称后标灰字「已停用」；5 个弹窗的账户行（含提成规则适用账户选项，R-05-070）按账户名称升序（会议清单 D49）
- **R-05-045** 充值金额计算：列为 账户名称 / 充值金额（输入）/ 税费 / 服务费 / 服务费税费 / 应收金额；填充值金额后按 R-05-017～R-05-022 正算其余四列，试算时机按 R-05-113；「服务费」单元格悬浮显示「服务费率 x.xx%（第 N 行，[下限, 上限)；固定比例显示「固定」）/ 税率 y.yy% / 服务费税费{客户承担 / 公司承担}」，数据取自试算结果，无适用规则的行显示「服务费率 0.00% / 税率 0.00% / -」（会议清单 D44）。充值金额 = 本次进入该账户余额的金额
- **R-05-046** 应收金额计算：列为 账户名称 / 应收金额（输入）/ 税费 / 服务费 / 服务费税费 / 充值金额；填应收金额后按 R-05-020～R-05-022 反算，试算时机按 R-05-113，「服务费」悬浮同 R-05-045；反算无解按 R-05-020 标红
- **R-05-047** 列表下方展示：应收金额总计（账户币种）= 各行应收金额之和；结算币种与账户币种不同时再展示「汇率」与「应收金额总计（结算币种）」（R-05-024、R-05-025）；前端只展示服务端返回的 2 位金额，不自己再舍入，合计用展示值相加（D-00-13）；任一行输入非法或反算无解时，应收金额总计显示「—（有错误行，暂不计算）」，提交时按该行提示拦截；应收金额总计必须 > 0，否则提交时提示「请至少为一个账户填写充值金额」
- **R-05-048** 打款凭证选填，最多 10 个文件、每个 ≤ 5MB、格式不限；一次选择超出剩余名额时按选择顺序保留到总数 10 个，其余不上传，提示「最多上传 10 个文件，超出部分未上传」；超过 5MB 的文件不上传并提示「单个文件不能超过 5MB」（D-00-14）
- **R-05-049** 某个账户行没有适用规则时按 R-05-017 以 0 费率计算：税费、服务费、服务费税费显示 0.00，与正常行一样可提交，不显示任何提示；「服务费」悬浮照常显示 0.00%，不另提示（D-05-38）

#### 2.5.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 客户没有付款主体 | 下拉为空 | 不能提交 | 按有无「客户管理-读写」两种提示（R-05-042） |
| 新增付款主体审批中 | — | 新主体不可选（R-05-042） | 下拉下方灰字「有 1 张付款主体变更审批中，通过后可选（审批单号…）」 |
| 弹窗期间所选付款主体被删除 | 提交复核 | 不建单、弹窗不关（R-05-079） | 「付款主体已变更，请重新选择」 |
| 有错误行 | 输入非法或反算无解 | 总计不计算（R-05-047） | 「—（有错误行，暂不计算）」 |
| 全部留空 | 总计 0 | 不提交（R-05-047） | 「请至少为一个账户填写充值金额」 |
| 凭证超限 | — | 不上传（R-05-048） | 对应提示 |
| 提交后余额 | — | 审批中、收款前余额都不变（R-05-082） | — |

#### 2.5.6 验收标准

- **G-05-022** 前置：G-05-011 填好的弹窗；付款主体选 Starfish Ltd，上传 2 张凭证，备注「10 月第二笔」。操作：点提交审批并确定。期望：确认框标题「提示」，文案「账户充值需进行审批，是否提交审批单？」；提示「已提交审批」，弹窗关闭；已提交审批 tab 出现一条 账户充值·审批中；审批详情发起记录备注「10 月第二笔」；A、B 余额不变。
- **G-05-023** 前置：G-05-022 的单审批中。操作：王敏再点星海的「充值」；用接口直接再提交一张。期望：不打开弹窗，弹提示框「该客户已有审批中的账户充值（审批单号 {G-05-022 的单号}，申请人 王敏），请等审批结束或撤回后再操作」，单号可点、新页打开审批详情，点「知道了」关闭；接口被拒，不产生第二张单；点「退款」仍可正常打开。
- **G-05-024** 前置：G-05-022 的单；A 有 2026-10-10 生效的长期额度 5,000.00（早于本单提交）。操作：审批通过；之后 09 确认收款，实收 102,600.00 人民币。期望：通过后 09 出现一张收款单（应收 102,605.45 人民币），交易明细新增一条「账户充值·待完成」，余额不变；确认收款后 A 余额 +8,000.00、B +5,000.00，A 到账后可用余额 > 0、额度清零，交易明细变「已完成」，实收 102,600.00 人民币、手续费 5.45 人民币。
- **G-05-025** 前置：公共前置。操作：打开账户充值，A 填 0、B 留空，点提交审批。期望：提示「请至少为一个账户填写充值金额」，不弹确认框。
- **G-05-026** 前置：王敏有「客户管理-读写」；陈思远没有；另有客户「云杉传媒有限公司」没有付款主体，且有一张审批中的付款主体变更单 SP20261019005。操作：两人分别展开星海账户充值的付款主体下拉，王敏点「+ 新增付款主体」并提交；两人再分别打开云杉传媒的账户充值。期望：王敏看到「+ 新增付款主体」及旁边灰字「需审批通过后可选」，点开是 04 的付款主体弹窗，提交后弱提示「已提交审批，审批通过后重新打开本弹窗即可选择」，下拉仍只有原两个主体；陈思远看不到「+ 新增付款主体」；云杉传媒：王敏看到「该客户暂无付款主体，请先新增」，陈思远看到「该客户暂无付款主体，请联系有客户管理读写权限的同事在客户管理中新增」，两人下拉下方都有灰字「有 1 张付款主体变更审批中，通过后可选（审批单号 SP20261019005）」。
- **G-05-027** 前置：客户「海岸文娱有限公司」币种为空。操作：打开账户充值。期望：结算币种没有默认值；不选直接提交提示「请选择结算币种」。
- **G-05-028** 前置：打款凭证。操作：一次选 11 个文件；再选一个 6MB 的文件。期望：按选择顺序保留前 10 个，第 11 个不上传，提示「最多上传 10 个文件，超出部分未上传」；6MB 文件不上传，提示「单个文件不能超过 5MB」。
- **G-05-079** 前置：王敏打开星海账户充值，付款主体选 Starfish Ltd、填好金额；期间 04 一张付款主体变更审批通过，删除了 Starfish Ltd。操作：点提交审批并确定。期望：不创建审批单，提示「付款主体已变更，请重新选择」；弹窗不关、已填内容保留。

<!-- mock: mocks/02-账户充值-充值金额计算.html | 账户充值弹窗（充值金额计算，USD 账户 → 人民币结算） -->

<!-- mock: mocks/03-账户充值-应收反算与校验.html | 账户充值弹窗（应收金额计算：尾差、反算无解、无规则账户按 0） -->

### 2.6 充值退款

#### 2.6.1 功能描述

把预付款账户的可用余额退给客户：按分桶充值时的费率倒推应退（含当时收的税费、服务费），按结算币种转出，提交即锁定，审批通过扣余额并生成 09 付款单。

#### 2.6.2 核心字段

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 收款主体 | payer | string | 是 | 客户当前生效的付款主体（同充值） | 空 | R-05-050 |
| 结算币种 | settle_currency | enum | 是 | 人民币 / USD / USDT | 客户币种 | R-05-024 |
| 可用余额（每账户） | available | decimal(2) | — | 只读 | — | R-05-051 |
| 退款余额（每账户） | lines[].net_amount | decimal(2)，账户消耗币种 | 至少一行 > 0 | 0 ≤ x ≤ 可用余额 | 空 | R-05-053 |
| 税费 / 服务费 / 服务费税费 / 应退金额 | lines[] | decimal(2) | — | 只读 | — | R-05-027 |
| 应退金额总计（账户 / 结算币种） | total_* | decimal(2) | — | 只读 | — | R-05-054 |
| 备注 | remark | text | 否 | — | 空 | R-05-080 |

#### 2.6.3 业务规则

- **R-05-050** 充值退款弹窗字段依次：公司名称（只读）、收款主体*（选项与规则同 R-05-042，下拉底部入口仍叫「+ 新增付款主体」，会议清单 D37）、结算币种*（R-05-024）、账户列表*、可退余额、应退金额总计、备注；没有凭证字段
- **R-05-051** 账户列表列：账户名称 / 可用余额 / 退款余额（输入）/ 税费 / 服务费 / 服务费税费 / 应退金额；「可用余额」按 R-05-008（原型列名「账户余额」改为「可用余额」，D-05-23）；可用余额 ≤ 0 的账户退款余额框禁用；账户范围与排序按 R-05-115
- **R-05-052** 列表右上「可退余额：{合计} {账户币种}」= 各账户 max(可用余额, 0) 之和；点「全部」把每个可用余额 > 0 的账户的退款余额按当前可用余额回填，并把该行标为「全部退款」；提交时服务端按提交时刻最新可用余额取值（≤ 0 的账户跳过），确认框回显实际退款额（R-05-114）；用户手动改了该行金额就取消「全部退款」标记
- **R-05-053** 退款余额留空或 0 = 该账户不退；填了的必须 ≤ 该账户可用余额，超出时该框标红，提示「不能超过可用余额 {金额}」，不能提交（D-00-52）；至少一个账户退款余额 > 0，否则提示「请至少为一个账户填写退款余额」
- **R-05-054** 每行税费、服务费、服务费税费、应退金额按 R-05-027 计算，试算时机按 R-05-113；列表下方展示应退金额总计（账户币种），结算币种不同时加汇率与应退金额总计（结算币种）；前端不二次舍入，合计用展示值相加（D-00-13）

#### 2.6.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 弹窗期间发生消耗 / 跨桶 | 服务端金额与弹窗不同 | 预算回显，变了的行标黄，请用户再确认（R-05-114） | 「金额已按最新余额重算」 |
| 提交前余额被消耗到低于填的金额 | 服务端可用余额变小 | 不建单（R-05-079、R-05-114） | 「不能超过可用余额 {最新金额}」 |
| 点了「全部」 | — | 按提交时刻最新可用余额取值（R-05-052） | 确认框回显实际退款额 |
| 提交后可用资金 ≤ 0 | — | 确认框加停投提示（R-05-078） | 「…账户会立即停投…」 |
| 可用余额 ≤ 0 | — | 输入框禁用（R-05-051） | — |
| 余额来自返点抵扣 | 分桶费率 0 | 只退净额（D-05-21） | 税费、服务费为 0 |
| 余额来自存量期初 | 费率快照按 0（R-05-005） | 见第 4 节 | 只退净额 |

#### 2.6.6 验收标准

- **G-05-029** 前置：G-05-001 的数据（A 可用余额 13,000.00；B 可用余额 0.00）。操作：打开充值退款，A 填 4,000.00。期望：主体字段名为「收款主体」；列名为「可用余额」；B 的退款余额框禁用；可退余额 13,000.00 USD；A 税费 240.00、服务费 170.00、服务费税费 10.20、应退 4,420.20；汇率「1 USD = 7.1234 人民币（2026-10-19）」；应退金额总计（结算币种）31,486.85 人民币。
- **G-05-030** 前置：G-05-029 的弹窗。操作：A 改填 13,500.00；再点「全部」；再把 A 手改为 12,000.00。期望：13,500.00 标红「不能超过可用余额 13,000.00」，不能提交；点「全部」后 A 填为 13,000.00 并标「全部退款」，B 仍禁用；手改为 12,000.00 后「全部退款」标记取消。
- **G-05-031** 前置：G-05-029 提交，审批中。操作：审批人驳回；另一次改为审批通过，09 先确认汇款、再确认到账。期望：驳回后 A 锁定释放、可用余额回到 13,000.00；通过后（不等确认汇出）A 余额 9,000.00、09 出现付款单（应付 31,486.85 人民币）、交易明细「余额退款·待完成」充值金额 -4,000.00 USD；09 确认汇款后交易明细仍为「待完成」；确认到账（付款单已完成）后变「已完成」，实收金额 = 付款单到账金额（记负数），打款凭证、到账凭证为付款单上传的文件，完成时间 = 付款单完成时间，手续费显示「-」。
- **G-05-064** 前置：G-05-001 的数据（A 分桶①剩 1,000.00、②剩 12,000.00）。操作：王敏打开充值退款，A 填 1,500.00（弹窗显示税费 90.00、服务费 95.00、服务费税费 5.70、应退 1,690.70）；弹窗打开期间 A 又消耗 200.00；点提交审批。期望：确认框（标题「提示」）按服务端预算回显：A 税费 90.00、服务费 85.00、服务费税费 5.10、应退 1,680.10，该行标黄并写「金额已按最新余额重算」；点确定后按 1,680.10 建单，A 锁定分桶①800.00、②700.00；点确定前弹窗内容不丢。

<!-- mock: mocks/04-充值退款.html | 充值退款弹窗（可用余额、全部、超额标红） -->

### 2.7 余额分配

#### 2.7.1 功能描述

同一客户账户之间挪钱：从一个或多个账户「取出」（按分桶倒推实际金额），再「转入」其他账户（按转入账户提交当天规则反算充值余额），两侧实际金额相等才能提交。

#### 2.7.3 业务规则

- **R-05-055** 余额分配弹窗字段依次：公司名称（只读）、取出余额账户列表*、充值余额账户列表*、可分配实际金额、备注；标题右侧问号悬浮说明（R-05-061）
- **R-05-056** 取出余额账户列表列：账户名称 / 可用余额 / 取出余额（输入）/ 税费 / 服务费 / 服务费税费 / 实际金额（D-00-54；「可用余额」同 R-05-051）；取出余额留空或 0 = 不取；填了的必须 > 0 且 ≤ 可用余额，超出提示「不能超过可用余额 {金额}」；可用余额 ≤ 0 的账户取出余额框禁用（同 R-05-051）；实际金额按 R-05-027，试算时机按 R-05-113
- **R-05-057** 充值余额账户列表列：账户名称 / 账户余额 / 实际金额（输入）/ 税费 / 服务费 / 服务费税费 / 充值余额（D-00-54）；「账户余额」锁定悬浮同 R-05-033；填实际金额后按 R-05-017～R-05-022 反算充值余额（试算时机 R-05-113），反算无解按 R-05-020；「服务费」悬浮同 R-05-045。每行实际金额框旁有「填入剩余」，点后该行实际金额 = 该行当前值 + 可分配实际金额，可分配实际金额 ≤ 0 时置灰；只有一个可转入的账户（输入框未禁用）时自动带入可分配实际金额并随取出侧变化同步，用户手改后不再跟随；填入后照常按 R-05-020 反算，无解照常标红（会议清单 D46）
- **R-05-058** 两个列表的账户范围与排序按 R-05-115；同一个账户不能既取出又转入，在一边填了金额后另一边该账户的输入框禁用（D-05-26）
- **R-05-059** 可分配实际金额 = 取出列表实际金额之和 − 充值列表实际金额之和，实时显示；提交时必须等于 0.00，否则提示「可分配实际金额须为 0，当前为 {金额}」（D-00-14）；提交时服务端重算出的取出实际金额合计与页面不同时，差额按 R-05-114 并入转入行
- **R-05-060** 至少一个账户取出余额 > 0 且至少一个账户实际金额 > 0，否则提示「请填写取出和转入的账户」
- **R-05-061** 问号悬浮说明：「提交前请确认「可分配实际金额」为 0，大于或小于 0 均无法提交。」「「实际金额」可手动填写，填写后系统自动算出「充值余额」：实际金额 ÷（1 + 税率 + 服务费率 + 服务费率 × 税率），服务费税费由公司承担时不含最后一项。」「点「填入剩余」可把可分配实际金额补进该行。」「转入按提交当天的规则折算，阶梯按本次每个账户的充值余额落档；取出按每笔余额充值时的规则分别计算。」「金额统一四舍五入到 2 位小数。」「提交审批后取出的余额将被锁定。」（原型「若有区间规则统一使用上边界」改为按 D-00-51 表述）

#### 2.7.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 可分配实际金额不为 0 | — | 不提交（R-05-059） | 提示当前差额 |
| 同一账户两边都填 | — | 另一边禁用（R-05-058） | — |
| 转入账户没有适用规则 | — | 按 0 费率反算，充值余额 = 实际金额（R-05-017） | 无提示 |
| 只有一个账户 | 无法既取又转 | 不拦打开，提交时按 R-05-060 拦 | 「请填写取出和转入的账户」 |
| 只有一个可转入账户 | — | 自动带入可分配实际金额并跟随，手改后停止跟随（R-05-057） | — |
| 点「填入剩余」后反算无解 | — | 照常标红（R-05-057、R-05-020） | 「可填小于甲或不小于乙」 |
| 提交时取出金额变化 | 跨桶 | 差额并入转入行再反算、确认框回显（R-05-114） | 无解时「取出金额已变化为 {x}，请调整转入金额后重新提交」 |

#### 2.7.6 验收标准

- **G-05-032** 前置：A 分桶①剩 1,000.00（快照 8.00% / 6.00% / 客户承担）；B 规则固定 4.00%、税率 6.00%、公司承担；星海只有 A、B 两个账户。操作：打开余额分配：取出 A 1,000.00。期望：取出 A：税费 60.00、服务费 80.00、服务费税费 4.80、实际金额 1,144.80；B 是唯一可转入的账户，自动带入实际金额 1,144.80：充值余额 1,040.73、税费 62.44、服务费 41.63、服务费税费 0.00；可分配实际金额 0.00，可以提交；转入列表 A 行输入框禁用。
- **G-05-033** 前置：G-05-032 的弹窗。操作：B 实际金额手改为 1,100.00 点提交审批；再把取出 A 改为 900.00。期望：提示「可分配实际金额须为 0，当前为 44.80」，不提交；改取出金额后 B 不再自动跟随，仍为 1,100.00。
- **G-05-034** 前置：G-05-032 提交并审批通过。操作：查看 A、B 余额与交易明细。期望：提交时 A 锁定 1,000.00；通过后 A 余额减少 1,000.00、B 余额增加 1,040.73（新分桶，快照 4.00% / 6.00% / 公司承担）；交易明细「余额分配·已完成」，充值金额 0、账户列表「星海-iOS-US -1,000.00 USD」「星海-iOS-JP +1,040.73 USD」；A、B 额度不变。
- **G-05-035** 前置：后付客户「橙子出行科技有限公司」。操作：查看操作列。期望：没有充值、退款、余额分配。
- **G-05-067** 前置：A 分桶①剩 1,000.00（快照 8.00% / 6.00% / 客户承担）；B 规则固定 4.00%、税率 6.00%、公司承担；星海-iPad-US 没有适用规则。操作：取出 A 1,000.00（实际金额 1,144.80）；转入 B 实际金额填 500.00；点星海-iPad-US 行的「填入剩余」。期望：有两个可转入账户，不自动带入；点后星海-iPad-US 实际金额 644.80、充值余额 644.80；可分配实际金额 0.00，各行「填入剩余」置灰，可以提交。

<!-- mock: mocks/05-余额分配.html | 余额分配弹窗（取出 / 转入、可分配实际金额为 0） -->

### 2.8 调整额度

#### 2.8.1 功能描述

给账户设或改授信额度，预付款可带有效期，走审批，通过后生效。

#### 2.8.3 业务规则

- **R-05-062** 调整额度弹窗：标题「调整额度 · {客户别名}（{计费模式}）」，客户别名为空时用公司名称；账户列表*（账户范围与排序按 R-05-115，每行 账户名称、额度（输入，前缀币种代码）、额度有效期（日期，仅当前结算期为预付款的客户显示；跨切换生效才通过的按 R-05-118⑤ 写入））、备注；底部「提交审批」
- **R-05-063** 打开时回填每个账户当前生效的额度与有效期，没有额度回填 0.00、有效期为空
- **R-05-064** 额度必填，≥ 0、最多 2 位小数、不设上限，填 0 = 取消额度（D-00-53），输入框口径同 R-05-023（D-00-82）；额度有效期选填，只能选今天（UTC0）及以后，额度为 0 时有效期框禁用并清空；最后通过时有效期已早于通过当天的处理见 R-05-082
- **R-05-065** 所有账户的额度与有效期都与当前生效完全相同时不能提交，提示「额度未修改」（D-05-27）

#### 2.8.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 什么都没改 | — | 不提交（R-05-065） | 「额度未修改」 |
| 有效期选过去 | — | 不可选（R-05-064） | — |
| 审批中账户充值到账 | 额度清零 | 单内账户按提交内容写入；单外账户不动（R-05-082） | 审批内容区顶部提示基准已变（R-05-104） |
| 审批中有效期已过 | 最后一人通过 | 回滚，审批单仍审批中（R-05-082、D-00-79） | 「额度有效期 yyyy-mm-dd 已过，请驳回后重新提交」 |

#### 2.8.6 验收标准

- **G-05-036** 前置：A 当前额度 5,000.00、有效期 2026-10-31；B 无额度。操作：打开调整额度。期望：标题「调整额度 · 星海（预付款）」；A 回填 USD 5,000.00 / 2026-10-31；B 回填 0.00、有效期框禁用；不改直接提交提示「额度未修改」。
- **G-05-037** 前置：G-05-036 的弹窗。操作：B 额度填 3,000.00、有效期选 2026-10-18；再改为 2026-11-30 提交并审批通过。期望：2026-10-18 不可选；通过后 B 授信额度 3,000.00 USD、有效期 2026-11-30；列表剩余额度随之更新。
- **G-05-038** 前置：后付客户「橙子出行科技有限公司」。操作：打开调整额度。期望：每行只有额度，没有额度有效期。
- **G-05-066** 前置：A 当前额度 5,000.00（长期），B 当前额度 2,000.00（长期）。操作：王敏打开调整额度，只把 A 改为 8,000.00 并提交；审批中 B 一笔在额度生效后提交的账户充值到账，到账后可用余额 > 0；之后审批通过。期望：业务单据和审批内容区只有 A；B 充值到账后额度清零为 0.00；审批通过后 A 额度 8,000.00，B 仍为 0.00，不被写回 2,000.00。
- **G-05-076** 前置：王敏 2026-10-19 提交额度调整：B 额度 3,000.00、有效期 2026-10-25；审批流 1 个节点。操作：审批人 2026-10-26 点通过。期望：确认框不关闭，显示「额度有效期 2026-10-25 已过，请驳回后重新提交」；审批单仍为审批中，这次通过不记录，B 额度不变；审批详情记「最近一次通过未执行：额度有效期 2026-10-25 已过，请驳回后重新提交（{审批人} 2026-10-26 hh:mm）」。
- **G-05-084** 前置：额度调整审批流为 0 节点。操作：王敏提交一张把 B 额度改为 1,000.00 的额度调整。期望：弱提示「提交成功，无需审批，已生效」；B 额度立即为 1,000.00；已提交审批出现该单，状态已通过。

<!-- mock: mocks/06-调整额度.html | 调整额度弹窗（预付带有效期 / 后付无有效期） -->

### 2.9 提成规则配置

#### 2.9.1 功能描述

在客户上配置销售、优化师两套提成规则（适用账户、计算方式、阶梯、上限）和生效日期，一起提交审批，通过后按所选生效日期起替换旧版本；弹窗下方可展开历史提成规则。11 按某日适用版本计算提成。

#### 2.9.2 核心字段

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 适用账户 | accounts | 账户列表 | 是 | 该客户全部账户 | 空 | 同一套内不重复（R-05-070） |
| 计算方式 | calc_mode | enum | 是 | 毛利阶梯计算 / 服务费百分比 | 毛利阶梯计算 | R-05-071 |
| 阶梯 | tiers | 列表（下限、上限：decimal(2) 人民币；比例：decimal(2) %） | 是 | ≥ 1 档 | 1 档「0 - 不限」 | R-05-072 |
| 提成上限 | cap | decimal(2)，人民币 | 否 | ≥ 0 | 空 = 不封顶 | R-05-073 |
| 生效日期 | effective_date | date（UTC0） | 是 | 当月 1 号及以后，无最晚 | 空 | 两套共用一个；R-05-108、R-05-109 |
| 版本状态 | state | enum | 是 | 待生效 / 生效中 / 已结束 / 已覆盖 | 系统计算 | R-05-110 |

#### 2.9.3 业务规则

- **R-05-066** 提成规则挂在客户上：每个客户一份，分「销售」「优化师」两套，每套 0 到多条规则；某账户在销售套里命中的规则用于该客户销售的提成，在优化师套里命中的规则用于该账户优化师的提成；提成金额怎么算、归谁、怎么展示归 11（D-00-38～D-00-41）
- **R-05-067** 提成规则配置弹窗顶部「销售 / 优化师」两个切换，默认销售；两套一起编辑、一起提交成一张「提成规则配置」审批单，审批通过后整份替换该客户的两套规则（D-05-28）
- **R-05-068** 打开时回填该客户当前生效版本（R-05-110）的两套规则，生效日期留空；没有当前生效版本（从没配过，或只有待生效版本）时每套各有 1 条空规则「提成规则1」。选了生效日期后，表单按该日期适用的版本（R-05-075）重新回填，没有适用版本时回填空规则；表单已经改过时先确认「将按 {日期} 适用的版本重新回填，当前修改会丢失」，取消则日期恢复原值、表单不动；回填后日期框下提示「已按 {日期} 适用的版本（{审批单号}）回填」（会议清单 D18-a）
- **R-05-117** 待生效提示：该客户有待生效版本时，弹窗顶部提示「该客户有待生效的提成规则（{yyyy-mm-dd} 起），如需修改，请选择该生效日期提交，审批通过后覆盖」，有多个待生效版本时按生效日期升序列出（D-05-41，会议清单 D99）
- **R-05-069** 每条规则标题「提成规则N」右侧「+」在最后追加一条空规则、「−」删除本条，删除后从 1 重排编号；每套可以删到 0 条，0 条时显示「暂无规则」和「+ 添加规则」；条数不设上限
- **R-05-070** 适用账户必填复选，选项为该客户下全部账户（不按当前用户的账户查看权限过滤，避免整份替换时误删他看不到的账户，D-05-29），按账户名称升序，已停用账户名称后标灰字「已停用」、排在最后、不剔除；同一套里各条规则的适用账户不能重复，重复时提示「适用账户与提成规则{N}重复：{账户名称}」；每套底部灰字「以下账户未适用任何规则：{账户名称}」（全部账户都有规则时不显示），不拦提交，客户新开账户不另通知；没有被任何规则选中的账户不产生该角色的提成
- **R-05-116** 空规则：适用账户未选、阶梯比例未填、提成上限为空的规则视为空规则，提交时忽略、不进审批单；只填了一部分的规则照常按必填校验在对应框标红、不能提交（会议清单 D18-c）
- **R-05-071** 计算方式必填单选：毛利阶梯计算（基数 = 毛利，D-00-34）/ 服务费百分比（基数 = 服务费，不含税，D-00-39），默认毛利阶梯计算；选项后显示「单位：人民币」
- **R-05-072** 每条规则一张阶梯表「下限 - 上限 比例%」，交互与校验同 03 的阶梯（R-03-023、R-03-024、R-03-026）：第一档下限 0、下一档下限 = 上一档上限、最后一档上限「不限」、左闭右开、至少 1 档；区间金额为人民币；比例 ≥ 0、最多 2 位小数、不设上限；阶梯怎么落档按 D-00-40（同一人、同一角色、同一月、同一版本内同一条规则的基数合计落一档、不累进），由 11 计算
- **R-05-073** 提成上限选填，人民币，≥ 0、最多 2 位小数；为空 = 不封顶；含义 = 每个人每个自然月按这条规则算出的提成最多到该金额（D-05-08）；规则身份 = 一个版本里的一条规则，月中换版本时各版本分别封顶（D-00-40）；上限框旁释义「每人每自然月按本条规则封顶（人民币）；月中换版本时各版本分别封顶」
- **R-05-074** 两套规则与当前生效版本或同生效日期的版本完全相同时也允许提交，不拦（D-05-39）；原型弹窗里隐藏的「投放应用（应用名称 / 应用ID）」面板是残留，不做（D-05-30）
- **R-05-075** 提成规则版本：审批通过（R-12-025）时按业务单据快照写入一个版本，生效日期 = 提交时所选日期，写入时不再校验是否早于当月 1 号（跨月才通过的照常按所选日期写入）；该客户已有同生效日期、未覆盖的版本时，新版本替换它，旧版本变为已覆盖。某日适用版本 = 该客户未覆盖的版本里，生效日期 ≤ 该日、生效日期最大的那一个；没有则该日没有提成规则，不产生提成。生效日期早于审批通过当天时，从生效日期起的提成由 11 按新版本重算，已算完人员月的金额变化由 11 记变化记录、不锁（D-05-08、D-00-41）；版本只追加或覆盖，旧版本保留供 11 回溯
- **R-05-108** 弹窗底部「生效日期」必填，销售、优化师两套共用一个；日期选择器只能选「当月 1 号」及以后（当月按 UTC0 今天所在月），不设最晚日期；为空提示「请选择生效日期」；所选日期早于今天（UTC0）时日期框下灰字「生效日期早于今天，审批通过后将从 {日期} 起按新规则重算提成」，不拦（会议清单 D19）；服务端提交时复核，早于当月 1 号提示「生效日期不能早于当月 1 号」（同 03 规则起始日期 R-03-033，D-05-08）；上线前导入的提成规则不受「最早当月 1 号」限制，生效日期 = 上线月 1 日（与 index S-18 同一个上线月配置），关联审批单号显示「上线导入」（§4.4，D-05-53）
- **R-05-109** 选的生效日期与该客户某个未覆盖的版本相同时，日期框下方提示「该生效日期已有提成规则，审批通过后将覆盖原规则」，不拦提交；表单按该日期适用的版本回填（R-05-068）
- **R-05-110** 版本状态由系统按日期计算、不能手动改（今天按 UTC0）：生效中 = 以今天计的适用版本（R-05-075）；待生效 = 生效日期晚于今天；已结束 = 生效日期早于生效中那一版；已覆盖 = 被同生效日期的新版本替换，不在历史提成规则展示、不参与适用判定，写入它的审批单照常可查。待生效版本不能撤销，要改就选同一个生效日期再提一版覆盖（D-05-41，提示见 R-05-117）

**历史提成规则**

- **R-05-111** 弹窗表单下方「历史提成规则」区默认收起，点标题展开 / 收起；列出该客户全部未覆盖的版本，按生效日期降序；生效中、待生效的版本在生效日期旁打标签「生效中」「待生效」，已结束的不打标签；没有版本时展开显示「暂无历史提成规则」（同 03 历史规则 R-03-035，D-05-40）；有审批中提成规则单时只读打开的弹窗里照常可展开（R-05-077）
- **R-05-112** 历史提成规则表列：生效日期（yyyy-mm-dd）、销售规则、优化师规则、关联审批单号；销售 / 优化师规则的文字格式同审批内容区（R-05-106），某套 0 条显示「无」；点关联审批单号新页打开写入该版本的审批单详情（查看判断按 R-05-086），上线导入的版本显示「上线导入」（R-05-108）；历史区只读、没有回填按钮，按所选生效日期回填见 R-05-068
- **R-05-119** 提供给 11 的提成规则数据（11 X-4）：①版本写入时每条规则的序号（「提成规则N」）随版本固定，作为该版本内规则的稳定标识，之后不再变；编辑表单里删除后从 1 重排（R-05-069）只影响新提交的版本，跨版本本就不算同一条规则（D-00-40）；②每个未覆盖版本的生效区间 = [本版生效日期, 下一个生效日期更晚的未覆盖版本的生效日期)，最后一版到「不限」，按 R-05-075 计算；③该客户审批中的提成规则配置单的审批单号与所选生效日期，供 11 显示「规则审批中」提示（会议清单 D19）

#### 2.9.4 状态与流转

提成规则版本状态（系统按日期计算，R-05-110；今天按 UTC0）：

| 从 | 动作 | 到 | 依据 |
| --- | --- | --- | --- |
| 无 | 审批通过写入，生效日期 > 今天 | 待生效 | R-05-075 |
| 无 | 审批通过写入，生效日期 ≤ 今天且没有更晚的已生效版本 | 生效中 | R-05-075 |
| 无 | 审批通过写入，已有生效日期更晚且 ≤ 今天的版本 | 已结束 | R-05-110 |
| 待生效 | 到生效日期（UTC0 00:00） | 生效中 | R-05-075 |
| 生效中 | 生效日期更晚的版本开始生效 | 已结束 | R-05-110 |
| 待生效 / 生效中 / 已结束 | 同生效日期的新版本审批通过 | 已覆盖 | R-05-075 |

逆向：本期没有撤销 / 作废版本；要改只能选同一生效日期再提一版覆盖（D-05-41）。

#### 2.9.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 适用账户重复 | — | 不提交（R-05-070） | 「适用账户与提成规则N重复：…」 |
| 两套都没改 | — | 照常提交（R-05-074） | 确认框 |
| 生效日期没选 | — | 不提交（R-05-108） | 「请选择生效日期」 |
| 弹窗跨月才提交，所选日期已早于当月 1 号 | 服务端复核 | 不创建审批单（R-05-108） | 「生效日期不能早于当月 1 号」 |
| 跨月才审批通过 | 生效日期在上个月 | 照常按所选日期写入，11 重算（R-05-075） | 历史显示所选日期 |
| 与已有版本同生效日期 | — | 提示，不拦；通过后覆盖（R-05-109、R-05-075） | 「该生效日期已有提成规则，审批通过后将覆盖原规则」 |
| 只有待生效版本 | 没有当前生效 | 回填空规则（R-05-068）；顶部待生效提示（R-05-117） | 历史里能看到待生效版本 |
| 选了生效日期 | — | 按该日期适用的版本回填，改过的先确认（R-05-068） | 「已按 {日期} 适用的版本（{审批单号}）回填」 |
| 生效日期早于今天 | — | 不拦（R-05-108） | 灰字「…审批通过后将从 {日期} 起按新规则重算提成」 |
| 有空规则 | — | 提交时忽略（R-05-116） | 审批内容区该套显示「无」 |
| 有审批中的提成规则单 | — | 只读打开弹窗（R-05-077、D-05-45） | 顶部提示含审批单号；历史可展开 |
| 没有任何版本 | — | — | 历史展开显示「暂无历史提成规则」 |
| 客户新增了账户 | 不在任何规则里 | 不产生提成，需重新配置；不另通知 | 弹窗底部灰字「以下账户未适用任何规则：…」（R-05-070） |

#### 2.9.6 验收标准

- **G-05-039** 前置：星海从没配过提成规则。操作：打开提成规则配置。期望：默认「销售」；销售、优化师各有 1 条空的「提成规则1」；计算方式默认毛利阶梯计算、显示「单位：人民币」；生效日期为空；历史提成规则收起，展开显示「暂无历史提成规则」；没有投放应用面板。
- **G-05-040** 前置：G-05-039 的弹窗。操作：销售：规则1 适用 A、B，毛利阶梯 [0, 50,000.00) 3.00%、[50,000.00, 不限) 5.00%，上限 20,000.00；优化师：规则1 适用 A 服务费百分比 [0, 不限) 10.00%，再加规则2 也选 A；生效日期选 2026-10-20。期望：优化师规则2 提示「适用账户与提成规则1重复：星海-iOS-US」，不能提交；去掉规则2 后可提交，确认框「提成规则配置需进行审批，是否提交审批单？」。
- **G-05-041** 前置：G-05-040 的单（生效日期 2026-10-20）2026-10-19 审批通过。操作：2026-10-19 再打开提成规则配置并展开历史提成规则；查 2026-10-19 与 2026-10-20 的适用版本；2026-10-20 再打开。期望：10-19 打开：两套各 1 条空规则（只有待生效版本，没有当前生效），历史 1 条「2026-10-20」标「待生效」；2026-10-19 没有提成规则，2026-10-20 起适用新版本；10-20 打开：回填该版本，生效日期为空，历史里该版本标「生效中」。
- **G-05-042** 前置：陈思远只看得到 A，有「提成规则管理」；当前销售规则1 适用 A、B。操作：打开提成规则配置。期望：适用账户选项有 A、B 两个，规则1 回填 A、B。
- **G-05-053** 前置：公共前置（今天 2026-10-19）。操作：打开生效日期选择器；不选日期点提交审批。期望：2026-09-30 及以前不可选，2026-10-01 及以后可选、没有最晚日期；不选时日期框下提示「请选择生效日期」，不弹确认框、不产生审批单。
- **G-05-054** 前置：2026-10-30 提交一张生效日期 2026-10-01 的提成规则单。操作：2026-11-03 审批通过。期望：照常写入，历史提成规则显示生效日期 2026-10-01；2026-10-01 起适用该版本，11 从 2026-10-01 起按新版本重算提成（11 核对）。
- **G-05-055** 前置：王敏 2026-10-31 打开弹窗、生效日期选 2026-10-01，没提交。操作：2026-11-01（UTC0）在同一弹窗点提交审批并确定。期望：提示「生效日期不能早于当月 1 号」，不产生审批单。
- **G-05-056** 前置：星海已有版本 V1（生效日期 2026-10-01，生效中）、V2（2026-11-01，待生效）。操作：打开弹窗，生效日期选 2026-11-01，提交后审批通过。期望：选日期后日期框下提示「该生效日期已有提成规则，审批通过后将覆盖原规则」，仍可提交；通过后历史提成规则为 新版本（2026-11-01，待生效）、V1（生效中）两条，V2 不再出现；V2 的关联审批单详情照常能打开。
- **G-05-057** 前置：星海有版本 2026-09-01、2026-10-01、2026-11-01 三个（都未覆盖），今天 2026-10-19。操作：打开提成规则配置，点「历史提成规则」展开，点 2026-10-01 那行的关联审批单号。期望：默认收起；展开后顺序 2026-11-01（待生效）、2026-10-01（生效中）、2026-09-01（无标签）；每行销售规则、优化师规则按 R-05-106 格式，0 条的套显示「无」；点审批单号新页打开该审批详情；再点标题收起。
- **G-05-058** 前置：星海当前生效版本 V1（2026-10-01）。操作：打开弹窗不改两套规则，生效日期选 2026-11-01，提交审批。期望：允许提交，产生审批单；不提示「提成规则未修改」。
- **G-05-068** 前置：星海当前生效版本 V1（2026-10-01）；王敏有一张审批中的提成规则配置单 SP20261019012，另有一张审批中的账户充值单。操作：王敏点「提成规则配置」并展开历史；再点「充值」。期望：打开只读弹窗，顶部提示条「该客户提成规则有状态为审批中的修改未通过，此处展示当前生效中的信息。（审批单号 SP20261019012，申请人 王敏）」；两套回填 V1 且全部禁用，生效日期框与「提交审批」隐藏；历史提成规则可展开；点「充值」仍不打开弹窗（R-05-077）。
- **G-05-074** 前置：星海有 V1（2026-10-01，生效中，销售规则1 上限 20,000.00）、V2（2026-11-01，待生效，写入单 SP20261015003，销售规则1 上限 30,000.00）；今天 2026-10-19。操作：打开提成规则配置；生效日期选 2026-11-01；把上限改为 25,000.00 后再把日期改为 2026-11-15 并确定。期望：打开时顶部提示「该客户有待生效的提成规则（2026-11-01 起），如需修改，请选择该生效日期提交，审批通过后覆盖」，表单回填 V1；选 2026-11-01 后表单按 V2 回填（上限 30,000.00），日期框下提示「已按 2026-11-01 适用的版本（SP20261015003）回填」与覆盖提示；改上限后换日期先确认「将按 2026-11-15 适用的版本重新回填，当前修改会丢失」，确定后按 V2 回填。
- **G-05-075** 前置：星海从没配过提成规则（两套各 1 条空规则）。操作：只填销售规则1：适用 A、毛利阶梯 [0, 不限) 3.00%，优化师规则1 不动，提交审批；另一次把优化师规则1 只勾适用账户 A、不填比例再提交。期望：销售套底部灰字「以下账户未适用任何规则：星海-iOS-JP」；第一次可提交，优化师空规则被忽略，审批内容区优化师规则显示「无」；第二次优化师规则1 的比例框标红，不能提交。
- **G-05-081** 前置：公共前置（今天 2026-10-19）。操作：生效日期选 2026-10-05。期望：日期框下灰字「生效日期早于今天，审批通过后将从 2026-10-05 起按新规则重算提成」，可照常提交。

<!-- mock: mocks/07-提成规则配置.html | 提成规则配置弹窗（优化师 tab、阶梯、重复校验、生效日期覆盖提示） -->

<!-- mock: mocks/13-历史提成规则.html | 提成规则配置弹窗 · 历史提成规则展开 -->

### 2.10 提交审批与审批结果（5 类共用）

#### 2.10.1 功能描述

5 个弹窗共用的提交、防重、服务端复核、审批结束后的数据变化，以及与 09 收付款的两个接口点。

#### 2.10.3 业务规则

- **R-05-076** 本页 5 种审批类型（R-12-001）：账户充值、充值退款、额度调整、余额分配、提成规则配置，审批事项都是「费用管理」
- **R-05-077** 同一客户、同一审批类型同时最多 1 张审批中的单（D-00-14）：已有时点对应按钮不打开弹窗，弹提示框「该客户已有审批中的{审批类型}（审批单号 {单号}，申请人 {姓名}），请等审批结束或撤回后再操作」，点「知道了」关闭，单号可点、新页打开审批详情（句式与形态按 R-12-047）。例外：提成规则配置有审批中单时打开只读弹窗：顶部提示条「该客户提成规则有状态为审批中的修改未通过，此处展示当前生效中的信息。（审批单号 {单号}，申请人 {姓名}）」（形态按 R-12-047），两套回填当前生效版本且全部禁用，生效日期框与「提交审批」隐藏，历史提成规则照常可展开（D-05-45）。不同类型互不影响（退款、余额分配可同时审批中，各自锁定按 R-05-008 叠加）
- **R-05-078** 点「提交审批」先做本弹窗的全部前端校验（有试算未完成时先等试算，R-05-113），任一不通过不提交，在对应位置提示；通过后弹二次确认框，标题「提示」（取消 / 确定）：账户充值、额度调整、提成规则配置为「{审批类型}需进行审批，是否提交审批单？」；充值退款、余额分配的确认框内容按 R-05-114 由服务端预算后回显；按服务端预算任一账户「提交后可用余额 + 额度 ≤ 0」时确认框加一句「提交后 {账户名称} 可用资金将 ≤ 0，账户会立即停投；审批驳回或撤回后不会自动恢复投放，需人工恢复。」（会议清单 D42）
- **R-05-079** 确定后服务端复核：权限点（R-05-038）、当前结算期计费模式（R-05-003）、同类型审批中单（R-05-077）、所选付款主体 / 收款主体仍在客户当前生效的付款主体里（否则提示「付款主体已变更，请重新选择」，会议清单 D116）、提成规则生效日期不早于当月 1 号（R-05-108）、可用余额（R-05-053、R-05-056，按服务端最新数据）、汇率与计算结果（充值与转入侧 R-05-026，退款与取出侧 R-05-114）；任一不满足不创建审批单并提示对应文案，弹窗不关、已填内容保留；带在途单号的提示同 R-05-077；同一弹窗连续点击只提交一次，请求中按钮显示加载
- **R-05-114** 退款 / 取出服务端预算与确认框回显（D-05-48）：充值退款、余额分配点提交审批后，先做前端校验，再由服务端按最新分桶预算（不建单）；确认框（标题「提示」）回显每个账户的退款 / 取出余额、税费、服务费、服务费税费、应退 / 实际金额和合计（余额分配另回显转入侧各行与可分配实际金额），与弹窗不同的行标黄并写「金额已按最新余额重算」；点确定后服务端再算一次：退款 / 取出余额 ≤ 最新可用余额、且结果与确认框一致时建单，不一致时刷新确认框请用户再确认，不关闭弹窗、不清空内容。标「全部退款」的行按提交时刻最新可用余额取值（R-05-052）。余额分配取出实际金额合计与页面不同时，差额并入转入侧最后一次点过「填入剩余」的那一行，没有这样的行时并入实际金额最大的转入行，再按 R-05-020 反算并在确认框回显；并入后该行反算无解时不建单，提示「取出金额已变化为 {x}，请调整转入金额后重新提交」，弹窗内容保留（会议清单 D07）
- **R-05-080** 复核通过后提交审批（R-12-014）：操作对象客户 = 本客户；本单涉及账户（供「绑定的运营」按账户优化师解析，D-00-76）= 充值、退款、余额分配中填了金额的账户，额度调整的单内账户，提成规则配置为该客户名下全部账户；业务单据 = 弹窗全部内容 + R-05-029 的计算快照 + 提交时各账户可用余额；额度调整只把额度或有效期与提交时当前生效值不同的账户写进业务单据（服务端按提交时刻判断），并带上这些账户提交时的生效额度与有效期作为比对基准（R-05-104、D-00-75）；发起备注 = 弹窗里的「备注」（同时作为业务备注在审批内容区展示，D-05-31）。成功后按返回的审批单状态弱提示（文案按 R-12-018），关闭弹窗、刷新列表
- **R-05-081** 退款、余额分配提交成功即按 R-05-007 锁定，并按 R-05-014 即时判断停投；其他类型提交不动余额
- **R-05-082** 审批单变为已通过（R-12-025）时：账户充值 → 生成 09 的收款单（应收 = 应收金额总计（结算币种））并写一条「待完成」交易明细，余额此时不变；充值退款 → 审批通过即从锁定分桶扣减余额（不等 09 确认汇出）、生成 09 的付款单（应付 = 应退金额总计（结算币种））、写一条「待完成」交易明细；余额分配 → 取出部分扣减、转入部分按 R-05-004 到账（新分桶），写一条「已完成」交易明细；额度调整 → 只写入单内账户的额度与有效期（含额度为 0 的取消），单外账户的额度不动（包括审批期间被充值清零或已到期的）；提成规则配置 → 按 R-05-075 写入版本（按所选生效日期生效）（D-05-05）。生成收付款单时按 R-09-001、R-09-002 带：付款主体 / 收款主体、币种（= 本单结算币种）、备注（弹窗备注）、申请人、申请时间；账户充值另带打款凭证与账户行（本单每个填了金额的账户及其应收金额，账户币种）。最后一个审批人通过时业务执行失败按 R-12-045 回滚（D-00-79①）；本页只有一种执行失败：额度调整单内任一账户的额度有效期早于通过当天（UTC0），原因「额度有效期 yyyy-mm-dd 已过，请驳回后重新提交」（D-05-49；通过时为后付、有效期被丢弃的不做此校验，R-05-118⑤）；其余情形通过时不复核、不算失败：账户充值审批期间客户计费模式已改为后付款的照常通过（在途单照常走完，R-05-118），退款 / 取出已在提交时锁定，提成规则不复核生效日期
- **R-05-083** 审批单变为已驳回、已撤回或已作废（作废效果同撤回，R-12-046、D-00-79③）：退款、余额分配释放锁定；其余类型不动任何数据；原单不能修改重提，要再申请需重新打开弹窗填写（R-12-034）。释放后若该账户当前处于停投、且可用余额 + 额度 > 0，通知该客户销售和该账户优化师（渠道同 R-05-015），文案见 notifications「可恢复投放」；不自动恢复投放（D-05-46）
- **R-05-084** 审批流 0 节点或全部节点被跳过时提交即已通过（R-12-018），立即按 R-05-082 处理，提交提示按 R-05-080；免审单照常有单号、出现在已提交审批（R-05-087），状态为已通过
- **R-05-085** 09 收款单确认收款（已完成）时：按快照给每个账户充值到账（生成分桶，R-05-004、R-05-005），预付款账户按 R-05-011 判断是否清零额度，对应交易明细改为「已完成」并回写实收金额、手续费、到账凭证、完成时间。09 付款单确认汇款后为「待完成」，此时余额退款交易明细仍为「待完成」、不回写（R-09-042）；付款单「已完成」（确认到账，D-00-33）时按 R-09-071 回写，交易明细改为「已完成」，各列取值：实收金额 = 到账金额（记负数，与应付同号），打款凭证 = 付款单打款凭证，到账凭证 = 付款单到账凭证，完成时间 = 付款单完成时间，手续费显示「-」（付款差额只在 09 记录，D-10-05；D-05-44）。收付款单本期不作废、退回（D-00-69）；sys 兜底撤回（不对前端暴露、记日志，R-09-076、D-00-69）只有两种：①充值收款单待完成时撤回：充值不到账、不生成分桶、额度不清零，交易明细该笔变「已撤回」；②退款付款单待汇出时撤回：把审批通过时已扣的退款余额按原分桶快照加回原分桶，交易明细该笔变「已撤回」，并按 R-05-014 即时判断停投（D-05-42）
- **R-05-086** 审批详情第②类只读查看判断（R-12-043、R-12-044）：账户充值、充值退款、额度调整、余额分配 = 当前用户持「费用管理（查看）」且对单内任一账户有查看权限，或当前用户有「收付款中心」权限点（只读，不显示通过 / 驳回 / 撤回，R-13-050、D-00-71）；提成规则配置 = 当前用户有「提成规则管理」权限点；申请人与快照里的审批人不受本条影响（R-12-043①，D-05-52）

#### 2.10.4 状态与流转

费用单据本身不设状态（D-05-35）：审批阶段看 12 审批单状态（审批中 / 已通过 / 已驳回 / 已撤回），通过后看交易明细状态（2.12.4）。本页触发的数据变化：

| 审批类型 | 提交 | 已通过 | 已驳回 / 已撤回 / 已作废 | 09 完成 |
| --- | --- | --- | --- | --- |
| 账户充值 | 不动余额 | 09 收款单 + 交易明细待完成 | 无 | 到账成桶、按 R-05-011 判断额度清零、交易明细已完成；待完成时被 sys 撤回 → 不到账、交易明细已撤回 |
| 充值退款 | 锁定 | 即扣减（不等汇出）+ 09 付款单 + 交易明细待完成 | 释放 | 交易明细已完成；待汇出时被 sys 撤回 → 按原分桶加回、交易明细已撤回 |
| 余额分配 | 锁定取出 | 取出扣减、转入成桶、交易明细已完成 | 释放 | — |
| 额度调整 | — | 只写入单内账户；有效期已过则回滚（R-05-082） | 无 | — |
| 提成规则配置 | — | 按所选生效日期写入版本（R-05-075） | 无 | — |

#### 2.10.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 连续点提交 | — | 只提交一次（R-05-079） | 按钮加载 |
| 两个标签页同时提交同类型 | 第二张 | 服务端拒（R-05-077） | 提示含审批单号与申请人 |
| 0 节点 | — | 提交即通过（R-05-084） | 「提交成功，无需审批，已生效」，数据立即变化 |
| 计费模式变更生效时有在途单 | 预付改后付次月 1 日生效 | 在途退款、余额分配、充值照常走完，释放或到账的分桶按 R-05-118 保留；新单按后付款隐藏按钮 | — |
| 09 收付款单作废 | — | 本期不做（D-00-69）；只有 sys 兜底撤回两种（R-05-085） | 交易明细「已撤回」 |
| 被「审批配置」持点人作废 | — | 同撤回（R-05-083） | — |

#### 2.10.6 验收标准

（见各弹窗验收：G-05-022～G-05-024、G-05-031、G-05-034、G-05-041、G-05-064、G-05-065、G-05-076、G-05-077、G-05-079、G-05-084）

<!-- mock: mocks/08-提交确认.html | 提交审批二次确认与重复提交提示 -->

### 2.11 已提交审批

#### 2.11.1 功能描述

费用管理页第二个 tab，看自己提交的 5 类单，进详情、撤回。

#### 2.11.3 业务规则

- **R-05-087** 已提交审批只展示当前登录账号提交的本页 5 类审批单（同 04 R-04-044 做法），含免审单（状态已通过）
- **R-05-088** 搜索框按审批单号、公司名称包含匹配；状态筛选 全部 / 审批中 / 已通过 / 已驳回 / 已撤回，默认全部
- **R-05-089** 列表字段：审批单号、操作对象（审批类型名：账户充值 / 充值退款 / 额度调整 / 余额分配 / 提成规则配置）、操作客户（公司名称）、所属账户系统（客户当前的）、申请人、申请时间（yyyy-mm-dd hh:mm:ss，Asia/Shanghai）、审批状态、操作
- **R-05-090** 排序：审批中置顶，其余按申请时间降序；分页 10 / 50 / 100 / 300 条每页，默认 10；没有数据显示「暂无数据」
- **R-05-091** 行操作：所有状态都有「详情」，新页打开该单审批详情；只有审批中有「撤回」，撤回范围、确认文案、后果与通知按 12（R-12-032～R-12-035），只校验申请人本人且单据审批中，不校验业务权限点（D-00-79②）；撤回或被作废后数据按 R-05-083 处理

#### 2.11.6 验收标准

- **G-05-043** 前置：王敏提交过账户充值（审批中）、额度调整（已通过）、余额分配（已驳回）各一张；陈思远提交过一张。操作：王敏切到已提交审批。期望：只有王敏的 3 张；审批中排第一；操作对象显示类型名；只有审批中那张有撤回；点详情新页打开审批详情。
- **G-05-044** 前置：王敏一张审批中的余额分配单。操作：点撤回并确定。期望：确认文案按 R-12-033；状态变已撤回；锁定释放。
- **G-05-077** 前置：G-05-031 的退款单审批通过（A 余额 9,000.00、付款单待汇出）；G-05-024 的充值单审批通过、收款单待完成。操作：sys 在后台撤回这张付款单与这张收款单。期望：退款：A 余额回到 13,000.00，分桶①1,000.00、②3,000.00 按原快照加回，交易明细该行「已撤回」；充值：不到账、余额不变、额度不清零，交易明细该行「已撤回」；费用管理与费用明细页上都没有撤回收付款单的入口。

<!-- mock: mocks/09-已提交审批.html | 费用管理 · 已提交审批 tab -->

### 2.12 费用明细页与交易明细

#### 2.12.1 功能描述

从费用信息列表某客户的「费用明细」进入，看这个客户的账单（费用明细 tab，口径 06）和全部资金流水（交易明细 tab，本页主管）。

#### 2.12.2 核心字段

交易明细（transaction）：

| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 发起时间 | initiated_at | datetime（Asia/Shanghai，秒） | 是 | — | — | R-05-097 |
| 交易类型 | type | enum | 是 | 账户充值 / 余额退款 / 余额分配 / 结算单支付 / 余额抵扣账单 / 客户返点 / 客情费用 | — | R-05-095 |
| 财务ID | finance_id | string | 否 | 09 收付款单编号 | — | R-09-004、R-05-097 |
| 充值金额 | recharge_amount | decimal(2)，账户消耗币种 | 是 | 可负；不动余额的类型存 0、显示「-」 | — | R-05-096、R-05-097 |
| 应付金额 | payable_amount | decimal(2)，结算币种 | 否（余额抵扣账单无） | 可负 | — | R-05-097 |
| 实收金额 / 手续费 | received_amount / handling_fee | decimal(2)，结算币种 | 否 | 09 回写 | — | D-00-32；余额退款按 R-05-085 |
| 打款凭证 / 到账凭证 | payment_vouchers / arrival_vouchers | 文件列表 | 否 | — | — | R-05-097 |
| 备注 | remark | text | 否 | — | — | — |
| 账户列表 | account_changes | 列表 | 是 | 「账户 ± 金额 币种」 | — | R-05-097、R-05-098 |
| 关联审批单号 | approval_id | 关联 12 | 是 | — | — | R-05-100 |
| 关联账单 | bill_ref | 关联 06 | 否 | 仅结算单支付、余额抵扣账单 | — | R-05-097 |
| 状态 | status | enum | 是 | 待完成 / 已完成 / 已撤回 | — | 2.12.4 |
| 完成时间 | completed_at | datetime（Asia/Shanghai，秒） | 否 | — | — | — |

#### 2.12.3 业务规则

- **R-05-092** 费用明细页标题「费用管理/费用明细」，标题下显示公司名称；顶部「费用明细 / 交易明细」两个切换，默认费用明细；只展示这一个客户的数据（原型标题「费用中心」统一为「费用管理」，D-05-32）
- **R-05-093** 「费用明细」tab 就是 06 的账单按本客户展示：三层展开（结算期 → 账户 → 订单号）、各列口径、账单状态（D-00-59）、导出内容、排序都按 06 定义；具体展示规则见 R-06-032：单客户、只读、不显示「生成结算单」，没有搜索和客户级列，保留结算期与状态筛选；本页只规定入口、tab 与第二层只展示当前用户有查看权限的账户（D-05-01）
- **R-05-094** 交易明细是本页主管的实体：记录一个客户每一笔会动钱或动余额的业务，一笔业务一行；生成时机见 R-05-082、R-05-085，06（结算单支付，写入口径见 R-06-051）、07（客户返点、客情费用）按自己的审批结果写入本实体
- **R-05-095** 交易类型：账户充值、余额退款、余额分配（05 写入）；结算单支付（06 写入，R-06-051：结算单审批通过时写入、待完成，09 确认收款后变已完成；充值金额显示「-」）；余额抵扣账单（06 结算单审批通过时调用 05 写入，按 R-05-118 扣减剩余分桶，生成即已完成，R-06-076、D-00-73）；客户返点、客情费用（07 写入；后付款客户的返点余额抵扣不写交易明细，R-07-056、D-07-18；合计为 0 的返点 / 客情单不写交易明细；账单结转充进余额时由 06 写一条「客户返点」，备注「yyyy-mm 账单结转」，生成即已完成，R-06-078、D-00-81）。每行状态 待完成 / 已完成 / 已撤回：资金要经 09 收付款的（账户充值、余额退款、结算单支付、现金返还的返点 / 客情）生成时为待完成，随 09 收付款单完成变已完成，sys 兜底撤回时变已撤回（R-05-085）；不经 09 的（余额分配、余额抵扣账单、预付返点余额抵扣、账单结转）生成即已完成（D-05-05）
- **R-05-096** 交易明细列表列：发起时间、交易类型、财务ID、充值金额、应付金额、实收金额、手续费、打款凭证、到账凭证、备注、账户列表、关联审批单号、关联账单、状态、完成时间；不适用的格显示「-」；不动余额的交易类型（结算单支付，R-06-051）充值金额存 0、页面显示「-」；金额格一律千分位、2 位小数、后缀币种代码（充值金额用账户消耗币种，应付、实收、手续费用该行结算币种，人民币显示「人民币」），负数前加「-」，不标红（会议清单 D47）
- **R-05-097** 05 写入的三类取值：发起时间 = 审批单申请时间；充值金额：账户充值 = 本单各账户充值金额之和（正），余额退款 = −本单各账户退款余额之和，余额分配固定为 0（页面显示 0.00，各账户变动看账户列表）；应付金额 = 应收 / 应退金额总计（结算币种；退款为负，余额分配为 0）；实收金额、手续费、到账凭证、完成时间由 09 回写（账户充值的手续费口径 D-00-32；余额退款各列按 R-05-085，实收与应付同号记负数）；打款凭证 = 充值弹窗上传的凭证，退款由 09 回写（R-05-085）；账户列表每个账户一行「{账户名称} +/- {金额} {币种}」；备注 = 弹窗备注；财务ID = 对应 09 收付款单的编号（R-09-004）。余额抵扣账单（06 结算单审批通过时调用 05 写入）：充值金额 = −各账户扣减的分桶金额之和（账户消耗币种），应付金额、实收金额、手续费显示「-」，账户列表每账户「{账户名称} -{金额} {币种}」，关联审批单号 = 该结算单的审批单，关联账单 = 被抵扣的账单。关联账单只有结算单支付、余额抵扣账单有
- **R-05-098** 交易明细可见范围：单内任一账户当前用户有查看权限即展示该行，账户列表只列他有权限的账户
- **R-05-099** 交易明细顶部两个筛选：「交易类型」全部 + 7 类（R-05-095），「状态」全部 / 待完成 / 已完成，默认都为全部，已撤回的行只在状态「全部」下出现；不做导出。按发起时间降序；时间格式 yyyy-mm-dd hh:mm:ss（Asia/Shanghai）；分页 10 / 50 / 100 / 300 条每页，默认 10；没有记录或筛选无结果显示「暂无交易记录」
- **R-05-100** 点关联审批单号新页打开该审批单详情（12 统一的审批详情页），能否查看按 R-12-043；凭证按钮统一叫「查看」：图片和 PDF 新页预览，其他格式直接下载；多个文件时弹出文件列表逐个查看（会议清单 D47）

#### 2.12.4 状态与流转

本页**定义**交易明细状态：

| 当前状态 | 触发动作 | 操作者 | 目标状态 | 前置条件 |
| --- | --- | --- | --- | --- |
| 无 | 账户充值 / 充值退款审批通过；06 结算单、07 现金返还审批通过 | 系统 | 待完成 | R-05-082、R-05-095 |
| 无 | 余额分配审批通过；07 预付返点余额抵扣审批通过；06 后付结算单余额抵扣审批通过；账单结转充进余额 | 系统 | 已完成 | R-05-095 |
| 待完成 | 09 收款单确认收款 / 付款单确认到账（已完成） | 系统 | 已完成 | R-05-085 |
| 待完成 | sys 兜底撤回充值收款单（待完成）/ 退款付款单（待汇出） | sys | 已撤回 | R-05-085 |

逆向：收付款单作废 / 退回本期不做（D-00-69）；只有 sys 兜底撤回让交易明细从待完成变已撤回，已撤回无操作。

#### 2.12.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 没有交易 | — | — | 「暂无交易记录」 |
| 部分账户无权限 | — | 行可见、账户列表裁剪（R-05-098） | 只看到自己能看的账户 |
| 审批单链接无权限 | — | 按 R-12-043 | 「无权限查看」 |
| 费用明细 tab 点生成结算单 | — | 该 tab 只读，不显示「生成结算单」（R-06-032） | 只能到账单管理操作 |

#### 2.12.6 验收标准

- **G-05-045** 前置：G-05-024、G-05-031、G-05-034 发生后。操作：王敏打开星海费用明细切到交易明细。期望：三行按发起时间降序；账户充值行 已完成、打款凭证「查看」可打开 2 个文件；余额分配行充值金额 0.00、应付金额 0.00；点关联审批单号新页打开审批详情。
- **G-05-046** 前置：陈思远只看得到 A；G-05-034 的余额分配单涉及 A、B。操作：陈思远打开星海交易明细。期望：能看到该行，账户列表只有「星海-iOS-US -1,000.00 USD」。
- **G-05-060** 前置：星海有一行 06 写入的「结算单支付」交易明细（R-06-051），以及 G-05-034 的余额分配行。操作：王敏打开星海交易明细。期望：结算单支付行充值金额显示「-」；余额分配行充值金额显示 0.00。
- **G-05-047** 前置：公共前置。操作：打开费用明细页。期望：标题「费用管理/费用明细」，标题下「星海网络科技有限公司」；默认「费用明细」tab，只读、没有「生成结算单」，第二层只出现当前用户可见的账户；其余三层与金额口径按 06 的 G-06-015 核对。
- **G-05-080** 前置：G-05-024、G-05-031、G-05-034 发生后；G-05-024 的打款凭证为 1 张 PNG 和 1 个 XLSX。操作：王敏打开星海交易明细；交易类型选「余额退款」；再改回全部、状态选「已完成」；点账户充值行打款凭证「查看」。期望：账户充值行充值金额「13,000.00 USD」、应付「102,605.45 人民币」、实收「102,600.00 人民币」；余额退款行充值金额「-4,000.00 USD」、应付「-31,486.85 人民币」，确认到账后实收与应付同号为负数，负数不标红；交易类型筛选后只剩余额退款行；状态选已完成只剩已完成的行；凭证弹出文件列表，PNG 新页预览、XLSX 直接下载。

<!-- mock: mocks/10-费用明细-交易明细.html | 费用明细页 · 交易明细 tab -->

### 2.13 费用管理审批详情 · 审批内容区

#### 2.13.1 功能描述

版本记录第 15 项。审批信息区与时间线按 12；本页定义 5 类审批的「审批内容」区。

#### 2.13.3 业务规则

- **R-05-101** 审批信息区按 12（R-12-026），审批事项「费用管理」，审批类型为本单类型；审批内容区按类型展示，全部取业务单据快照（R-05-080），公司名称为超链接、新页打开客户详情（R-04-050），所属账户系统取客户当前的
- **R-05-102** 账户充值内容区：公司名称、所属账户系统、付款主体、结算币种、计算方式、账户列表（账户名称 / 规则起始日期 / 服务费率 / 税率 / 服务费税费承担方 / 充值金额 / 税费 / 服务费 / 服务费税费 / 应收金额）、应收金额总计（账户币种）、汇率（含汇率日期，R-05-024）与应收金额总计（结算币种）（币种不同时）、打款凭证（文件名，按 R-05-100 查看）、备注（原型隐藏的费率表并入账户列表，D-05-33）；提交时没有适用规则的行，规则起始日期显示「-」、服务费率与税率显示 0.00%，不加其他提示（D-05-38）
- **R-05-103** 充值退款内容区：公司名称、所属账户系统、收款主体、结算币种、账户列表（账户名称 / 提交时可用余额 / 退款余额 / 税费 / 服务费 / 服务费税费 / 应退金额）、应退金额总计（账户币种）、汇率（含汇率日期）与应退金额总计（结算币种）（币种不同时）、备注
- **R-05-104** 额度调整内容区：公司名称、所属账户系统、账户列表（只列单内账户，R-05-080：账户名称 / 额度 / 额度有效期，后付款不显示有效期列）、备注；启用 12 变更高亮（R-12-030，额度调整以「原值 → 新值」并排代替标红格下的「原：」灰字）：比对基准 = 提交那一刻该账户的生效额度与有效期，随审批单快照保存，审批中与审批结束后回看一致、所有查看者一致（D-00-75）；每格显示「原值 → 新值」，与原值不同的格标红；提交时没有额度的视为原值为空，不标红、只显示新值；审批中该账户当前生效额度已与基准不同时（如审批期间充值清零），内容区顶部提示「提交后该账户额度已有变更，当前生效值与本单比对基准不同」
- **R-05-105** 余额分配内容区：公司名称、所属账户系统、取出余额账户列表（账户名称 / 提交时可用余额 / 取出余额 / 税费 / 服务费 / 服务费税费 / 实际金额）、充值余额账户列表（账户名称 / 提交时账户余额 / 服务费率 / 税率 / 实际金额 / 税费 / 服务费 / 服务费税费 / 充值余额；费率取提交快照，无适用规则显示 0.00%，会议清单 D96）、备注；只列填了金额的账户
- **R-05-106** 提成规则配置内容区：公司名称、所属账户系统、销售规则、优化师规则（每条「提成规则N」：适用账户名称用顿号分隔、计算方式、阶梯每档一行「[下限, 上限) x.xx%」最后一档「[下限, 不限) x.xx%」、提成上限「¥x.xx」或「不封顶」；某套 0 条时显示「无」）、生效日期（yyyy-mm-dd）、备注；文字展示，不用输入框；不启用变更高亮
- **R-05-107** 账户充值、充值退款、余额分配的账户列表只列本单填了金额的账户；内容区展示单内全部账户行，不按查看者的账户权限隐藏（D-05-34）；金额格式同 R-05-033

#### 2.13.5 异常与边界

| 场景 | 现象 | 系统行为 | 用户看到 |
| --- | --- | --- | --- |
| 查看者只有部分账户权限 | — | 内容区不隐藏账户行（R-05-107） | 全单 |
| 不满足 R-05-086 任一条件 | — | 按 R-12-043 | 「无权限查看」 |
| 额度原值为空 | — | 不标红（R-05-104） | 只显示新值 |
| 审批中账户额度已变 | 当前生效值 ≠ 比对基准 | 照常按提交时基准标红（R-05-104、D-00-75） | 顶部提示「提交后该账户额度已有变更…」 |

#### 2.13.6 验收标准

- **G-05-048** 前置：G-05-022 的单。操作：审批人打开审批详情。期望：审批事项「费用管理」、类型「账户充值」；账户列表 A 行规则起始日期 2026-10-01、服务费率 5.00%、税率 6.00%、客户承担，B 行 4.00%、6.00%、公司承担；应收金额总计 14,404.00 USD、汇率 1 USD = 7.1234 人民币（2026-10-19）、102,605.45 人民币；凭证可查看；公司名称新页打开客户详情。
- **G-05-049** 前置：G-05-037 的单审批中（只改了 B）。操作：审批人打开审批详情；审批通过后再回看。期望：内容区只列 B 一行，A 未改不在单内；B 提交时没有额度，原值为空，额度 3,000.00 与有效期 2026-11-30 不标红；通过后回看显示相同。
- **G-05-050** 前置：A 当前额度 5,000.00；一张额度调整把 A 改为 8,000.00、有效期不变。操作：审批人打开审批详情；审批中 A 因一笔充值到账额度清零后再看；审批通过后回看。期望：A 额度格显示「5,000.00 → 8,000.00」并标红，有效期不标红；A 额度清零后内容区顶部提示「提交后该账户额度已有变更，当前生效值与本单比对基准不同」，标红仍按提交时基准；通过后回看仍标红。
- **G-05-051** 前置：G-05-034 的余额分配单；陈思远不在审批流里、只看得到 A；周婷不在审批流里、看不到 A 和 B。操作：两人分别打开该审批单链接。期望：陈思远能只读看到审批信息与内容，内容区 A、B 两行都显示；周婷显示「无权限查看」。
- **G-05-052** 前置：G-05-040 通过的提成规则单；周婷有「提成规则管理」但不在审批流里。操作：周婷打开审批详情。期望：能只读查看；销售规则「提成规则1：星海-iOS-US、星海-iOS-JP；毛利阶梯计算；[0.00, 50,000.00) 3.00%；[50,000.00, 不限) 5.00%；提成上限 ¥20,000.00」；生效日期「2026-10-20」。
- **G-05-059** 前置：G-05-034 的余额分配单；李娜有「收付款中心」权限点，不在审批流里、看不到 A 和 B。操作：李娜打开该审批单链接。期望：能只读看到审批信息与内容，内容区 A、B 两行都显示；不显示通过 / 驳回 / 撤回。
- **G-05-083** 前置：G-05-034 的余额分配单。操作：审批人打开审批详情。期望：转入列表 B 行显示服务费率 4.00%、税率 6.00%（取提交快照）；取出列表没有费率列。

<!-- mock: mocks/11-审批内容-账户充值.html | 审批详情 · 审批内容（账户充值，含费率与汇率） -->

<!-- mock: mocks/12-审批内容-额度调整与提成.html | 审批详情 · 审批内容（额度调整标红 / 提成规则配置） -->

## 3 变更影响面

| 被影响对象 | 影响方式 | 处理动作 | 负责人 |
| --- | --- | --- | --- |
| 03 规则配置 | 本页按提交当天调用 R-03-003 / R-03-006 / R-03-009 | 03 提供取用能力（T-03-002） | 03 / 技术 |
| 04 客户管理 | 付款主体弹窗被本页调起 | 无需改 04 | — |
| 06 账单 | 预付账单逐张按分桶覆盖判结清（D-00-11、R-05-009）、后付未结清消耗（R-05-013，原始消耗）、费用明细 tab、结算单支付写交易明细；后付结算单余额抵扣锁定 / 扣减 / 释放分桶并写「余额抵扣账单」（D-00-73、R-05-118、R-05-097）；结转额出账时已转预付入余额并写「客户返点」（D-00-81、R-05-004） | 06 引用 R-05-001 / R-05-007 / R-05-009 / R-05-013 / R-05-027 / R-05-093～097 / R-05-118；本页引用 R-06-012、R-06-032、R-06-051 | 06 会话（2026-10-21 回写同步） |
| 07 返点 | 预付余额抵扣到账成桶（费率 0）、返点 / 客情写交易明细；后付余额抵扣不写（R-07-056、D-07-18） | 07 按 R-05-004、R-05-095 | 07 会话 |
| 09 收付款 | 本页生成收款单 / 付款单并等待完成回写；退款审批通过即扣余额（R-05-082）；sys 兜底撤回两种情形回退余额 / 到账并把交易明细置「已撤回」（R-05-085） | 生成字段 R-09-001、R-09-002，财务ID R-09-004，确认汇款 / 到账 R-09-042、R-09-071；09 加只读状态「已撤回」（D-00-69） | 09 会话 |
| 11 提成 | 按 R-05-075 取提成规则版本（生效日期由用户选，可早于审批通过当天、最早当月 1 号；跨月通过时上月也要重算）；上限与落档按规则身份 = 一个版本里的一条规则（D-00-40、R-05-073） | 11 引用；已算完人员月金额变化记变化记录、不锁（D-00-41） | 11 会话 |
| 12 审批 | 提交时传本单涉及账户（D-00-76，R-05-080）；最终通过执行失败回滚（D-00-79①，本页只有额度有效期过期一种，R-05-082）；作废同撤回（D-00-79③）；额度调整高亮基准随单快照（D-00-75，R-05-104）；免审提交提示（R-12-018） | 12 引用 | 12 会话 |
| 13 权限 | 新增「账户费用管理」「提成规则管理」「费用管理（查看）」；收付款中心只读看 4 类审批详情 | 两页按「费用管理（查看）」显示（D-00-78、D-05-43）；R-05-086 按 R-13-050 | 13 会话 |
| 停投 | 停投条件与判断时机、不自动恢复、释放后通知（R-05-014、R-05-083） | 技术按 D-05-46 改：后付额度 0 不停投、未结清按原始消耗、不另扣未到款 | 技术负责人 |
| 账户老字段「授信额度」 | 不再使用 | 见第 4 节 | 用户 / 技术 |

## 4 存量数据处理

本页改动会动到上线前已有的数据。4.1～4.4 的处理方式已于 2026-10-22 按闭环清单 C01～C03 定（D-05-53），各条仍标「待定」的执行细节随 Q-05-01 跟进（量级与导入方式问技术负责人）。没处理就上线的后果写在每项「用户可见变化」里。已上报总控汇总（WORKLOG 跨页影响 X-2）。

### 4.1 存量预付款账户的余额：上线前已经在跑、有充值和消耗的预付款账户（量级待技术统计）

- 处理方式：导入期初余额（闭环清单 C01，D-05-53）
- 规则 / 待议点：余额按 R-05-001 动态算；期初余额基准日 = 上线月 1 日 00:00（UTC0），与 index S-18 共用同一个上线月配置，基准日之前的消耗不再计入；期初余额 > 0 的账户建期初桶，费率快照按服务费率 0、税率 0（R-05-005）；期初余额 ≤ 0 的账户不建期初桶，余额从 0 起，负数部分出清单，交财务线下追收；期初余额来源（旧系统余额 / 财务台账）待定（Q-05-01）
- 用户可见变化：期初余额 ≤ 0 的账户上线后余额从 0 起算，旧欠费不在系统里显示（在清单里，由财务线下追收）；没导入的账户上线后余额 = 0 − 累计消耗，会显示大额欠费，并按 R-05-014 触发停投
- 协作分工：提供 财务 / 商务（待定）；执行 技术（导入脚本，待定）；核对 财务（待定）；负数清单交财务线下追收
- 时机：上线前
- 校验与验收：抽查期初余额 > 0 的账户上线后余额 = 财务台账余额、退款试算与财务手算一致（快照按 0）；期初余额 ≤ 0 的账户余额从 0 起，且出现在负数清单里
- 失败与回滚：迁移核对完成前，停投开关保持关闭（C01）；导入出错的重导方式待技术确认

### 4.2 账户上的老「授信额度」字段（D-02-02 保留不用）：有值的账户

- 处理方式：导入为长期额度（闭环清单 C02 S-3，D-05-53）
- 规则 / 待议点：老额度按上线时刻生效的长期额度导入（有效期为空），之后按 R-05-011 的条件清零（判断「额度生效之后才提交」时额度生效时刻 = 上线时刻）；后付款账户不因充值清零（R-05-012）；上线后新额度只能经「额度调整」审批写入（R-05-010）
- 用户可见变化：预付款账户上线后第一笔「上线后提交、到账后可用余额 > 0」的账户充值到账时，导入的额度清零
- 协作分工：提供 商务 / 财务（待定）；执行 技术（待定）；核对 商务（待定）
- 时机：上线前
- 校验与验收：抽查列表授信额度 = 老字段值、额度有效期为空
- 失败与回滚：待定

### 4.3 旧系统里的充值、退款等资金记录

- 处理方式：不导入（闭环清单 C02 S-4，D-05-53）
- 规则 / 待议点：过渡期的旧资金记录不导入，交易明细从上线起记；要查旧记录看旧报表
- 用户可见变化：费用明细页交易明细里看不到上线前的记录，需到旧报表查
- 协作分工：不涉及
- 时机：不涉及
- 校验与验收：上线后交易明细只有上线后产生的记录
- 失败与回滚：不涉及

### 4.4 现有的提成规则（若线下已有）

- 处理方式：上线前逐客户导入（会议清单 D18、闭环清单 C03，D-05-53）
- 规则 / 待议点：S-5 的数据由商务按客户提供销售、优化师两套规则清单；导入的版本不受 R-05-108「最早当月 1 号」的限制，生效日期 = 上线月 1 日（与 index S-18 同一个上线月），关联审批单号显示「上线导入」（R-05-108、R-05-112），同样出现在历史提成规则（R-05-111）；上线后 11 按 R-05-075 取版本；没有规则的账户不产生提成
- 用户可见变化：清单里没有的客户，上线后到首次配置审批通过前的日子没有提成
- 协作分工：提供 商务；执行 技术（待定）；核对 财务（待定）
- 时机：上线前
- 校验与验收：抽查导入客户的历史提成规则：生效日期 = 上线月 1 日、关联审批单号「上线导入」、两套规则与商务清单一致
- 失败与回滚：待定

### 4.5 存量账户的规则配置（D-00-57：上线前批量导入固定比例规则；阶梯 / 分段上线后在 04 客户材料历史附件行的「规则配置」入口配；没配前按 0 算）

- 处理方式：初始化导入 + 上线后页面配置（已定，D-00-57，执行在总控上线检查项；阶梯 / 分段须在首个月末结算前配完）
- 规则 / 待议点：本页依赖：没导入规则的账户充值、余额分配转入按 0 费率计算并按 0 快照入桶（R-05-017、R-05-005），之后补导规则也不回算这些已提交的单（R-05-029）
- 用户可见变化：没导入的账户充值不收服务费和税费，没有任何提示；这部分余额退款时也只退净额
- 协作分工：提供 用户收集；执行 技术；核对 用户
- 时机：上线前
- 校验与验收：抽查已导入账户充值时服务费率不为 0（与导入的规则一致）；G-05-014
- 失败与回滚：同 D-00-57

## 5 非功能与埋点

- 权限：所有提交、撤回、查看在服务端校验（R-05-079、R-05-035、R-05-086、R-05-098）。
- 审计：分桶、交易明细只追加不删除；分桶、额度、提成版本都能追溯到来源审批单。
- 一致性：前后端同一计费口径；规则判定只调用 03。
- 通知文案（D-05-36）：
  - 停投：「【停投提醒】{公司名称}-{账户名称}（{所属账户系统}）可用资金已用完，账户已停投。当前余额 {账户余额} {币种}，授信额度 {授信额度} {币种}。{链接}」
  - 可用天数：「【余额提醒】{公司名称}-{账户名称}（{所属账户系统}）按昨日消耗 {昨日消耗} {币种} 估算，可用资金 {可用资金} {币种} 预计不足 {7 / 3} 天，请及时充值或调整额度。{链接}」
  - 可恢复投放（会议清单 D42，R-05-083）：「{公司名称}-{账户名称} 的{审批类型}单已{驳回 / 撤回 / 作废}，可用资金恢复为 {x} {币种}，可人工恢复投放。{链接}」
- 量级、性能：无依据，由技术沿用现有方案。
- 已知限制：
  - 余额分配转入按转入账户提交当天的规则重新定价（D-00-54），取出与转入两边的税费、服务费可能不对称；开票口径本期不做（会议清单 D96）。
  - 预付账单「已结算」后金额冻结，之后的消耗修正只影响余额、不回改账单，05 余额与 06 账单可能对不上（会议清单 D03）。
  - 停投后不自动恢复投放，靠人工（D-05-46）。
  - 结算汇率锁 4 位小数（D-00-74），人民币→USD / USDT 这类小于 1 的汇率有最多约万分之 3.6 的相对误差，待财务确认能否接受。
  - 返点余额 0 费率入桶（含覆盖欠费）的税务口径待财务确认（会议清单 D100）。
  - 后付期间账户剩余余额不能退，只能在后付结算单里抵扣，或等改回预付后再退（D-05-47）。
  - 预付改后付后，切换前的预付结算期欠费已冻结转入后付账单、或账单已结算冻结的，之后该结算期的消耗修正不再进入余额，也不参与分桶覆盖，由线下处理（R-05-001、R-05-118②、D-05-50；版本级收进 index §2.9，由总控登记）。

## 6 开放问题

| 编号 | 问题 | 需谁回答 | 卡谁 |
| --- | --- | --- | --- |
| Q-05-01 | 存量数据剩余待定项（第 4 节标「待定」处）：期初余额来源（旧系统余额 / 财务台账）与导入出错的重导方式（4.1），各项的提供 / 执行 / 核对人与量级；导入方式、期初余额基准日与费率快照、老额度、旧资金记录、提成规则导入已于 2026-10-22 按闭环清单 C01～C03 定（D-05-53，index §7 S-2～S-5） | 用户 + 财务 + 商务；技术负责人（量级、导入方式） | T-05-001、T-05-002 |

## 7 附录

### 7.1 决策

| 编号 | 决策点 | 结论 | 影响面 | 状态 |
| --- | --- | --- | --- | --- |
| D-05-01 | 费用明细 tab 与 06 的边界 | 05 画入口、tab、三层展开与按账户权限过滤；列口径、账单状态、出账、导出内容引用 06 | R-05-093；06 | 已定 |
| D-05-02 | 账户余额怎么算 | 动态计算 = 资金进出 − 累计消耗；历史消耗会被修正（如 10-21 发现 10-18 的消耗变了），余额随之变，不做冲正单据；实现方式由技术定 | R-05-001 | 已定 |
| D-05-03 | 后付款客户 | 后付款（以当前结算期的计费模式为准，D-00-73）不能充值、退款、余额分配（按钮隐藏）；调整额度照常（没有有效期）；预付改后付后留下的分桶照常显示余额，用于后付结算单余额抵扣、不退（D-05-47） | R-05-003、R-05-038、R-05-118 | 已定（2026-10-21 用户定，会议清单 D02 改写） |
| D-05-04 | 客户币种的含义 | 客户「币种」= 客户给我们结算的币种；账户消耗币种可以不同（如中国客户投出海产品） | R-05-002、R-05-024 | 已定 |
| D-05-05 | 交易明细生成时机 | 审批通过即生成：经 09 收付款的为「待完成」，09 完成后变「已完成」；余额分配、预付返点余额抵扣生成即「已完成」 | R-05-082、R-05-095 | 已定 |
| D-05-06 | 退款 / 取出的锁定 | 提交即锁定，驳回 / 撤回释放，审批通过扣减；汇出、到账只改交易明细状态 | R-05-007、R-05-082 | 已定 |
| D-05-07 | 分桶扣减顺序 | 消耗、退款、取出一律先进先出 | R-05-006、R-05-007 | 已定 |
| D-05-08 | 提成规则生效与上限 | 生效日期由提交人选（UTC0 日期），只能选当月 1 号及以后，同 03 规则起始日期；审批通过后按所选日期生效，跨月才通过也按所选日期（用户 2026-10-19：本月提成本来就没算完，不算回算）；提成上限 = 每人每自然月按该条规则算出的提成封顶。原「审批通过当天生效」作废 | R-05-073、R-05-075、R-05-108；11；D-00-41 措辞（已上报总控） | 已定 |
| D-05-09 | 余额与金额币种 | 余额、充值金额、退款余额、取出余额、额度都用账户消耗币种 | R-05-002 | 已定 |
| D-05-10 | 结算币种 | 充值弹窗加「结算币种」；金额按账户币种算，再按日汇率（D-00-74，锁 4 位）转成结算币种的应收 | R-05-024、R-05-025 | 已定 |
| D-05-11 | 同一客户的账户币种 | 同一客户下所有账户消耗币种相同，不处理混币种 | R-05-002 | 已定 |
| D-05-12 | 负余额、授信额度与停投 | 余额可为负 = 欠费；授信额度 = 客户打款慢时我们给的兜底；剩余额度用完要停投 + 通知，停投沿用后端现有逻辑 | R-05-009、R-05-014 | 已定 |
| D-05-13 | 弹窗里新增付款主体 | 「新增」= 打开 04 付款主体弹窗提交付款主体变更审批，通过前不能选 | R-05-042；04 | 已定 |
| D-05-14 | 提交到到账之间规则 / 区间变化 | 提交时锁定全部计算结果，到账不重算；按用户授权已改 D-00-58（原「到账当天」→「提交当天」） | R-05-018、R-05-029；index D-00-58 | 已定 |
| D-05-15 | 应收反算哪档都不成立 | 该行标红不能提交，提示可填范围；按充值金额计算不受影响 | R-05-020 | 已定 |
| D-05-16 | 退款结算币种 | 同充值：结算币种默认客户币种、可改，取日汇率（D-00-74），提交时锁定 | R-05-024 | 已定 |
| D-05-17 | 后付款剩余额度 | max(0, 额度 − 未结清消耗)；未结清消耗只算原始消耗（不含服务费、税费、服务费税费），范围 = 尚未「已结算」的后付账单 + 尚未出账、且所属结算期为后付款的日子（含出账日前的上月；切换前最后一个预付月出账前由分桶覆盖，不计入）；额度 > 0 且剩余额度 ≤ 0 停投 | R-05-013、R-05-014；06 | 已定（2026-10-21 用户定，会议清单 D06，与推荐「含费」不同；2026-10-22 用户与技术确认，闭环清单 A08：未出账日子限定为后付结算期） |
| D-05-18 | 停投通知与可用天数提醒 | 停投通知销售 + 优化师；另按前一天消耗预估可用天数，不足 7 天、不足 3 天各提醒一次 | R-05-015、R-05-016 | 已定 |
| D-05-19 | 反算尾差 | B 与三项各自四舍五入，和输入差出的尾差全部计入服务费，输入值为准；服务费率为 0 的行也可能出现 ±0.01 服务费，接受 | R-05-022 | 已定（2026-10-21 用户定，会议清单 D98，由代定转已定） |
| D-05-20 | 哪些入账清零额度 | 只有「账户充值」到账可能清零额度，且须满足 D-00-53 的条件（额度生效后才提交、到账后可用余额 > 0）；余额分配转入、返点余额抵扣、后付返点结转额不清零。依据：D-00-53 原文写的是充值到账 | R-05-011 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-21 | 返点余额抵扣分桶的费率 | 按服务费率 0、税率 0 入桶，退款 / 取出时不再乘费率 | R-05-005；07 | 已定（用户确认 2026-10-19） |
| D-05-22 | 「+ 新增付款主体」谁看得到 | 只有「客户管理-读写」的用户看得到；没有的人按 R-05-042 提示找有权限的同事 | R-05-042 | 已定（2026-10-21 用户定，会议清单 D31-路由与按钮、D45） |
| D-05-23 | 退款列名 | 原型「账户余额」改为「可用余额」，与上限口径一致 | R-05-051、R-05-056 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-24 | 后付款额度为 0 | 视为不限制、不因额度停投；后端现状（额度 0 也停投）按本条改 | R-05-014 | 已定（2026-10-21 用户定，会议清单 技术答复 T13 后补充决定） |
| D-05-25 | 列表排序的币种 | 昨日消耗合计直接按数值排，不折算 | R-05-036 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-26 | 余额分配同一账户 | 不能既取出又转入 | R-05-058 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-27 | 额度没改能否提交 | 不能，提示「额度未修改」 | R-05-065 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-28 | 提成两套规则怎么提交 | 销售、优化师一起提交一张单，通过后整份替换。依据：审批详情原型一张单同时展示两套 | R-05-067 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-29 | 提成适用账户的选项范围 | 该客户全部账户，不按操作人的账户查看权限过滤。依据：整份替换时避免误删他看不到的账户 | R-05-070 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-30 | 提成弹窗隐藏的「投放应用」面板 | 原型残留，不做 | R-05-074 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-31 | 弹窗备注与发起备注 | 弹窗里的备注即发起备注，同时在审批内容区展示，不再另弹备注框 | R-05-080 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-32 | 费用明细页标题 | 原型「费用中心/费用明细」统一为「费用管理/费用明细」 | R-05-092 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-33 | 充值审批内容的费率展示 | 原型隐藏的费率表并入账户列表（每行带规则起始日期、服务费率、税率、承担方） | R-05-102 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-34 | 审批内容区按权限隐藏账户行 | 不隐藏，审批要看全单。依据：R-12-044 由业务包决定 | R-05-107 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-35 | 费用单据是否单独设状态 | 不设：审批阶段看 12 审批单状态，通过后看交易明细状态（同 D-00-60 做法） | entities 费用单据 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-36 | 停投 / 提醒文案 | 按 notifications 段模板 | R-05-015、R-05-016 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-38 | 没有适用规则时的充值 / 余额分配 | 按 0 费率计算，分桶快照也是 0，照常提交，弹窗与审批内容区都不加提示（用户 2026-10-19：静默按 0）；出账、返点也按 0（D-00-57 已由 06 会话改） | R-05-005、R-05-017、R-05-049；「服务费」悬浮显示 0.00% 属数值展示，不算提示（会议清单 D44） | 已定 |
| D-05-39 | 提成规则与当前生效相同能否提交 | 允许，不拦（同 03 D-03-14）。依据：有了待生效版本后，可能要用原内容按某日期覆盖未来版本；原「提成规则未修改」拦截作废 | R-05-074 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-40 | 历史提成规则放哪 | 弹窗表单下方默认收起的「历史提成规则」区，同 03 历史规则 | R-05-111、R-05-112 | 已定（用户 2026-10-19） |
| D-05-41 | 待生效版本能否撤销 | 不能；要改就选同一个生效日期再提一版覆盖（原「或更早日期接替」不成立，更早的版本到期仍会被待生效版本接替） | R-05-110、R-05-117；flows 提成规则版本 | 已定（用户 2026-10-19；2026-10-21 措辞按会议清单 D99 修正） |
| D-05-37 | 权限点 | 「账户费用管理」（充值、退款、余额分配、调整额度）、「提成规则管理」（提成规则配置）只控制写操作；费用管理、费用明细两页按「费用管理（查看）」权限点显示（D-00-78），页面内数据按账户查看权限展示 | R-05-035、R-05-038；13 | 已定（费用管理.html:4848 §3.1.6；2026-10-21 按 D-00-78 补查看点） |
| D-05-42 | 收付款单编号与作废 | 交易明细「财务ID」即 09 收付款单编号（R-09-004）；收付款单作废 / 退回本期不做（D-00-69）；sys 兜底撤回只有充值收款单待完成、退款付款单待汇出两种，按 R-05-085 回退，交易明细加状态「已撤回」 | R-05-085、R-05-095、R-05-097；flows 交易明细 | 已定（2026-10-21 用户定，会议清单 D32；原 2026-10-20 结论补 sys 撤回） |
| D-05-43 | 费用管理、费用明细两页的页面访问 | 两页按「费用管理（查看）」权限点显示菜单，没有就无菜单、直接访问显示「无权限访问」；页面内数据按账户查看权限过滤；「账户费用管理」「提成规则管理」只控制写操作（D-00-78；原「对登录用户常显」作废） | R-05-035、R-05-038；13 | 已定（2026-10-21 用户定，会议清单 D86） |
| D-05-44 | 付款单完成回写到余额退款交易明细的列 | 实收金额 = 到账金额，打款凭证 = 付款单打款凭证，到账凭证 = 付款单到账凭证，完成时间 = 付款单完成时间，手续费显示「-」。依据：R-09-071 回写字段、交易明细各列由 05 定；付款差额只在 09 记录（D-10-05）。风险：交易明细看不到汇出金额与差额，要到 09 付款单查 | R-05-085、R-05-097 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-45 | 有审批中的提成规则单时能否查看 | 打开只读弹窗：展示当前生效版本、全部禁用、隐藏生效日期与提交，历史提成规则照常可展开；其余四类仍不打开弹窗（原开放问题第 7 条关闭） | R-05-077、R-05-111 | 已定（2026-10-21 用户定，会议清单 D48） |
| D-05-46 | 停投判定时机与恢复投放 | 停投条件按 R-05-014（后付额度 0 不停投、未结清按原始消耗、不另扣未到款，后端按此改）；锁定与释放、到账、额度变化与到期、消耗更新时即时判断，另有定时兜底；不自动恢复投放，释放锁定后可用资金 > 0 时通知销售与优化师人工恢复（原开放问题第 2 条关闭） | R-05-014、R-05-078、R-05-083；notifications | 已定（2026-10-21 用户定，会议清单 D42、技术答复 T13） |
| D-05-47 | 预付改后付对本页余额的细节（D-00-73 之下） | ①后付期间仍不显示退款，剩余分桶只用于后付结算单余额抵扣；②按 R-06-074 冻结、转入后付账单的欠费消耗移出账户余额（冻结时不属于任何分桶的那部分消耗从余额计算中剔除，D-05-50），避免改回预付后被新分桶再覆盖一次；③在途账户充值照常到账成桶，按 D-00-73① 保留；④余额抵扣不足全部分桶时，最后一桶按快照费率反算取用本金：余额抵扣金额以剩余应收为准，最后一桶本金 = round2(所需金额 ÷ 倍率)、不超过该桶剩余，尾差计入该账户行余额抵扣的服务费，同 R-05-022（2026-10-22 用户与技术确认，闭环清单 B02）。依据：D-00-73 与会议清单 D02 用户方案只写了充值、余额分配隐藏和余额抵扣，未写退款与欠费在余额里的去向；风险：后付期间客户要退剩余余额只能等改回预付。2026-10-21 用户确认维持：改后付后「退款」仍隐藏、剩余余额只用于后付结算单余额抵扣（①）；审批期间客户改为后付的充值单照常通过到账、不算执行失败（③、R-05-082） | R-05-003、R-05-009、R-05-118 | 已定（2026-10-21 用户确认，由代定转已定） |
| D-05-48 | 退款 / 取出与充值的提交复核 | 退款、取出改为服务端预算后在确认框回显新金额，金额变了不拒单、请用户再确认；充值与转入侧计算变化时就地重载标黄、不关弹窗；只有汇率变时确认是否按新汇率提交（原「关闭弹窗重新打开」作废） | R-05-026、R-05-052、R-05-059、R-05-114 | 已定（2026-10-21 用户定，会议清单 D07、D35，A 档按推荐） |
| D-05-49 | 额度调整的写入范围与有效期过期 | 只把额度或有效期改了的账户写进单，通过时只写单内账户；最后通过时单内账户有效期已早于通过当天，按 D-00-79① 回滚，提示驳回后重新提交 | R-05-080、R-05-082、R-05-104 | 已定（2026-10-21 用户定，会议清单 D43、D26） |
| D-05-50 | 预付改后付前后的分桶覆盖与欠费冻结（D-00-73 之下） | ①生效后，切换前最后一个预付月在出账判结清或冻结之前，分桶照常按先进先出覆盖它，包括期间补报的消耗、释放的锁定分桶、新到账的充值；欠费冻结之后的消耗以及生效月起的消耗不再被分桶覆盖；②冻结时，不属于任何分桶的那部分消耗从余额计算中剔除（原「余额的负数部分归 0」作废）；已冻结转入后付账单、或已结算冻结的切换前月份，之后的消耗修正不再进余额、也不再参与分桶覆盖，线下处理；③冻结的欠费在下一张后付账单生成时挂上，挂上前客户又改回预付的，解除冻结，欠费退回余额，原账单重新按 R-06-022 判结清；④生效时还在审批中的 07 预付返点余额抵扣，通过后按提交时的快照成桶（0 费率），之后按 R-05-118① 保留 | R-05-001、R-05-003、R-05-006、R-05-009、R-05-013、R-05-118；06 R-06-074 | 已定（2026-10-22 用户与技术确认，闭环清单 A06、A07、A08、B03） |
| D-05-51 | 计费模式切换时的授信额度 | 切换生效时额度值、有效期、来源审批单原样保留；预付期设的有效期照常到期清零；后付期不新设有效期；跨切换生效才通过的额度调整，按通过那一刻的计费模式写入，是后付就丢弃有效期；改回预付后判断「额度生效之后才提交的充值」时，额度生效时刻仍取原审批通过时刻 | R-05-011、R-05-012、R-05-062、R-05-118⑤ | 已定（2026-10-22 用户与技术确认，闭环清单 A09） |
| D-05-52 | 费用审批详情第②类查看资格 | 账户充值、充值退款、额度调整、余额分配按账户查看权限看详情时，要求同时持「费用管理（查看）」；申请人和快照里的审批人不受影响（R-12-043①） | R-05-086；12 R-12-043；13 | 已定（2026-10-22 用户与技术确认，闭环清单 B10） |
| D-05-53 | 存量数据处理（index S-2～S-5） | ①期初余额基准日 = 上线月 1 日 00:00（UTC0），与 S-18 共用同一个配置；期初余额 ≤ 0 的账户不建期初桶，余额从 0 起，负数部分出清单交财务线下追收；期初桶费率快照按 0；迁移核对完成前停投开关保持关闭；②老额度按上线时刻生效的长期额度导入，之后按 R-05-011 的条件清零；③过渡期的旧资金记录不导入，交易明细从上线起记，旧记录看旧报表；④上线前导入的提成规则不受 R-05-108「最早当月 1 号」限制，生效日期 = 上线月 1 日，关联审批单号显示「上线导入」，S-5 数据由商务按客户提供两套规则清单 | §4.1～§4.4、R-05-005、R-05-010、R-05-108、R-05-112；Q-05-01 | 已定（2026-10-22 用户与技术确认，闭环清单 C01、C02、C03） |

### 7.2 实现任务

| 编号 | 任务 | 依赖 | 完成判据 |
| --- | --- | --- | --- |
| T-05-001 | 分桶与账户余额：资金入账生成分桶、先进先出扣消耗、锁定 / 释放 / 扣减、可用余额、负余额、计费模式切换（R-05-001～R-05-009、R-05-118） | — | G-05-001～G-05-004、G-05-062、G-05-072、G-05-073 通过 |
| T-05-002 | 授信额度、剩余额度、停投判定与通知、可用天数提醒（R-05-010～R-05-016） | T-05-001 | G-05-005～G-05-010、G-05-063、G-05-065、G-05-070 通过；停投动作调用现有逻辑 |
| T-05-003 | 计费口径：取规则、落行、正算 / 反算落档、舍入与尾差、结算币种与汇率、分桶倒推、提交快照、试算（R-05-017～R-05-029、R-05-113） | T-03-002、T-05-001 | G-05-011～G-05-017、G-05-061、G-05-071、G-05-082 通过；不另写规则判定 |
| T-05-004 | 费用信息列表：搜索、筛选、客户 / 账户两级、金额列、数据权限、排序分页、按权限点显示操作（R-05-030～R-05-040） | T-05-001、T-05-002 | G-05-018～G-05-021、G-05-069、G-05-078 通过 |
| T-05-005 | 账户充值弹窗与弹窗账户范围（R-05-041～R-05-049、R-05-115） | T-05-003、T-04-006 | G-05-022、G-05-025～G-05-028、G-05-079 通过 |
| T-05-006 | 充值退款弹窗（R-05-050～R-05-054） | T-05-003 | G-05-029、G-05-030、G-05-064 通过 |
| T-05-007 | 余额分配弹窗（R-05-055～R-05-061） | T-05-003 | G-05-032、G-05-033、G-05-035、G-05-067 通过 |
| T-05-008 | 调整额度弹窗（R-05-062～R-05-065） | T-05-002 | G-05-036～G-05-038、G-05-066、G-05-084 通过 |
| T-05-009 | 提成规则配置弹窗、生效日期、提成规则版本与历史提成规则（R-05-066～R-05-075、R-05-108～R-05-112、R-05-116、R-05-117） | — | G-05-039～G-05-042、G-05-053～G-05-058、G-05-068、G-05-074、G-05-075、G-05-081 通过；11 能按日取版本 |
| T-05-010 | 提交审批、服务端复核与预算回显、审批结果处理、与 09 收付款单联动（R-05-076～R-05-086、R-05-114） | T-05-005、T-05-006、T-05-007、T-05-008、T-05-009、T-12-004、T-12-006 | G-05-023、G-05-024、G-05-031、G-05-034、G-05-041、G-05-076、G-05-077 通过 |
| T-05-011 | 已提交审批 tab（R-05-087～R-05-091） | T-12-005 | G-05-043、G-05-044 通过 |
| T-05-012 | 费用明细页与交易明细（R-05-092～R-05-100） | T-05-010、T-06-004 | G-05-045～G-05-047、G-05-060、G-05-080 通过；费用明细 tab 复用 06 账单信息（R-06-032），G-06-015 同时通过 |
| T-05-013 | 5 类审批内容区、额度变更高亮、查看判断（R-05-101～R-05-107） | T-05-010、T-12-007 | G-05-048～G-05-052、G-05-059、G-05-083 通过 |

### 7.3 原型出处

- 费用管理.html:4848（标签、搜索、列表、权限、余额分配）、:4856（余额分配充值侧、账户充值）、:4864（充值、退款、额度、提成规则）。
- 费用明细.html:3612（费用明细 / 交易明细）。
- 审批详情-费用管理.html（5 类审批内容区；提成规则一张单含销售 + 优化师）。
