⚠ 5 项未定,先别开跑:Q-07-01 "【已关闭 2026-10-22 → D-07-32:只对结算期 ≥ 上线月的月份产生计提项,上线月与 06、08、10、11 共用 index S-18 的配置(S-17 定掉)】原问题:存量:上线前的月份要不要产生计提项?存量规则导入后起始日期早于上线时,系统会把线下可能已结过的月份算成「待结算」。可选:只从上线当月起算 / 之前也算但加「标记线下已结」/ 导入历史已结记录(用户说要和财务商量,index S-17)"Q-07-02 "【已关闭 2026-10-21 → D-07-25:MAX = 出价策略 MAX_CONVERSIONS,按天按系列可拆,从上线起记录策略变更(技术答复 T14)】原问题:MAX 类型广告系列在现有数据里怎么识别"Q-07-03 "【已关闭 2026-10-20】09 付款单作废 / 退回时,「待打款」的计提项回到哪个状态、交易明细怎么处理。结论:本期收付款单不作废、不退回(D-00-69),本页不做回退,见 D-07-24、R-07-059"Q-07-04 "【已关闭 2026-10-20】12 能否支持业务包在「最终通过」时否决(R-07-061)。结论:最后通过时不复核、照常生效;2026-10-21 起账单为负由 06 结转(D-00-81),本包没有最终通过失败情形(D-00-79),见 D-07-20、R-07-061"Q-07-05 "【已关闭 2026-10-21 → 用户确认 D-07-12、D-07-18、D-07-19、D-07-22 全部转已定】原问题:仍为由我代定、评审时确认:D-07-12、D-07-18(除应付记正数外)、D-07-19、D-07-22(D-07-13~D-07-17、D-07-21、D-07-23 已于 2026-10-21 由用户定)"
返点管理 PRD
| 项 | 内容 |
|---|
| 所属产品 | ASA |
| 版本 | v2.1.0 |
| 页面 | 07-返点管理 |
| 涉及功能 | 返点管理(feature 台账由总控登记) |
| 编制日期 | 2026-10-19(2026-10-21 总控代改:按会议清单 v2 回写;2026-10-22 总控代改:按闭环问题清单回写) |
| 文档状态 | 待评审 |
| 目标读者 | 研发、测试、AI 实现助手(本文件可直接整份投喂给 AI 作为实现依据) |
| 关联文档 | 本目录 spec.yaml、mocks/;版本 index.md;原型 html/返点管理.html、html/审批详情-返点管理.html(均无 V2.1 注释);决策来源《财务v2.1.0_会议清单v2》 |
0 前置说明
1 整体概述
1.1 背景与目标
现状:返点只有原型画面,返点怎么算(MAX 怎么扣、阶梯按什么落档、90 天怎么截)、什么时候能结、一张单能结什么、后付抵扣和现金打款各怎么走、结完以后数据变了怎么办,都没写。
目标:
- 系统按账户 × 月自动算出客户返点和客情费用,口径和 03 规则配置、06 账单一致。
- 每月 2 日账单出账后,商务按客户勾选要结的账户 × 月,按实际情况改金额,选余额抵扣(预付充余额、后付抵账单)或现金打款(换成结算币种、走付款),审批后自动落到余额、账单或付款单。
- 每个账户每个月返点 / 客情「结没结完」有明确状态,10 / 11 能据此判断「算没算完」。
可证伪的判定:公共前置下 2026-10-05,橙子 9 月 C 返点 300.00、D 返点 90.00(扣 MAX 后落第 1 档)、C 客情 200.00;把 C 的 300.00 余额抵扣到 9 月账单并审批通过后,账单总计 35,040.00(与 G-06-001 一致);C 客情 200.00 现金打款成人民币,应付 1,424.68。
1.2 本页范围
- ✅ 包含:计提项计算与状态机;返点管理页(返点信息 / 已提交审批);客户返点弹窗、客情费用弹窗;提交审批、服务端复核与审批结果处理;两类审批内容区。
- ❌ 不包含:规则配置(03);账单金额、可扣减判断与结转本身(06);分桶与交易明细实体(05);付款单执行(09);审批引擎(12);导出(D-07-23);10 / 11 怎么用返点;上线月之前的月份(不产生计提项,R-07-001)。
1.3 角色与权限
| 角色 | 能做什么 | 不能做什么 | 权限来源 |
|---|
| 有「返点管理(查看)」权限点的用户 | 看到返点管理菜单与页面;「返点结算」「客情结算」依赖它 | — | D-00-78、D-13-01(R-07-021) |
| 有「返点结算」权限点的用户 | 发起客户返点(余额抵扣 / 现金打款) | 结他看不到的账户 | 新增权限点(D-07-21,13 汇总) |
| 有「客情结算」权限点的用户 | 发起客情费用(现金打款) | 结他看不到的账户 | 新增权限点(D-07-21,13 汇总) |
| 申请人本人 | 撤回自己的审批中单(不校验业务权限点) | — | D-00-79(R-07-065) |
| 有「审批配置」权限点的用户 | 在审批详情作废审批中的单(效果同撤回) | — | D-00-79(R-07-060) |
| 能看到某账户的用户 | 看到含该账户的客户与该账户计提项;同时持「返点管理(查看)」时只读查看含该账户的两类审批详情(R-07-071) | 看没有权限的账户行与金额 | 现有账户查看权限(R-07-021) |
| 有「收付款中心」权限点的用户 | 只读查看客户返点、客情费用两类审批详情(R-07-071) | 通过 / 驳回 / 撤回;不因此获得返点管理页访问权 | D-00-71、R-13-050 |
| 审批人 | 通过 / 驳回 | 改审批内容 | 12 |
| 系统 | 计算计提项,按出账、数据修正、审批结果、付款完成推进状态 | — | R-07-001~R-07-019 |
1.4 术语定义
| 术语 | 释义 |
|---|
| 计提项 | 一个账户一个 UTC0 自然月的一笔客户返点或客情费用,是本页结算的最小单位(R-07-001) |
| 计提天数 | 当月里该算返点 / 客情的日子:返点 = 消耗首日起第 1~90 天内、且当天有适用规则的日子;客情按当天规则的客情结算方式(R-07-002、R-07-005) |
| 系统计算金额 | 系统按规则算出的金额(R-07-004、R-07-006) |
| 实际金额 | 进单时用户填的金额,默认 = 系统计算金额,可改(D-07-04) |
| MAX 消耗 | 当天出价策略为 MAX_CONVERSIONS 的广告系列的消耗,返点基数要扣掉(D-00-15、R-07-007) |
| 客户返点单 / 客情费用单 | 一次提交审批的业务单据,含若干计提项(D-07-03) |
| 余额抵扣 | 本页的返点兑现方式之一:预付充进账户余额;后付计入「纳入扣减月份」那张账单的客户返点(D-00-18、D-00-19);与 06 结算单里的「余额抵扣」行(D-00-73)不是一回事 |
| 现金打款 | 换算成结算币种,审批通过生成 09 付款单(D-07-06) |
| 收款主体 | 现金打款时收钱的客户一方主体,选项取客户当前生效的付款主体(D-07-29) |
| 日汇率 | 当天 UTC 00:17 从系统汇率源取的那一次价格;结算锁定 4 位(D-00-74) |
1.5 核心流程
| 步骤 | 操作者 | 系统行为 | 产物 |
|---|
| 1 | 系统 | 账户当月有消耗即生成计提项「未出账」,实时预估 | 计提项(未出账) |
| 2 | 系统 | 次月 2 日该月账单出账(06)→ 金额 > 0 待结算,= 0 无返点 / 无客情 | 计提项(待结算 / 无返点) |
| 3 | 有权限点的用户 | 在客户行点「客户返点」/「客情费用」,勾选账户 × 月,按需改金额,选方式,提交审批 | 客户返点单 / 客情费用单、审批单(12);计提项审批中 |
| 4 | 审批人 | 通过:预付抵扣入分桶 / 后付抵扣计入账单 → 已结算;现金 → 生成 09 付款单 → 待打款;合计 0 → 直接已结算。驳回 / 撤回 / 作废 → 回待结算 | 分桶 / 交易明细(05)、账单返点(06)、付款单(09) |
| 5 | 财务 | 09 确认汇款后计提项仍「待打款」;确认到账、付款单「已完成」→ 计提项已结算(R-07-059) | — |
| 6 | 系统 | 10 / 11 读计提项实际金额与完成状态 | — |
2 详细需求
2.1 计提项与金额计算(定义)
2.1.1 功能描述
定义一个账户一个月的客户返点、客情费用怎么算。列表、弹窗、审批内容、10、11 都用这里的结果。
2.1.2 核心字段
| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|
| 种类 | kind | enum | 是 | 客户返点 / 客情费用 | — | R-07-001 |
| 账户 | account_id | 关联账户(02) | 是 | — | — | 所属客户添加后不变(R-07-012) |
| 结算期 | period | string(7) | 是 | yyyy-mm(UTC0 自然月) | — | 展示「yyyy-mm-01 至 yyyy-mm-最后一天」 |
| 币种 | currency | enum | 是 | 人民币 / USD / USDT | — | 账户消耗币种(R-05-002) |
| 消耗金额 | month_consumption | decimal(2),账户币种 | 是 | — | — | 全月消耗(R-07-008) |
| 时间范围 | accrual_ranges | 列表 | 否 | 「yyyy-mm-dd 至 yyyy-mm-dd」 | — | 计提天数合并的连续段(R-07-002、R-07-005) |
| 范围内消耗 | range_consumption | decimal(2),账户币种 | 是 | — | — | 扣 MAX 前(R-07-008) |
| MAX消耗 | range_max | decimal(2),账户币种 | 否 | — | — | 仅客户返点(R-07-007) |
| 计算分段 | segments | 列表 | 否 | 日期段 + 规则(含规则起始日期)+ 比例 + 基数 + 金额 | — | R-07-003 |
| 系统计算金额 | calc_amount | decimal(2),账户币种 | 是 | ≥ 0 | — | R-07-004、R-07-006 |
| 状态 | status | enum | 是 | 未出账 / 待结算 / 无返点 / 无客情 / 审批中 / 待打款 / 已结算 | 未出账 | 2.2 |
| 实际金额 | actual_amount | decimal(2),账户币种 | 否 | ≥ 0 | — | 进单后才有(D-07-04) |
| 结算时间 | settled_at | datetime(秒;存储为时间戳,展示北京时间 Asia/Shanghai) | 否 | — | — | 变已结算的时间(D-07-35) |
2.1.3 业务规则
- R-07-001 计提项:每个账户在每个 UTC0 自然月各有一条「客户返点」和一条「客情费用」计提项,从该账户当月第一天有消耗起产生;全月消耗为 0 的账户不产生。只对结算期 ≥ 上线月的月份产生,上线月与 06 出账、08、10、11 共用一个配置(index S-18;S-17 定为只从上线月起),上线月之前的月份不产生计提项(D-07-32)
- R-07-002 返点计提天数 = 当月里落在该账户消耗首日起第 1~90 天(含第 90 天)内、且当天有适用规则的日子(R-03-005、R-03-007、D-00-56);没有适用规则的日子不算进计提天数,也不算进返点时间内消耗金额和 MAX消耗;显式配置为 0% 的日子照常算进去(D-07-26);消耗首日首次确定后冻结,未确定时没有计提天数,早于首日的日子不计提。「返点时间范围」= 计提天数按连续日期合并成的段,每段「yyyy-mm-dd 至 yyyy-mm-dd」;没有计提天数显示「-」
- R-07-003 分段:对计提天数里的每一天按 R-03-003 取该账户的适用规则(已出账计提项以该月出账时刻为 t,D-03-24),连续日子里适用条款相同的为一段:返点看返点比例设置,客情看客情结算方式与客情比例设置,两段条款完全相同就合并成一段再落档(D-00-55、D-07-26);没有适用规则的日子不进计提天数(R-07-002、R-07-005)
- R-07-004 客户返点金额:每段基数 = 段内消耗 − 段内 MAX 广告系列消耗,小于 0 按 0(D-00-15)。返点比例为固定比例 → 基数 × 比例;阶梯 + 按月统计 → 段基数(扣 MAX 后,D-07-01)按 R-03-009 落一档 × 该档比例;阶梯 + 按日统计 → 每天的(当日消耗 − 当日 MAX,小于 0 按 0)各自落档 × 该档比例;落档用未舍入的原始金额(D-00-13)。每段(按日统计时每天)四舍五入到 2 位后相加 = 系统计算金额,币种为账户消耗币种
- R-07-005 客情计提天数:逐日看当天适用规则的客情结算方式(R-03-008)——无客情 → 不计提;首次消耗起 90 天 → 当天在消耗首日起第 1~90 天内才计提;按自然月每月返还 → 当天计提;没有适用规则 → 不计提。「客情时间范围」= 计提天数按连续日期合并成的段,每段一行;没有计提天数显示「-」
- R-07-006 客情费用金额:客情计提天数按 R-07-003 分段,每段基数 = 段内全部消耗,不扣 MAX(D-00-20);客情比例固定 → 基数 × 比例;阶梯 → 段基数落一档 × 该档比例(客情一律按自然月口径,D-00-22、R-03-010);每段四舍五入到 2 位后相加 = 系统计算金额
- R-07-007 MAX 广告系列消耗(MAX 消耗口径以本条为准,08 等页引用)= 账户当天出价策略为 MAX_CONVERSIONS 的广告系列的消耗,按当天的策略识别:从上线起记录广告系列出价策略的变更,一天内改过策略的按该天 UTC0 结束时同步到的策略计整天;上线前的日子按上线时的当前策略计(index S-23)(D-07-25)
- R-07-008 列口径:消耗金额 = 账户全月消耗;返点时间内消耗金额 / 客情时间内消耗金额 = 各自计提天数内的消耗(扣 MAX 前),没有计提天数为 0.00;MAX消耗 = 返点计提天数内的 MAX 广告系列消耗,没有计提天数显示「-」。金额千分位、2 位小数(D-00-13)
- R-07-009 没进单的计提项(未出账、待结算、无返点、无客情)随最新数据重算:消耗修正、MAX 数据修正、消耗首日首次确定。规则按 R-03-003 取:未出账的以当前时刻为 t,已出账的以该月账单出账时刻为 t,出账后才审批通过的规则不作用于该月(R-03-011,D-03-24、D-07-13)
- R-07-010 冻结:计提项被提交进单时,系统计算金额、时间范围、范围内消耗、MAX消耗、分段与比例(含规则起始日期)都存进单据快照;在单期间(审批中、待打款、已结算)页面一律显示快照与单内实际金额,之后的数据修正、规则变化都不改它,也不补差(D-07-07)
- R-07-011 列表中计提项显示的金额:进了单的显示实际金额(D-07-04);未出账显示实时预估的系统计算金额,状态旁悬浮「金额为实时预估,随消耗数据更新,数据截至 yyyy-mm-dd hh:mm(UTC0)」(截至时间取消耗数据最近一次同步的时间,技术取不到时去掉后半句,D-07-30);其余显示系统计算金额;无返点 / 无客情显示 0.00
- R-07-012 账户的所属客户添加后不能改(R-02-017),本页不设计计提项跟随换客户 / 换账户系统的规则;技术后台改数据按数据修复处理(D-07-14)
2.1.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|
| 账户还没有消耗首日 | 没有计提天数 | 返点 / 客情按 0(R-07-002) | 时间范围「-」,无返点 / 无客情 |
| 当月部分日子没有规则 | 不进计提天数 | 不算进时间范围与范围内消耗(R-07-002) | 无提示(D-00-57) |
| 规则显式配 0% | 照常计提 | 算进时间范围,金额 0(R-07-002) | 时间范围含这些日子 |
| 月中切规则、条款不同 | 两段不同比例 | 各段分别落档后相加(R-07-004) | 审批内容区比例分两行 |
| 月中切规则、条款相同 | 只改了别的部分 | 合并成一段落档(R-07-003) | 比例一行 |
| MAX 消耗大于当天 / 当段消耗 | 基数为负 | 按 0(R-07-004) | 该段 0.00 |
| 出账后才通过的规则 | 起始日期落在已出账月份 | 不回算(R-07-009) | 金额不变 |
| 补报了早于消耗首日的消耗 | 首日已冻结 | 首日不变,那几天不计提(R-07-002) | — |
| 已进单后消耗修正 | 金额冻结 | 不改、不补差(R-07-010) | 显示单内金额 |
2.1.6 验收标准
公共前置见 spec.yaml 文件头(橙子 C / D 后付、星海 A 预付、2026-10-05 日汇率 1 USD = 7.1234 人民币)。
- G-07-001 前置:公共前置。操作:2026-10-05 在返点信息展开橙子 → 2026-09 → C。期望:C 行:消耗 20,000.00、MAX消耗 5,000.00、返点时间范围「2026-09-01 至 2026-09-30」、返点时间内消耗 20,000.00、客户返点 300.00((20,000 − 5,000) × 2%)、客情时间范围「2026-09-01 至 2026-09-30」、客情时间内消耗 20,000.00、客情费用 200.00;两个状态都是待结算。
- G-07-002 前置:公共前置。操作:看橙子 2026-09 的 D 行。期望:扣 MAX 后基数 9,000.00 落 [0, 10,000.00) 档 → 客户返点 90.00(不是按 12,000.00 落第 2 档的 180.00);客情费用 0.00、状态「无客情」。
- G-07-003 前置:公共前置;2026-11-02 已出 10 月账单。操作:看橙子 2026-10 的 C 行,并打开客户返点弹窗勾选它。期望:客户返点 490.00(10-01~10-15 (9,000 − 1,000) × 2% = 160.00;10-16~10-31 11,000 × 3% = 330.00)、返点时间范围「2026-10-01 至 2026-10-31」一段;客情费用 200.00;提交后审批详情「客户返点比例」两行:「2026-10-01 至 2026-10-15:固定 2.00%(规则起始 2026-09-01)」「2026-10-16 至 2026-10-31:固定 3.00%(规则起始 2026-10-16)」。
- G-07-004 前置:公共前置;2026-11-02 已出 10 月账单,2026-12-02 已出 11 月账单,D 11 月消耗 8,000.00。操作:看 D 的 2026-10、2026-11 行。期望:10 月:返点时间范围「2026-10-01 至 2026-10-07」、返点时间内消耗 2,800.00、消耗金额 11,800.00、客户返点 28.00;11 月:返点时间范围「-」、返点时间内消耗 0.00、MAX消耗「-」、客户返点 0.00、状态「无返点」。
- G-07-005 前置:公共前置(C 在 2026-09-01 前没有规则)。操作:看橙子 2026-08 的 C 行。期望:没有适用规则的日子不进计提天数:返点时间范围「-」、返点时间内消耗 0.00、MAX消耗「-」、客户返点 0.00、状态「无返点」;客情时间范围「-」、客情费用 0.00、状态「无客情」;消耗金额 4,000.00;页面无任何「无规则」提示。
- G-07-006 前置:账户 F 消耗首日 2026-09-01,规则返点 阶梯 按日统计 [0, 500.00) 1.00%、[500.00, 不限) 2.00%;2026-09 只有两天消耗:9-03 600.00(MAX 200.00)、9-04 800.00(MAX 0)。操作:10-02 出账后看 F 的 2026-09。期望:客户返点 20.00(9-03 基数 400.00 × 1% = 4.00;9-04 800.00 × 2% = 16.00)。
- G-07-007 前置:公共前置;2027-01-02 已出 12 月账单。操作:看星海 2026-12 的 A 行。期望:返点时间范围、客情时间范围都是「2026-12-01 至 2026-12-10」,返点 / 客情时间内消耗 1,000.00、消耗金额 3,100.00;客户返点 15.00、客情费用 5.00。
2.2 计提项状态(定义)
2.2.1 功能描述
计提项状态机,以及给 10 / 11 的「完成」口径和取数口径。
2.2.3 业务规则
- R-07-013 该月账单出账前(当月,以及上月在次月 2 日出账前)计提项为「未出账」,只展示预估、不能勾选;该账户该月账单按 R-06-001 出账后:系统计算金额 > 0 → 待结算,= 0 → 客户返点「无返点」/ 客情费用「无客情」(D-07-02、D-07-11)
- R-07-014 待结算与无返点 / 无客情之间随 R-07-009 重算自动切换;只有「待结算」能被勾进单
- R-07-015 同一条计提项同一时间只能在一张单里;审批中、待打款、已结算的计提项不再出现在弹窗里
- R-07-016 审批通过后:余额抵扣(预付或后付)→ 已结算;现金打款 → 待打款,09 付款单「已完成」(确认到账)后 → 已结算;合计为 0 的单 → 直接已结算(R-07-055~R-07-059、R-07-072)
- R-07-017 「完成」口径(供 10、11 判断「算没算完」,D-00-65):客户返点计提项为「已结算」或「无返点」、客情费用计提项为「已结算」或「无客情」即为完成;未出账、待结算、审批中、待打款都是未完成
- R-07-018 10、11 计算利润、提成时取:已进单的计提项用实际金额,其余用系统计算金额(D-07-04「按实际的来」);计提项的实际金额或状态变化时 10、11 按 D-00-66 处理(X-6)
- R-07-019 状态展示:账户行「客户返点状态」「客情费用状态」直接显示状态名
2.2.4 状态与流转
状态清单:未出账、待结算、无返点(客户返点)、无客情(客情费用)、审批中、待打款、已结算。
| 当前状态 | 触发动作 | 操作者 | 目标状态 | 前置条件 |
|---|
| 无 | 账户当月第一天有消耗 | 系统 | 未出账 | R-07-001 |
| 未出账 | 该月账单出账,系统金额 > 0 | 系统 | 待结算 | R-07-013 |
| 未出账 | 该月账单出账,系统金额 = 0 | 系统 | 无返点 / 无客情 | R-07-013 |
| 待结算 ⇄ 无返点 / 无客情 | 数据修正后金额在 0 与非 0 之间变 | 系统 | 对应状态 | R-07-014 |
| 待结算 | 勾进单并提交审批 | 有权限点的用户 | 审批中 | R-07-050~R-07-052 |
| 审批中 | 通过,余额抵扣 | 系统 | 已结算 | R-07-055、R-07-056 |
| 审批中 | 通过,现金打款且合计 > 0 | 系统 | 待打款 | R-07-057 |
| 审批中 | 通过,合计 = 0(任一方式) | 系统 | 已结算 | R-07-058、R-07-072 |
| 待打款 | 09 付款单已完成(确认到账;确认汇款后仍待打款) | 系统 | 已结算 | R-07-059 |
逆向:驳回 / 撤回 / 作废 → 回待结算并重算(R-07-060);09 付款单本期不作废、不退回(D-00-69),待打款只能等付款单已完成;已结算不能撤销,之后数据修正不补差(D-07-07)。
2.2.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|
| 账单还没出账就想结 | 未出账 | 不进弹窗(R-07-013) | 列表显示预估,悬浮数据截至时间 |
| 待结算的计提项数据修正后变 0 | 无返点 | 自动切换(R-07-014) | 不再出现在弹窗 |
| 两人同时勾同一计提项 | 第二个提交时已审批中 | 复核失败、就地重载(R-07-051) | 该行取消勾选并标「状态已变化」 |
| 付款单一直没确认到账 | 待打款 | 本期付款单不作废(D-00-69),计提项保持待打款、算未完成(R-07-017) | 待打款 |
2.2.6 验收标准
- G-07-010 前置:公共前置。操作:2026-10-01 看橙子 2026-09;2026-10-02 出账后再看。期望:10-01:C、D 的 9 月计提项都是「未出账」,金额为预估,状态旁悬浮「金额为实时预估,随消耗数据更新,数据截至 …(UTC0)」,弹窗里不出现;10-02 起:C 返点、客情待结算,D 返点待结算、客情无客情;2026-10 的计提项为「未出账」。
- G-07-011 前置:公共前置,C 9 月计提项待结算。操作:2026-10-06 C 的 9-20 消耗修正 +500.00。期望:C 客户返点变 310.00、客情费用 205.00,状态仍待结算;若此时 C 9 月返点已在一张审批中的单里,则仍显示 300.00,不变。
- G-07-012 前置:王敏已提交含 C 9 月返点 300.00 的单(审批中),随后 C 9-20 消耗修正 +500.00。操作:审批人驳回。期望:C 9 月返点回到待结算、显示 310.00;弹窗里重新出现。
2.3 返点信息列表
2.3.1 功能描述
按客户 → 结算期 → 账户三层展示返点与客情,客户行有「客户返点」「客情费用」两个入口。
2.3.3 业务规则
- R-07-020 页面标题「返点管理」,两个切换「返点信息 / 已提交审批」,默认返点信息(原型标题「返点中心」、tab「费用信息」统一改名,D-07-22);菜单与页面准入见 R-07-021
- R-07-021 菜单与页面按「返点管理(查看)」权限点显示:没有该点不显示菜单,直接访问按 R-13-005 在内容区显示「无权限访问」、保留当前地址;「返点结算」「客情结算」两个权限点依赖该查看点,服务端同样校验(D-00-78、D-13-01)。数据权限跟账户查看权限走:用户对客户下任一账户有查看权限才展示该客户;第二、三层与所有汇总金额只算他有权限的账户(D-07-21)
- R-07-022 搜索框按公司名称、客户别名、账户名称、orgId 包含匹配,占位「搜索公司名称 / 客户别名 / 账户名称 / orgId」;账户名称和 orgId 只在当前用户有查看权限的账户里匹配,由服务端过滤;命中账户时展示该客户,下面照常列全部可见账户(D-07-23);筛选 所属账户系统(全部 + 现有账户系统列表;原型选项是登记表状态,复制残留,第二个同名下拉不做)、计费模式(全部 / 预付款 / 后付款,按客户当前生效的计费模式筛),默认全部
- R-07-023 第一层每个客户一行,列依次:公司名称、所属账户系统、计费模式、客户别名、销售、累计客户返点金额、待结算客户返点金额、累计客情费用、待结算客情费用、处理中客户返点金额、处理中客情费用、操作;所属账户系统、计费模式、客户别名、销售取客户当前值;有待生效的计费模式变更时计费模式显示「{当前生效值}({yyyy-mm-dd} 起改为{目标值})」,同 R-04-067(D-00-73);公司名称过长省略、悬浮显示全称;金额后带账户消耗币种(如「390.00 USD」);两个「处理中」列表头悬浮「审批中 + 待打款」(D-07-15)
- R-07-024 累计客户返点金额 / 累计客情费用 = 该客户可见账户「已结算」计提项的实际金额之和;待结算客户返点金额 / 待结算客情费用 = 状态为「待结算」的计提项系统计算金额之和;处理中客户返点金额 / 处理中客情费用 = 状态为审批中、待打款的计提项实际金额之和;未出账不计入任何一列(D-07-15)
- R-07-025 展开客户行显示第二层结算期行,列:结算期(yyyy-mm-01 至 yyyy-mm-最后一天)、消耗金额、MAX消耗、客户返点金额、客户返点进度、客情费用、客情费用进度,金额列 = 该月可见账户行之和(金额按 R-07-011);进度列按状态计数,只列数量不为 0 的「未出账 n」「待结算 n」「处理中 n」(处理中 = 审批中 + 待打款),用「 · 」分隔,如「待结算 1 · 处理中 1」;全部是已结算或无返点 / 无客情时显示「已完成」(D-07-15);只列至少有一条计提项的月份,结算期降序
- R-07-026 展开结算期行显示第三层账户行,列:账户名称、消耗金额、MAX消耗、返点时间范围、返点时间内消耗金额、客户返点、客情时间范围、客情时间内消耗金额、客情费用、客户返点状态、客情费用状态(口径 R-07-002、R-07-005、R-07-008、R-07-011);时间范围多段时每段一行;按消耗金额降序
- R-07-027 客户排序:待结算客户返点金额降序,相同按待结算客情费用降序,再按公司名称升序;分页按第一层 10 / 50 / 100 / 300 条每页,默认 10;没有可见客户或筛选无结果显示「暂无数据」
- R-07-028 操作列「客户返点」只对同时有「返点管理(查看)」「返点结算」权限点的用户显示,「客情费用」只对同时有「返点管理(查看)」「客情结算」权限点的用户显示(D-13-01);该客户没有可见的待结算计提项时按钮置灰不可点,悬浮提示「暂无待结算的客户返点」/「暂无待结算的客情费用」
- R-07-029 原型的「导出」按钮本期不做(D-07-23)
2.3.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|
| 没有「返点管理(查看)」 | — | 不显示菜单(R-07-021) | 直接访问时内容区「无权限访问」,保留地址(R-13-005) |
| 没有可见客户 / 筛选无结果 | 空列表 | — | 「暂无数据」 |
| 只能看客户下部分账户 | 其余账户隐藏 | 汇总只算可见账户(R-07-021) | 汇总比全量小 |
| 搜索无权限账户的名称 / orgId | — | 服务端不匹配(R-07-022) | 「暂无数据」 |
| 没有权限点 | — | 按钮隐藏(R-07-028) | 只能看 |
| 没有待结算计提项 | — | 按钮置灰(R-07-028) | 悬浮提示「暂无待结算的客户返点」 |
2.3.6 验收标准
- G-07-020 前置:公共前置,无任何单据。操作:2026-10-05 王敏打开返点管理。期望:标题「返点管理」、默认「返点信息」;橙子行 累计客户返点金额 0.00 USD、待结算客户返点金额 390.00 USD(C 300.00 + D 90.00;8 月无返点、10 月未出账不计)、累计客情费用 0.00 USD、待结算客情费用 200.00 USD、处理中客户返点金额 0.00 USD、处理中客情费用 0.00 USD;展开后 2026-09 行客户返点进度「待结算 2」、客情费用进度「待结算 1」,2026-08 行两个进度都是「已完成」;橙子排在星海(待结算 24.00 USD)前面;没有「导出」按钮。
- G-07-021 前置:公共前置,赵磊只能看 C。操作:赵磊打开返点管理并展开橙子。期望:只显示 C 的账户行;橙子待结算客户返点金额 300.00 USD、待结算客情费用 200.00 USD;看不到星海。
- G-07-022 前置:公共前置;用户钱芳能看 C、D,但没有「返点结算」「客情结算」权限点;用户孙悦没有「返点管理(查看)」。操作:钱芳打开返点管理;孙悦看侧栏并直接访问返点管理地址。期望:钱芳能看到橙子三层数据,操作列不显示「客户返点」「客情费用」;孙悦侧栏没有「返点管理」,直接访问时内容区显示「无权限访问」、保留原地址。
- G-07-023 前置:星海的 9 月客户返点已结算,没有其他待结算客户返点。操作:王敏看星海行。期望:「客户返点」按钮置灰,悬浮提示「暂无待结算的客户返点」;「客情费用」可点(9 月客情 10.00 待结算)。
- G-07-024 前置:公共前置。操作:搜索框输入「橙子」;输入「橙子-iOS-HK」;赵磊(只能看 C)输入「橙子-iOS-HK」;再把计费模式筛成预付款。期望:「橙子」只剩橙子一行;「橙子-iOS-HK」显示橙子,展开后照常列 C、D;赵磊搜「橙子-iOS-HK」显示「暂无数据」;筛预付款后显示「暂无数据」。
- G-07-025 前置:公共前置;王敏提交了 C 9 月返点 300.00 现金打款(审批中)。操作:看橙子行与 2026-09 行。期望:橙子处理中客户返点金额 300.00 USD、待结算客户返点金额 90.00 USD;2026-09 客户返点进度「待结算 1 · 处理中 1」。
- G-07-026 前置:公共前置;橙子 2026-10-10 保存了后付改预付,2026-11-01(UTC0)起生效。操作:2026-10-15 看返点信息并打开客户返点弹窗、选余额抵扣。期望:列表与弹窗计费模式都显示「后付款(2026-11-01 起改为预付款)」;余额抵扣仍按后付款,要选纳入扣减月份。
示意 1返点信息列表(三层展开、汇总列、状态列)mocks/01-返点信息列表.html
2.4 客户返点弹窗
2.4.1 功能描述
勾选一个客户的待结算客户返点计提项(可跨月、跨账户),逐行确认或调整金额,选余额抵扣或现金打款,提交「返点管理—客户返点」审批。
2.4.2 核心字段
| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|
| 公司名称 / 所属账户系统 / 计费模式 | — | 只读 | — | 客户当前值 | — | R-07-030 |
| 返点方式 | method | enum | 是 | 余额抵扣 / 现金打款 | 不选 | R-07-034 |
| 纳入扣减月份 | deduct_bill | 关联账单(06) | 后付 + 余额抵扣 + 合计 > 0 时是 | 符合 R-06-024 的账单 | 不选 | R-07-036 |
| 结算币种 | settle_currency | enum | 现金打款 + 合计 > 0 时是 | 人民币 / USD / USDT | 客户币种 | R-07-039 |
| 汇率 | fx_rate | decimal(4) | 现金打款时自动 | 1 账户币种 = x 结算币种 | 当天日汇率四舍五入 4 位 | R-07-040 |
| 汇率日期 | fx_date | date(UTC0) | 币种不同时自动 | — | 实际取到汇率的日期 | R-07-040 |
| 应付金额 | payable | decimal(2),结算币种 | 现金打款时自动 | — | 合计 × 汇率 | 只读(R-07-041) |
| 收款主体 | payee | string | 现金打款 + 合计 > 0 时是 | 客户当前生效的付款主体 | 不选 | R-07-042 |
| 返点金额(合计) | total | decimal(2),账户币种 | 自动 | ≥ 0 | 0.00 | 只读 = 勾选行之和(R-07-033) |
| 各行返点金额 | lines[].actual_amount | decimal(2),账户币种 | 勾选时是 | ≥ 0,最多 2 位小数,无上限 | 系统计算返点 | R-07-033 |
| 备注 | remark | text | 否 | 沿用现有备注长度 | 空 | 发起备注(R-07-043) |
2.4.3 业务规则
- R-07-030 弹窗标题「客户返点」,右上角 ✕ 关闭;顶部只读 公司名称、所属账户系统、计费模式(客户当前值,待生效写法同 R-07-023);然后是 返点方式、纳入扣减月份 / 结算币种 / 汇率 / 应付金额 / 收款主体(按条件出现)、返点金额(合计)、备注;下方计提项表;底部「提交审批」
- R-07-031 计提项表两层:结算期行(勾选框、结算期、消耗金额、MAX消耗、系统计算返点合计、返点金额合计)→ 账户行(勾选框、账户名称、消耗金额、MAX消耗、返点时间范围、返点时间内消耗金额、系统计算返点、返点金额);只列该客户状态为「待结算」、当前用户有查看权限的账户的客户返点计提项,结算期降序;不列无返点、未出账和已在单里的;默认展开最近一个结算期,其余收起,收起的结算期行照样能勾,勾上即勾选其下全部账户行;打开时一行待结算都没有的,表格空态「暂无待结算的客户返点」,「提交审批」置灰,关闭弹窗时刷新列表(D-07-28)
- R-07-032 勾选:默认都不勾;表头全选 = 勾上全部结算期行;勾结算期行 = 勾上其下全部账户行,取消同理;账户行部分勾选时结算期行显示半选,结算期行部分勾选时表头半选;可跨多个结算期、多个账户勾(D-07-03);取消勾选后再勾,该行保留之前改过的金额与「已调整」标识
- R-07-033 每个账户行的「返点金额」是输入框,默认 = 系统计算返点,勾选后才可编辑;可改大改小(D-07-04、D-07-08),必填、≥ 0、最多 2 位小数、不设上限;输入按 D-00-82:只接受数字和一个小数点,负号、字母输不进去,小数第 3 位按不下去,粘贴或自动填充的非法内容不写入、保留原值并就地标红「请输入不小于 0、最多 2 位小数的金额」,不静默四舍五入或截断;清空时同样标红;与系统计算值不同时输入框旁显示「已调整」。「返点金额(合计)」只读 = 已勾选行返点金额之和,实时更新,带账户消耗币种;任一勾选行不合法(如被清空)时合计显示「—」(D-07-28)
- R-07-034 返点方式:必选单选 余额抵扣 / 现金打款,默认不选,未选提示「请选择返点方式」;合计为 0 时也必选(R-07-072)
- R-07-035 余额抵扣按客户当前生效的计费模式走(待生效的变更不算,D-00-73):预付款 → 不选月份,方式旁说明「审批通过后按账户充入各账户余额」(D-00-19);后付款 → 合计 > 0 时必选「纳入扣减月份」(R-07-036);所勾计提项所属月的计费模式和当前不同时照常可勾,余额抵扣去向只看当前模式(D-07-31)。结算币种、汇率、应付金额、收款主体只在现金打款且合计 > 0 时出现(D-07-10)
- R-07-036 纳入扣减月份(合计 > 0 时):必选,下拉单选,选项与可结算应收由服务端下发 = 该客户符合 R-06-024 的账单(后付款、待结算、没有审批中的结算单),显示「yyyy-mm(可结算应收 {金额} {币种})」,降序;未出账月份不出现在选项里;已被另一张审批中、合计 > 0 的客户返点单选为扣减月份的账单置灰,显示「yyyy-mm(已有审批中的扣减单 {审批单号})」,不可选(D-07-16);不要求晚于所勾计提项的月份;没有可选账单时提示「暂无可扣减的账单,请选择现金打款」;合计 > 所选账单可结算应收时标红提示「返点金额不能大于该月账单可结算应收 {金额}」,合计显示「—」时暂停这条校验;只校验整单合计,账户行应收因此为负也允许(D-07-16)
- R-07-037 后付余额抵扣通过后,返点按账户加到所选账单对应账户行的「客户返点」(R-06-010):每个账户 = 本单该账户各行实际金额之和;返点时间范围 = 这些计提项的时间范围
- R-07-038 至少勾 1 行,否则提示「请至少勾选一项」;合计可以为 0(全部改成 0 表示这些月份不返,提交后照常结掉,D-07-17、R-07-072)
- R-07-039 结算币种(现金打款且合计 > 0 时):必选,下拉单选 人民币 / USD / USDT,默认客户的币种,客户币种为空时无默认值(R-04-011)
- R-07-040 汇率(现金打款且合计 > 0 时):结算币种与账户消耗币种相同时汇率为 1、不显示;不同时显示「汇率:1 {账户币种} = x {结算币种}(yyyy-mm-dd)」,x = 当天(UTC0)日汇率四舍五入到 4 位,显示与计算都用这 4 位,日期 = 实际取到的那天(当天没有、向前取最近一天时显示那一天)(D-00-74、D-07-06);提交时服务端按提交当天重新取并锁定,与弹窗不同时按 R-07-051 请用户确认;取不到任何汇率时不能提交,提示「未取到 {账户币种}→{结算币种} 汇率,请稍后再试」
- R-07-041 应付金额(现金打款且合计 > 0 时):只读 = 返点金额(合计)× 汇率,四舍五入到 2 位,带结算币种;合计或汇率变化时实时更新;合计显示「—」时应付金额也显示「—」(D-07-09、D-07-28)
- R-07-042 收款主体(现金打款且合计 > 0 时):必选,下拉单选,选项 = 该客户当前生效的付款主体(我们付钱给客户,字段叫「收款主体」,D-07-29);下拉底部入口仍叫「+ 新增付款主体」,旁加灰字「需审批通过后可选」;新增、客户没有付款主体、有审批中的付款主体变更时的提示与做法同 R-05-042(调起 04 付款主体弹窗、走付款主体变更审批、通过前不在选项里、仅「客户管理-读写」可见);客户没有付款主体时合计 > 0 的现金打款单不能提交
- R-07-043 备注:多行、选填,长度上限沿用现有备注输入框;即审批发起备注,同时在审批内容区展示
- R-07-044 点「提交审批」校验 R-07-033、R-07-034、R-07-036、R-07-038~R-07-042(合计为 0 时只校验 R-07-033、R-07-034、R-07-038),不通过在对应位置提示;通过后二次确认,标题「提示」(同 R-05-078),文案「客户返点需进行审批,是否提交审批单?」(取消 / 确定),确定后按 R-07-050 复核提交
- R-07-072 合计为 0 的单:返点 / 客情合计为 0.00 时,纳入扣减月份、结算币种、汇率、应付金额、收款主体都不出现、不校验;客户返点仍必选返点方式;合计在 0 与非 0 之间变化时这些字段实时出现或消失,已选的值保留;0 元单不占用任何账单、不触发 06 生成结算单置灰(R-06-040);审批内容区返点方式写「余额抵扣(0 元,不扣减账单)」或「现金打款(0 元,不生成付款单)」;审批通过后计提项直接变已结算,不入桶、不计入账单、不生成付款单、不写交易明细(D-07-17)
2.4.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|
| 打开时没有待结算行 | 被别人先结了 | 空态、提交置灰(R-07-031) | 「暂无待结算的客户返点」 |
| 后付但没有可扣减账单 | 下拉为空 | 合计 > 0 时不能提交(R-07-036) | 「暂无可扣减的账单,请选择现金打款」 |
| 账单已被别的抵扣单占用 | 选项置灰 | 不可选(R-07-036) | 「yyyy-mm(已有审批中的扣减单 {审批单号})」 |
| 合计大于可结算应收 | — | 不能提交(R-07-036) | 「返点金额不能大于该月账单可结算应收 {金额}」 |
| 取不到汇率 | — | 不能提交(R-07-040) | 「未取到 USD→人民币 汇率,请稍后再试」 |
| 客户没有付款主体 | 收款主体下拉为空 | 合计 > 0 的现金打款不能提交(R-07-042) | 文案按 R-05-042 |
| 客户币种为空 | 结算币种无默认 | 必选(R-07-039) | 「请选择结算币种」 |
| 键入负数 / 3 位小数 / 粘贴非法值 | — | 输不进 / 不写入并标红(R-07-033) | 「请输入不小于 0、最多 2 位小数的金额」 |
| 某勾选行被清空 | 不合法 | 合计、应付显示「—」,暂停超额校验(R-07-033、R-07-036) | 「—」 |
| 全部改成 0 | 合计 0 | 允许提交,相关字段隐藏(R-07-072) | — |
| 跨午夜提交 | 汇率日期变了 | 不建单,弹确认(R-07-051) | 「汇率已更新为 …,是否按新汇率提交?」 |
| 预付时提交余额抵扣,审批中预付改后付生效 | 快照为预付款 | 通过后按提交快照成桶(0 费率),之后按 R-05-118 ① 保留(R-07-055) | 执行状态「已充入余额」 |
2.4.6 验收标准
- G-07-030 前置:公共前置。操作:2026-10-05 王敏点橙子的「客户返点」。期望:弹窗显示公司名称、所属账户系统 苹果ASA(自接苹果)、计费模式 后付款;计提项表只有 2026-09 一个结算期(默认展开),下有 C(系统计算返点 300.00)、D(90.00)两行,默认不勾;8 月、10 月不出现;返点金额(合计)0.00 USD。
- G-07-031 前置:接 G-07-030。操作:勾 2026-09 结算期行,把 D 的返点金额改成 100.00;在 C 框键入「-」;粘贴「-1」;再清空 C。期望:C、D 都被勾上,结算期行系统计算返点合计 390.00、返点金额合计 400.00,合计 400.00 USD,D 旁显示「已调整」;「-」输不进去;粘贴不写入、C 保留 300.00 并标红「请输入不小于 0、最多 2 位小数的金额」;清空 C 后 C 标红,合计显示「—」。
- G-07-032 前置:接 G-07-031,C 改回 300.00。操作:选余额抵扣,展开纳入扣减月份;再把 C 改成 40,000.00。期望:纳入扣减月份出现,选项只有「2026-09(可结算应收 35,340.00 USD)」;结算币种、收款主体不出现;C 改成 40,000.00 后合计 40,100.00,标红「返点金额不能大于该月账单可结算应收 35,340.00」,不能提交。
- G-07-033 前置:接 G-07-031(C 300.00、D 100.00,合计 400.00 USD)。操作:选现金打款,结算币种保持默认。期望:结算币种默认人民币(下拉);显示「汇率:1 USD = 7.1234 人民币(2026-10-05)」,应付金额 2,849.36 人民币(只读);收款主体选项 橙子出行科技有限公司、Orange Mobility Ltd,下拉底部「+ 新增付款主体」旁灰字「需审批通过后可选」;纳入扣减月份不出现;结算币种改 USD 后汇率不显示、应付金额 400.00 USD。
- G-07-034 前置:接 G-07-033(结算币种人民币、已选收款主体),弹窗开着。操作:另一处 C 的 9-20 消耗被修正 +500.00 后,王敏点提交审批并确定;再点一次提交并确定。期望:第一次不生成审批单,弹窗不关,顶部「数据已更新,请核对后重新提交」;C 行标黄「系统计算值已由 300.00 变为 310.00」,C 没改过、返点金额跟随为 310.00;D 改过、保留 100.00;合计 410.00 USD,应付 2,920.59 人民币;结算币种、收款主体、返点方式、勾选都保留;第二次提交成功。
- G-07-035 前置:接 G-07-031。操作:什么都不选直接点提交审批;再取消全部勾选点提交审批。期望:先提示「请选择返点方式」;未勾任何行时提示「请至少勾选一项」。
- G-07-036 前置:预付客户星海,A 9 月返点 24.00 待结算。操作:王敏点「客户返点」,勾 A,选余额抵扣。期望:不出现纳入扣减月份、结算币种、收款主体;返点方式旁显示「审批通过后按账户充入各账户余额」。
- G-07-037 前置:王敏打开橙子客户返点弹窗时,C、D 9 月返点都已被赵磊(假设能看 D)提交进单。操作:王敏看弹窗并关闭。期望:表格空态「暂无待结算的客户返点」,「提交审批」置灰;关闭后列表刷新,橙子「客户返点」按钮置灰。
- G-07-038 前置:公共前置;D 9 月返点 90.00 待结算;另有客户「蓝鲸游戏」没有付款主体,账户 E 9 月返点 50.00 待结算。操作:王敏把 D 改成 0.00、选余额抵扣提交,审批中时看 06 橙子 9 月账单;审批通过;再对蓝鲸 E 改 0.00、选现金打款提交。期望:D 那张单不出现纳入扣减月份,审批中时 06「生成结算单」不因它置灰;通过后 D 9 月返点已结算,06 账单客户返点不变、不多出 0.00 行;蓝鲸那张单不出现结算币种、收款主体,能提交,审批内容区返点方式「现金打款(0 元,不生成付款单)」。
示意 2客户返点弹窗(后付款 · 余额抵扣 · 有调整行)mocks/02-客户返点弹窗-后付余额抵扣.html
示意 3客户返点弹窗(现金打款 · 换汇 · 校验失败)mocks/03-客户返点弹窗-现金打款.html
2.5 客情费用弹窗
2.5.1 功能描述
勾选一个客户的待结算客情费用计提项,逐行确认或调整,现金打款,提交「返点管理—客情费用」审批。
2.5.3 业务规则
- R-07-045 弹窗标题「客情费用」,右上角 ✕ 关闭;顶部只读 公司名称、所属账户系统;然后是 结算币种、汇率、应付金额、收款主体、客情费用(合计)、备注;没有返点方式和纳入扣减月份,一律现金打款(D-07-05);底部「提交审批」
- R-07-046 计提项表两层:结算期行(勾选框、结算期、消耗金额、系统计算客情合计、客情费用合计)→ 账户行(勾选框、账户名称、消耗金额、客情时间范围、客情时间内消耗金额、系统计算客情费用、客情费用);只列状态为「待结算」、当前用户有查看权限的账户的客情费用计提项;勾选、展开、全选、空态做法同 R-07-031、R-07-032(空态文案「暂无待结算的客情费用」)
- R-07-047 每个账户行的「客情费用」输入框、合计、结算币种、汇率、应付金额、收款主体、备注的取值与校验同 R-07-033、R-07-038~R-07-043、R-07-072(文案中的「返点金额」改为「客情费用」)
- R-07-048 点「提交审批」校验后二次确认,标题「提示」(同 R-05-078),文案「客情费用需进行审批,是否提交审批单?」(取消 / 确定),确定后按 R-07-050 复核提交
2.5.5 异常与边界
同 2.4.5 中现金打款相关各行(汇率、收款主体、金额校验、合计为 0、空态)。
2.5.6 验收标准
- G-07-040 前置:公共前置。操作:2026-10-05 王敏点橙子的「客情费用」,勾 C 9 月。期望:没有返点方式、纳入扣减月份;计提项表只有 C 一行(D 无客情不出现),系统计算客情费用 200.00;结算币种默认人民币,汇率「1 USD = 7.1234 人民币(2026-10-05)」,应付金额 1,424.68 人民币;收款主体必选,下拉底部有「+ 新增付款主体」。
示意 4客情费用弹窗(现金打款)mocks/04-客情费用弹窗.html
2.6 提交与服务端复核
2.6.1 功能描述
两个弹窗点「确定」后的服务端复核与提交审批。
2.6.3 业务规则
- R-07-050 确定后服务端复核:当前用户有「返点管理(查看)」和对应的结算权限点(D-13-01);所勾计提项都仍是「待结算」、都在当前用户可见账户内、系统计算金额与弹窗打开时一致;客户计费模式与弹窗打开时一致;后付余额抵扣且合计 > 0 时所选账单仍符合 R-06-024、没有被其他审批中的扣减单占用、且合计 ≤ 其当前可结算应收;现金打款且合计 > 0 时汇率与弹窗一致、所选收款主体仍在客户当前生效的付款主体里;并发提交同一账单的扣减单只成功一张
- R-07-051 复核失败时不建单、弹窗不关:①计提项金额或状态变了:按最新数据就地重载,保留结算币种、收款主体、备注、返点方式、勾选状态;值没变的行原样保留;值变了的行标黄「系统计算值已由 X 变为 Y」,用户没改过的跟随新值、改过的保留用户填的值;已经不能选的计提项取消勾选并标「状态已变化」;顶部提示「数据已更新,请核对后重新提交」,用户再点一次提交才建单;②计费模式变了:同样就地重载,顶部提示「客户计费模式已变化,请核对后重新提交」;③所选账单已不可扣减或被占用:「所选月份账单已不可扣减,请重新选择」,清空纳入扣减月份;④提交当天汇率与弹窗不同:返回新汇率,弹确认「汇率已更新为 1 {账户币种} = x {结算币种}(yyyy-mm-dd),换算后金额 {Y},是否按新汇率提交?」,点确定后按新汇率建单;⑤收款主体已失效:「收款主体已变更,请重新选择」。同一弹窗连续点击只提交一次,请求中按钮显示加载(D-07-27)
- R-07-052 复核通过后提交审批(R-12-001):类型「返点管理—客户返点」或「返点管理—客情费用」;操作对象客户 = 本客户;涉及账户 = 所勾计提项的账户(D-00-76);业务单据 = 弹窗全部内容 + 汇率与汇率日期 + 应付金额 + 所勾计提项的全部快照(R-07-010);发起备注 = 备注。成功后按 12 R-12-018 给弱提示(审批中「已提交审批」;免审直接通过「提交成功,无需审批,已生效」)、关闭弹窗,所勾计提项变「审批中」
- R-07-053 有选了某月扣减、合计 > 0、仍在审批中的客户返点单时,06 该月账单「生成结算单」置灰(R-06-040、D-06-23)
2.6.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|
| 弹窗打开期间消耗被修正 | 系统金额变了 | 不建单、就地重载(R-07-051 ①) | 变化行标黄、顶部「数据已更新,请核对后重新提交」 |
| 弹窗打开期间计费模式生效 | 模式变了 | 不建单、就地重载(R-07-051 ②) | 「客户计费模式已变化,请核对后重新提交」 |
| 选的账单被生成结算单 / 被占用 | 不再可扣减 | 不建单(R-07-051 ③) | 「所选月份账单已不可扣减,请重新选择」 |
| 两张单并发扣同一账单 | — | 只成功一张(R-07-050) | 后到的同上提示 |
| 跨零点提交 | 汇率变了 | 不建单,弹确认(R-07-051 ④) | 「汇率已更新为 …」 |
| 连点提交 | — | 只提交一次 | 按钮加载中 |
| 无权限点直接调接口 | — | 服务端拒绝 | — |
2.6.6 验收标准
- G-07-056 前置:公共前置;王敏、赵磊(假设能看 C、D)同时打开橙子客户返点弹窗,各勾一行、都选余额抵扣、纳入扣减月份 2026-09。操作:王敏先提交成功,赵磊后提交;之后赵磊重新打开弹窗看纳入扣减月份。期望:只有王敏那张建单;赵磊看到「所选月份账单已不可扣减,请重新选择」;重新打开后选项「2026-09(已有审批中的扣减单 {王敏的单号})」置灰不可选。
- G-07-057 前置:接 G-07-033(合计 400.00 USD、现金打款、人民币);弹窗 2026-10-05 打开,2026-10-06 的日汇率为 7.1301。操作:2026-10-06 00:20(UTC0)提交并确定。期望:不建单,确认框「汇率已更新为 1 USD = 7.1301 人民币(2026-10-06),换算后金额 2,852.04,是否按新汇率提交?」;确定后建单,单内汇率 7.1301、汇率日期 2026-10-06、应付 2,852.04 人民币。
2.7 审批结果
2.7.1 功能描述
审批通过 / 驳回 / 撤回 / 作废 / 付款完成后,计提项、余额、账单、付款单、交易明细怎么变。
2.7.3 业务规则
- R-07-054 审批流 0 节点或全部节点被跳过时提交即通过(R-12-018),立即按 R-07-055~R-07-058 处理
- R-07-055 客户返点单审批通过(R-12-025),预付款 + 余额抵扣、合计 > 0:单内每个账户的实际金额之和 > 0 时,给该账户按 R-05-004 ③ 入一个分桶(费率快照 0,R-05-005;不清零额度,R-05-011);写一条「客户返点」交易明细,状态已完成:发起时间 = 申请时间,充值金额 = 合计(账户币种),应付金额「-」,账户列表每个账户一行「{账户名称} +{金额} {币种}」,关联审批单号,备注 = 备注;计提项变「已结算」。提交时为预付款、客户预付改后付生效时仍在审批中的,通过后照常按提交时的快照成桶(费率 0),之后按 R-05-118 ① 保留(D-07-33)
- R-07-056 客户返点单审批通过,后付款 + 余额抵扣、合计 > 0:按 R-07-037 计入所选账单(06 按 R-06-010、R-06-019 刷新);计提项变「已结算」;不写交易明细(不动钱、不动余额,结算单支付时体现,D-07-18)
- R-07-057 现金打款(客户返点或客情费用)审批通过且合计 > 0:生成一张 09 付款单(交易类型 客户返点 / 客情费用,应付 = 应付金额,币种 = 结算币种,收款主体,关联本单与审批单);写一条对应交易类型的交易明细,状态待完成:发起时间 = 申请时间,充值金额「-」,应付金额 = 应付金额(结算币种,正数,D-07-18),账户列表每个账户一行「{账户名称} {金额} {账户币种}」,关联审批单号,备注 = 备注;计提项变「待打款」(D-07-18)
- R-07-058 合计为 0 的单(余额抵扣或现金打款)审批通过:按 R-07-072 处理,计提项直接变「已结算」
- R-07-059 09 付款单变「已完成」(确认到账,D-00-33、R-09-071)时:该单计提项变「已结算」并记结算时间;交易明细由 05 按 R-05-095 变已完成。09 确认汇款后付款单为「待完成」,计提项仍为「待打款」、不回写(R-09-042)。本期付款单不作废、不退回(D-00-69),本页没有付款单作废后的回退
- R-07-060 审批单变为已驳回、已撤回或被作废(作废效果同撤回,R-12-046、D-00-79):计提项回到「待结算」并按 R-07-009 重算(重算为 0 的变无返点 / 无客情),不动任何余额、账单、付款数据;原单不能修改重提,要再申请需重新打开弹窗(R-12-034)
- R-07-061 按 R-12-045 列明本包的最终通过执行失败情形:没有(D-00-79)——后付余额抵扣不再复核所选账单可结算应收,照常生效(D-00-67);审批期间账单金额变小导致可结算应收被扣成负数的,由 06 在生成结算单时应付固定 0.00、超出部分结转下期(R-06-077、R-06-078);预付抵扣、现金打款通过时也不复核
2.7.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|
| 审批期间账单可结算应收变小 | 最终通过时已不足本次返点 | 不复核,照常通过并计入账单(R-07-061、D-00-67) | 06 生成结算单时应付 0.00、结转(R-06-077) |
| 审批期间客户改了计费模式 | 快照是旧模式 | 按提交时快照处理(R-07-055、R-07-056) | — |
| 0 节点审批流 | 提交即通过 | 立即处理(R-07-054) | 直接待打款 / 已结算 |
| 合计 0 | 无付款、无入桶、不计入账单 | 直接已结算(R-07-058) | 交易明细无新行 |
| 申请人被收回权限点 | 单仍审批中 | 仍可撤回(R-07-065) | 撤回按钮照常 |
| 卡死的单 | 申请人、审批人都不可用 | 「审批配置」持有人作废(R-07-060) | 同撤回 |
2.7.6 验收标准
- G-07-050 前置:公共前置。操作:王敏勾 C 9 月 300.00,余额抵扣,纳入扣减月份 2026-09,提交;审批通过。期望:提交后 C 9 月返点「审批中」,06 该月账单「生成结算单」置灰;通过后 C 9 月返点「已结算」,橙子 9 月账单 C 行客户返点 300.00、返点时间范围「2026-09-01 至 2026-09-30」、总计 35,040.00(同 G-06-001);交易明细不新增行;返点信息橙子累计客户返点 300.00 USD、待结算 90.00 USD;已提交审批该单执行状态「已计入 2026-09 账单」。
- G-07-051 前置:星海 A 9 月返点 24.00 待结算;A 当前额度 5,000.00。操作:王敏余额抵扣提交,审批通过。期望:A 新增一个 24.00 USD 分桶(费率快照 0);额度仍 5,000.00;交易明细新增一行「客户返点」已完成,充值金额 24.00,应付金额「-」,账户列表「星海-iOS-US +24.00 USD」;A 9 月返点「已结算」;执行状态「已充入余额」。
- G-07-052 前置:接 G-07-040。操作:选收款主体 橙子出行科技有限公司提交,审批通过;之后 09 确认汇款,再确认到账。期望:通过后生成 09 付款单(客情费用,1,424.68 人民币,收款主体 橙子出行科技有限公司),交易明细新增「客情费用」待完成、应付金额 1,424.68(正数)、账户列表「橙子-iOS-CN 200.00 USD」;C 9 月客情「待打款」,执行状态「付款单待汇出」;确认汇款后(付款单待完成)C 9 月客情仍「待打款」、交易明细仍待完成,执行状态「付款单待完成」;确认到账(付款单已完成)后变「已结算」,交易明细变已完成,执行状态「已到账」。
- G-07-053 前置:D 9 月返点 90.00 待结算。操作:王敏把 D 改成 0.00、现金打款提交,审批通过。期望:弹窗不出现结算币种、收款主体;不生成付款单、不写交易明细;D 9 月返点直接「已结算」,实际金额 0.00;橙子 9 月 D 的返点计提项算作完成;执行状态「已结清(0 元)」。
- G-07-054 前置:王敏把 C 9 月返点改成 35,000.00,余额抵扣到 2026-09(可结算应收 35,340.00)提交,审批流 1 个节点;之后 D 9-25 消耗修正 −1,000.00,账单可结算应收变 34,250.00。操作:审批人点「审批通过」。期望:不复核、不提示,审批单照常变已通过;C 9 月返点「已结算」,橙子 9 月账单 C 行客户返点 35,000.00、账户行应收 -12,740.00,账单可结算应收 -750.00;之后生成结算单按 G-06-027:应付 0.00、「本次抵扣 34,250.00,剩余 750.00 结转至下期」。
- G-07-055 前置:「返点管理—客户返点」审批流未配置(0 节点)。操作:王敏提交 D 9 月返点 90.00 现金打款。期望:提交即已通过,弱提示「提交成功,无需审批,已生效」;立即生成付款单、交易明细,D 9 月返点直接「待打款」。
2.8 已提交审批
2.8.3 业务规则
- R-07-062 已提交审批只展示当前登录账号提交的客户返点单、客情费用单(含免审直接通过的单,R-12-018;同 R-05-087 做法)
- R-07-063 搜索框按审批单号、公司名称包含匹配;筛选 操作对象(全部 / 客户返点 / 客情费用)、审批状态(全部 / 审批中 / 已通过 / 已驳回 / 已撤回),默认全部
- R-07-064 列表字段:审批单号、操作对象(客户返点 / 客情费用)、操作客户(公司名称)、所属账户系统(客户当前的)、申请人(已禁用时按 R-12-049 显示「姓名(已禁用)」)、申请时间(yyyy-mm-dd hh:mm:ss,Asia/Shanghai)、审批状态、执行状态、操作;执行状态只有已通过的单有值:「已充入余额」(预付抵扣)、「已计入 yyyy-mm 账单」(后付抵扣)、「付款单待汇出 / 付款单待完成 / 已到账」(现金打款,按 09 R-09-073 按审批单号取付款单状态)、「已结清(0 元)」,其余显示「-」(D-07-30);排序 审批中置顶,其余按申请时间降序;分页 10 / 50 / 100 / 300,默认 10;没有数据显示「暂无数据」
- R-07-065 行操作:所有状态都有「详情」,新页打开审批详情(12 统一的审批详情页,按审批单号打开);只有审批中有「撤回」,只校验申请人本人与单据审批中、不校验「返点结算」「客情结算」权限点(D-00-79);确认文案、后果与通知按 12(R-12-032~R-12-035),撤回后按 R-07-060 处理
2.8.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|
| 没有提交过 | 空 | — | 「暂无数据」 |
| 撤回时单子已被通过 | 状态已变 | 按 12 拒绝撤回 | 12 的提示 |
2.8.6 验收标准
- G-07-060 前置:王敏提交了 2 张单(1 张审批中、1 张已通过),赵磊提交了 1 张;王敏提交后被收回了「返点结算」权限点。操作:王敏打开「已提交审批」,对审批中那张点「撤回」并确定。期望:只看到自己的 2 张,审批中那张置顶,已通过那张执行状态有值;王敏仍能撤回,撤回后该单变已撤回,所含计提项回到待结算,弹窗里重新可选。
2.9 审批内容
2.9.3 业务规则
- R-07-066 审批信息区按 12(R-12-026),审批事项「返点管理」、审批类型「客户返点」或「客情费用」
- R-07-067 客户返点单内容区依次:公司名称(超链接,新页打开客户详情 R-04-050)、所属账户系统(客户当前的)、计费模式(提交时快照)、返点方式(合计为 0 时写法按 R-07-072)、纳入扣减月份(后付余额抵扣且合计 > 0 时,yyyy-mm)、返点金额(合计,带账户币种)、结算币种 / 汇率与汇率日期(币种不同时,「1 {账户币种} = x {结算币种}(yyyy-mm-dd)」)/ 应付金额 / 收款主体(现金打款且合计 > 0 时)、备注(空显示「-」);下面是计提项表;审批通过后内容区底部显示执行结果:「已计入 yyyy-mm 账单」「已充入余额」「付款单:{财务ID} · {状态}」或「已结清(0 元)」(D-07-30;展示位置随 12 统一审批详情页)
- R-07-068 客户返点计提项表:结算期行(结算期、消耗金额、MAX消耗、系统计算返点合计、返点金额合计)→ 账户行(账户名称、消耗金额、MAX消耗、返点时间范围、返点时间内消耗金额、客户返点比例、系统计算返点、返点金额);只列本单包含的计提项,不带勾选框;全部取单据快照;返点金额与系统计算返点不同的行,返点金额标红并带「已调整」(D-07-19)
- R-07-069 客户返点比例 / 客情费用比例按分段快照展示:每段一行「yyyy-mm-dd 至 yyyy-mm-dd:」加 R-03-037 的比例写法(固定「x.xx%」或「阶梯(按月统计 / 按日统计)」加档位;客情阶梯为「阶梯(按自然月)」),比例后加「(规则起始 yyyy-mm-dd)」,便于和 03 历史规则对上(D-03-24)
- R-07-070 客情费用单内容区依次:公司名称(超链接)、所属账户系统、客情费用(合计)、结算币种、汇率与汇率日期(币种不同时)、应付金额、收款主体(合计为 0 时这四项按 R-07-072 不出现,写「现金打款(0 元,不生成付款单)」)、备注;计提项表:结算期行(结算期、消耗金额、系统计算客情合计、客情费用合计)→ 账户行(账户名称、消耗金额、客情时间范围、客情时间内消耗金额、客情费用比例、系统计算客情费用、客情费用),调整标红同 R-07-068;底部执行结果同 R-07-067(原型列名「客情返点比例」统一为「客情费用比例」,D-07-22)
- R-07-071 不启用 12 的变更高亮(R-12-030);内容区展示单内全部账户行,不按查看者的账户权限隐藏(同 D-05-34);审批详情第②类只读查看判断 = 当前用户对单内任一账户有查看权限、且持「返点管理(查看)」(R-12-043、R-12-044,D-07-34),或当前用户有「收付款中心」权限点(D-00-71、R-13-050);满足任一即可只读打开,不显示通过 / 驳回 / 撤回;申请人与快照里的审批人不受影响
2.9.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|
| 查看者只能看部分账户 | — | 照常展示全部行(R-07-071) | 全单 |
| 只有「收付款中心」权限点、看不到单内任何账户 | — | 可只读打开(R-07-071、D-00-71) | 全单,无通过 / 驳回 / 撤回 |
| 两类人都不是 | — | 12 拦截 | 「无权限查看」 |
| 能看单内账户但没有「返点管理(查看)」 | 不满足第②类(R-07-071) | 12 拦截 | 「无权限查看」 |
| 客户当前所属账户系统变了 | — | 取当前值,其余取快照 | — |
2.9.6 验收标准
- G-07-070 前置:接 G-07-031 用现金打款人民币提交(C 300.00、D 改成 100.00)。操作:审批人打开审批详情。期望:标题「返点管理/审批详情」、审批类型 客户返点;内容区 计费模式 后付款、返点方式 现金打款、返点金额 400.00 USD、汇率「1 USD = 7.1234 人民币(2026-10-05)」、应付金额 2,849.36 人民币、收款主体;计提项表结算期行系统计算返点合计 390.00、返点金额合计 400.00;C 行返点金额 300.00 正常显示,D 行系统计算返点 90.00、返点金额 100.00 标红带「已调整」;D 行客户返点比例「2026-09-01 至 2026-09-30:阶梯(按月统计)」加两档、后带「(规则起始 2026-09-01)」。
- G-07-071 前置:接 G-07-070;赵磊只能看 C,不是申请人也不是审批人。操作:赵磊打开该审批详情链接。期望:只读打开,C、D 两行都展示,不显示通过 / 驳回 / 撤回;只能看星海账户的人打开显示「无权限查看」;只能看星海账户、但有「收付款中心」权限点的人可只读打开,C、D 两行都展示,不显示通过 / 驳回 / 撤回。
示意 5客户返点审批详情 · 审批内容区(现金打款、调整标红)mocks/05-审批内容-客户返点.html
3 变更影响面
4 非功能
- 提交、撤回、作废在服务端复核(R-07-050、D-00-79),前端隐藏不算权限控制;列表、搜索、弹窗、审批详情按账户查看权限在服务端过滤(R-07-021、R-07-022、R-07-031、R-07-071)。
- 单据快照只追加不改;系统计算金额与实际金额同时留存,可追溯到审批单、付款单。
- 规则判定与落档调用 03(T-03-002),可扣减判断与占用调用 06(T-06-003),不另写。
- 实现任务:T-07-001~T-07-008,见 spec.yaml;其中 T-07-008 为给 10 的逐日接口:计提项逐日金额(R-10-004、R-10-011)。
5 开放问题
| 编号 | 问题 | 卡谁 | 期望结论时间 |
|---|
| ~~Q-07-01~~ | 已关闭(2026-10-22)→ D-07-32:只对结算期 ≥ 上线月的月份产生计提项,上线月与 06、08、10、11 共用 index S-18 的配置(S-17 定掉) | — | — |
| ~~Q-07-02~~ | 已关闭(2026-10-21)→ D-07-25:MAX = 出价策略 MAX_CONVERSIONS,按天按系列可拆,从上线起记录策略变更(技术答复 T14) | — | — |
| Q-07-03 | 【已关闭 2026-10-20】09 付款单作废 / 退回时,「待打款」的计提项回到哪个状态、交易明细怎么处理。结论:本期收付款单不作废、不退回(D-00-69),本页不做回退,见 D-07-24、R-07-059 | 用户(09 会话,已定) | — |
| Q-07-04 | 【已关闭 2026-10-20】12 能否支持业务包在「最终通过」时否决(R-07-061)。结论:最后通过时不复核、照常生效;2026-10-21 起账单为负由 06 结转(D-00-81),本包没有最终通过失败情形(D-00-79),见 D-07-20、R-07-061 | 用户(已定) | — |
| ~~Q-07-05~~ | 已关闭(2026-10-21)→ 用户确认 D-07-12、D-07-18、D-07-19、D-07-22 全部转已定 | — | — |
决策 D-07-01~D-07-35 见 spec.yaml decisions(原代定项已于 2026-10-21 由用户确认,全部为已定;D-07-32~D-07-35 为 2026-10-22 闭环清单回写)。