收付款中心

v2.1.0 09-收付款中心 ASA 状态:待评审 2026-10-20 评审版 · 由 PRD.md 自动生成,勿手改

收付款中心 PRD

项内容
所属产品ASA
版本v2.1.0
页面09-收付款中心
涉及功能收付款(feature 台账由总控登记)
编制日期2026-10-20(2026-10-21 总控代改:按会议清单 v2 回写;2026-10-22 总控代改:按闭环清单回写)
文档状态待评审
目标读者研发、测试、AI 实现助手(本文件可直接整份投喂给 AI 作为实现依据)
关联文档本目录 spec.yaml、mocks/;版本 index.md;原型 html/收付款中心.html(无 V2.1 注释,规则来自用户确认与 05~08 的接口点)

0 前置说明

1 整体概述

1.1 背景与目标

现状:05~08 的充值、退款、结算单、返点 / 客情现金打款、渠道付款审批通过以后,钱什么时候真正收到、付出,系统里没有地方确认;05 的余额到账、06 账单结清、07 返点结清、08 渠道付完、10 / 11「算没算完」都卡在这一步。

目标:

可证伪的判定:公共前置(spec.yaml 头部)下,SK-A 实收 99,700.00 人民币确认后,手续费 27.60 人民币按系统分配为 星海-iOS-US 17.03、星海-iOS-JP 10.57,05 两个账户立即到账;FK-A 确认汇款后 08 行仍「付款中」,确认到账后才变「已完成」。

1.2 本页范围

1.3 角色与权限

角色能做什么不能做什么数据范围 / 权限来源
有「收付款中心」权限点的用户进入页面;看全部收款单、付款单;查看凭证确认收款 / 汇款 / 到账(另需权限点)全部单据,不按账户数据权限过滤(R-09-061);新增权限点
另有「确认收款」对待完成的收款单确认收款改已完成的单新增权限点(R-09-060)
另有「确认付款」对待汇出的付款单确认汇款、对待完成的付款单确认到账改应付金额;改已汇出 / 已完成的单新增权限点(R-09-060)
系统来源审批通过时生成单据;完成时回写来源;提供状态与金额—R-09-001~R-09-006、R-09-070~R-09-075

1.4 术语定义

术语释义
收款单我们向客户收钱的单据:交易类型 账户充值 / 结算单支付;状态 待完成 / 已完成(另有 sys 兜底产生的只读「已撤回」)
付款单我们向外付钱的单据:交易类型 余额退款 / 客户返点 / 客情费用 / 渠道付款;状态 待汇出 / 待完成 / 已完成(另有 sys 兜底产生的只读「已撤回」)
付款主体 / 收款主体收款单上客户付钱的一方叫「付款主体」;付款单上收钱的一方叫「收款主体」(D37,术语表)
财务ID收付款单编号,全局唯一;05 交易明细的「财务ID」就是它
手续费收款单的 应收 − 实收;少收为正、多收为负(D-00-32、D-09-04);付款单没有手续费
账户行 / 分摊收款单涉及的账户,每个账户分到一份手续费,合计 = 手续费
打款凭证 / 到账凭证打款凭证 = 付款方打款的凭证(收款单上是客户的,付款单上是我们的);到账凭证 = 收款方确认到账的凭证。原型里的「到款凭证」就是到账凭证(D-09-13)
本单币种来源单据的结算币种(05~08 统一叫「结算币种」,D-00-68),人民币 / USD / USDT

1.5 核心流程

步骤操作者系统行为产物
1系统(来源页)05 / 06 / 07 / 08 的审批通过 → 调本页生成收付款单(R-09-001~R-09-003)收款单(待完成)/ 付款单(待汇出)
2有「确认收款」的财务客户钱到了 → 确认收款:填实收、传到账凭证、分摊手续费(R-09-030~R-09-038)收款单已完成 → 回写 05 / 06(R-09-070)
3有「确认付款」的财务我们把钱汇出 → 确认汇款:填汇出金额、传打款凭证(R-09-040~R-09-043)付款单待完成(不回写来源)
4有「确认付款」的财务对方确认到账 → 确认到账:填到账金额、传到账凭证(R-09-044~R-09-046)付款单已完成 → 回写 05 / 07 / 08(R-09-071)
5系统10 读手续费分摊与收付款金额(R-09-074)—

2 详细需求

2.1 收付款单的生成

2.1.1 功能描述

收付款单不在本页手动新建,都由来源页在审批通过那一刻调本页生成。生成后金额不能改、不能作废,只能往前确认。

2.1.2 核心字段(收款单)

字段名key类型必填枚举/取值默认值规则说明
财务IDfinance_idstring是全局唯一生成R-09-004
交易类型typeenum是账户充值 / 结算单支付—R-09-001
来源单据source_doc关联对象是05 费用单据 / 06 结算单——
关联审批单号approval_id关联对象是来源审批单—R-09-003
公司名称customer_id关联对象是04 客户——
付款主体payerstring是来源快照——
申请人 / 申请时间applicant / applied_at关联对象 / datetime(Asia/Shanghai,秒)是来源审批单—R-09-005
币种currencyenum是人民币 / USD / USDT—D-00-08
应收金额receivabledecimal(2)是> 0,本单币种(0 只作兜底)—R-09-001、R-09-006
账户行account_lines列表是账户 / 分摊权重(原币应收)/ 手续费分摊—R-09-002、R-09-034
打款凭证payer_vouchers列表否仅账户充值—R-09-001
备注remarktext否来源备注——
状态statusenum是待完成 / 已完成 / 已撤回待完成2.1.4、R-09-076
实收金额receiveddecimal(2)确认时本单币种—R-09-031
手续费handling_feedecimal(2)确认时可为负—R-09-032
手续费分配fee_alloc_modeenum确认时系统分配 / 手动分配系统分配R-09-033~R-09-036
到账凭证arrival_vouchers列表确认时≥ 1 个(应收 0 的兜底单选填)—R-09-031、R-09-050
确认备注confirm_remarktext否≤ 1,024 字空R-09-054
确认人 / 完成时间confirmed_by / completed_at关联对象 / datetime(Asia/Shanghai,秒)系统——R-09-005

2.1.3 核心字段(付款单)

字段名key类型必填枚举/取值默认值规则说明
财务IDfinance_idstring是全局唯一生成R-09-004
交易类型typeenum是余额退款 / 客户返点 / 客情费用 / 渠道付款—R-09-001
来源单据、关联审批单号source_doc、approval_id关联对象是——R-09-003
公司名称customer_id关联对象否渠道付款没有—R-09-012
账户系统、结算期account_system、period关联对象、string否仅渠道付款—R-09-012
收款主体payeestring否来源快照;渠道付款为 08 选填值,可为空—R-09-012
申请人 / 申请时间applicant / applied_at关联对象 / datetime(Asia/Shanghai,秒)是来源审批单—R-09-005
币种currencyenum是人民币 / USD / USDT——
应付金额payabledecimal(2)是> 0,正数—R-09-006
备注remarktext否来源备注——
状态statusenum是待汇出 / 待完成 / 已完成 / 已撤回待汇出2.1.4、R-09-076
汇出金额、打款凭证remitted、remit_vouchersdecimal(2)、列表确认汇款时> 0;≥ 1 个—R-09-041
汇款确认人 / 汇出时间remitted_by / remitted_at关联对象 / datetime系统——R-09-005
到账金额、到账凭证arrived、arrival_vouchersdecimal(2)、列表确认到账时> 0;≥ 1 个—R-09-044
到账确认人 / 完成时间arrived_by / completed_at关联对象 / datetime系统——R-09-005
确认汇款备注 / 确认到账备注remit_remark / arrive_remarktext否≤ 1,024 字空R-09-054
撤回时间withdrawn_atdatetime系统——R-09-076

另有「收付款操作日志」(只追加、页面不展示),字段见 spec.yaml,规则 R-09-063。

2.1.4 状态与流转(本页定义)

收款单:

当前状态触发动作操作者目标状态前置条件
无05 账户充值 / 06 生成结算单 审批通过系统待完成R-09-001~R-09-003
待完成确认收款有「确认收款」的用户已完成R-09-030~R-09-038
待完成撤回待到款充值(sys 兜底,前端不暴露;仅账户充值)sys已撤回R-09-076

付款单(D-00-33、D-09-01:到账才算完成):

当前状态触发动作操作者目标状态前置条件
无05 充值退款 / 07 现金打款(合计 > 0)/ 08 渠道付款 审批通过系统待汇出R-09-001~R-09-003
待汇出确认汇款有「确认付款」的用户待完成R-09-040~R-09-043
待完成确认到账有「确认付款」的用户已完成R-09-044~R-09-046
待汇出撤回待汇出退款(sys 兜底,前端不暴露;仅余额退款)sys已撤回R-09-076

逆向:本期没有作废、退回,撤回不对前端开放,只有 R-09-076 两种 sys 兜底(D-09-02)。已完成、已汇出的单不能改(R-09-053);错单、退款被银行退回线下结清,确需改数据由技术逐单出方案、用户确认后执行并留日志(R-09-053);客户一直不付、对方一直没到账时单据保持未完成(R-09-075)。后续版本再加作废时,要一起定作废后来源单据怎么回退。

2.1.5 业务规则

2.1.6 验收标准

2.2 收付款中心列表

2.2.1 功能描述

两个 tab:收款单据、付款单据。顶部搜索与筛选,列表每行一张单,操作列按状态与权限出现确认按钮。原型没有公司名称列、没有搜索,本页补上(D-09-07);原型「所属账户系统」「状态」筛选的选项是复制残留(D-09-08)。

2.2.2 业务规则

2.2.3 异常与边界

场景现象系统行为用户看到
空态没有任何单据—「暂无数据」(R-09-019)
筛选无结果——「没有符合条件的单据」
列表加载失败接口报错 / 超时沿用现有列表的加载失败处理现有的失败提示与重试
无页面权限 / 权限加载失败没有「收付款中心」/ 权限接口失败R-09-061(R-13-005、R-13-006)内容区「无权限访问」保留地址 / 「加载失败,请刷新」不跳登录
只有查看权限没有确认权限点不显示按钮(R-09-020)操作列为空
没有该单账户查看权限点关联审批单号有「收付款中心」即可只读打开(R-09-015、D-00-71)审批详情只读,没有通过 / 驳回 / 撤回
公司名称很长—超长省略,悬浮显示全称(同 05 做法)—

2.2.4 验收标准

示意 1收款单据列表(补列、筛选、手续费悬浮分摊)mocks/01-收款单据列表.html
示意 2付款单据列表(三态、确认汇款 / 确认到账)mocks/02-付款单据列表.html

2.3 确认收款

2.3.1 功能描述

客户的钱到账后,财务在收款单上点「确认收款」:填实收金额、上传到账凭证,系统算出手续费并分到各账户。收款只确认一次,确认后来源直接结清(D-00-32)。

2.3.2 业务规则

2.3.3 异常与边界

场景触发系统行为用户看到
少收 / 多收实收 ≠ 应收照常确认,差额进手续费(R-09-032)手续费正 / 负
账户行应收为负06 账户行被返点扣成负数(D-00-67)不参与系统分配(R-09-034)该账户 0.00
全部账户应收 ≤ 0—R-09-035只能手动分配
应收为 0正常流程不再生成(D-00-80);兜底单实收可填 0、凭证选填(R-09-031)手续费 0.00
客户用其他币种付款实收按银行实际入账的本单币种金额填汇差计入手续费、按账户分摊进 10 毛利,不单独记录(D-09-18,已知限制)实收下方灰字提示
实收与应收差 > 1%可能误录不拦(R-09-037)二次确认红字提醒
客户代付 / 换付款主体—付款主体只读(R-09-030)写在确认备注
校验不过—R-09-037对应位置提示,不提交
重复点击 / 失败 / 并发—R-09-051、R-09-052—

2.3.4 验收标准

示意 3确认收款弹窗(多账户、系统分配)mocks/03-确认收款-系统分配.html
示意 4确认收款弹窗(手动分配、待分配不为 0)mocks/04-确认收款-手动分配校验失败.html

2.4 确认汇款 / 确认到账

2.4.1 功能描述

付款分两步:财务把钱汇出后点「确认汇款」(付款单变待完成,来源还在付款中);对方确认收到后点「确认到账」(付款单变已完成,这时才回写来源)。到账才算完成(D-00-33、D-09-01)。

2.4.2 业务规则

2.4.3 异常与边界

场景触发系统行为用户看到
汇出 / 到账 ≠ 应付银行扣费、汇率差只记录(D-09-06)灰字「与应付金额相差 x」(R-09-043)
汇出后一直没到账—保持待完成,来源保持付款中(R-09-075)操作列「确认到账」
对方不给回执—到账凭证仍必填,任意能证明收到的文件都可(R-09-044)上传区提示语
退款被银行退回 / 错单—系统内不处理,线下结清(R-09-053)—
校验不过金额空 / 非法、没凭证R-09-041、R-09-044对应位置提示
重复点击 / 失败 / 并发—R-09-051、R-09-052—

2.4.4 验收标准

示意 5确认汇款弹窗(汇出与应付不同)mocks/05-确认汇款.html
示意 6确认到账弹窗mocks/06-确认到账.html

2.5 公共校验与异常

2.5.1 业务规则

验收见 G-09-012、G-09-013、G-09-014、G-09-018。

2.6 权限与留痕

2.6.1 业务规则

2.6.2 验收标准

2.7 对外接口

验收见 G-09-007、G-09-008、G-09-015~G-09-017、G-09-023。

3 变更影响面

被影响对象影响方式处理动作负责人
D-00-33(版本级)付款「确认汇出即完成」改为「到账才算完成」已按用户授权改写 index本页(已改)、总控登记
05 充值 / 退款 / 交易明细收付款单的作废逆向本期不做(D-00-69);财务ID = 本页编号;付款单回写字段见 R-09-07105 已改 flows reverse、原开放问题转 D-05-42;交易明细列映射 05 定已收口(2026-10-20)
06 账单收款单不作废(D-00-69);客户不付时账单一直待支付、不能重生成结算单06 reverse 已改、Q-06-05 已关闭已收口(2026-10-20)
07 返点 / 客情付款单不作废(D-00-69);确认汇款后仍「待打款」,到账才「已结算」07 reverse 已改、Q-07-03 已关闭已收口(2026-10-20)
08 渠道付款付款单不作废(D-00-69);付款单状态名 待汇出 / 待完成 / 已完成 与 G-08-025 一致08 reverse 已改、原开放问题转 D-08-27已收口(2026-10-20)
10 利润 / 11 提成手续费按账户分摊可取;付款到账才算完成;手续费归月与付款差额已由 10 定(R-10-007)Q-09-04 已关闭,R-09-074 引用 R-10-007已收口(2026-10-20)
12 审批详情查看有「收付款中心」可只读打开 8 种审批类型的审批详情(D-00-71)13 R-13-050 已写;12 R-12-043 映射与 05~08 能否查看判断按 D-00-71 补;Q-09-01 已关闭总控(已收口 2026-10-20)
13 权限新增 3 个权限点(R-09-060)13 汇总13
存量数据本页实体为新增,上线时为空;上线前线下未结清的收付款要不要导入未定;按 S-19 导入的只作记录、不回写来源、不进 10,渠道付款不导入(R-09-077)Q-09-03(已并入版本 index §7 S-19)用户 / 财务(经总控)
05 交易明细sys 撤回后显示「已撤回」、退款余额按原分桶加回、充值额度不清零(R-09-076)05 同步05
06 / 07应付 0 不生成收款单;执行状态列读本页状态(R-09-001、R-09-073)06 / 07 同步06、07
08渠道付款带收款主体,列表显示(R-09-012)08 已同步(R-08-047、R-08-053)—
10手续费与 10 的手续费(含改应付差额)数不同属正常;已撤回单不给 10(R-09-074)10 知悉10

假设:

4 非功能与埋点

5 开放问题

编号问题卡谁 / 影响哪条需谁回答期望结论时间
Q-09-01【已关闭 2026-10-20 → D-00-71:有「收付款中心」权限点的人可只读打开 8 种审批类型(账户充值、充值退款、额度调整、余额分配、生成结算单、客户返点、客情费用、渠道付款)的审批详情(R-13-050),已落 R-09-015】原问题:只有「收付款中心」、没有对应账户查看权限的财务点开审批单号链接显示「无权限查看」,要不要把该权限点加进只读查看名单R-09-015用户(13 会话已定 8 类)—
Q-09-02【已关闭 2026-10-22 → D-09-25(闭环清单 E 组):财务ID 沿用现有单据 ID(充值 RC-、退款 RF-、结算单、渠道结算单 ID),全局唯一、生成后不变,已落 R-09-004】原问题:财务ID 编号规则(前缀、位数)—技术负责人—
Q-09-03上线前线下还没收 / 没付完的款要不要导成收付款单(已并入版本 index §7 S-19);不导则列表从上线后第一笔审批通过开始。2026-10-22 已定导入后的处理(R-09-077,闭环清单 B09):只作记录,确认后不回写来源、不进 10;渠道付款不导入不阻塞用户 / 财务(经总控)—
Q-09-04【已关闭 2026-10-20 → R-10-007(D-10-04、D-10-05):手续费 结算单支付 → 账单结算期、账户充值 → 收款完成日(UTC0)所在月;付款汇出 / 到账差额不进毛利;已落 R-09-074】原问题:手续费折人民币、归哪个月;付款单汇出 / 到账与应付的差额进不进毛利R-09-074用户(10 会话已定)—

6 附录

6.1 已定决策

编号决策点结论状态
D-09-01付款单状态与完成时点三态,确认到账才算完成;D-00-33 已按用户授权改写已定(用户)
D-09-02作废 / 退回 / 撤回本期不支持作废、退回;撤回只留 sys 兜底两种,加只读「已撤回」;错单线下结清已定(用户;2026-10-21 改写,会议清单 D32)
D-09-03数据范围有「收付款中心」看全部已定(用户)
D-09-04差额叫法沿用「手续费」,不另存银行手续费已定(用户)
D-09-05手续费分摊系统 + 手动;系统按应收占比、尾差给最大账户已定(用户选方向,算法代定已确认)
D-09-06汇出 / 到账 ≠ 应付允许,只记录已定(用户)
D-09-07列表补列与搜索补公司名称 / 所属账户系统 / 付款主体(付款单为收款主体);加搜索;付款金额正数由我代定(已确认)
D-09-08筛选与残留见 R-09-016、R-09-017由我代定(已确认)
D-09-09时间取值系统时间,不能手填由我代定(已确认)
D-09-10输入校验金额 > 0;凭证必填 ≤ 10 × 5MB;应收为 0 的兜底单实收可为 0、凭证选填已定(2026-10-21 会议清单 D33)
D-09-11权限点3 个由我代定(已确认)
D-09-12导出与通知都不做由我代定(已确认)
D-09-13凭证叫法「到款凭证」统一为「到账凭证」由我代定
D-09-14确认时主体与确认备注主体只读、代付写备注;三个确认弹窗加备注已定(2026-10-21 用户定,会议清单 D33)
D-09-15收款主体与渠道付款展示付款单叫「收款主体」;渠道付款取 08 选填值;公司名称格「账户系统 · 结算期」可搜已定(2026-10-21 用户定,会议清单 D37、D14、D90)
D-09-16差额 > 1% 提示二次确认红字提醒,不拦已定(2026-10-21 用户定,会议清单 D05)
D-09-17凭证查看与超量上传「查看」;超出按顺序保留 10 个已定(2026-10-21 用户定,会议清单 D47)
D-09-18其他币种付款、到账凭证提示按本单币种实际入账填,汇差进手续费;凭证提示语已定(2026-10-21 用户定,会议清单 D89、D91)
D-09-190 元单应付 0 的结算单不生成收款单;金额 > 0,0 只作兜底已定(2026-10-21 用户定,D-00-80)
D-09-20分摊币种前提同客户账户同币种,原币直接比已定(2026-10-21 用户定,会议清单 D88)
D-09-21分摊权重为负本次应收 ≤ 0 的账户行权重按 0,本次应收照原值记录;引用改 R-06-051 / R-06-013已定(2026-10-22 用户与技术确认,闭环清单 B05)
D-09-22确认汇款时渠道金额已变待汇出渠道付款单 08 当前总计 ≠ 快照时确认汇款弹窗黄字提示(同 R-08-070),只提示不拦,按提交时金额付款已定(2026-10-22 用户与技术确认,闭环清单 B08)
D-09-23按 S-19 导入的历史收付款单只作记录:确认后不回写来源、不进 10;渠道付款不导入,上线月之前线下处理已定(2026-10-22 用户与技术确认,闭环清单 B09)
D-09-24付款单未完成组排序待汇出、待完成同属「未完成」一组,组内按申请时间降序混排已定(2026-10-22 用户与技术确认,闭环清单 B22)
D-09-25财务ID 编号沿用现有单据 ID(充值 RC-、退款 RF-、结算单、渠道结算单 ID),全局唯一、生成后不变;关闭 Q-09-02已定(2026-10-22 用户与技术确认,闭环清单 E 组)

6.2 原型对照

原型本页处理
收付款中心.html:3121–3135「所属账户系统」选项是登记表状态改为现有账户系统列表(R-09-016)
收付款中心.html:3168–3178 状态筛选「待结算 / 已结算」按单据状态(R-09-016)
收款单列(1962–2329)没有公司名称补公司名称、所属账户系统、付款主体(付款单为收款主体)(R-09-011、R-09-012)
确认收款弹窗(3218–3523)手续费分配 系统分配 / 手动分配、待分配手续费保留,算法见 R-09-034~R-09-036
付款单 待汇出 / 待完成 / 已完成,确认汇款、确认到账(2561–2960、3550–3909)保留三态,到账才算完成(D-09-01)
「到款凭证」「到账凭证」混用统一「到账凭证」(D-09-13)
原型没有搜索框加搜索(R-09-016)