返点管理

v2.1.0 07-返点管理 ASA 状态:待评审 2026-10-22 评审版 · 由 PRD.md 自动生成,勿手改

返点管理 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 天怎么截)、什么时候能结、一张单能结什么、后付抵扣和现金打款各怎么走、结完以后数据变了怎么办,都没写。

目标:

可证伪的判定:公共前置下 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 本页范围

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类型必填枚举/取值默认值规则说明
种类kindenum是客户返点 / 客情费用—R-07-001
账户account_id关联账户(02)是——所属客户添加后不变(R-07-012)
结算期periodstring(7)是yyyy-mm(UTC0 自然月)—展示「yyyy-mm-01 至 yyyy-mm-最后一天」
币种currencyenum是人民币 / USD / USDT—账户消耗币种(R-05-002)
消耗金额month_consumptiondecimal(2),账户币种是——全月消耗(R-07-008)
时间范围accrual_ranges列表否「yyyy-mm-dd 至 yyyy-mm-dd」—计提天数合并的连续段(R-07-002、R-07-005)
范围内消耗range_consumptiondecimal(2),账户币种是——扣 MAX 前(R-07-008)
MAX消耗range_maxdecimal(2),账户币种否——仅客户返点(R-07-007)
计算分段segments列表否日期段 + 规则(含规则起始日期)+ 比例 + 基数 + 金额—R-07-003
系统计算金额calc_amountdecimal(2),账户币种是≥ 0—R-07-004、R-07-006
状态statusenum是未出账 / 待结算 / 无返点 / 无客情 / 审批中 / 待打款 / 已结算未出账2.2
实际金额actual_amountdecimal(2),账户币种否≥ 0—进单后才有(D-07-04)
结算时间settled_atdatetime(秒;存储为时间戳,展示北京时间 Asia/Shanghai)否——变已结算的时间(D-07-35)

2.1.3 业务规则

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 人民币)。

2.2 计提项状态(定义)

2.2.1 功能描述

计提项状态机,以及给 10 / 11 的「完成」口径和取数口径。

2.2.3 业务规则

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 验收标准

2.3 返点信息列表

2.3.1 功能描述

按客户 → 结算期 → 账户三层展示返点与客情,客户行有「客户返点」「客情费用」两个入口。

2.3.3 业务规则

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 验收标准

示意 1返点信息列表(三层展开、汇总列、状态列)mocks/01-返点信息列表.html

2.4 客户返点弹窗

2.4.1 功能描述

勾选一个客户的待结算客户返点计提项(可跨月、跨账户),逐行确认或调整金额,选余额抵扣或现金打款,提交「返点管理—客户返点」审批。

2.4.2 核心字段

字段名key类型必填枚举/取值默认值规则说明
公司名称 / 所属账户系统 / 计费模式—只读—客户当前值—R-07-030
返点方式methodenum是余额抵扣 / 现金打款不选R-07-034
纳入扣减月份deduct_bill关联账单(06)后付 + 余额抵扣 + 合计 > 0 时是符合 R-06-024 的账单不选R-07-036
结算币种settle_currencyenum现金打款 + 合计 > 0 时是人民币 / USD / USDT客户币种R-07-039
汇率fx_ratedecimal(4)现金打款时自动1 账户币种 = x 结算币种当天日汇率四舍五入 4 位R-07-040
汇率日期fx_datedate(UTC0)币种不同时自动—实际取到汇率的日期R-07-040
应付金额payabledecimal(2),结算币种现金打款时自动—合计 × 汇率只读(R-07-041)
收款主体payeestring现金打款 + 合计 > 0 时是客户当前生效的付款主体不选R-07-042
返点金额(合计)totaldecimal(2),账户币种自动≥ 00.00只读 = 勾选行之和(R-07-033)
各行返点金额lines[].actual_amountdecimal(2),账户币种勾选时是≥ 0,最多 2 位小数,无上限系统计算返点R-07-033
备注remarktext否沿用现有备注长度空发起备注(R-07-043)

2.4.3 业务规则

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 验收标准

示意 2客户返点弹窗(后付款 · 余额抵扣 · 有调整行)mocks/02-客户返点弹窗-后付余额抵扣.html
示意 3客户返点弹窗(现金打款 · 换汇 · 校验失败)mocks/03-客户返点弹窗-现金打款.html

2.5 客情费用弹窗

2.5.1 功能描述

勾选一个客户的待结算客情费用计提项,逐行确认或调整,现金打款,提交「返点管理—客情费用」审批。

2.5.3 业务规则

2.5.5 异常与边界

同 2.4.5 中现金打款相关各行(汇率、收款主体、金额校验、合计为 0、空态)。

2.5.6 验收标准

示意 4客情费用弹窗(现金打款)mocks/04-客情费用弹窗.html

2.6 提交与服务端复核

2.6.1 功能描述

两个弹窗点「确定」后的服务端复核与提交审批。

2.6.3 业务规则

2.6.5 异常与边界

场景现象系统行为用户看到
弹窗打开期间消耗被修正系统金额变了不建单、就地重载(R-07-051 ①)变化行标黄、顶部「数据已更新,请核对后重新提交」
弹窗打开期间计费模式生效模式变了不建单、就地重载(R-07-051 ②)「客户计费模式已变化,请核对后重新提交」
选的账单被生成结算单 / 被占用不再可扣减不建单(R-07-051 ③)「所选月份账单已不可扣减,请重新选择」
两张单并发扣同一账单—只成功一张(R-07-050)后到的同上提示
跨零点提交汇率变了不建单,弹确认(R-07-051 ④)「汇率已更新为 …」
连点提交—只提交一次按钮加载中
无权限点直接调接口—服务端拒绝—

2.6.6 验收标准

2.7 审批结果

2.7.1 功能描述

审批通过 / 驳回 / 撤回 / 作废 / 付款完成后,计提项、余额、账单、付款单、交易明细怎么变。

2.7.3 业务规则

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 验收标准

2.8 已提交审批

2.8.3 业务规则

2.8.5 异常与边界

场景现象系统行为用户看到
没有提交过空—「暂无数据」
撤回时单子已被通过状态已变按 12 拒绝撤回12 的提示

2.8.6 验收标准

2.9 审批内容

2.9.3 业务规则

2.9.5 异常与边界

场景现象系统行为用户看到
查看者只能看部分账户—照常展示全部行(R-07-071)全单
只有「收付款中心」权限点、看不到单内任何账户—可只读打开(R-07-071、D-00-71)全单,无通过 / 驳回 / 撤回
两类人都不是—12 拦截「无权限查看」
能看单内账户但没有「返点管理(查看)」不满足第②类(R-07-071)12 拦截「无权限查看」
客户当前所属账户系统变了—取当前值,其余取快照—

2.9.6 验收标准

示意 5客户返点审批详情 · 审批内容区(现金打款、调整标红)mocks/05-审批内容-客户返点.html

3 变更影响面

被影响对象影响方式处理动作负责人
版本 index本页引用 D-00-73、D-00-74、D-00-76、D-00-78~D-00-82 与改写后的 D-00-13、D-00-18、D-00-55、D-00-56、D-00-67index 子任务写入总控
03 规则配置Q-03-01 已由 D-07-01 定(扣 MAX 后落档);以时刻 t 取规则(D-03-24)、按条款合并(D-00-55)本页已落03 关 Q-03-01(X-1)总控 → 03
05 费用管理预付抵扣入桶、交易明细写法;后付抵扣不写交易明细;现金打款应付金额记正数(D-07-18);0 元单不写交易明细(R-07-072)05 R-05-095 补「后付返点抵扣、0 元单不写」(X-4)总控 → 05
06 账单与结算单读本页实际金额按账户计入;占用与 0 元不占用(R-06-024、R-06-040);超出可结算应收由 06 结转(R-06-077)06 同轮回写总控
09 收付款中心两类付款单由本页生成,字段叫「收款主体」;付款单已完成(确认到账)才回写已结算;执行状态取 09 状态(R-09-073)09 回写(D37、D51)总控 → 09
10 利润 / 11 提成返点、客情成本用实际金额,完成口径 R-07-017(X-6)已收口总控
10 利润中心读计提项逐日金额(R-10-004、R-10-011)T-07-008本页
12 审批本包最终通过无业务拒绝情形(D-00-79);执行结果行位置;提交提示(R-12-018);作废12 回写总控 → 12
13 导航与权限「返点管理(查看)」「返点结算」「客情结算」13 汇总(D-00-78)总控
存量已定只对结算期 ≥ 上线月的月份产生计提项(R-07-001,index S-17 / S-18,Q-07-01 关闭);MAX 出价策略从上线起记录(index S-23)进版本存量汇总(X-9)用户 + 财务 / 技术

4 非功能

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 闭环清单回写)。