渠道对账

v2.1.0 08-渠道对账 ASA 状态:待评审 2026-10-19 评审版 · 由 PRD.md 自动生成,勿手改

渠道对账 PRD

项内容
所属产品ASA
版本v2.1.0
页面08-渠道对账
涉及功能渠道对账(feature 台账由总控登记)
编制日期2026-10-19(2026-10-21 总控代改:按会议清单 v2 回写;2026-10-22 总控代改:按闭环清单回写)
文档状态待评审
目标读者研发、测试、AI 实现助手(本文件可直接整份投喂给 AI 作为实现依据)
关联文档本目录 spec.yaml、mocks/;版本 index.md;原型 html/渠道对账中心.html、html/审批详情-渠道对账中心.html(均无 V2.1 注释,规则来自用户确认);3 份渠道样表(只参考格式,D-00-27)

0 前置说明

1 整体概述

1.1 背景与目标

现状:上游渠道(账户系统)每月给一份结算单,格式各不相同;自接苹果的账户系统系统里有苹果订单,其他渠道只能靠人看表格核对,渠道统计金额进不了系统,06 账单的消耗差额、10 的毛利与「算没算完」都缺这一项。

目标:

可证伪的判定:公共前置(spec.yaml 头部)下,亨利-国内 2026-09 第一层总计 29,746.02 人民币(直接取模板总计,不是反算的 29,746.03);苹果ASA(自接苹果)第一层 24,000.00 USD(PR-0902 只算一次);亨利-出海 2026-09 发起渠道付款选人民币,换算后应付 124,850.12 人民币;付款单完成后该行变「已完成」,Kredi Plus 渠道付完、OfferGo 未付完。

1.2 本页范围

1.3 角色与权限

角色能做什么不能做什么权限来源
有「渠道对账中心」权限点的用户进入页面;看全部账户系统、全部账户;只读查看两种审批详情导入、付款(另需权限点)新增权限点(R-08-080,13 汇总)
另有「导入渠道账单」权限点导入并提交渠道对账审批;撤回自己的审批中单导入系统抓取的账户系统新增权限点
另有「渠道付款」权限点对符合条件的行发起渠道付款;撤回自己的审批中单修改应付金额新增权限点
审批人通过 / 驳回改审批内容12
系统按订单数据更新抓取数据;审批通过后入账替换;生成付款单;记变化日志、通知下游—R-08-017、R-08-021、R-08-051、R-08-053

1.4 术语定义

术语释义
渠道就是账户系统;「同渠道同结算期」= 同账户系统 × 同结算期(D-08-01)
渠道统计金额上游渠道应付金额,按账户 × 结算期一条;= 其中的「总计」(D-00-26,术语表)
渠道返点上游渠道返给我们的返点,按原值录(D-00-31,术语表);和客户返点无关
系统抓取 / 上传账户系统的渠道数据来源,二选一,技术预置(R-08-016)
渠道导入批次一次导入 = 一个批次 = 一张「渠道对账」审批单;一个结算期、可含多个账户系统
批次分段批次里某一个账户系统那部分;整批替换以分段为单位,同账户系统同结算期只有一个「当前生效」分段
渠道账单行列表第一层,账户系统 × 结算期一行,状态 待完成 / 已完成
在途渠道付款单审批中,或审批已通过但 09 付款单还没完成的渠道付款单
结算期UTC0 自然月,展示「yyyy-mm-01 至 yyyy-mm-最后一天」;本页只从上线月起(D-08-28)
收款主体渠道付款里渠道一方收钱的主体名称(R-08-047,术语表)
入账影响渠道对账入账后会被清空 / 改金额 / 新增的账户清单(R-08-026)

1.5 核心流程

步骤操作者系统行为产物
1系统账户系统 × 月(≥ 上线月)有消耗或渠道数据时出一行;自接苹果按订单数据汇总渠道统计金额渠道账单行(待完成)
2有导入权限的用户选结算期、上传标准模板 → 系统先校验,有错列出错误清单,用户决定继续或返回修改—
3同上继续提交 → 「渠道对账」审批(12)渠道导入批次(审批中)
4系统审批通过:再校验,错的跳过,其余按账户系统整批替换入账;记日志;通知 06、10渠道统计金额
5有付款权限的用户结算期结束后对总计 > 0 的一行发起渠道付款(选结算币种、选填收款主体)→「渠道付款」审批;总计 0.00 的行视为已完成(R-08-056)渠道付款单
6系统审批通过 → 生成 09 付款单(09-收付款中心)付款单
7财务(09)付款单确认汇款(本行仍「付款中」)→ 确认到账(付款单已完成,D-00-33)行变「已完成」;10 判断渠道付完

2 详细需求

2.1 渠道账单列表

2.1.1 功能描述

渠道账单 tab 是三层可展开列表:第一层账户系统 × 结算期,第二层账户,第三层苹果订单(只有系统抓取的账户系统有)。顶部筛选与「导入渠道账单」按钮;第一层操作列发起渠道付款。

2.1.2 核心字段

第一层(渠道账单行):

字段名key类型必填枚举/取值默认值规则说明
结算期periodstring(7)是yyyy-mm(UTC0)—展示「yyyy-mm-01 至 yyyy-mm-最后一天」(R-08-003)
账户系统account_system关联对象是现有账户系统—左固定
数据来源—string是系统抓取 / 上传 · {审批单号} / 未上传—R-08-004
小计subtotaldecimal(2)否≥ 0—本行币种;R-08-019
MAX消耗max_consumptiondecimal(2)是≥ 00.00本行币种;R-08-020
税费taxdecimal(2)否≥ 0—R-08-019;抓取 USD 体系没有税费字段为「-」(R-08-017)
渠道返点channel_rebatedecimal(2)否≥ 0—抓取为「-」;R-08-019
总计totaldecimal(2)否≥ 0—R-08-019;没有数据「-」
状态statusenum是待完成 / 已完成待完成R-08-008、R-08-056
操作———渠道付款 / 付款中 / 变化记录—R-08-011,右固定

第二层(账户):账户名称、orgid、小计、MAX消耗、税费、渠道返点、总计(R-08-005)。第三层(订单):订单号、付款参考编号、账单、账单类型、产品或广告主、描述、发票、截止日期、小计、税费、总计(R-08-006,沿用现有)。

2.1.3 业务规则

2.1.4 状态与流转(本页定义:渠道账单行)

当前状态触发动作操作者目标状态前置条件
无该账户系统该月有任一账户有消耗或有渠道统计金额系统待完成R-08-002
待完成本行渠道付款对应的 09 付款单变「已完成」(确认到账,D-00-33;确认汇款后的待完成不算)系统已完成R-08-054
待完成结算期已结束、第一层总计为 0.00(有值)、无在途且无已完成渠道付款(视为已完成,无需付款)系统已完成R-08-056(D-00-80)
已完成(按 R-08-056 视为)总计变为不是 0.00系统待完成R-08-056

逆向:

2.1.5 异常与边界

场景现象系统行为用户看到
空态没有任何消耗与渠道数据不出行「暂无数据」
筛选无结果——「没有符合条件的渠道账单」
上传账户系统还没导入有消耗没渠道数据金额为「-」数据来源「未上传」,没有「渠道付款」
抓取的同一订单挂多个账户账户行相加 > 第一层第一层按订单号去重(R-08-019)第二层之和大于第一层
当月结算期未结束照常展示没有「渠道付款」(R-08-040)
无权限没有「渠道对账中心」R-08-080(R-13-005)菜单不显示;直接访问时内容区「无权限访问」、保留地址
权限加载失败非登录失效R-13-006「加载失败,请刷新」+「重新加载」,不跳登录
历史月份上线月之前的月份不出行(R-08-002,D-08-28)列表、结算期筛选、导入选项都从上线月起
总计 0.00 / 负数结算期已结束0.00 视为已完成;负数不能付款(R-08-056)「已完成 · 无需付款」/ 待完成无按钮

2.1.6 验收标准

示意 1渠道账单列表(三层展开、付款中、金额有变化)mocks/01-渠道账单列表.html
示意 2渠道账单列表(空态)mocks/02-空态.html

2.2 渠道统计金额口径

2.2.1 功能描述

定义「账户 × 结算期」的渠道统计金额从哪来、怎么合计、怎么被替换、变了怎么记、怎么通知下游。06 账单、10 利润都读这里。

2.2.2 核心字段(渠道统计金额)

字段名key类型必填枚举/取值默认值规则说明
账户account_id关联对象是02 账户—按 orgid 匹配(D-00-23)
orgidorgidstring是——账户 ID
账户系统account_system关联对象是——账户所属(R-02-002)
结算期periodstring(7)是yyyy-mm(UTC0)——
来源sourceenum是系统抓取 / 上传—R-08-016
小计subtotaldecimal(2)是≥ 0—账户消耗币种;上传 = 模板「消耗金额」
税费taxdecimal(2)是≥ 0—账户消耗币种
渠道返点channel_rebatedecimal(2)否≥ 0—抓取为空
总计(渠道统计金额)totaldecimal(2)是≥ 0—上传取模板「总计金额」原值,不反算(D-00-26)
来源批次分段segment_id关联对象否——上传时有
更新时间updated_atdatetime(UTC 存,Asia/Shanghai 显示,秒)是——系统生成

变化日志字段:时间、账户系统、结算期、账户、变化前总计、变化后总计、来源(R-08-023)。

2.2.3 业务规则

2.2.4 状态与流转(本页定义:批次分段)

当前状态触发动作操作者目标状态前置条件
无所属批次入账时,该账户系统有可入账行系统当前生效R-08-021
当前生效同账户系统同结算期的新批次入账系统已被替换R-08-021

没有逆向操作:已入账的数据不能撤销,要改就再导入修正文件整批替换(D-00-30)。

已知限制(D-08-39):导入选错结算期时,系统不能把该结算期清回「未上传」;该结算期的正确文件到了后再导入整批替换;在此之前不要对该行发起渠道付款,付款审批人按审批内容核对。导入弹窗所选结算期不是上个月时黄字提醒(R-08-031)。

2.2.5 异常与边界

场景现象系统行为用户看到
修正文件少了某个 orgid旧批次有、新批次没有该 orgid 变回「-」(R-08-021)金额「-」,变化日志一条「x → -」
入账时某账户系统全部行被跳过0 行可入账该账户系统不替换旧数据保留
付款中或已完成时数据变化—照常更新(R-08-022)已完成的行出现「金额有变化」
模板总计与分项对不上消耗 + 税费 − 渠道返点 ≠ 总计不校验,取总计(D-00-26)按模板总计展示
同账户系统下账户币种不同不会出现(D-08-29,技术答复 T08)以账户系统 × 结算期为键(R-08-015)—
抓取类账户有消耗、没有订单金额「-」所属行已完成后视为渠道付完、10 按 0 计(R-08-091)仍显示「-」
渠道返点隔月单独打回总计没冲抵不校验;按说明填冲抵后的总计(R-08-031、R-08-032)已知限制,下期再做

2.2.6 验收标准

本节规则的验收见 G-08-001、G-08-002(抓取口径、税费「-」、共享标注与去重)、G-08-008(入账影响)、G-08-012(整批替换与变化日志)、G-08-022(付款后金额变化与时间点行)、G-08-035(抓取类无订单账户)。

2.3 导入渠道账单

2.3.1 功能描述

有导入权限的用户选结算期、上传标准模板,系统先逐行校验;有错误行时列出错误清单,由用户决定返回修改还是带着错误继续提交;提交后走「渠道对账中心—渠道对账」审批,通过后才入账。

2.3.2 标准上传模板(定稿,2026-10-21 用户确认,D-08-45)

文件名「渠道账单导入模板.xlsx」,第一个工作表「渠道账单」:

列列名必填取值入账为
A账户系统是系统里的账户系统名称,须为上传类账户系统
Borgid是账户 ID,数字或文本匹配账户
C消耗金额是数字,≥ 0,该账户消耗币种小计
D税费是数字,≥ 0;渠道不收税填 0税费
E渠道返点是数字,≥ 0;没有填 0渠道返点
F总计金额是数字,≥ 0;即应付上游的金额总计(渠道统计金额)

第二个工作表「填写说明」:上表每列的含义,加一条示例行(亨利-国内 / 8630011 / 16277.43 / 976.65 / 0 / 17254.07),导入时不读。结算期不在模板里,在弹窗选。

2.3.3 弹窗字段

字段名key类型必填枚举/取值默认值规则说明
结算期periodenum是上线月起已结束的 UTC0 自然月,降序上个月当月不可选;非上个月黄字提醒(R-08-031)
渠道账单模板—链接—「下载模板」—R-08-032
渠道账单文件file文件是1 个 .xlsx—大小上限沿用现有上传组件
备注remarktext否多行空即发起备注(D-08-24)

2.3.4 业务规则

2.3.5 状态与流转(本页定义:渠道导入批次)

当前状态触发动作操作者目标状态前置条件
无「提交审批」/「继续提交」有导入权限的用户审批中R-08-033、R-08-036~R-08-038
审批中「渠道对账」审批通过(含 0 节点即通过)系统已入账R-08-050、R-08-051
审批中审批驳回审批人已驳回R-08-052
审批中撤回申请人已撤回R-08-052、R-12-032(D-00-79②)
审批中作废(效果同撤回)持「审批配置」权限点的人已撤回R-08-052(D-00-79③)

逆向:驳回 / 撤回 / 作废只在审批中;不入账,原单不能改重提,可重新导入。已入账不提供撤销,要改就导入修正文件整批替换(D-00-30)。提交前的校验结果不落批次,用户点「返回修改」或关闭弹窗即丢弃。

2.3.6 异常与边界

场景现象系统行为用户看到
文件格式不对 / 表头不对 / 空文件—不出校验结果、不能提交(R-08-033)字段下方提示
有错误行—列错误清单,可继续提交(R-08-037)「校验结果」弹窗
全部行错误可入账 0 行「继续提交」置灰「没有可入账的行……」
同账户系统同结算期已有审批中导入—整份不能提交(R-08-036)提示框,带审批单号与申请人
选错结算期已入账不能清回「未上传」(已知限制,§2.2.4)非上个月时黄字提醒
入账会清空旧数据错误行 / 文件里没有的 orgid列「入账影响」表(R-08-026)将清空置顶标红
校验中解析耗时按钮加载、弹窗不可关加载态
重复点击连点「继续提交」只提交一次(R-08-038)—
校验后到提交前另一张单进入审批中并发提交时再查冲突(R-08-038)冲突提示
审批期间账户归属变化—通过时再校验跳过(R-08-051)入账结果显示跳过行
无权限没有「导入渠道账单」按钮不显示,接口拒绝(R-08-080)—
文件行数很多—上限由技术评估(§4)—

2.3.7 验收标准

示意 3导入渠道账单弹窗与校验结果mocks/03-导入渠道账单.html

2.4 渠道付款

2.4.1 功能描述

结算期结束后,有付款权限的用户对第一层一行(账户系统 × 结算期)发起渠道付款,应付 = 该行总计;可换结算币种;走「渠道对账中心—渠道付款」审批,通过后交给 09 生成付款单。

2.4.2 核心字段(渠道付款单)

字段名key类型必填枚举/取值默认值规则说明
结算期periodstring(7)是—本行只读
账户系统account_system关联对象是—本行只读
小计 / 税费 / 渠道返点 / 总计subtotal / tax / channel_rebate / totaldecimal(2)是(渠道返点否)—本行本行币种,提交时快照
应付金额payabledecimal(2)是= 总计总计本行币种,不可改(R-08-041)
结算币种settle_currencyenum是人民币 / USD / USDT本行币种R-08-042
汇率fx_ratedecimal(4)是1 本行币种 = x 结算币种同币种为 1日汇率四舍五入 4 位,显示与计算一致(D-00-74);提交当天锁定(D-00-62)
汇率日期fx_datedate是实际取到汇率的那天(UTC0)—汇率后括号显示、进快照(R-08-042)
收款主体payeestring否该渠道填过的值 / 手填新值空R-08-047
共享订单数shared_order_countint是≥ 0—R-08-041
换算后应付金额payable_settledecimal(2)是= 应付 × 汇率,四舍五入—结算币种
缺数据账户数missing_countint是≥ 0—R-08-043
账户明细快照account_snapshot列表是第二层全部账户—R-08-046
备注remarktext否多行空即发起备注
付款单payment_order_id关联对象否09 付款单—通过后生成(R-08-053)

渠道付款单不单独设状态:审批阶段看 12 审批单状态,通过后看 09 付款单状态。

2.4.3 业务规则

2.4.4 异常与边界

场景现象系统行为用户看到
当月 / 总计为「-」或 ≤ 0 / 已完成 / 有在途—不显示「渠道付款」(R-08-040)在途时显示「付款中」;0.00 为「已完成 · 无需付款」
有账户缺数据—不拦(R-08-043)黄色提示
取不到汇率—不能提交(R-08-042)「未取到……汇率」
换算后应付为 0.00如总计 0.01 人民币选 USD 结算不能提交;复核时同样拦截(R-08-042、R-08-045 ④)「换算后应付金额为 0.00,请改用 {本行币种} 结算」
弹窗打开期间数据变了并发不创建审批单、弹窗不关、就地重载(R-08-045 ①)变化标黄、「数据已更新,请核对后重新提交」
跨零点 / 当天汇率更新提交时汇率与展示不同先不建单,弹汇率确认(R-08-045 ②)「汇率已更新为……是否按新汇率提交?」
别人已先提交并发不创建(R-08-045 ③)提示框,带审批单号与申请人或付款单财务ID与状态
重复点击—只提交一次按钮加载
无权限没有「渠道付款」按钮不显示,接口拒绝—

2.4.5 验收标准

示意 4渠道付款弹窗(换结算币种、缺数据提示)mocks/04-渠道付款.html

2.5 审批结果处理

2.5.1 功能描述

两种审批结束后,本页怎么处理业务单据(12 只通知结果,R-12-025)。

2.5.2 业务规则

2.5.3 异常与边界

场景现象系统行为用户看到
审批期间账户归属变了提交时可入账,通过时不可跳过(R-08-051)入账结果「跳过 Y 行」+ 入账错误清单
0 节点免审提交即通过(R-08-050)「提交成功,无需审批,已生效」;立即入账或立即生成付款单
通过时错误行全部跳过入账 0 行不算执行失败,批次照常「已入账」(R-08-057)入账结果「入账 0 行,跳过 Y 行」
审批中被「审批配置」作废—同撤回(R-08-052、R-08-055)—
付款中又导入修正文件—照常入账,付款金额按快照(R-08-022)付款完成后若不一致显示「金额有变化」
已完成后金额变化—状态不变(R-08-025)「金额有变化」「变化记录」
已确认汇款、还没确认到账付款单待完成不回写(R-08-053)仍是待完成、「付款中」
付款单作废 / 退回—本期不做(D-00-69,D-08-27)—

2.5.4 验收标准

2.6 已提交审批

2.6.1 功能描述

列当前用户在本页提交的两种审批单,可看详情、撤回。

2.6.2 业务规则

2.6.3 异常与边界

场景现象系统行为用户看到
没提交过——「暂无数据」
撤回时单子刚被审完并发按 12 处理,撤回失败12 的提示,刷新后状态为最新

2.6.4 验收标准

示意 5已提交审批 tabmocks/05-已提交审批.html

2.7 审批内容区

2.7.1 功能描述

两种审批详情的「审批内容」区(审批信息、审批流、按钮由 12 通用框架提供,D-00-46)。

2.7.2 业务规则

2.7.3 异常与边界

场景现象系统行为用户看到
提交后渠道数据又变了—内容区仍是快照(R-08-070)金额不变;渠道付款审批中顶部黄色提示差额
原文件下载失败—沿用现有文件下载的失败提示—
无查看权限—R-08-082「无权限查看」

2.7.4 验收标准

示意 6两种审批的审批内容区mocks/06-审批内容.html

2.8 权限

2.8.1 业务规则

2.8.2 验收标准

2.9 对外接口

验收见 G-08-012(06 同步)、G-08-020(09 生成付款单、10 判断渠道付完)。

3 变更影响面

被影响对象影响方式处理动作负责人
06 账单渠道两列上传来源读本页数据(R-08-090);苹果订单归期、币种折算、税费「-」与 06 同口径(R-08-017)06 接入本页接口(T-06-002);06 R-06-015 同步口径06 / 技术
09 付款单新交易类型「渠道付款」的来源与字段(R-08-053、R-08-092)09 定义付款单、回写完成09
10 利润 / 11 提成渠道统计金额、渠道付完、变化退回(R-08-091)10 读取并实现 D-00-6610
12 审批两种审批类型的业务单据、查看判断(R-08-038、R-08-046、R-08-082)无需改 12—
13 权限新增 3 个权限点(R-08-080)汇总13
版本级口径D-00-25 列名、D-00-29 校验时机有调整总控更新 index总控
存量上线月之前不出行(D-08-28,S-18,与 06 / 07 / 10 / 11 共用同一上线月,上线月上线前定);每个渠道预置收款主体「渠道名称」(D-08-31,技术迁移)总控登记存量汇总总控 / 技术
10 利润0.00 行视为完成、抓取类无订单账户视为付完、共享订单 10 拆分(R-08-091)10 同步 R-10-021 等10
09 付款单新增收款主体字段、列表显示(R-08-053)09 同步 R-09-01209

4 非功能与埋点

5 开放问题

编号问题卡谁期望结论时间
Q-08-01【已关闭 2026-10-21 → D-08-30(技术答复 T09)】哪些账户系统是「系统抓取」,订单数据现有字段与接口——
Q-08-02【已关闭 2026-10-21 → D-08-29(技术答复 T08)】同一账户系统下所有账户的消耗币种是否一定相同——
Q-08-04【已关闭 2026-10-21 → D-08-28(会议清单 D60)】存量:上线前历史结算期怎么处理——
Q-08-05【已关闭 2026-10-21 → 用户确认 D-08-24、D-08-25 转已定】评审确认代定的 D-08-24(模板结构、导入备注)、D-08-25(已提交审批范围与列)——
Q-08-06【已关闭 2026-10-21 → D-08-45:R-08-032 / §2.3.2 现稿即定稿】标准上传模板草稿(§2.3.2)确认——

已知限制(2026-10-21 回写):

6 附录

6.1 已定决策

D-08-01~D-08-49 见 spec.yaml → decisions。其中 D-08-01~D-08-13 为用户逐条回答,D-08-14~D-08-23 为用户确认的代定清单,D-08-24、D-08-25 原为代定、2026-10-21 用户确认转已定,D-08-26 已由会议清单 D59 定,D-08-27 为 09 付款单本期不作废(D-00-69);D-08-28~D-08-43 为 2026-10-21 用户在会议清单 v2 拍板后由总控代改回写(D-08-10、D-08-23 同日改写);D-08-44(0.00 行视为已完成可逆)、D-08-45(标准模板定稿)为 2026-10-21 用户确认;D-08-46~D-08-49 为 2026-10-22 用户与技术确认的闭环清单 B01 / B06 / B07 / B21,D-08-28 同日按闭环清单 A01 改写。

6.2 原型对照

原型位置本 PRD 处理
渠道对账中心.html:1962–2674 三层列表照搬列,第一层加「数据来源」、第二层加「orgid」(R-08-003~R-08-006)
:3042–3052 状态筛选「待结算 / 已结算」复制残留,改为 待完成 / 已完成(R-08-008)
:3092–3191 渠道付款弹窗「充值金额」去掉;加结算币种、汇率、缺数据提示(R-08-041~R-08-043)
:3218–3293 导入弹窗按钮「保存」改「提交审批」,加备注(R-08-031)
:2773–2980 已提交审批「操作对象」列改「审批类型」,加结算期、账户系统(R-08-061)
审批详情-渠道对账中心.html 面包屑「返点管理/审批详情」改「渠道对账中心/审批详情」(R-08-070)

6.3 样表观察(只参考格式)