账单与结算单 PRD
| 项 | 内容 |
|---|---|
| 所属产品 | ASA |
| 版本 | v2.1.0 |
| 页面 | 06-账单与结算单 |
| 涉及功能 | 账单管理(feature 台账由总控登记) |
| 编制日期 | 2026-10-19(2026-10-21 总控代改:按会议清单 v2 回写;2026-10-22 总控代改:按闭环问题清单回写) |
| 文档状态 | 待评审 |
| 目标读者 | 研发、测试、AI 实现助手(本文件可直接整份投喂给 AI 作为实现依据) |
| 关联文档 | 本目录 spec.yaml、mocks/;版本 index.md;原型 html/账单管理.html(V2.1 注释 :3931)、html/审批详情-账单管理.html;决策来源《财务v2.1.0_会议清单v2》 |
0 前置说明
- 本页覆盖版本记录第 16 项(账单管理)、第 17 项(账单审批详情,只写「审批内容」区)。
- 本页主管:账单(客户 × UTC0 自然月)与账单状态机、账单金额口径(含渠道统计金额去重、上期预付欠费、结转额)、结算单(「账单管理—生成结算单」审批的业务单据,含后付余额抵扣)。05 费用明细页的「费用明细」tab、05 后付剩余额度(R-05-013)、10 / 11「算没算完」(D-00-65)都读本页的账单。
- 引用 03-规则配置:后付账单逐日取规则、落行、落档全部调用 03(R-03-003、R-03-005、R-03-006、R-03-009、R-03-010),本页只写「怎么把钱算进账单」。
- 引用 05-费用管理:预付账单按分桶先进先出与费率快照折算(R-05-005、R-05-006);账户余额(R-05-001);分桶锁定(R-05-007)与退款折算口径(R-05-027,余额抵扣用);结算单审批通过后往 05 的交易明细写「结算单支付」(R-05-094、R-05-095),余额抵扣由 05 写「余额抵扣账单」。
- 引用 04(计费模式及其次月生效、币种、销售、付款主体)、12(审批引擎、撤回、作废、通知、审批详情框架)。
- 07(返点)、08(渠道统计金额)、09(收款单)接口按其编号对齐(R-07-036、R-07-037、R-08-018、R-08-090、R-09-002);本页写到「读 07 已通过的扣减返点」「读 08 入账数据」「审批通过 → 生成收款单」「收款单完成 → 已结算」这几个接口点为止。
- 版本级口径:D-00-82(金额输入)、D-00-10、D-00-11、D-00-13、D-00-18、D-00-19、D-00-24、D-00-26、D-00-32、D-00-34、D-00-55~D-00-57、D-00-59~D-00-62、D-00-65、D-00-67、D-00-69、D-00-73、D-00-74、D-00-76、D-00-78~D-00-81。
1 整体概述
1.1 背景与目标
现状:账单只有原型和一段注释,账单金额怎么来、预付和后付各怎么结、渠道统计金额为什么和账户加总对不上(苹果同一订单挂在多个账户下)、结算单和收款怎么衔接都没写清。
目标:
- 每个客户每个自然月一张账单,2 日自动出上月账单;一个结算期只有一种计费模式;后付按 03 规则算服务费、税费,预付按充值时锁定的分桶费率折算,金额和 05、03 同一口径。
- 后付款由人从账单生成结算单(可改应付、可换结算币种、自动带出余额抵扣),审批通过生成收款单,收款确认后账单结清;应付为 0 的结算单审批通过即结清;返点抵扣超出账单的部分结转到下期。预付款逐张账单判断是否被余额覆盖,覆盖完自动结清,欠费通知销售;改后付时没还清的欠费转入第一张后付账单收取。
- 渠道统计金额按订单号去重,内部能看到真实的消耗差额。
可证伪的判定:公共前置下 2026-10-02 出账,橙子 9 月账单总计 35,040.00 USD、第一层渠道统计金额 24,000.00(PR-0902 只算一次);生成结算单选人民币,应付默认 249,603.94;审批通过后账单变「待支付」,09 确认收款后变「已结算」。
1.2 本页范围
- ✅ 包含:账单生成与金额口径;上期预付欠费;渠道统计金额与消耗差额;账单状态机、刷新与锁定、预付逐张结清与欠费通知;账单管理页(账单信息 / 已提交审批);生成结算单弹窗(含余额抵扣、结转)与审批;审批内容区;05 费用明细 tab 的口径。
- ❌ 不包含:导出、账期计算(D-06-10);收款确认与手续费(09);返点金额计算(07);渠道统计金额的抓取与上传(08);交易明细实体与分桶本身(05);审批引擎(12)。
1.3 角色与权限
| 角色 | 能做什么 | 不能做什么 | 权限来源 |
|---|---|---|---|
| 有「账单管理(查看)」权限点的用户 | 看到账单管理菜单与页面 | — | D-00-78(R-06-025) |
| 有「生成结算单」权限点的用户(依赖「账单管理(查看)」,D-13-01) | 对能看到全部账户的后付款待结算账单生成结算单 | 对预付款账单生成结算单;改账单金额 | 新增权限点(D-06-15,13 汇总) |
| 申请人本人 | 撤回自己的审批中结算单(不校验业务权限点) | — | D-00-79(R-06-062) |
| 有「审批配置」权限点的用户 | 在审批详情作废审批中的结算单(效果同撤回) | — | D-00-79(R-06-052) |
| 能看到某账户的用户 | 看到含该账户的账单、该账户行与订单;同时持「账单管理(查看)」时只读查看含该账户的结算单审批详情(R-06-073) | 看他没有权限的账户行 | 现有账户查看权限(R-06-031) |
| 审批人 | 通过 / 驳回 | 改审批内容 | 12 |
| 系统 | 出账、刷新、预付逐张结清、欠费冻结与转入、结转额挂载、欠费通知 | — | R-06-001、R-06-019~R-06-022、R-06-074、R-06-078 |
1.4 术语定义
| 术语 | 释义 |
|---|---|
| 账单 | 一个客户一个 UTC0 自然月的费用汇总,每月 2 日出上月(D-00-10) |
| 结算单 | 由人从后付款账单手动生成的待付款单据,走「账单管理—生成结算单」审批,不单独设状态(D-00-60) |
| 流转计费模式 | 该结算期的计费模式(一个结算期只有一种,D-00-73),决定账单走预付还是后付流转(R-06-012) |
| 可结算应收 | 账户行应收加上期预付欠费;结算单的「预估应收金额」(R-06-013) |
| 上期预付欠费 | 预付改后付生效时没还清的预付账单欠费,冻结后按账户并入第一张后付账单(R-06-074) |
| 返点抵扣 / 余额抵扣 | 结算单里的两种抵扣行,名称固定:返点抵扣 = 本账单客户返点(07 后付余额抵扣计入的返点 + 结转额,不计到款);余额抵扣 = 改后付后账户里剩下的余额按退款口径自动抵应收(计入到款,R-06-076)。与 07 兑现方式「余额抵扣」不是一回事 |
| 结转额 | 返点抵扣超出账单可结算应收的部分,结算单通过后挂到下一张后付账单(R-06-077、R-06-078) |
| 自接苹果 | 系统从苹果同步订单、按订单号结算的账户系统(由账户系统配置决定,D-06-31);其他上游渠道只给金额 |
| 日汇率 | 当天 UTC 00:17 从系统汇率源取的那一次价格;结算锁定 4 位(D-00-74) |
| 在途结算单 | 审批中,或已通过但收款单未完成的结算单(D-00-61) |
1.5 核心流程
| 步骤 | 操作者 | 系统行为 | 产物 |
|---|---|---|---|
| 1 | 系统 | 当月有消耗即生成「未出账」账单,实时算 | 账单(未出账) |
| 2 | 系统 | 次月 2 日出账 → 待结算;预付账单消耗全部被分桶覆盖直接已结算,否则通知销售(R-06-021) | 账单(待结算 / 已结算) |
| 3 | 系统 | 待结算且未锁定时,随消耗修正、07 扣减返点、分桶覆盖、结转额挂上刷新(R-06-019) | — |
| 4 | 有权限的用户 | 后付账单「生成结算单」(自动带出余额抵扣;可结算应收为负时应付 0、结转)→ 提交审批,账单锁定、余额抵扣分桶锁定 | 结算单、审批单(12) |
| 5 | 审批人 | 通过 → 应付 > 0 生成 09 收款单、账单待支付;应付 = 0 直接已结算;扣分桶、挂结转额。驳回 / 撤回 / 作废 → 解锁回待结算 | 收款单(09)、交易明细(05) |
| 6 | 财务 | 09 确认收款 → 账单已结算(欠费转入它的预付账单一起已结算) | — |
| 7 | 系统 | 预付待结算账单逐张在被分桶覆盖完时已结算;预付改后付生效时把未结清欠费并入第一张后付账单(R-06-022、R-06-074) | — |
2 详细需求
2.1 账单与出账(定义)
2.1.1 功能描述
定义账单是什么、什么时候生成、币种和计费模式怎么取。
2.1.2 核心字段
| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|---|---|---|---|---|---|
| 结算期 | period | string(7) | 是 | yyyy-mm(UTC0) | — | 展示「yyyy-mm-01 至 yyyy-mm-最后一天」(R-06-001) |
| 账单币种 | currency | enum | 是 | 人民币 / USD / USDT | — | = 账户消耗币种(R-06-003) |
| 流转计费模式 | billing_mode | enum | 是 | 预付款 / 后付款 | — | 该结算期的计费模式(R-06-004、R-06-012) |
| 状态 | status | enum | 是 | 未出账 / 待结算 / 待支付 / 已结算 | 未出账 | 2.4 状态机 |
| 出账时间 | generated_at | datetime(UTC0,秒) | 否 | — | — | R-06-001 |
| 锁定来源审批单 | locked_by | 关联对象 | 否 | 12 审批单 | — | R-06-020 |
| 欠费转入账单 | arrears_moved_to | 关联对象 | 否 | 06 账单 | — | 预付账单欠费冻结后转入的后付账单(R-06-074) |
| 待结转金额 | pending_carryover | decimal(2) 账单币种 | 否 | — | — | 已生成、尚未挂上的结转额(R-06-078) |
| 结算时间 | settled_at | datetime(秒;存储为时间戳,展示北京时间 Asia/Shanghai) | 否 | — | — | 变已结算的时间(D-06-47) |
其余金额字段见 2.2.2。
2.1.3 业务规则
- R-06-001 账单按「客户 × UTC0 自然月」一张,结算期展示「yyyy-mm-01 至 yyyy-mm-最后一天」。当月从该客户第一天有任一账户消耗数据起就有一张「未出账」账单,金额随消耗实时变化;次月 2 日(UTC0)系统自动出账,账单变「待结算」,出账时刻由技术定;全月没有任何账户消耗数据的客户不生成账单(账单管理.html:3931 §2.4.1,D-06-13)。只出结算期 ≥ 上线月的账单,上线月与 07 计提、08、10、11 共用一个配置(index S-18;S-16 定为只从上线月起),上线月之前的结算期不出账单(D-06-36)。已知限制:客户全月零消耗、只有苹果订单或 08 入账时同样不生成账单,渠道金额在 08 / 10 查看(§2.1.5、index §2.9,D-06-45)
- R-06-002 第二层每个账户一行;同时满足以下条件的账户不展示:消耗、服务费、税费、服务费税费、客户返点、上期预付欠费都为 0,渠道统计金额为 0 或「-」,且没有订单行(D-06-33);客户返点不为 0 的账户照常展示,应收为负也展示(R-06-011);05 费用明细 tab、结算单弹窗明细、审批快照用同一口径
- R-06-003 账单币种 = 该客户账户的消耗币种(同一客户下所有账户相同,D-05-11);账单里所有金额都用账单币种,千分位、2 位小数、后缀币种代码,格式同 R-05-033;前端只展示服务端返回的 2 位金额,不做二次舍入(D-00-13);结算币种换算只发生在结算单(R-06-043)
- R-06-004 一个结算期只有一种计费模式:该结算期的计费模式 = 该结算期第一天(UTC0)客户生效的计费模式;04 的计费模式变更从确定时刻的次月 1 日(UTC0)起生效(预付改后付以审批通过时刻、后付改预付以保存时刻为准,D-00-73、R-04-023、R-04-024),结算期中途不切换(R-04-066),账单内不再按天区分预付日子、后付日子(D-06-12、D-06-24)
2.1.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 全月没有消耗 | 客户该月无数据 | 不生成账单 | 列表里没有这一行 |
| 全月零消耗、只有苹果订单或 08 入账(已知限制) | 客户该月有渠道金额、没有消耗 | 不生成账单(R-06-001,index §2.9) | 06 没有这一行,渠道金额在 08 / 10 查看 |
| 结算期早于上线月 | 上线前的月份 | 不出账单(R-06-001,index S-18) | 列表里没有这些结算期 |
| 账户全月为 0 且无渠道数据、无订单 | 其他账户有数据 | 该账户不进第二层(R-06-002) | 第二层少这个账户 |
| 账户消耗为 0 但有订单或渠道金额 | — | 照常展示(R-06-002) | 一行 0.00 消耗、有渠道统计金额 |
| 2 日出账任务失败 | 账单仍未出账 | 由技术重跑,出账时间以实际为准 | 仍显示「未出账」 |
| 结算期中途改计费模式 | 04 审批通过 / 保存 | 次月 1 日起生效,本结算期不变(R-06-004) | 本月账单仍是原计费模式 |
2.1.6 验收标准
出账与币种见 G-06-001、G-06-012;计费模式次月生效见 G-06-007。
2.2 金额口径(定义)
2.2.1 功能描述
账户行与第一层的消耗、服务费、税费、服务费税费、客户返点、上期预付欠费、应收 / 总计 / 可结算应收怎么算。
2.2.2 核心字段
| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|---|---|---|---|---|---|
| 消耗金额 | consumption | decimal(2) 账单币种 | 是 | ≥ 0 | — | R-06-005 |
| 服务费 | fee | decimal(2) 账单币种 | 是 | — | — | R-06-006~R-06-009 |
| 税费 | tax | decimal(2) 账单币种 | 是 | — | — | R-06-006~R-06-009 |
| 服务费税费 | fee_tax | decimal(2) 账单币种 | 是 | — | — | R-06-006~R-06-009 |
| 客户返点 | rebate | decimal(2) 账单币种 | 否 | 预付为空 | — | 含挂上的结转额(R-06-010) |
| 返点时间范围 | rebate_ranges | 列表 | 否 | 「yyyy-mm-dd 至 yyyy-mm-dd」/「yyyy-mm 结转」 | — | R-06-010 |
| 上期预付欠费 | prior_arrears | 列表(来源结算期 + 金额) | 否 | — | — | R-06-074 |
| 应收金额(账户行) | receivable | decimal(2) 账单币种 | 是 | — | — | R-06-011 |
| 总计(第一层) | total | decimal(2) 账单币种 | 是 | — | — | R-06-011 |
| 可结算应收 | settle_base | decimal(2) 账单币种 | 是 | — | — | R-06-013,页面不单列 |
| 无适用规则的日子 | no_rule_days | 列表 | 否 | 日期范围 | — | R-06-009 |
2.2.3 业务规则
- R-06-005 消耗金额 = 该账户本结算期内每个 UTC0 自然日的消耗之和,消耗数据来源沿用现有;历史消耗被修正时按 R-06-019 / R-06-020 决定账单变不变
- R-06-006 账户行三项费用:流转计费模式为预付款的账单按 R-06-007 算,后付款的按 R-06-008 算;第一层各金额 = 本账单全部账户行(含当前用户看不到的)之和,渠道统计金额例外(R-06-016);舍入点按 D-06-19(D-00-13):中间值可以存更高精度,但不能拿高精度值直接加总代替舍入点
- R-06-007 预付款账单:按 05 的先进先出(R-05-006),本结算期消耗从哪些分桶扣、各扣了多少 P,就用该分桶的费率快照(R-05-005)算:服务费 = P × 服务费率,税费 = P × 税率,服务费税费 = P × 服务费率 × 税率(快照为客户承担时;公司承担为 0);锁定中的分桶(审批中的退款、余额分配、余额抵扣占住的,R-05-007)不参与覆盖;返点余额等 0 费率分桶覆盖的消耗服务费、税费按 0,覆盖欠费时同样按 0(D-05-21);超出全部可用分桶的欠费消耗(R-05-009)先按该日 03 规则用 R-06-008 的算法暂算(阶梯落档时用该段全部消耗落档取比例,按日统计时用当天全部消耗,比例只乘欠费部分;欠费部分的各项各自四舍五入到 2 位,D-06-39),之后有新分桶按先进先出覆盖它时,改按新分桶的快照重算(账单待结算、未锁定、欠费未转入后付账单时生效,R-06-019,D-06-03、D-06-20);每个分桶的扣减段各自四舍五入到 2 位再相加(D-06-19)
- R-06-008 后付款账单:逐日取 03 的适用规则(R-03-003;已出账月份重算时以该月出账时刻为 t,R-06-019)与服务费时间区间行(R-03-005、R-03-006;消耗首日首次确定后冻结,早于首日的日子落第 1 行,D-00-56);把适用条款相同(服务费规则与税率完全相同,D-00-55)且落在同一行时间区间里的连续日子归成一段:固定比例 → 服务费 = 段内消耗 × 比例;阶梯 + 按月统计 → 段内消耗加总后按 R-03-009 落档 × 档位比例(落档用未舍入的原始消耗合计,D-00-13);阶梯 + 按日统计 → 每天单独落档 × 比例(R-03-010);税费 = 消耗 × 该段税率;服务费税费 = 服务费 × 税率(客户承担,R-03-028),公司承担为 0;按段(按日统计时按天)各项四舍五入到 2 位后相加(D-06-19)
- R-06-009 没有适用规则的日子(账户没有任何规则配置,或早于第一条规则起始日期)服务费率、税率按 0:服务费、税费、服务费税费为 0,照常出账、照常结算,不标异常、页面不加提示(D-00-57、D-06-08);按 0 计的日期范围记在账户行的「无适用规则的日子」里供技术排查与 S-1 导入核对,页面不展示
- R-06-010 客户返点(后付款账单)= 以下两项之和,按账户加到对应账户行:①07 里「纳入扣减月份」选了本结算期、审批已通过、合计 > 0 的客户返点(R-07-036、R-07-037);②挂到本账单的结转额(R-06-078);两项在账户行上分开记录(结转额不是本月新增的返点成本,10 不重复计),账户行应收因此可为负(D-07-16)。「返点时间范围」= ①所属的消耗日期段每段一行「yyyy-mm-dd 至 yyyy-mm-dd」,②每笔一行「yyyy-mm 结转」(yyyy-mm 为来源账单结算期);都没有显示「-」。预付款的返点在 07 审批通过时直接充进余额(D-00-19),流转计费模式为预付款的账单「客户返点」「返点时间范围」都显示「-」(D-06-11、D-00-18)
- R-06-011 账户行 应收金额 = 消耗金额 + 服务费 + 税费 + 服务费税费 − 客户返点;第一层「总计」= 各账户行应收金额之和(不去重,D-06-02);账户行应收、总计、可结算应收都可能为负(返点按账户加,D-07-16;审批期间账单变小,D-00-67),生成结算单时可结算应收为负的按 R-06-077 结转
- R-06-012 账单走哪条流转按「流转计费模式」= 该结算期的计费模式(R-06-004,已出账、未出账一样):预付款走 R-06-021,后付款走结算单(R-06-040 起)(D-06-12)
- R-06-013 可结算应收:账户行可结算应收 = 该账户行应收金额 + 该账户挂到本账单的上期预付欠费(R-06-074);账单可结算应收 = 各账户行可结算应收之和,没有上期预付欠费时 = 总计。结算单的「预估应收金额」、07 纳入扣减月份的比较(R-06-024)都取账单可结算应收
- R-06-074 上期预付欠费:客户预付款改后付款生效后(D-00-73),流转计费模式为预付款、仍未结清的账单,把欠费冻结并入该客户第一张后付款账单:①冻结时点:生效时已出账且待结算的,在生效时刻冻结;生效时还没出账的(切换前最后一个预付月份),按 R-06-021 出账时判一次,没结清就在出账时冻结;生效后到该月出账判结清或冻结之前,分桶照常按先进先出覆盖该月消耗,包括期间补报的消耗、释放的锁定分桶、新到账的充值;欠费冻结之后的消耗、生效月起的消耗不再被分桶覆盖(D-06-37);②冻结金额按账户算 = 该账户未被分桶覆盖的消耗 + 这部分按 R-06-007 暂算的服务费、税费、服务费税费(落档与舍入按 R-06-007),冻结后不再随分桶覆盖、消耗修正变化;已冻结转入后付账单、或已结算冻结的切换前月份,之后的消耗修正不再进入余额,也不再参与分桶覆盖,不改账单,线下处理(index §2.9,D-06-38);③承接账单 = 该客户生效月的账单(该月没有账单时顺延到之后第一张后付款账单),在承接账单生成时挂上(冻结时承接账单已生成的即刻挂上):对应账户行加一项「上期预付欠费(yyyy-mm)」= 冻结金额,每个来源结算期一行,计入账户行可结算应收(R-06-013),不计入总计,账户行当月没有消耗也照常展示;④原预付账单保持「待结算」、金额冻结;挂上前状态副标显示「欠费待转入下一张后付账单」,挂上后改为「欠费已转入 yyyy-mm 账单」,冻结期间不按 R-06-022 判结清;承接账单变「已结算」时(R-06-051 ③、R-06-053)一起变「已结算」并记结算时间(D-06-27);挂上前客户又改回预付款(改回预付生效时承接账单仍未生成)的,解除冻结,欠费退回余额,原账单重新按 R-06-022 判结清(D-06-38)
2.2.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 账户没有适用规则 | 没有任何规则配置或早于首条规则 | 费率按 0(D-00-57) | 服务费、税费 0.00,无提示 |
| 预付欠费 | 消耗超过可用分桶 | 暂按 03 规则算,被新分桶覆盖后重算 | 金额会变(仅未锁定、欠费未转入时) |
| 返点余额覆盖消耗 | 0 费率分桶 | 服务费、税费按 0(R-06-007) | 账户行服务费悬浮说明(R-06-028) |
| 返点大于可结算应收 | 07 想扣到本月 | 本月不可提交(R-06-024) | 07 侧提示 |
| 预付改后付时还有欠费 | 预付账单待结算 | 冻结并入第一张后付账单(R-06-074) | 后付账单多一项上期预付欠费 |
| 欠费已冻结、承接账单还没生成 | 生效月无消耗 | 等下一张后付账单生成时挂上(R-06-074 ③) | 原账单副标「欠费待转入下一张后付账单」 |
| 挂上前客户又改回预付 | 一直没有后付账单 | 解除冻结、欠费退回余额,原账单重新按 R-06-022 判结清(R-06-074 ④) | 副标回到「欠费 x {币种},待充值」或变已结算 |
| 切换前月份冻结后消耗修正 | 已冻结转入或已结算冻结 | 不进余额、不参与分桶覆盖、不改账单(R-06-074 ②) | 无变化,线下处理(index §2.9) |
| 消耗数据还没回来 | 当天消耗未到 | 按已有数据算 | 未出账金额偏小 |
2.2.6 验收标准
- G-06-001 前置:公共前置。操作:2026-10-02 出账后在账单管理展开橙子 2026-09 账单。期望:C 行:消耗 20,000.00、服务费 1,000.00、税费 1,200.00、服务费税费 60.00、客户返点 300.00、应收 21,960.00 USD,返点时间范围「2026-09-01 至 2026-09-30」;D 行:消耗 12,000.00、服务费 360.00(按月落第 2 档 3.00%)、税费 720.00、服务费税费 0.00、客户返点「-」、应收 13,080.00 USD;第一层总计 35,040.00 USD,状态待结算。
- G-06-004 前置:预付客户「星海网络科技有限公司」账户 A 分桶① 2026-09-15 到账 3,000.00(快照 8.00%、6.00%、客户承担);2026-09 消耗 2,000.00 USD。操作:2026-10-02 出账。期望:A 行服务费 160.00、税费 120.00、服务费税费 9.60、客户返点「-」、应收 2,289.60;9 月消耗全部被分桶①覆盖 → 账单出账即已结算,不发欠费通知,没有「生成结算单」。
- G-06-006 前置:后付客户账户 G 没有任何规则配置,2026-09 消耗 1,000.00 USD。操作:出账后查看。期望:G 行服务费、税费、服务费税费 0.00,应收 1,000.00,页面没有任何提示;账单正常待结算,可以生成结算单。
- G-06-007 前置:预付款客户「云帆科技有限公司」(币种 USD,销售 周婷)2026-09-16 提交预付改后付、2026-09-20 审批通过 → 2026-10-01(UTC0)起后付款;账户 H(USD)规则 2026-09-01 起 固定 5.00%、税率 6.00%、公司承担;H 只有分桶① 6,000.00(快照 5.00%、6.00%、公司承担);H 2026-09 消耗 7,000.00、2026-10 消耗 4,000.00。操作:2026-10-02 出 9 月账单;2026-11-02 出 10 月账单,打开 10 月账单的生成结算单。期望:9 月账单计费模式「预付款」(9-20 通过后仍是预付款);H 9 月行 服务费 350.00(6,000 × 5% + 1,000 × 5% 暂算)、税费 420.00、服务费税费 0.00、应收 7,770.00;出账时未结清 → 冻结欠费 1,110.00(1,000.00 + 50.00 + 60.00),9 月账单保持待结算、副标「欠费已转入 2026-10 账单」,周婷收到一次欠费通知;10 月账单计费模式「后付款」,H 行应收 4,440.00、上期预付欠费(2026-09)1,110.00,第一层总计 4,440.00;生成结算单预估应收 5,550.00;10 月账单之后变已结算时,9 月账单一起变已结算。
2.3 渠道统计金额与消耗差额
2.3.1 功能描述
内部对账用的两列:账户系统是自接苹果的,按订单号算并在第一层去重;其他渠道取 08 的数据。
2.3.2 核心字段
| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|---|---|---|---|---|---|
| 渠道统计金额 | channel_amount | decimal(2) 账单币种 | 否 | 未取到为空 | — | R-06-014~R-06-016 |
| 消耗差额 | consumption_diff | decimal(2) 账单币种 | 否 | 可为负 | — | R-06-017 |
| 订单号 | order_no | string | 是 | 苹果 PR 单据号 | — | 第三层首列;可在多个账户下出现(R-06-015、R-06-028) |
| 订单总计 | order_total | decimal(2) | 是 | — | — | 渠道统计金额取它(币种不同时取折算值,R-06-015) |
订单行其余字段(付款参考编号、账单、账单类型、产品或广告主、描述、发票、截止日期、小计、税费)沿用现有(D-06-10),税费显示口径见 R-06-028。
2.3.3 业务规则
- R-06-014 渠道统计金额与消耗差额只是内部对账用,不影响任何应收(D-06-05);数据来源:自接苹果的账户系统(系统从苹果同步订单、按订单号结算的账户系统,由账户系统配置决定,D-06-31)取第三层订单数据,其他上游渠道取 08 按「账户 × 结算期」提供的上传来源渠道统计金额(R-08-018 的总计,R-08-090;D-00-24、D-00-26);还没有数据时显示「-」,数据到了自动更新(§2.4 注)
- R-06-015 自接苹果:LOC 订单按「账单月份」落到 UTC0 自然月,没有账单月份的 CC 订单按交易日落月;订单币种与账户消耗币种不同时,LOC 订单按截止日期当天、CC 订单按交易日当天的日汇率(D-00-74)折成账户币种后计入;截止日期晚于今天时先按最近一天的日汇率暂折,截止日当天汇率入库后重折一次,之后不再变(同 08 R-08-017,D-06-46);账户行渠道统计金额 = 该账户下本结算期订单行「总计」(折算后)之和;同一订单号挂在多个账户下时,每个账户下都展示一次、各自计入本账户行(D-06-04);共享订单在订单号旁标注:同一张账单内共享写「与 {账户名称} 共享,各账户全额列示,第一层只算一次」,与其他客户的账户共享写「与其他客户账户 {账户名称} 共享,本账单全额计入」(D-06-31)
- R-06-016 第一层渠道统计金额只来自本账单列出的账户行(含当前用户看不到的,按 R-06-002 的展示条件):自接苹果 = 这些账户下全部订单行按订单号去重后的「总计」之和,因此可能小于账户行之和;其他上游渠道(没有订单号)= 各账户行直接相加;去重范围只在同一张账单内(同客户、同结算期),不跨客户、不跨结算期(D-06-04)
- R-06-017 消耗差额 = 本层消耗金额 − 本层渠道统计金额(账户行用账户行的,第一层用第一层去重后的);渠道统计金额为「-」时消耗差额也为「-」(D-06-05);表头说明见 R-06-027
- R-06-018 渠道统计金额、消耗差额不受锁定:任何状态下都随订单数据或 08 数据更新(D-06-17)
2.3.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 渠道数据未到 | 08 未入账 / 订单未出 | 两列为空 | 「-」 |
| 共享订单 | 同一订单在两个账户下 | 账户行各算一次,第一层算一次 | 第一层 < 账户行之和;订单号旁标注(R-06-015) |
| 订单没有税费字段 | USD 体系苹果订单 | 税费「-」、总计 = 小计(R-06-028) | 「-」 |
| 订单币种与账户不同 | — | 按截止日 / 交易日日汇率折算(R-06-015) | 总计旁显示折算值 |
| 账单已锁定后渠道数据到 | 待支付 / 已结算 | 只更新两列 | 两列变化,其他不变 |
2.3.6 验收标准
- G-06-002 前置:公共前置。操作:同上查看渠道统计金额与消耗差额,并展开 C、D 的第三层。期望:C 行渠道统计金额 20,000.00(PR-0901 + PR-0902)、消耗差额 0.00;D 行 12,000.00(PR-0902 + PR-0903)、0.00;第一层渠道统计金额 24,000.00(PR-0902 只算一次)、消耗差额 8,000.00;第三层首列为订单号,C、D 下都列出 PR-0902,C 下标注「与 橙子-iOS-HK 共享,各账户全额列示,第一层只算一次」、D 下标注「与 橙子-iOS-CN 共享,各账户全额列示,第一层只算一次」;苹果ASA 为 USD 体系,订单税费显示「-」、小计 = 总计;总计不受影响仍为 35,040.00。
- G-06-003 前置:三方渠道客户「蓝鲸游戏」账户 E、F 2026-09 消耗 5,000.00、3,000.00 USD,08 尚未入账。操作:查看账单;之后 08 上传审批通过 E 4,950.00、F 3,000.00。期望:上传前 E、F 与第一层渠道统计金额、消耗差额都显示「-」,账户行没有展开箭头;上传后 E 4,950.00 / 差额 50.00,F 3,000.00 / 0.00,第一层 7,950.00 / 50.00;若此时账单已待支付,这两列照样更新,其他金额不变。
2.4 状态、刷新与锁定(定义)
2.4.1 功能描述
账单状态机,以及账单什么时候跟着数据变、什么时候锁死。
2.4.3 业务规则
- R-06-019 未锁定的账单随最新数据刷新:未出账;以及待结算且没有审批中结算单的账单。触发刷新的变化:消耗修正、07 返点纳入本月扣减审批通过、预付分桶覆盖关系变化(R-06-007)、结转额挂上(R-06-078)、上期预付欠费并入(R-06-074);已出账月份重算时以该月出账时刻为 t 取适用规则(R-03-003、D-03-24),出账后才通过的规则不回改该月;刷新只重算金额,不改变状态(D-06-06)
- R-06-020 结算单提交成功时,账单第一、二层金额(渠道两列除外)锁定为结算单快照(R-06-049),页面展示快照值,第一层总计旁标「已锁定」,悬浮「金额为结算单提交时的快照」;驳回 / 撤回 / 作废时解除锁定、按最新数据刷新;审批通过后一直锁定(待支付、已结算)。预付款账单变已结算时按当时的金额冻结。锁定或冻结后的消耗修正不回改账单,也不补差(D-06-06、D-06-18);已知限制(收进 index §2.9):预付账单已结算冻结后再有消耗修正,只改 05 的余额、不改账单,两边金额可能不一致;预付改后付的切换前月份按 R-06-074 ② 处理(消耗修正不进余额、线下处理)
- R-06-021 预付款账单出账时判一次结清:出账时有挂起的结转额要入桶的(R-06-078),先入桶,再判结清、决定是否发欠费通知(D-06-41);该结算期内全部消耗都已被分桶按先进先出覆盖(锁定中的分桶不参与覆盖,R-06-007)→ 直接变「已结算」;否则保持「待结算」、按 R-06-075 显示欠费副标,并给客户的销售发一次欠费通知(D-00-11、D-06-22);只看本张账单,与其他月份、其他账户的余额无关
- R-06-022 预付款「待结算」账单(欠费未转入后付账单的)在之后每次分桶覆盖关系变化(充值到账、余额分配、返点余额抵扣、锁定释放、消耗修正)以及每个 UTC0 自然日再判一次,满足 R-06-021 的结清条件即变「已结算」并冻结;逐张判断,早月份先结清不用等晚月份(D-00-11、D-06-07)
- R-06-023 预付款账单不显示「生成结算单」,任何状态都不能生成结算单(D-06-07)
- R-06-024 可被 07 选为「纳入扣减月份」的账单(R-07-036):流转计费模式为后付款、状态待结算、没有审批中的结算单、没有被其他审批中且合计 > 0 的客户返点单选为扣减月份(同一张账单同一时间最多 1 张,D-00-18);未出账月份不可选;本次返点 ≤ 该账单当前可结算应收(D-00-18),只校验整单合计,账户行应收因此为负也允许(D-07-16);选项与可结算应收由服务端下发;只在 07 提交时校验,最后一个审批人通过时不再复核、照常生效(D-00-67),之后生成结算单时可结算应收为负的按 R-06-077 结转;通过后返点按账户加到对应账户行(R-07-037、R-06-010)
- R-06-075 预付款待结算账单的状态副标:有未被分桶覆盖的消耗时显示「欠费 x {账单币种},待充值」,x = 未被分桶覆盖的消耗 + 其按 R-06-007 暂算的服务费、税费、服务费税费之和(落档与舍入按 R-06-007),随覆盖关系变化;欠费已冻结、承接账单还没挂上的显示「欠费待转入下一张后付账单」,已转入后付账单的显示「欠费已转入 yyyy-mm 账单」(R-06-074)(D-00-11)
2.4.4 状态与流转
账单状态清单:未出账、待结算、待支付、已结算(D-00-59)。
| 当前状态 | 触发动作 | 操作者 | 目标状态 | 前置条件 |
|---|---|---|---|---|
| 无 | 当月第一天有消耗 | 系统 | 未出账 | R-06-001 |
| 未出账 | 次月 2 日出账 | 系统 | 待结算 | 全月有数据 |
| 未出账 | 次月 2 日出账,预付且消耗全部被分桶覆盖 | 系统 | 已结算 | R-06-021 |
| 待结算 | 预付:本账单消耗全部被分桶覆盖 | 系统 | 已结算 | R-06-022 |
| 待结算 | 预付、欠费已转入:承接的后付账单已结算 | 系统 | 已结算 | R-06-074 |
| 待结算 | 后付:结算单审批通过、应付 > 0 | 系统 | 待支付 | R-06-051 |
| 待结算 | 后付:结算单审批通过、应付 = 0.00 | 系统 | 已结算 | R-06-051(D-00-80) |
| 待支付 | 09 收款单确认收款 | 系统 | 已结算 | R-06-053 |
逆向:结算单驳回 / 撤回 / 作废 → 账单留在待结算、解锁、释放余额抵扣分桶、可重新生成(R-06-052);收款单作废 / 退回 → 本期不做(D-00-69,Q-06-05 已关闭),已知限制见 R-06-053。
2.4.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 审批中消耗被修正 | 账单已锁 | 不变,驳回后再刷新 | 显示快照金额,总计旁「已锁定」 |
| 待支付后消耗被修正 | 账单已锁 | 不回改、不补差(D-06-18) | 金额不变 |
| 预付欠费月份多张 | 多张待结算 | 逐张判断,先被覆盖完的先结清(R-06-022) | 早月份先变已结算 |
| 预付退款审批中 | 分桶锁定 | 锁定分桶不参与覆盖(R-06-007) | 欠费副标不变小 |
| 返点与结算单抢同一月 | 返点审批中 | 「生成结算单」置灰(R-06-040) | 悬浮「有审批中的返点抵扣单 {单号},审批结束后可生成」 |
| 返点审批中账单变小 | 通过后可结算应收被扣成负数 | 最终通过不复核、照常生效(R-06-024、D-00-67) | 生成结算单时应付 0.00、结转(R-06-077) |
2.4.6 验收标准
- G-06-005 前置:同 G-06-004,但 2026-09 消耗 3,500.00(超出分桶① 500.00),该日规则第 1 行固定 8.00%。操作:2026-10-02 出账;2026-10-16 一笔 12,000.00(快照 3.00%、6.00%、客户承担)充值到账。期望:出账时服务费 280.00(3,000 × 8% + 500 × 8% 暂算)、税费 210.00、服务费税费 16.80,状态待结算、副标「欠费 572.40 USD,待充值」,销售张伟收到一条欠费通知;10-16 到账后 500.00 改按 3.00%,服务费变 255.00、税费仍 210.00、服务费税费 15.30,消耗全部被覆盖 → 账单变已结算并冻结,副标消失。
- G-06-008 前置:公共前置,账单待结算、无在途结算单。操作:2026-10-04 C 的 9-20 消耗修正 +500.00。期望:C 行消耗 20,500.00、服务费 1,025.00、税费 1,230.00、服务费税费 61.50、应收 22,516.50;总计 35,596.50;状态仍待结算。
- G-06-009 前置:公共前置,王敏已提交结算单(审批中)。操作:2026-10-06 C 的 9-20 消耗修正 +500.00;随后审批人驳回。期望:修正后账单仍显示快照 35,040.00、总计旁「已锁定」,「生成结算单」置灰;驳回后解锁刷新为 35,596.50,「生成结算单」重新可点。
- G-06-010 前置:公共前置,结算单已通过、账单待支付。操作:C 消耗修正 +500.00;之后 09 确认收款。期望:账单金额保持 35,040.00 不变、不出补差单;确认收款后账单变已结算、记结算时间,已提交审批该单执行状态「已收款」。
- G-06-011 前置:公共前置,账单待结算、无在途结算单。操作:07 再审批通过一笔 D 的返点 200.00(纳入 2026-09);再试一笔 C 的返点 40,000.00 选 2026-09。期望:D 行客户返点 200.00、应收 12,880.00,总计 34,840.00;40,000.00 那笔大于可结算应收,07 不能提交。
- G-06-025 前置:预付客户星海账户 A 规则 固定 0.00%、税率 0.00%;A 2026-08 账单待结算,欠费消耗 300.00;2026-09 账单出账后待结算,欠费消耗 500.00(9 月没有可用分桶)。操作:2026-10-05 一笔 400.00(快照 0.00%、0.00%)充值到账。期望:先进先出覆盖 8 月欠费 300.00 → 8 月账单变已结算;9 月账单 100.00 被覆盖,仍待结算,副标从「欠费 500.00 USD,待充值」变为「欠费 400.00 USD,待充值」;若到账前 A 有一笔审批中的退款锁定了分桶,被锁定的分桶不参与覆盖。
2.5 账单信息列表
2.5.1 功能描述
账单管理页的「账单信息」tab,三层展开,按账户权限过滤;05 的费用明细 tab 复用它。
2.5.3 业务规则
- R-06-025 页面标题「账单管理」,两个切换「账单信息 / 已提交审批」,默认账单信息(原型标题「账单中心」统一为「账单管理」,D-06-16);菜单与页面按「账单管理(查看)」权限点显示:没有该点不显示菜单,直接访问按 R-13-005 在内容区显示「无权限访问」、保留当前地址;「生成结算单」权限点依赖该查看点,服务端同样校验(D-13-01);有该点的用户看到哪些账单仍按 R-06-031 过滤(D-00-78、D-06-15)
- R-06-026 搜索框按公司名称、客户别名、账户名称、orgId 包含匹配,占位「搜索公司名称 / 客户别名 / 账户名称 / orgId」;账户名称和 orgId 只在当前用户有查看权限的账户里匹配,由服务端过滤;命中账户时展示该账单,第二层照常列全部可见账户,不是只列命中的那个(D-06-14);筛选:所属账户系统(全部 + 现有账户系统列表,原型里的登记表状态选项是复制残留)、结算期(全部 + 有账单的结算期,降序,由服务端返回;「全部」就是全部历史,不加隐含时间窗)、状态(全部 / 未出账 / 待结算 / 待支付 / 已结算),默认全部(D-06-13)
- R-06-027 第一层每张账单一行,列依次:结算期、公司名称(左固定)‖ 所属账户系统、计费模式、客户别名、销售、消耗金额、服务费、税费、服务费税费、客户返点、渠道统计金额、消耗差额、总计、状态 ‖ 操作(右固定);计费模式列显示该结算期的计费模式(= 流转计费模式,已出账、未出账一样,R-06-012);所属账户系统、客户别名、销售取客户当前值;「消耗差额」表头带问号,悬浮「= 消耗金额 − 渠道统计金额。渠道统计金额取渠道总计(含税,上传类已扣渠道返点),仅内部对账,差额不为 0 不一定是数据有误」;状态列:「未出账」旁悬浮「金额为实时预估,随消耗数据更新,数据截至 yyyy-mm-dd hh:mm(UTC0)」(截至时间取消耗数据最近一次同步的时间,技术取不到时去掉后半句);待结算且有审批中结算单时副标「结算单审批中」,点击新页打开审批详情;待支付时副标「收款单待完成」(纯文本);预付款待结算的副标按 R-06-075;有待结转金额时「客户返点」旁显示「待结转 {金额}」(R-06-078);锁定时总计旁「已锁定」(R-06-020);公司名称过长省略、悬浮显示全称(D-06-32)
- R-06-028 点第一层行(含未出账)展开第二层账户行,按消耗金额降序、相同按账户名称升序(D-06-33);列依次:账户名称、消耗金额、服务费、税费、服务费税费、渠道统计金额、消耗差额(表头问号同 R-06-027)、客户返点、上期预付欠费(本账单有时才出这一列,R-06-074)、应收金额、返点时间范围;预付款账单中有 0 费率分桶覆盖消耗的账户行,服务费格悬浮「其中 {x} 消耗由返点余额抵扣,按 0 费率计」(D-05-21、D-06-34);点有订单的账户行展开第三层订单行,列依次:订单号、付款参考编号、账单、账单类型、产品或广告主、描述、发票、截止日期、小计、税费、总计(沿用现有);税费:账户系统有税费字段的(人民币体系)照实展示,没有税费字段的(USD 体系,老数据为空)显示「-」、总计 = 小计,不用「总计 − 小计」反推;订单币种与账户币种不同时总计旁显示折算值(R-06-015,D-06-31);没有订单数据的账户(三方渠道)不显示展开箭头(§2.4.3)
- R-06-029 排序:结算期降序,同一结算期按总计降序;分页按第一层 10 / 50 / 100 / 300 条每页,默认 10;没有数据显示「暂无账单」(§2.5,D-06-14)
- R-06-030 第一层操作列只有「生成结算单」,按 R-06-040 隐藏或置灰;原型的「导出」按钮(顶部与行内)和勾选框本期不做(D-06-10、D-06-16)
- R-06-031 数据权限跟账户查看权限走:用户对账单里任一账户有查看权限才展示该账单;第二层只列他有权限的账户;第一层金额始终是整张账单的(结算按整张出,D-00-61),有看不到的账户时在第二层末尾显示「另有 N 个账户无查看权限」,N 只数按 R-06-002 会展示的账户(D-06-15)
- R-06-032 05 费用明细页的「费用明细」tab(R-05-093)= 本页账单信息按单个客户展示:没有搜索和公司名称、所属账户系统、客户别名、销售列,结算期筛选与状态筛选保留,三层、列口径、副标、权限与本页相同;只读,不显示「生成结算单」;该 tab 的页面准入按 05(D-06-25)
2.5.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 没有「账单管理(查看)」 | — | 不显示菜单(R-06-025) | 直接访问时内容区「无权限访问」,保留地址(R-13-005) |
| 无数据 | 筛选后为空 | — | 「暂无账单」 |
| 只能看部分账户 | 账单里有看不到的账户 | 第一层整单金额、第二层只列可见 | 「另有 N 个账户无查看权限」 |
| 搜索无权限账户的名称 / orgId | — | 服务端不匹配(R-06-026) | 无结果 |
| 一个账户都看不到 | — | 整张账单不出现 | — |
| 公司名称过长 | — | 省略 | 悬浮显示全称 |
2.5.6 验收标准
- G-06-012 前置:今天 2026-10-19;橙子有 2026-08(已结算)、2026-09(待结算)账单和 10 月消耗;客户「空客户」9 月无任何消耗。操作:打开账单管理。期望:橙子三行按结算期降序:2026-10 未出账(无操作,状态旁悬浮「金额为实时预估,随消耗数据更新,数据截至 …(UTC0)」,可展开第二层)、2026-09 待结算(「生成结算单」可点)、2026-08 已结算;三行计费模式都是「后付款」;空客户没有 9 月账单;状态筛选「待支付」时橙子一行都不出现。
- G-06-013 前置:公共前置,用户钱磊只能看账户 C,有「生成结算单」权限点。操作:打开账单管理展开橙子 9 月账单。期望:第一层总计仍 35,040.00;第二层只有 C 行,末尾「另有 1 个账户无查看权限」;「生成结算单」置灰,悬浮「另有 1 个账户无查看权限,不能生成」。
- G-06-014 前置:公共前置,用户赵晨能看 C、D 但没有「生成结算单」权限点;另有一个预付款待结算账单。操作:打开账单管理。期望:橙子 9 月账单不显示「生成结算单」;预付款账单对任何人都不显示「生成结算单」;没有「导出」按钮和勾选框。
- G-06-015 前置:公共前置。操作:王敏在 05 费用明细页打开橙子的「费用明细」tab。期望:看到 2026-10 / 09 / 08 三张账单,三层与金额同账单管理;没有「生成结算单」;按 05 R-05-093 只出现他能看的账户。
- G-06-031 前置:公共前置;钱磊只能看 C。操作:王敏搜索「5130048」(D 的 orgId);钱磊搜索「橙子-iOS-HK」。期望:王敏看到橙子 9 月等账单,展开后第二层仍列 C、D 两行;钱磊搜索结果为「暂无账单」。
- G-06-032 前置:公共前置,另有账户「橙子-iOS-TW」2026-09 消耗 0、服务费税费等都为 0,但有苹果订单 PR-0904 总计 500.00(只在 TW 下)。操作:展开橙子 9 月账单。期望:第二层按消耗降序 C、D、TW,TW 行消耗 0.00、渠道统计金额 500.00、消耗差额 -500.00,可展开看到 PR-0904;第一层渠道统计金额 24,500.00;钱磊(只能看 C)看到「另有 2 个账户无查看权限」。
- G-06-033 前置:用户孙悦没有「账单管理(查看)」权限点。操作:孙悦登录看侧栏,并直接访问账单管理地址。期望:侧栏没有「账单管理」;直接访问时内容区显示「无权限访问」,地址栏保留原地址;即使孙悦有「生成结算单」权限点,调生成结算单接口也被服务端拒绝。
- G-06-034 前置:预付客户星海账户 A 只有一个分桶:07 返点余额抵扣入的 200.00 USD(费率快照 0);A 2026-09 消耗 200.00,当日规则固定 8.00%、6.00%。操作:2026-10-02 出账后展开星海 9 月账单。期望:A 行服务费 0.00、税费 0.00、服务费税费 0.00、应收 200.00,服务费格悬浮「其中 200.00 消耗由返点余额抵扣,按 0 费率计」;账单出账即已结算。
2.6 生成结算单
2.6.1 功能描述
后付款待结算账单的行操作,打开弹窗确认金额(含自动带出的余额抵扣、结转提示)、选结算币种与付款主体、可改应付,提交「账单管理—生成结算单」审批。
2.6.2 核心字段
| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|---|---|---|---|---|---|
| 预估应收金额 | est_receivable | decimal(2) 账单币种 | 是 | 只读 | 账单可结算应收 | R-06-041、R-06-013 |
| 消耗 / 税费 / 服务费 / 服务费税费 / 返点抵扣 / 上期预付欠费 | — | decimal(2) 账单币种 | 是 | 只读 | 账单值(返点抵扣 = 账单客户返点合计) | R-06-041 |
| 余额抵扣 | balance_offset | decimal(2) 账单币种,按账户 | 否 | 只读,≥ 0 | 系统带出(行名固定「余额抵扣」) | R-06-076 |
| 结转额 | carryover | decimal(2) 账单币种 | 否 | 只读,> 0 | — | 可结算应收为负时(R-06-077) |
| 结算币种 | settle_currency | enum | 是 | 人民币 / USD / USDT | 客户币种 | R-06-042 |
| 汇率 | fx_rate | decimal(4) | 是 | 1 账单币种 = x 结算币种 | 当天日汇率四舍五入 4 位 | R-06-043 |
| 汇率日期 | fx_date | date(UTC0) | 币种不同时是 | — | 实际取到汇率的日期 | R-06-043 |
| 应付金额 | payable | decimal(2) 结算币种 | 是 | ≥ 0 | (预估应收 − 余额抵扣)× 汇率 | R-06-044 |
| 付款主体 | payer | string | 是 | 客户当前付款主体 | — | R-06-045 |
| 备注 | remark | text | 应付 ≠ 默认时是 | 沿用现有长度 | 空 | R-06-046 |
2.6.3 业务规则
- R-06-040 「生成结算单」按钮:没有「账单管理(查看)」或「生成结算单」权限点(D-13-01)、流转计费模式为预付款、或状态不是待结算时不显示;其余情况显示,下列任一条件成立时置灰并悬浮显示原因,同时有多条时只显示优先级最高的一条:①「该账单已有审批中的结算单 {审批单号}」;②「有审批中的返点抵扣单 {审批单号},审批结束后可生成」(07 选了本结算期扣减、合计 > 0、仍在审批中的客户返点单,D-06-23、R-07-053);③「另有 N 个账户无查看权限,不能生成」(D-06-15);单号可点,新页打开审批详情(D-06-32)
- R-06-041 生成结算单弹窗:标题「生成结算单」,右上角 ✕ 关闭,底部只有「提交审批」;只读信息 公司名称、结算期、预估应收金额(= 账单可结算应收,R-06-013)、消耗金额、税费、服务费、服务费税费、返点抵扣(= 账单客户返点合计,R-06-010)、上期预付欠费(有时)、余额抵扣(有时,R-06-076)(账单币种;两种抵扣行名称固定为「返点抵扣」「余额抵扣」);可结算应收为负时显示结转提示(R-06-077);下方带本账单第一、二层只读明细(同 R-06-027、R-06-028,有余额抵扣时账户行多一列「余额抵扣」,不带勾选框)
- R-06-042 结算币种(原型字段名「结算货币」,统一叫结算币种,D-00-68):必选,下拉单选 人民币 / USD / USDT,默认客户的币种,客户币种为空时没有默认值(R-04-011);原型占位里的「美元」不做(D-00-08)
- R-06-043 结算币种与账单币种相同时汇率为 1、不显示汇率;不同时显示「汇率:1 {账单币种} = x {结算币种}(yyyy-mm-dd)」,x = 当天(UTC0)日汇率四舍五入到 4 位,显示与计算都用这 4 位;日期 = 实际取到的那天(当天没有、向前取最近一天时显示那一天)(D-00-74、D-00-62);提交时服务端按提交当天重新取并锁定,与弹窗不同时按 R-06-048 ② 请用户确认;汇率与汇率日期随单进快照;取不到任何汇率时不能提交,提示「未取到 {账单币种}→{结算币种} 汇率,请稍后再试」
- R-06-044 应付金额(结算币种):必填,默认 = (预估应收金额 − 余额抵扣)× 汇率,四舍五入到 2 位;可以改,不设上限;输入按 D-00-82:输入框只接受数字和一个小数点:负号、字母输不进去,小数第 3 位按不下去;粘贴或自动填充的非法内容不写入、保留原值,并就地标红「请输入不小于 0、最多 2 位小数的金额」;任何情况下都不静默四舍五入或截断;输入框下显示「默认 {默认应付} {结算币种}」,应付 ≠ 默认时再显示「已调整 {应付 − 默认}」(带正负号);切换结算币种时按新汇率重新带出默认值、覆盖已改的值(D-06-09、D-06-21);预估应收金额为负时按 R-06-077 固定 0.00、只读
- R-06-045 付款主体:必选,下拉单选,选项 = 该客户当前生效的付款主体;「+ 新增付款主体」、客户没有付款主体、有审批中的付款主体变更、新增提交后的提示与「需审批通过后可选」灰字,做法全部同 05 R-05-042(调起 04 付款主体弹窗、走付款主体变更审批、通过前不在选项里、仅「客户管理-读写」可见)(D-06-21)
- R-06-046 备注:多行,长度上限沿用现有备注输入框;应付金额 ≠ 默认应付时必填,未填提示「修改了应付金额,请在备注中说明原因」,其余情况选填;即审批发起备注,同时在审批内容区展示(同 D-05-31 做法,D-06-09)
- R-06-047 点「提交审批」校验结算币种、应付金额、付款主体、备注(R-06-046),不通过在对应位置提示;通过后二次确认,标题「提示」(同 R-05-078),文案「生成结算单需进行审批,是否提交审批单?」(取消 / 确定)
- R-06-048 确定后服务端复核:「账单管理(查看)」与「生成结算单」权限点、R-06-040 的全部条件、所选付款主体仍在客户当前生效的付款主体里、汇率、账单金额与余额抵扣与弹窗展示一致。①账单或余额抵扣在弹窗打开期间变了:不建单、弹窗不关,按最新数据就地重载:保留结算币种、付款主体、备注;值没变的行原样保留,值变了的行标黄「系统计算值已由 X 变为 Y」;应付金额用户没改过的跟随新默认值,改过的保留用户填的值;顶部提示「数据已更新,请核对后重新提交」,用户再点一次提交才建单;②提交当天汇率与弹窗不同:不建单,返回新汇率,弹确认「汇率已更新为 1 {账单币种} = x {结算币种}(yyyy-mm-dd),换算后金额 {Y},是否按新汇率提交?」,Y = 按新汇率算的默认应付;用户改过应付的保留其值,确认框里同时列出新的默认值;点确定后按新汇率建单(D-06-30);③付款主体已不在选项里:提示「付款主体已变更,请重新选择」;④已有在途结算单(句式按 R-12-047):审批中的用提示框(「知道了」)「该账单已有审批中的生成结算单(审批单号 {单号},申请人 {姓名}),请等审批结束或撤回后再操作」,已通过、收款单未完成的「该账单已有处理中的结算单(收款单 {财务ID},待完成),待收款完成后再操作」;单号可点、新页打开审批详情,无查看权限按 R-12-043;⑤R-06-040 ②③ 任一在复核时成立(弹窗打开期间出现审批中的返点抵扣单、可见账户变化):不建单,提示框显示对应的置灰原因原文,单号可点(D-06-44);同一弹窗连续点击只提交一次,请求中按钮显示加载
- R-06-049 复核通过后提交「账单管理—生成结算单」审批(R-12-001、R-12-014):操作对象客户 = 本客户;涉及账户 = 本账单第二层全部账户(D-00-76);业务单据 = 弹窗全部内容 + 汇率与汇率日期 + 默认应付金额 + 余额抵扣明细(每个账户取用的分桶与金额,R-06-076)+ 结转额(有时,R-06-077)+ 账单第一、二层全部金额快照(含当前用户看不到的账户行);发起备注 = 备注。成功后按 12 R-12-018 给弱提示(审批中「已提交审批」;免审直接通过「提交成功,无需审批,已生效」)、关闭弹窗、账单按 R-06-020 锁定、余额抵扣的分桶锁定(R-06-076)
- R-06-076 余额抵扣(后付):生成结算单时客户当前生效的计费模式为后付款、且账单可结算应收 > 0 时,系统按账户自动带出「余额抵扣」,只读:每个账户 = min(该账户行可结算应收(< 0 按 0), 该账户未锁定分桶按退款口径 R-05-027 折算的应退金额);按先进先出取分桶,分桶余额与应退金额之间的换算同 R-05-027;余额抵扣金额以剩余应收为准,最后一个分桶只取够抵的部分,取用本金与尾差按 R-05-118 ①(本金 = round2(所需金额 ÷ 倍率),不超过该桶剩余;尾差计入服务费,同 R-05-022,D-06-46);余额抵扣之和不超过账单可结算应收,超出时从余额抵扣最大的账户行减回(相同按账户名称升序取第一个)(D-06-35);返点抵扣(= 客户返点,R-06-010)先扣,余额抵扣在其后;提交成功时锁定所取分桶(同退款,R-05-007),驳回、撤回、作废时释放;审批通过时扣减这些分桶,并按 05 写一条「余额抵扣账单」交易明细(取值以 R-05-095、R-05-097 为准:充值金额 = −扣减的分桶金额之和,应付、实收、手续费显示「-」,关联账单 = 被抵扣的本账单);余额抵扣算客户已付款(计入到款),与返点抵扣(不计到款)分开记录;抵不完的余额留在分桶里供下一张后付账单;客户改回预付后剩余分桶恢复先进先出(D-00-73、D-06-27)
- R-06-077 可结算应收为负:生成结算单时账单可结算应收 < 0 → 应付金额固定 0.00、只读,不做余额抵扣,不要求备注;结转额 = −可结算应收(账单币种);弹窗与审批内容区显示「本次抵扣 {返点抵扣 − 结转额},剩余 {结转额} 结转至下期」;结转额在审批通过时生成(R-06-078),驳回、撤回、作废不生成;只有这一种情况能产生结转,人工把正数应付改成 0 不产生结转(D-00-81、D-06-28)
- R-06-079 待结算返点提示:打开生成结算单弹窗时,该客户在 07 还有状态为「待结算」的客户返点计提项的,顶部黄条提示「该客户还有待结算的客户返点 {合计} {币种}({结算期,多个用「、」分隔}),生成结算单后不能再抵扣本账单,可在返点管理里抵扣其他账单或现金打款」,合计取 07 计提项金额(R-07-011);只提示、不拦提交(D-06-34)
2.6.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 弹窗期间账单刷新 | 金额变了 | 不建单、就地重载(R-06-048 ①) | 变化行标黄,顶部「数据已更新,请核对后重新提交」 |
| 跨零点或当天汇率更新 | 提交当天汇率不同 | 不建单,弹确认(R-06-048 ②) | 「汇率已更新为 …,是否按新汇率提交?」 |
| 两人同时提交 | 并发 | 只建 1 张 | 提示框「该账单已有审批中的生成结算单(审批单号 …,申请人 …)…」 |
| 取不到汇率 | 汇率表空 | 不能提交 | 「未取到 USD→人民币 汇率,请稍后再试」 |
| 客户没有付款主体 | 下拉为空 | 不能提交 | 文案按 R-05-042(区分有无「客户管理-读写」) |
| 付款主体期间被删除 / 改名 | 复核不通过 | 不建单(R-06-048 ③) | 「付款主体已变更,请重新选择」 |
| 弹窗期间出现审批中的返点抵扣单 / 可见账户变化 | 复核不通过 | 不建单(R-06-048 ⑤) | 提示框显示置灰原因原文,单号可点 |
| 改了应付没写备注 | — | 不能提交(R-06-046) | 「修改了应付金额,请在备注中说明原因」 |
| 可结算应收为负 | 返点超出 | 应付 0.00 只读、结转(R-06-077) | 「本次抵扣 X,剩余 Y 结转至下期」 |
| 余额抵扣抵满 | 默认应付 0.00 | 照常提交,通过即已结算(R-06-051 ③) | 应付 0.00 |
| 客户币种为空 | 无默认结算币种 | 必须手选 | 结算币种为空 |
| 连续点击 | — | 只提交一次 | 按钮加载 |
2.6.6 验收标准
- G-06-016 前置:公共前置;生成结算单当天 2026-10-05。操作:王敏点「生成结算单」。期望:弹窗右上角 ✕、底部只有「提交审批」;预估应收 35,040.00 USD 等只读;结算币种默认人民币(下拉);显示「汇率:1 USD = 7.1234 人民币(2026-10-05)」;应付金额默认 249,603.94,下方「默认 249,603.94 人民币」;付款主体选项 橙子出行科技有限公司、Orange Mobility Ltd。
- G-06-017 前置:G-06-016 打开的弹窗。操作:把应付改为 249,000.00、不写备注,选付款主体后点提交审批;再在备注填「客户协商抹零」后提交并确定。期望:改后显示「已调整 -603.94」;第一次提交被拦,备注处提示「修改了应付金额,请在备注中说明原因」;填备注后二次确认框标题「提示」,确定后提交成功、弱提示「已提交审批」;业务单据里默认应付 249,603.94、应付 249,000.00、汇率 7.1234、汇率日期 2026-10-05;账单锁定、总计旁「已锁定」、状态副标「结算单审批中」、「生成结算单」置灰;已提交审批出现一行审批中,执行状态「-」。
- G-06-018 前置:G-06-016 打开的弹窗。操作:在应付框键入「-」和字母;输入 100.12 后再键入「3」;粘贴「100.123」;再改结算币种为 USD。期望:「-」和字母输不进去;第 3 位小数按不下去,框内仍是 100.12;粘贴内容不写入、保留原值并标红「请输入不小于 0、最多 2 位小数的金额」;切 USD 后不显示汇率,应付重新带出 35,040.00。
- G-06-019 前置:王敏打开弹窗、没改应付、选了付款主体,期间 C 消耗修正 +500.00 导致账单刷新。操作:点提交并确定。期望:不创建审批单,弹窗不关;C 行标黄「系统计算值已由 21,960.00 变为 22,516.50」,预估应收变 35,596.50,应付跟随新默认值 253,568.11,付款主体保留;顶部「数据已更新,请核对后重新提交」;再点提交并确定后建单。
- G-06-020 前置:王敏、赵晨(假设有权限点并能看 C、D)同时打开同一账单的弹窗。操作:王敏先提交成功,赵晨后提交。期望:只生成 1 张审批单;赵晨看到提示框「该账单已有审批中的生成结算单(审批单号 {王敏的单号},申请人 王敏),请等审批结束或撤回后再操作」,单号可点,按钮「知道了」。
- G-06-021 前置:07 有一张选了橙子 2026-09 扣减、合计 300.00、审批中的返点单。操作:王敏查看该账单;返点单通过后再看。期望:「生成结算单」置灰,悬浮「有审批中的返点抵扣单 {单号},审批结束后可生成」;通过后账单刷新、按钮可点。
- G-06-026 前置:接 G-06-007;云帆另有账户 K,规则同 H,改后付生效时 K 有未锁定分桶② 剩余 1,000.00(快照 服务费率 5.00%、税率 6.00%、客户承担),K 2026-10 消耗 3,000.00。操作:2026-11-02 打开 10 月账单的生成结算单(结算币种 USD),提交;审批通过。期望:K 行应收 3,330.00,账单可结算应收 8,880.00(H 5,550.00 + K 3,330.00);K 行余额抵扣 1,113.00(1,000 × (1 + 6% + 5% + 5% × 6%))、H 行 0.00,余额抵扣合计 1,113.00;默认应付 7,767.00 USD;提交后 K 可用余额 0.00;通过后分桶②扣完,05 交易明细新增「余额抵扣账单」,09 收款单应收 7,767.00 USD,账户权重 H 5,550.00、K 2,217.00;若改为驳回,分桶②释放、K 可用余额回到 1,000.00。
- G-06-027 前置:公共前置,但 C 9 月在 07 抵扣到 2026-09 的客户返点为 35,000.00(审批已通过,没有 300.00 那笔);之后 D 9-25 消耗修正 −1,000.00,D 行应收 11,990.00;橙子 10 月账单未出账。操作:2026-10-06 王敏生成结算单(结算币种人民币)提交,审批通过;2026-11-02 10 月账单出账。期望:弹窗预估应收 -750.00 USD(C -12,740.00 + D 11,990.00),应付 0.00 只读,显示「本次抵扣 34,250.00,剩余 750.00 结转至下期」,不要求备注;通过后不生成收款单,9 月账单直接已结算,已提交审批执行状态「已结清(0 元)」;当时没有可挂的后付待结算账单 → 9 月账单「客户返点」旁「待结转 750.00」;10 月账单出账后 C 行客户返点增加 750.00、返点时间范围多一行「2026-09 结转」,9 月账单的「待结转」消失。
- G-06-028 前置:同 G-06-027,但橙子 2026-09-20 保存了后付改预付 → 2026-10-01 起预付款。操作:同 G-06-027。期望:10 月账单流转计费模式预付款;11-02 出账时 750.00 按 0 费率充进 C 余额(新分桶 750.00 USD,费率快照 0),05 交易明细新增「客户返点」已完成、备注「2026-09 账单结转」;10 月账单客户返点仍「-」。
- G-06-029 前置:公共前置;07 里 D 的 2026-09 客户返点 90.00 待结算。操作:王敏打开 9 月账单的生成结算单。期望:顶部黄条「该客户还有待结算的客户返点 90.00 USD(2026-09),生成结算单后不能再抵扣本账单,可在返点管理里抵扣其他账单或现金打款」;照常可以提交。
- G-06-030 前置:公共前置;王敏 2026-10-05 23:58(UTC0)打开弹窗(汇率 7.1234),2026-10-06 的日汇率为 7.1301。操作:未改应付,2026-10-06 00:20 提交并确定;另一次把应付改为 249,000.00(填了备注)后同样跨零点提交。期望:不建单,确认框「汇率已更新为 1 USD = 7.1301 人民币(2026-10-06),换算后金额 249,838.70,是否按新汇率提交?」,确定后建单,单内汇率 7.1301、汇率日期 2026-10-06、应付 249,838.70;改过应付的那次确认框同时列出新默认 249,838.70,确定后应付仍为 249,000.00。
2.7 审批结果
2.7.1 功能描述
结算单审批结束后账单、收款单、分桶、结转额、交易明细怎么变。
2.7.3 业务规则
- R-06-050 审批流 0 节点或全部节点被跳过时提交即通过(R-12-018),立即按 R-06-051 处理
- R-06-051 审批单变为已通过(R-12-025)时:①余额抵扣 > 0 的按 R-06-076 扣减分桶;有结转额的按 R-06-078 处理;②应付金额 > 0:生成一张 09 收款单(交易类型 结算单支付,应收 = 应付金额,币种 = 结算币种,付款主体,关联本结算单与账单;另带账单第二层每个账户行及其本次应收 = 账户行可结算应收 − 余额抵扣,即扣完返点抵扣、余额抵扣、含上期预付欠费后的剩余应收(账单币种,作为 09 手续费分摊权重,R-09-002;本次应收 ≤ 0 的账户行分摊权重按 0,本次应收照原值记录,D-06-42));按 R-05-094 写一条「结算单支付」交易明细(待完成):发起时间 = 申请时间,充值金额显示「-」(余额不变),应付金额 = 应付金额(结算币种),账户列表每个账户一行「{账户名称} {本次应收} {账单币种}」,关联审批单号、关联账单 = 本结算期,备注 = 备注;账单变「待支付」(D-00-59);③应付金额 = 0.00(返点抵满、结转、余额抵扣抵满、人工改为 0):不生成收款单、不写「结算单支付」交易明细,账单直接变「已结算」,结算时间 = 审批通过时间(D-00-80、D-06-29);每张结算单都记审批通过时间,与默认应付(= 改前应收,已扣返点抵扣、余额抵扣)、应付、各账户行本次应收一起供 10 取数;④按 R-12-045 列明本包的最终通过执行失败情形:没有——通过时不复核账单金额、付款主体与分桶(分桶提交时已锁定),技术异常按 12 处理(D-00-79)
- R-06-052 审批单变为已驳回、已撤回或被作废(作废效果同撤回,R-12-046、D-00-79):账单留在「待结算」、解除锁定、释放余额抵扣锁定的分桶、不生成结转额、按最新数据刷新,「生成结算单」重新可用;原单不能修改重提(R-12-034)
- R-06-053 09 收款单确认收款(已完成)时:账单变「已结算」并记结算时间(欠费转入本账单的预付账单一起变已结算,R-06-074);对应交易明细由 05 按 R-05-095 变已完成;实收、手续费由 09 记录(D-00-32)。本期收款单不作废、不退回(D-00-69);已知限制:客户一直不付时收款单一直待完成,账单一直「待支付」、不能重新生成结算单(R-09-075、D-00-61)
- R-06-078 结转额挂载:审批通过时把结转额按原账单里可结算应收为负的账户行、按各行可结算应收负数大小占比拆到账户(D-06-40),四舍五入到 2 位,尾差给负数最大的那行;每个账户的结转额挂到该客户最早一张流转计费模式为后付款、待结算、未锁定的账单(不挂未出账账单),计入该账户行「客户返点」、返点时间范围加一行「yyyy-mm 结转」(R-06-010),目标账单按 R-06-019 刷新;当时没有这样的账单就挂起,原账单「客户返点」旁显示「待结转 {金额}」;挂起期间一旦出现符合条件的后付账单(新出账,或被驳回 / 撤回解锁)就挂上;挂起期间新出账的账单流转计费模式为预付款时,结转额在出账时按 0 费率充进该账户余额(05 入桶来源「账单结转」,R-05-004),先入桶再按 R-06-021 判结清、决定是否发欠费通知(D-06-41),由本页写一条「客户返点」交易明细(已完成,备注「yyyy-mm 账单结转」,各列取值按 R-05-095、R-05-097);目标账单之后生成结算单时可结算应收又为负的,按 R-06-077 继续结转;已知限制:客户之后再没有账单时结转额一直挂起(D-00-81、D-06-28)
2.7.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 审批流 0 节点 | 提交即通过 | 立即处理(R-06-050) | 账单直接待支付或已结算 |
| 应付为 0.00 | — | 不生成收款单,直接已结算(R-06-051 ③) | 执行状态「已结清(0 元)」 |
| 有结转额、没有可挂账单 | — | 挂起(R-06-078) | 原账单「待结转 {金额}」 |
| 结转期间客户已转预付 | 下一张账单是预付 | 按 0 费率充进余额(R-06-078) | 05 交易明细「客户返点」 |
| 申请人被收回「生成结算单」 | 单仍审批中 | 仍可撤回(R-06-062) | 撤回按钮照常 |
| 卡死的单 | 申请人、审批人都不可用 | 「审批配置」持有人作废(R-06-052) | 同撤回 |
| 收款单作废 | 09 逆向 | 本期不做(D-00-69) | — |
| 客户一直不付 | 收款单一直待完成 | 账单保持待支付(R-06-053、R-09-075) | 不能重新生成结算单 |
2.7.6 验收标准
- G-06-022 前置:G-06-017 提交的结算单。操作:审批通过。期望:09 出现一张收款单(结算单支付,应收 249,000.00 人民币,付款主体为所选);橙子交易明细新增「结算单支付」待完成,应付金额 249,000.00、充值金额「-」、账户列表「橙子-iOS-CN 21,960.00 USD」「橙子-iOS-HK 13,080.00 USD」、关联账单 2026-09;账单变待支付、副标「收款单待完成」;已提交审批执行状态「收款单待完成」;审批内容区底部「收款单:{财务ID} · 待完成」。
- G-06-023 前置:G-06-017 提交的结算单,审批中;王敏提交后被收回了「生成结算单」权限点。操作:王敏在已提交审批里撤回;另一张同类单由持「审批配置」的管理员在审批详情作废(填原因)。期望:两张单都结束(已撤回 / 作废);账单留在待结算、解锁、「生成结算单」重新可用;原单不能再编辑提交。
2.8 已提交审批
2.8.3 业务规则
- R-06-060 已提交审批只展示当前登录账号提交的「生成结算单」审批单(含免审直接通过的单,R-12-018);搜索框按审批单号、公司名称包含匹配;状态筛选 全部 / 审批中 / 已通过 / 已驳回 / 已撤回,默认全部
- R-06-061 列:审批单号、操作对象(生成结算单)、公司名称、结算期、申请人(已禁用时按 R-12-049 显示「姓名(已禁用)」)、申请时间(yyyy-mm-dd hh:mm:ss,Asia/Shanghai)、审批状态、执行状态、操作(D-06-26);执行状态只有已通过的单有值:「收款单待完成」「已收款」(收款单状态按 09 R-09-073 按审批单号取)、「已结清(0 元)」,其余显示「-」(D-06-32);审批中置顶,其余按申请时间降序;分页 10 / 50 / 100 / 300,默认 10;没有数据显示「暂无数据」
- R-06-062 行操作:所有状态都有「详情」,新页打开审批详情(12 统一的审批详情页,按审批单号打开);只有审批中有「撤回」,只校验申请人本人与单据审批中、不校验「生成结算单」权限点(D-00-79);撤回确认文案、后果与通知按 12(R-12-032~R-12-035),撤回后按 R-06-052 处理
2.8.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 无数据 | — | — | 「暂无数据」 |
| 撤回非审批中的单 | 按 12 | 不显示撤回 | — |
2.8.6 验收标准
已提交审批、执行状态与撤回见 G-06-017、G-06-022、G-06-023、G-06-027。
2.9 审批内容
2.9.3 业务规则
- R-06-070 审批详情标题「账单管理/审批详情」,审批信息区按 12(R-12-026),审批事项「账单管理」、审批类型「生成结算单」;内容区全部取业务单据快照(R-06-049)
- R-06-071 内容区依次:公司名称(超链接,新页打开客户详情 R-04-050)、结算期、所属账户系统(客户当前的)、预估应收金额、消耗金额、税费、服务费、服务费税费、返点抵扣、上期预付欠费(有时)、余额抵扣(有时)(账单币种)、结转提示「本次抵扣 X,剩余 Y 结转至下期」(有时)、结算币种、汇率(币种不同时,「1 {账单币种} = x {结算币种}(yyyy-mm-dd)」)、默认应付金额、应付金额(结算币种;≠ 默认时旁边标红「已调整 {应付 − 默认}」,同 R-07-068 做法)、付款主体、备注(空显示「-」);下面是账单第一、二层快照表(有时含上期预付欠费、余额抵扣列),第三层订单行取当前数据;审批通过后内容区底部显示执行结果「收款单:{财务ID} · {待完成 / 已完成}」,应付为 0 的显示「已结清(0 元,不生成收款单)」(D-06-32;展示位置随 12 统一审批详情页)
- R-06-072 内容区展示单内全部账户行,不按查看者的账户权限隐藏(同 D-05-34 做法);不启用 12 的变更高亮(R-12-030)
- R-06-073 第②类只读查看(R-12-043、R-12-044):对单内任一账户有查看权限、且持「账单管理(查看)」的人(D-06-43);另外有「收付款中心」权限点的人也可只读查看(R-13-050、D-00-71);申请人与快照里的审批人不受影响
2.9.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 无权限的人拿链接 | 两类都不是 | 按 12 | 「无权限查看」 |
| 能看单内账户但没有「账单管理(查看)」 | 不满足第②类(R-06-073) | 按 12 | 「无权限查看」 |
| 只能看部分账户的人 | 第②类查看 | 内容区照样展示全部账户行 | 全单 |
2.9.6 验收标准
- G-06-024 前置:G-06-017 提交的结算单。操作:审批人或只能看 C 的钱磊打开审批详情。期望:标题「账单管理/审批详情」;内容区有预估应收 35,040.00 USD、汇率「1 USD = 7.1234 人民币(2026-10-05)」、默认应付 249,603.94、应付 249,000.00 人民币旁标红「已调整 -603.94」、付款主体、备注「客户协商抹零」;快照表 C、D 两行都展示(钱磊也一样)。
3 变更影响面
| 被影响对象 | 影响方式 | 处理动作 | 负责人 |
|---|---|---|---|
| 版本 index | 本页引用 D-00-73~D-00-81(新增)与 D-00-11、D-00-13、D-00-18、D-00-55~D-00-57、D-00-59、D-00-62、D-00-67 改写后的口径 | index 子任务写入 | 总控 |
| 04 客户管理 | 计费模式次月 1 日生效(R-06-004);待生效计费模式的展示 | 04 回写 | 总控 → 04 |
| 05 费用管理 | 分桶锁定 / 扣减供余额抵扣(R-06-076)、交易类型「余额抵扣账单」;入桶来源「账单结转」(R-06-078);上期预付欠费计入后付未结清消耗(D06);费用明细 tab 按 R-06-032 | 05 回写(WORKLOG 跨页影响) | 总控 → 05 |
| 07 返点管理 | 纳入扣减月份可选条件与占用(R-06-024);结转(R-06-077、R-06-078);0 元抵扣单不挡结算单(R-06-040) | 07 同轮回写 | 总控 |
| 08 渠道对账 | 本页读 08 的渠道统计金额;自接苹果判定已定(D-06-31) | 无需改 | — |
| 09 收付款中心 | 收款单应收 = 扣除余额抵扣后的应付、账户权重 = 本次应收(R-06-051);应付 0 不生成收款单(D-00-80) | 09 回写 | 总控 → 09 |
| 10 利润中心 | 余额抵扣计入到款、返点抵扣不计(R-06-076);改应付差额并入 10 手续费(D-00-34);本页提供每张结算单的默认应付、应付、各账户行本次应收、审批通过时间;余额抵扣、上期预付欠费、挂入的结转额在账户行上与收入分开记录(10 收入不计这三项);预付账单按扣减段可取分桶快照费率(算公司承担服务费税费);逐日接口 T-06-001 | 10 回写 | 总控 → 10 |
| 12 审批 | 执行结果行位置、在途提示统一句式、提交提示(R-12-018)、作废(D-00-79) | 12 回写 | 总控 → 12 |
| 13 导航与权限 | 「账单管理(查看)」「生成结算单」 | 13 汇总(D-00-78) | 总控 |
| 存量账单 | 已定只出结算期 ≥ 上线月的账单(R-06-001,index S-16 / S-18,Q-06-01 关闭);具体上线月上线前定 | 上线时配置上线月(同 S-18) | 用户 / 财务定月份;技术配置 |
4 非功能
- 生成结算单、撤回、作废在服务端复核(R-06-048、D-00-79),前端隐藏不算权限控制;列表、费用明细 tab、审批详情查看按账户查看权限在服务端过滤(R-06-031、R-06-073);搜索账户名称 / orgId 也只在可见账户里匹配(R-06-026)。
- 结算单快照只追加不改;账单每次锁定、解锁、状态变化、欠费冻结转入、结转挂载可追溯到审批单或收款单。
- 后付账单规则判定调用 03(T-03-002),预付账单分桶扣减与余额抵扣的分桶锁定 / 扣减调用 05(T-05-001),不另写。
- 实现任务:T-06-001~T-06-009,见 spec.yaml。
5 开放问题
| 编号 | 问题 | 卡谁 | 期望结论时间 |
|---|---|---|---|
| ~~Q-06-01~~ | 已关闭(2026-10-22)→ D-06-36:只出结算期 ≥ 上线月的账单,上线月与 07、08、10、11 共用 index S-18 的配置,上线月之前的结算期不出账单(S-16 定掉) | — | — |
| ~~Q-06-02~~ | 已关闭(2026-10-21)→ D-06-31:自接苹果判定、订单归期 / 币种 / 税费按技术答复 T09 落 R-06-014、R-06-015、R-06-028 | — | — |
| ~~Q-06-03~~ | 已关闭(2026-10-21)→ D-06-12:计费模式次月 1 日生效(D-00-73),一个结算期只有一种计费模式,不再有「同月前几天后付」的情况 | — | — |
| ~~Q-06-04~~ | 已关闭(2026-10-21)→ 用户确认:D-06-13、D-06-16~D-06-18、D-06-20、D-06-22、D-06-25、D-06-26(D-06-14、D-06-15、D-06-19、D-06-21、D-06-23、D-06-24 已于 2026-10-21 由用户定) 全部转已定 | — | — |
| ~~Q-06-05~~ | 已关闭(2026-10-20)→ D-00-69:本期收付款单不作废、不退回,账单不回退;已知限制见 R-06-053(R-09-075) | — | — |
| ~~Q-06-06~~ | 已关闭(2026-10-21)→ 用户确认 D-06-35 全部转已定。原问题:①余额抵扣合计超过账单可结算应收时,从余额抵扣最大的账户行减回;②切换前最后一个预付月份在出账时(而不是生效时)判结清、没结清再冻结转入;③上期预付欠费的承接账单当月没有账单时顺延到下一张后付账单;④余额抵扣只在生成结算单时客户当前生效为后付款时带出;⑤应付为 0 的结算单不写「结算单支付」交易明细 | — | — |
| Q-06-07 | 需财务确认(确认前按已定口径实现):返点余额 0 费率含覆盖欠费的税务口径(D-05-21、D100);结算汇率锁 4 位小数的误差能否接受(D-00-74) | 财务(卡 —) | — |
6 决策
| 编号 | 决策点 | 结论 | 影响 | 状态 |
|---|---|---|---|---|
| D-06-01 | 账单粒度 | 客户 × UTC0 自然月一张,三层:结算期 → 账户 → 订单号;币种 = 账户消耗币种 | R-06-001~R-06-003 | 已定 |
| D-06-02 | 应收公式 | 账户行应收 = 消耗 + 服务费 + 税费 + 服务费税费 − 客户返点;总计 = 各账户应收之和,不去重 | R-06-011 | 已定 |
| D-06-03 | 预付账单的服务费、税费 | 按当月消耗从哪些分桶扣的,用分桶费率快照折算;欠费部分按当日 03 规则暂算 | R-06-007 | 已定 |
| D-06-04 | 渠道统计金额 | 自接苹果:账户行 = 本账户订单「总计」之和(共享订单各算一次),第一层 = 本账单内订单号去重后加总;其他上游渠道没有订单号,第一层 = 账户行相加;去重只在同一张账单内 | R-06-015、R-06-016 | 已定(用户原话:渠道统计金额就是把下面订单号金额去重加总) |
| D-06-05 | 消耗差额 | = 消耗 − 渠道统计金额,内部对账用,不影响应收 | R-06-014、R-06-017 | 已定 |
| D-06-06 | 出账后数据变了 | 待结算且无审批中结算单时跟着刷新;结算单提交即按快照锁定;驳回 / 撤回 / 作废解锁;已结算后冻结 | R-06-019、R-06-020 | 已定 |
| D-06-07 | 预付怎么结清 | 逐张账单判断:该结算期消耗全部被分桶先进先出覆盖(锁定中的不算)即已结算,与其他月份、其他账户无关;出账时判一次,之后覆盖关系变化和每个 UTC0 日再判;未结清副标「欠费 x,待充值」;预付不显示生成结算单 | R-06-021~R-06-023、R-06-075 | 已定(2026-10-21 用户定,会议清单 D03;原「全部账户余额 ≥ 0 一起结清」作废) |
| D-06-08 | 没有适用规则 | 费率按 0,照常出账结算,静默、页面不提示(与 05 D-05-38 一致);用户授权本会话直接改 index D-00-57(充值、账单、返点全部按 0) | R-06-009;index D-00-57;05、07 | 已定(用户原话:费率按 1 算……我允许你直接改这个);index 已改 |
| D-06-09 | 应付金额能否改 | 能改,不设上限;应付 ≠ 默认时备注必填;输入框下显示默认值与「已调整」差额,审批内容区同样显示 | R-06-044、R-06-046、R-06-071 | 已定(2026-10-21 用户定,会议清单 D54;原「备注始终选填」作废) |
| D-06-10 | 账期、订单数据、导出 | 本版不用账期;订单号层沿用现有数据;本期不做导出 | scope;R-06-028、R-06-030 | 已定 |
| D-06-11 | 客户返点列 | 后付 = 07 纳入本月扣减且审批通过的返点 + 挂上的结转额,时间范围 = 返点所属消耗日期段 /「yyyy-mm 结转」;预付显示「-」 | R-06-010 | 已定 |
| D-06-12 | 计费模式与流转 | 一个结算期只有一种计费模式(D-00-73 次月 1 日生效),账单按该结算期的计费模式流转;不再按天分段、不再有预付日子扣除(关闭 Q-06-03) | R-06-004、R-06-012、R-06-013 | 已定(2026-10-21 用户定,会议清单 D02;原「月中按天分段」作废) |
| D-06-13 | 未出账账单 | 当月(及 2 日出账前的上月)显示「未出账」行,金额实时,无操作;状态筛选补「未出账」「待支付」 | R-06-001、R-06-026 | 已定(2026-10-21 用户确认,由代定转已定) |
| D-06-14 | 搜索、排序、分页 | 搜索公司名称 / 客户别名 / 账户名称 / orgId(账户只在可见范围匹配);结算期降序、同期按总计降序;10 / 50 / 100 / 300 | R-06-026、R-06-029 | 已定(2026-10-21 用户定,会议清单 D53) |
| D-06-15 | 权限点与可见性 | 页面按「账单管理(查看)」显示(D-00-78);新增「生成结算单」权限点;可见性跟账户查看权限;第一层显示整张账单金额,第二层只列有权限账户;看不全账户时生成结算单置灰并说明 | R-06-025、R-06-031、R-06-040;13 | 已定(2026-10-21 用户定,会议清单 D86、D50) |
| D-06-16 | 原型残留 | 勾选框、导出按钮、注释里的交易明细不做;标题「账单中心」统一为「账单管理」 | R-06-025、R-06-030 | 已定(2026-10-21 用户确认,由代定转已定) |
| D-06-17 | 渠道两列是否锁定 | 不锁定,任何状态都随数据更新 | R-06-018 | 已定(2026-10-21 用户确认,由代定转已定) |
| D-06-18 | 锁定后消耗修正 | 不回改账单、不补差 | R-06-020 | 已定(2026-10-21 用户确认,由代定转已定) |
| D-06-19 | 舍入 | 按段(后付按日统计时按天、预付按分桶扣减段)各项四舍五入到 2 位再加总;中间值可存更高精度但不能代替舍入点;阶梯落档用未舍入的原始消耗合计(D-00-13) | R-06-006~R-06-008 | 已定(2026-10-21 用户定,会议清单 D01) |
| D-06-20 | 预付欠费部分 | 先按 03 规则暂算,新分桶覆盖后改按新分桶快照重算 | R-06-007 | 已定(2026-10-21 用户确认,由代定转已定) |
| D-06-21 | 结算单弹窗默认值 | 结算币种默认客户币种(下拉);付款主体同 05;应付默认 =(预估应收 − 余额抵扣)× 汇率,可改、≥ 0;换币种重带默认值 | R-06-042~R-06-045 | 已定(2026-10-21 用户定,会议清单 D54、D02、附 1 N1) |
| D-06-22 | 预付欠费通知 | 出账时一次,发客户的销售;文案见 notifications | R-06-021 | 已定(2026-10-21 用户确认,由代定转已定) |
| D-06-23 | 返点与结算单并发 | 有选了本月扣减、合计 > 0、审批中的返点单时生成结算单置灰并带单号;同一账单同时最多 1 张审批中的抵扣单;07 只能选无审批中结算单的待结算后付账单,只在 07 提交时校验,最后通过不再复核;0 元抵扣单不占用 | R-06-024、R-06-040;07 | 已定(2026-10-21 用户定,会议清单 D50、D10、D57) |
| D-06-24 | 计费模式变更从哪天算 | 从确定时刻的次月 1 日(UTC0)起生效,结算期中途不切换(D-00-73) | R-06-004 | 已定(2026-10-21 用户定,会议清单 D02;原「变更当天算新模式」作废) |
| D-06-25 | 费用明细 tab | 复用本页账单信息、单客户、只读、不带生成结算单 | R-06-032;05 | 已定(2026-10-21 用户确认,由代定转已定) |
| D-06-26 | 已提交审批列 | 在原型列基础上加公司名称、结算期、执行状态 | R-06-061 | 已定(执行状态列 2026-10-21 按会议清单 D51 加;2026-10-21 用户确认,由代定转已定) |
| D-06-27 | 预付改后付的余额与欠费 | 改后付后剩余未锁定分桶保留、不再被消耗扣,后付账单生成结算单时按账户自动带出余额抵扣(退款口径,上限为剩余应收,先扣返点再扣余额,算到款);切换前未结清的预付欠费冻结,作为「上期预付欠费(yyyy-mm)」并入第一张后付账单,承接账单结清时原账单一起结清 | R-06-074、R-06-076、R-06-051 | 已定(2026-10-21 用户定,会议清单 D02 用户方案 + 技术补充 4 条) |
| D-06-28 | 返点抵扣后账单为负 | 可结算应收 < 0 时应付固定 0.00、只读;超出部分在通过时生成结转额,按可结算应收为负的账户行占比拆(2026-10-22 改,D-06-40),挂到最早一张后付待结算未锁定账单,没有就挂起;下一张出账账单为预付时按 0 费率充进余额;人工改 0 不结转 | R-06-077、R-06-078、R-06-010 | 已定(2026-10-21 用户定,会议清单 D09;原 D-00-67「由人改应付」作废) |
| D-06-29 | 0 元结算单 | 应付为 0.00 的结算单审批通过即已结算,不生成收款单(与 07 一致) | R-06-051 | 已定(2026-10-21 用户定,会议清单技术答复后补充决定、D-00-80) |
| D-06-30 | 复核失败与汇率变化 | 不再要求关闭重开:数据变了就地重载并标黄、保留用户已填内容;提交当天汇率不同时弹确认后按新汇率建单;复核补付款主体仍有效;在途提示带单号 | R-06-043、R-06-048 | 已定(2026-10-21 用户定,会议清单 D35、D40、D116) |
| D-06-31 | 订单数据口径 | 自接苹果 = 从苹果同步订单、按订单号结算的账户系统;LOC 按账单月份、CC 按交易日落月;币种不同按截止日 / 交易日日汇率折算;人民币体系税费照实、USD 体系税费「-」;第三层首列订单号;共享订单分两种标注(关闭 Q-06-02) | R-06-014、R-06-015、R-06-028 | 已定(2026-10-21 用户定,会议清单 D13、D103,技术答复 T09) |
| D-06-32 | 展示补充 | 未出账悬浮数据截至时间;状态副标(结算单审批中 / 收款单待完成)、「已锁定」;生成结算单置灰带原因;已提交审批加执行状态列;审批内容区加执行结果行 | R-06-027、R-06-040、R-06-061、R-06-071 | 已定(2026-10-21 用户定,会议清单 D39、D50、D51) |
| D-06-33 | 第二层账户行 | 隐藏条件加「渠道统计金额为 0 或「-」且无订单行」;第一层渠道统计金额只来自列出的账户行;第二层按消耗降序、同额按名称升序 | R-06-002、R-06-016、R-06-028、R-06-031 | 已定(2026-10-21 用户定,会议清单 D52) |
| D-06-34 | 提示与说明 | 预付账户行返点余额 0 费率悬浮说明;生成结算单时有待结算客户返点的黄条提示(不拦);消耗差额表头问号说明 | R-06-028、R-06-079、R-06-027 | 已定(2026-10-21 用户定,会议清单 D100、D101、D102;D100 税务口径待财务确认) |
| D-06-35 | 回写时按理解代定 | 余额抵扣合计封顶时从最大的账户行减回;最后一个预付月份出账时判结清后再冻结;承接账单顺延;余额抵扣只在客户当前生效为后付款时带出;0 元结算单不写「结算单支付」交易明细 | R-06-074、R-06-076、R-06-051 | 已定(2026-10-21 用户确认,Q-06-06 关闭) |
| D-06-36 | 账单从哪个月起出 | 只出结算期 ≥ 上线月的账单;上线月与 07 计提、08、10、11 共用 index S-18 的同一个配置;上线月之前的结算期不出账单(S-16 定掉,Q-06-01 关闭) | R-06-001;§3 存量;migration | 已定(2026-10-22 用户与技术确认,闭环清单 A01) |
| D-06-37 | 切换前最后一个预付月还能否被分桶覆盖 | 预付改后付生效后,切换前最后一个预付月在出账判结清或冻结之前,分桶照常按先进先出覆盖它,包括期间补报的消耗、释放的锁定分桶、新到账的充值;欠费冻结之后的消耗、生效月起的消耗不再被分桶覆盖 | R-06-074 ① | 已定(2026-10-22 用户与技术确认,闭环清单 A06) |
| D-06-38 | 冻结欠费的两个口子 | ①已冻结转入后付账单、或已结算冻结的切换前月份,之后的消耗修正不再进余额、不参与分桶覆盖,线下处理(index §2.9);②冻结的欠费在下一张后付账单生成时挂上,挂上前原账单副标「欠费待转入下一张后付账单」;挂上前客户又改回预付的,解除冻结、欠费退回余额,原账单重新按 R-06-022 判结清 | R-06-074 ②③④、R-06-075、R-06-020 | 已定(2026-10-22 用户与技术确认,闭环清单 A07) |
| D-06-39 | 欠费暂算的落档基数 | 欠费暂算时用该段全部消耗落档取比例(按日统计时用当天全部消耗),比例只乘欠费部分;欠费部分各项各自四舍五入到 2 位 | R-06-007、R-06-074 ②、R-06-075 | 已定(2026-10-22 用户与技术确认,闭环清单 A10) |
| D-06-40 | 结转额拆分口径 | 按原账单里可结算应收为负的账户行、按负数大小占比拆(index D-00-81 同步) | R-06-078、D-06-28 | 已定(2026-10-22 用户与技术确认,闭环清单 A11) |
| D-06-41 | 出账时结转入桶与判结清的先后 | 出账时先把挂起的结转额入桶,再判结清,再决定发不发欠费通知 | R-06-021、R-06-078 | 已定(2026-10-22 用户与技术确认,闭环清单 B04) |
| D-06-42 | 手续费分摊权重为负 | 本次应收 ≤ 0 的账户行分摊权重按 0,本次应收照原值记录 | R-06-051 ② | 已定(2026-10-22 用户与技术确认,闭环清单 B05) |
| D-06-43 | 审批详情第②类查看 | 对单内任一账户有查看权限之外,还要同时持「账单管理(查看)」;申请人和快照里的审批人不受影响 | R-06-073 | 已定(2026-10-22 用户与技术确认,闭环清单 B10) |
| D-06-44 | 复核时返点抵扣单 / 可见账户变化 | R-06-040 ②③ 在复核时任一成立就不建单,提示框显示对应的置灰原因原文,单号可点 | R-06-048 ⑤ | 已定(2026-10-22 用户与技术确认,闭环清单 B16) |
| D-06-45 | 零消耗只有渠道金额的客户 | 不生成账单,渠道金额在 08 / 10 查看,作为已知限制写进 §2.1.5 与 index §2.9 | R-06-001、§2.1.5 | 已定(2026-10-22 用户与技术确认,闭环清单 B17) |
| D-06-46 | 引用 05 / 08 的同步口径 | 余额抵扣以剩余应收为准,最后一桶本金与尾差按 R-05-118 ①(B02);LOC 截止日期晚于今天时先按最近一天汇率暂折,截止日当天汇率入库后重折一次、之后不再变,同 R-08-017(B07) | R-06-076、R-06-015 | 已定(2026-10-22 用户与技术确认,闭环清单 B02、B07) |
| D-06-47 | 结算时间时区 | 展示统一用北京时间(Asia/Shanghai),存储统一用时间戳(06 bill.settled_at、07 accrual_item.settled_at 一致);R-06-020 的已知限制收进 index §2.9 | 字段 settled_at、R-06-020 | 已定(2026-10-22 用户与技术确认,闭环清单 D 组) |