渠道对账 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 前置说明
- 本页覆盖版本记录第 20 项(渠道对账中心)、第 21 项(渠道对账审批详情,只写「审批内容」区)。
- 本页主管:渠道导入批次(含批次分段)、渠道统计金额(账户 × 结算期)、渠道账单行(账户系统 × 结算期)及其状态、渠道付款单、渠道金额变化日志;「渠道对账中心—渠道对账」「渠道对账中心—渠道付款」两种审批(D-12-14)的业务处理与审批内容区。
- 引用 02-账户管理:按 orgid 匹配账户(D-00-23),账户所属账户系统(添加时选定 R-02-002,编辑不可改 R-02-017)。
- 引用 06-账单与结算单:系统抓取(自接苹果)的订单数据与口径和 06 是同一份(R-06-014~R-06-016、R-06-028);06 反过来读本页上传来源的渠道统计金额,不锁定(R-06-018)。
- 引用 12:审批提交、结果、撤回、通知、审批详情框架与只读查看(R-12-001、R-12-010、R-12-014、R-12-016、R-12-018、R-12-025、R-12-026~R-12-035、R-12-038、R-12-043、R-12-044)。
- 引用 09-收付款中心(2026-10-20 补):付款单三态 待汇出 / 待完成 / 已完成,确认到账才算完成并回写本页(R-09-042、R-09-071、R-09-072,D-00-33);本期不作废 / 退回(D-00-69)。引用 13:有「收付款中心」权限点的人可只读查看渠道付款审批详情(R-13-050,D-00-71)。
- 09(付款单)、10(利润)已出草稿,接口按其编号对齐(R-09-042、R-09-071、R-10-005);本页写到「审批通过 → 生成付款单」「付款单完成 → 行已完成」「给 10 渠道统计金额与渠道付完判定」这几个接口点为止。
- 版本级口径:D-00-08、D-00-13、D-00-15、D-00-23~D-00-31、D-00-44、D-00-45、D-00-62、D-00-65、D-00-66、D-00-74(日汇率与结算汇率 4 位)、D-00-75(审批中对象变化提示)、D-00-76(提交审批传涉及账户)、D-00-78(权限点清单)、D-00-79(审批通用口径)、D-00-80(0 元单)。2026-10-21 按会议清单 v2 回写的页面决策见 D-08-28~D-08-43。本页与其中两条有出入、已上报总控:D-00-25「返点金额」列名改「渠道返点」(D-08-12);D-00-29 改为提交前先校验、审批后再校验跳过错误行(D-08-09)。
1 整体概述
1.1 背景与目标
现状:上游渠道(账户系统)每月给一份结算单,格式各不相同;自接苹果的账户系统系统里有苹果订单,其他渠道只能靠人看表格核对,渠道统计金额进不了系统,06 账单的消耗差额、10 的毛利与「算没算完」都缺这一项。
目标:
- 每个账户系统每个月一行,能看到每个账户的渠道统计金额:自接苹果自动从订单汇总,其他渠道按标准模板上传,整批审批后入账。
- 上传前就告诉用户哪几行会出错;审批通过后整批替换同账户系统同结算期的旧数据,旧版本留档可追溯。
- 按账户系统 × 结算期发起渠道付款,审批通过交给 09 付款,付款完成即「已完成」,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 本页范围
- ✅ 包含:渠道对账中心页(渠道账单、已提交审批两个 tab);渠道统计金额口径(抓取 / 上传、整批替换、变化日志);导入渠道账单(模板、提交前校验、渠道对账审批、通过后再校验入账);渠道付款(弹窗、结算币种、渠道付款审批、生成付款单、行状态);两种审批的审批内容区;3 个权限点;给 06 / 09 / 10 的接口点。
- ❌ 不包含:付款单本身与付款执行(09);账单里渠道两列的展示与去重(06);客户返点(07);利润计算(10);付款后金额变化的补付 / 退款单据(线下处理,D-08-08);抓取 / 上传来源的页面配置(技术预置,D-08-12);审批引擎与通用框架(12);单条录入、草稿、跨月合并付款、补充账单(补数据一律导入修正文件整批替换,D-00-30、D-08-39);作废当前生效分段(D-08-39);渠道收款账号与收款主体维护页(D-08-31);渠道返点隔月单独打回的收款(下期,D-08-40)。
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 | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|---|---|---|---|---|---|
| 结算期 | period | string(7) | 是 | yyyy-mm(UTC0) | — | 展示「yyyy-mm-01 至 yyyy-mm-最后一天」(R-08-003) |
| 账户系统 | account_system | 关联对象 | 是 | 现有账户系统 | — | 左固定 |
| 数据来源 | — | string | 是 | 系统抓取 / 上传 · {审批单号} / 未上传 | — | R-08-004 |
| 小计 | subtotal | decimal(2) | 否 | ≥ 0 | — | 本行币种;R-08-019 |
| MAX消耗 | max_consumption | decimal(2) | 是 | ≥ 0 | 0.00 | 本行币种;R-08-020 |
| 税费 | tax | decimal(2) | 否 | ≥ 0 | — | R-08-019;抓取 USD 体系没有税费字段为「-」(R-08-017) |
| 渠道返点 | channel_rebate | decimal(2) | 否 | ≥ 0 | — | 抓取为「-」;R-08-019 |
| 总计 | total | decimal(2) | 否 | ≥ 0 | — | R-08-019;没有数据「-」 |
| 状态 | status | enum | 是 | 待完成 / 已完成 | 待完成 | R-08-008、R-08-056 |
| 操作 | — | — | — | 渠道付款 / 付款中 / 变化记录 | — | R-08-011,右固定 |
第二层(账户):账户名称、orgid、小计、MAX消耗、税费、渠道返点、总计(R-08-005)。第三层(订单):订单号、付款参考编号、账单、账单类型、产品或广告主、描述、发票、截止日期、小计、税费、总计(R-08-006,沿用现有)。
2.1.3 业务规则
- R-08-001 菜单「财务中心 / 渠道对账中心」进入;页面两个 tab:渠道账单(默认)、已提交审批;页面数据不跟随顶栏「账户系统」切换,只用页内筛选(D-08-14)。
- R-08-002 第一层一个账户系统 × 一个 UTC0 自然月一行,只出结算期 ≥ 上线月的行(上线月 = 第一个在系统里付渠道款的结算期;06 出账单、07 计提、08 渠道、10 利润、11 提成从同一个上线月起算,共用一个配置,即 index S-18 的上线月(D-10-08),具体月份上线前定,D-08-28);该账户系统该月有任一账户有消耗数据,或有任一账户有渠道统计金额时出现这一行;当月也展示,金额随数据变化;两者都没有的月份不出行(D-08-15)。
- R-08-003 第一层列依次:结算期(「yyyy-mm-01 至 yyyy-mm-最后一天」)、账户系统(左固定)‖ 数据来源、小计、MAX消耗、税费、渠道返点、总计、状态 ‖ 操作(右固定)。
- R-08-004 数据来源列:系统抓取的账户系统显示「系统抓取」;上传的账户系统有当前生效分段时显示「上传 · {该批次审批单号}」,审批单号可点、新页打开 12 的唯一审批详情地址(R-12-026);没有当前生效分段显示「未上传」。
- R-08-005 点第一层行展开第二层,列依次:账户名称、orgid、小计、MAX消耗、税费、渠道返点、总计;列出该账户系统下本结算期有消耗或有渠道统计金额的账户;没有渠道统计金额的账户 小计 / 税费 / 渠道返点 / 总计 显示「-」;按总计降序,「-」的排最后,同值按账户名称升序。
- R-08-006 第三层只有系统抓取的账户系统有:点有订单的账户行展开,列 订单号、付款参考编号、账单、账单类型、产品或广告主、描述、发票、截止日期、小计、税费、总计;数据与 06 第三层是同一份苹果订单数据,下载与跳转沿用现有(R-06-028);同一订单号挂在本行多个账户下时,该订单在每个账户下都标注「与 {其他账户名称} 共享,各账户全额列示,第一层只算一次」(其他账户多个时用「、」连接,D-08-42);上传的账户系统的账户行不显示展开箭头。
- R-08-007 金额一律本行币种(= 账户消耗币种,不换算,D-08-04),千分位、2 位小数、后缀币种代码(格式同 R-05-033);没有数据显示「-」。
- R-08-008 状态只有两个:待完成(默认)、已完成;已完成 = 本行渠道付款对应的 09 付款单已完成(R-08-054),或第一层总计为 0.00 视为已完成(R-08-056);原型状态筛选里的「待结算 / 已结算」是复制残留,不做(D-08-16)。
- R-08-009 筛选:搜索框按账户名称或 orgid 包含匹配,命中时第一层只显示含命中账户的行,展开后第二层只列命中账户,第一层金额仍是整行的;账户系统 单选 全部 + 全部账户系统,默认全部;结算期 单选 全部 + 有数据的月份(≥ 上线月,降序,R-08-002),默认全部;状态 全部 / 待完成 / 已完成,默认全部;各条件同时生效。
- R-08-010 第一层按结算期降序、同结算期按账户系统名称升序;分页 10 / 50 / 100 / 300 条每页,默认 10;没有数据显示「暂无数据」;筛选后没有结果显示「没有符合条件的渠道账单」。
- R-08-011 第一层操作列:符合 R-08-040 时显示「渠道付款」;有在途渠道付款单时显示灰字「付款中」(不可点);本行有任一条变化日志(R-08-023)时另显示「变化记录」(R-08-025),可与「渠道付款」或「付款中」并列(D-08-32);都不符合时为空。
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 |
逆向:
- 渠道付款驳回 / 撤回 / 作废(作废同撤回,D-00-79③):保持待完成,「渠道付款」重新出现(R-08-055)。
- 已完成后金额变化:状态不变,只标记与记日志,线下处理(R-08-025,D-08-08)。
- 收付款单作废 / 退回:本期不做(D-00-69,D-08-27);sys 兜底撤回只对 05 充值收款单、退款付款单,渠道付款单不在其列。
- 总计 < 0 的行:不能发起渠道付款,保持待完成,线下处理(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 验收标准
- G-08-001 前置:公共前置;王敏打开渠道对账中心,筛选结算期 2026-09-01 至 2026-09-30。操作:查看第一层。期望:三行按账户系统名称升序:亨利-出海 数据来源「上传 · SP-0902 的审批单号」小计 20,145.70 USD、税费 0.00 USD、渠道返点 2,618.94 USD、总计 17,526.76 USD;亨利-国内 小计 28,533.98 人民币、MAX消耗 2,000.00 人民币、税费 1,712.05 人民币、渠道返点 500.00 人民币、总计 29,746.02 人民币(不等于 小计 + 税费 − 返点 的 29,746.03,因为直接取总计);苹果ASA(自接苹果)数据来源「系统抓取」小计 24,000.00 USD、税费「-」(USD 体系没有税费字段)、渠道返点「-」、总计 24,000.00 USD;三行状态都是待完成,操作列都是「渠道付款」和「变化记录」并列;顶栏账户系统切到别的值后列表不变。
- G-08-002 前置:同 G-08-001。操作:展开苹果ASA(自接苹果)行,再展开 5130021、5130048。期望:第二层 橙子-iOS-CN 总计 20,000.00 USD、橙子-iOS-HK 12,000.00 USD(相加 32,000.00 > 第一层 24,000.00),两行税费都是「-」;两个账户的第三层都列出 PR-0902,5130021 下标注「与 橙子-iOS-HK 共享,各账户全额列示,第一层只算一次」,5130048 下标注「与 橙子-iOS-CN 共享,各账户全额列示,第一层只算一次」;PR-0901、PR-0903 没有标注;展开亨利-国内行,三个账户行都没有展开箭头。
- G-08-003 前置:同 G-08-001。操作:展开亨利-出海行。期望:Kredi Plus 8527001 总计 17,526.76 USD;OfferGo 8527002、Moma Live 8527003 四项金额都为「-」,排在最后(Moma Live 在 OfferGo 前)。
- G-08-004 前置:同 G-08-001。操作:搜索 8630012。期望:第一层只剩亨利-国内 2026-09,总计仍为 29,746.02 人民币;第二层只有 青柠-iOS-TW。
- G-08-005 前置:新环境无数据;另在公共前置下筛选状态「已完成」。期望:前者「暂无数据」;后者「没有符合条件的渠道账单」;状态筛选只有 全部 / 待完成 / 已完成。
- G-08-031 前置:上线月配置为 2026-09;苹果ASA 2026-08 有消耗与订单,亨利-国内 2026-08 有消耗。操作:查看渠道账单列表与结算期筛选;打开导入弹窗查看结算期选项。期望:第一层没有任何 2026-08 及更早的行;结算期筛选只有 全部、2026-10、2026-09;导入弹窗结算期只有 2026-09 一个选项(2026-10 未结束不可选)。
2.2 渠道统计金额口径
2.2.1 功能描述
定义「账户 × 结算期」的渠道统计金额从哪来、怎么合计、怎么被替换、变了怎么记、怎么通知下游。06 账单、10 利润都读这里。
2.2.2 核心字段(渠道统计金额)
| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|---|---|---|---|---|---|
| 账户 | account_id | 关联对象 | 是 | 02 账户 | — | 按 orgid 匹配(D-00-23) |
| orgid | orgid | string | 是 | — | — | 账户 ID |
| 账户系统 | account_system | 关联对象 | 是 | — | — | 账户所属(R-02-002) |
| 结算期 | period | string(7) | 是 | yyyy-mm(UTC0) | — | — |
| 来源 | source | enum | 是 | 系统抓取 / 上传 | — | R-08-016 |
| 小计 | subtotal | decimal(2) | 是 | ≥ 0 | — | 账户消耗币种;上传 = 模板「消耗金额」 |
| 税费 | tax | decimal(2) | 是 | ≥ 0 | — | 账户消耗币种 |
| 渠道返点 | channel_rebate | decimal(2) | 否 | ≥ 0 | — | 抓取为空 |
| 总计(渠道统计金额) | total | decimal(2) | 是 | ≥ 0 | — | 上传取模板「总计金额」原值,不反算(D-00-26) |
| 来源批次分段 | segment_id | 关联对象 | 否 | — | — | 上传时有 |
| 更新时间 | updated_at | datetime(UTC 存,Asia/Shanghai 显示,秒) | 是 | — | — | 系统生成 |
变化日志字段:时间、账户系统、结算期、账户、变化前总计、变化后总计、来源(R-08-023)。
2.2.3 业务规则
- R-08-015 渠道统计金额按「账户 × UTC0 自然月结算期」一条,含 小计、税费、渠道返点、总计 四项;系统里的「渠道统计金额」就是其中的总计(D-00-26);币种 = 该账户的消耗币种,不换算(D-08-04);同一账户系统下所有账户的消耗币种相同(= 账户系统币种),同一账户系统同一结算期只有一个币种,所以第一层合计、整批替换、渠道付款、渠道付完都以「账户系统 × 结算期」为键,导入金额的币种即账户系统币种(D-08-29)。
- R-08-016 来源按账户系统二选一:系统抓取 / 上传,由技术预置,页面不提供配置(D-08-12);系统抓取 = 从苹果同步订单、按订单号结算渠道账单的账户系统(自接苹果),其余都是上传(D-08-30);系统抓取的账户系统不开放上传(D-00-24)。
- R-08-017 系统抓取:账户的 小计 / 税费 / 总计 = 该账户本结算期订单行对应列之和,同一订单号挂在多个账户下时每个账户各算一次(口径同 R-06-015);订单归期与币种同 06:LOC 订单按账单月份落 UTC0 自然月,订单币种与账户币种不同时按截止日期当天的日汇率折成账户币种,截止日期晚于今天(UTC0)时先按最近一天的日汇率暂时折算,截止日当天汇率入库后按当天汇率重折一次,变化记为「订单数据更新」(R-08-023),之后不再变(D-08-48);CC 订单按交易日归期、按交易日的日汇率折算;税费:订单有税费字段的照实取,没有税费字段的(USD 体系,含老数据为空的)税费显示「-」、不补 0,此时总计 = 小计,不用总计 − 小计反推(D-08-30);渠道返点为空、显示「-」;订单数据更新时随之更新。
- R-08-018 上传:账户的四项 = 该账户所属账户系统(R-02-002)在本结算期「当前生效」分段里该 orgid 那一行(四舍五入到 2 位后的值);没有当前生效分段,或分段里没有这个 orgid,显示「-」。
- R-08-019 第一层合计:上传 = 第二层各账户四项分别相加,「-」不计,全部为「-」时显示「-」;系统抓取 = 本行全部订单按订单号去重后小计、税费、总计分别相加(口径同 R-06-016;税费全部为「-」时显示「-」),渠道返点「-」;所以抓取的第一层可能小于账户行之和。
- R-08-020 MAX消耗 = 系统里该账户本结算期出价策略为 MAX_CONVERSIONS 的广告系列的消耗之和:按当天的出价策略识别,一天内改过的按当天 UTC0 结束时的策略计整天,上线前的日子按上线时的策略(口径同 07 R-07-007、D-00-15 里的 MAX 消耗),取数沿用现有广告数据;第一层 = 各账户相加;没有 MAX 系列为 0.00;只展示供核对,不参与任何计算(D-08-05)。
- R-08-021 整批替换:批次入账时,对批次里每个有可入账行的账户系统,该账户系统该结算期原「当前生效」分段变「已被替换」,本批分段变「当前生效」;被替换分段的数据保留、可在审批详情追溯,不再参与任何计算;新分段里没有的 orgid 渠道统计金额变回「-」(D-00-30、D-08-20);入账时某账户系统一行可入账的都没有,该账户系统不替换。
- R-08-022 渠道统计金额不锁定:任何行状态(含付款中、已完成)下都随入账替换或订单数据更新(与 R-06-018 一致);渠道付款金额以提交时快照为准(R-08-046)。
- R-08-023 账户 × 结算期的总计每变一次记一条变化日志:时间、账户系统、结算期、账户、变化前总计、变化后总计、来源(「渠道对账 {审批单号}」或「订单数据更新」);从无到有、变回「-」也记。
- R-08-024 账户 × 结算期的渠道统计金额从无到有、变化、变回「-」时通知下游:06 账单的渠道两列随之更新(R-06-018),10 按 D-00-66 把该账户该月退回重算;第一层行状态变化(付款单完成变已完成 R-08-054;0.00 行视为已完成或回到待完成 R-08-056)同样通知 10,10 按 R-10-023「完成条件变化」重算该行各账户该月(D-08-46);一次批次入账只发一次汇总通知还是逐条,由技术定。
- R-08-025 付款后金额变化:行因渠道付款已完成(R-08-054),且当前总计 ≠ 已付总计快照时,状态保持已完成(D-08-08);状态旁显示橙色「金额有变化」,悬浮显示「已付 {已付总计} {币种},现总计 {当前总计} {币种},差额 {当前 − 已付} {币种}」,差额含付款后才有渠道统计金额的账户;修正文件把整行清成「-」(当前总计为「-」)时悬浮显示「已付 {已付总计} {币种},现总计 -,差额按 0 计为 −{已付总计} {币种}」(D-08-49);线下处理,系统不生成补付或退款单据。「变化记录」(R-08-011)点开弹窗,标题「变化记录 · {账户系统} · {结算期}」,按时间倒序列本行全部变化日志(R-08-023),并在对应时间位置插入时间点行「付款提交 · {审批单号} · 快照总计 {快照总计} {币种}」「付款完成 · {财务ID}」(没有渠道付款的不插;驳回 / 撤回 / 作废的付款不插)(D-08-32)。
- R-08-026 「入账影响」表:按本批每个有可入账行的账户系统,列出本结算期入账后会变的账户:账户系统、账户名称、orgid、当前生效总计 → 本次总计;分三类依次列:将清空(x → -:当前有值、本批没有它的可入账行,含错误行对应的账户和文件里没有的 orgid),置顶标红;金额变化(x → y);新增(- → x);当前有值且本次总计相同的不逐行列,表尾一行「其余 N 个账户不变」(N = 0 不显示);可入账 0 行的账户系统不替换(R-08-021),不进本表;用于校验结果弹窗、无错误行时的确认框(R-08-037)与渠道对账审批内容区(R-08-071,提交时快照)(D-08-33)。
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(抓取类无订单账户)。
- G-08-032 前置:公共前置(亨利-国内 2026-09 待完成,SP-0901 入账时记了 3 条日志)。操作:点该行「变化记录」。期望:操作列「渠道付款」与「变化记录」并列;弹窗标题「变化记录 · 亨利-国内 · 2026-09-01 至 2026-09-30」,列 3 条:8630011 - → 17,254.07、8630012 - → 5,811.04、8630013 - → 6,680.91,来源都是「渠道对账 SP-0901」;没有「付款提交」「付款完成」时间点行;2026-10 亨利-国内行(没有日志)不显示「变化记录」。
2.3 导入渠道账单
2.3.1 功能描述
有导入权限的用户选结算期、上传标准模板,系统先逐行校验;有错误行时列出错误清单,由用户决定返回修改还是带着错误继续提交;提交后走「渠道对账中心—渠道对账」审批,通过后才入账。
2.3.2 标准上传模板(定稿,2026-10-21 用户确认,D-08-45)
文件名「渠道账单导入模板.xlsx」,第一个工作表「渠道账单」:
| 列 | 列名 | 必填 | 取值 | 入账为 |
|---|---|---|---|---|
| A | 账户系统 | 是 | 系统里的账户系统名称,须为上传类 | 账户系统 |
| B | orgid | 是 | 账户 ID,数字或文本 | 匹配账户 |
| C | 消耗金额 | 是 | 数字,≥ 0,该账户消耗币种 | 小计 |
| D | 税费 | 是 | 数字,≥ 0;渠道不收税填 0 | 税费 |
| E | 渠道返点 | 是 | 数字,≥ 0;没有填 0 | 渠道返点 |
| F | 总计金额 | 是 | 数字,≥ 0;即应付上游的金额 | 总计(渠道统计金额) |
第二个工作表「填写说明」:上表每列的含义,加一条示例行(亨利-国内 / 8630011 / 16277.43 / 976.65 / 0 / 17254.07),导入时不读。结算期不在模板里,在弹窗选。
2.3.3 弹窗字段
| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|---|---|---|---|---|---|
| 结算期 | period | enum | 是 | 上线月起已结束的 UTC0 自然月,降序 | 上个月 | 当月不可选;非上个月黄字提醒(R-08-031) |
| 渠道账单模板 | — | 链接 | — | 「下载模板」 | — | R-08-032 |
| 渠道账单文件 | file | 文件 | 是 | 1 个 .xlsx | — | 大小上限沿用现有上传组件 |
| 备注 | remark | text | 否 | 多行 | 空 | 即发起备注(D-08-24) |
2.3.4 业务规则
- R-08-030 渠道账单 tab 右上「导入渠道账单」按钮只对有「导入渠道账单」权限点的用户显示;点开弹窗,标题「导入渠道账单」。
- R-08-031 弹窗字段依次:结算期(必选单选,选项 = 上线月起已结束的 UTC0 自然月、降序,默认上个月,当月不可选,D-08-28;所选不是上个月时结算期下方黄字「所选结算期不是上个月,请确认」,不拦,D-08-39);渠道账单模板(「下载模板」链接,下载「渠道账单导入模板.xlsx」),旁边说明文字「总计金额须为已冲抵渠道返点后、实际应付渠道的金额;渠道返点隔月单独打回的,按冲抵后的应付填总计」(D-08-40);渠道账单文件(必传,1 个 .xlsx,重新选择即替换,大小上限沿用现有上传组件);备注(选填、多行,即审批发起备注);按钮「取消」「提交审批」(原型的「保存」改为「提交审批」)。
- R-08-032 标准模板 .xlsx:第一个工作表「渠道账单」第 1 行为表头、第 2 行起为数据,列依次 账户系统、orgid、消耗金额、税费、渠道返点、总计金额,6 列都必填;第二个工作表「填写说明」写每列含义、一条示例行,以及「总计金额须为已冲抵渠道返点后、实际应付渠道的金额;渠道返点隔月单独打回的,按冲抵后的应付填总计」(D-08-40),导入时不读;结算期不在模板里,在弹窗里选(D-00-25);模板「消耗金额」入账为「小计」,「返点金额」列名改为「渠道返点」(D-08-12)。
- R-08-033 文件级校验,不通过不能提交,提示在对应字段下方:未选结算期「请选择结算期」;未传文件「请上传渠道账单文件」;不是 .xlsx「仅支持 .xlsx 文件,请下载模板填写」;第一个工作表表头和模板 6 列名称、顺序不一致(忽略首尾空格)「文件表头与模板不一致,请下载最新模板」;去掉全空行后没有数据行「文件里没有数据行」。
- R-08-034 逐行校验(单元格去首尾空格;orgid 接受数字或文本;行号 = Excel 原始行号),错误原因原文:①任一列为空「{列名}为空」;②金额列不是数字或小于 0「{列名}须为不小于 0 的数字」;③账户系统名称在系统里找不到「账户系统不存在」;④账户系统是系统抓取的「该账户系统由系统抓取渠道数据,不支持上传」;⑤orgid 在系统里找不到账户「orgid 在系统中不存在」;⑥orgid 对应账户不属于本行账户系统「orgid 不属于账户系统 {账户系统}」;⑦同一 orgid 在文件里出现多行,这些行都报「orgid 在文件中重复出现(第 a、b 行)」,该 orgid 一行都不入账(D-08-03);金额可以有任意位小数,通过校验后四舍五入到 2 位(D-00-13);不校验 消耗 + 税费 − 渠道返点 是否等于总计(D-00-26)。
- R-08-035 一行有多个错误时全部列出,用「;」隔开;没有错误的行为可入账行。
- R-08-036 在途冲突:文件里出现的有效账户系统(通过 R-08-034 ③④)只要有一个在所选结算期已有审批中的渠道对账单,整份不能提交,用提示框(「知道了」,不用自动消失的弱提示)提示「{账户系统} {结算期} 已有审批中的渠道账单导入(审批单号 {审批单号},申请人 {姓名}),请等审批结束或撤回后再导入」(句式按 12 R-12-047);审批单号可点、新页打开 12 的唯一审批详情地址(R-12-026),没有查看权限时按 R-12-043 显示「无权限查看」(D-08-19、D-08-38)。
- R-08-037 点「提交审批」后服务端解析并校验,期间按钮加载、弹窗不可关;文件级通过且无在途冲突时:没有错误行 → 确认框(标题「提示」,同 R-05-078)文案「导入渠道账单需进行审批,是否提交审批单?审批通过后,{账户系统列表} 在 {结算期} 的渠道数据将被本文件整批替换」,下方带「入账影响」表(R-08-026),按钮 取消 / 确定;有错误行 → 弹「校验结果」:标题行「共 N 行,可入账 A 行,错误 M 行」、按账户系统汇总表(账户系统、可入账行数、总计合计、当前生效总计,没有为「-」)、「入账影响」表(R-08-026)、错误清单表(原始行号、账户系统、orgid、错误原因,超过 10 行表内滚动)、「下载错误清单」、提示「错误行不会入账;错误行和文件里没有的 orgid,入账后渠道数据将清空(见入账影响)。审批通过后,{账户系统列表} 在 {结算期} 的渠道数据将被本文件整批替换」,按钮「返回修改」(回到导入弹窗、已选内容保留)「继续提交」(D-08-09);可入账 0 行时「继续提交」置灰并提示「没有可入账的行,请修改文件后重新上传」。
- R-08-038 确定 / 继续提交后,服务端再查一次 R-08-036,通过则提交「渠道对账中心—渠道对账」审批(R-12-001、R-12-014):不传操作对象客户(D-08-10);按 D-00-76 传本批可入账行涉及的账户(这类审批不提供动态选项,不影响审批人,D-08-41);业务单据 = 渠道导入批次(结算期、原文件、校验结果、可入账行、错误清单、按账户系统汇总及当时生效总计、入账影响);发起备注 = 备注;提交后的弱提示按 12 R-12-018(审批中「已提交审批」,免审即通过「提交成功,无需审批,已生效」),关闭弹窗;审批中时渠道数据不变;同一弹窗连续点击只提交一次。
- R-08-039 错误清单下载为 .xlsx:列 原始行号、账户系统、orgid、消耗金额、税费、渠道返点、总计金额(原样)、错误原因;入账错误清单(R-08-051)同格式。
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 验收标准
- G-08-006 前置:王敏打开「导入渠道账单」。操作:查看结算期选项、说明文字并下载模板;再把结算期改选 2026-08(本条上线月按 2026-07 配置)。期望:结算期默认 2026-09,选项不含 2026-10;模板旁说明文字「总计金额须为已冲抵渠道返点后、实际应付渠道的金额;渠道返点隔月单独打回的,按冲抵后的应付填总计」;模板第一个工作表「渠道账单」表头为 账户系统、orgid、消耗金额、税费、渠道返点、总计金额,第二个工作表「填写说明」有示例和同一句冲抵说明;弹窗按钮是「取消」「提交审批」;改选 2026-08 后结算期下方黄字「所选结算期不是上个月,请确认」,仍可提交。
- G-08-007 前置:结算期 2026-09,分别上传 .csv、表头把「渠道返点」写成「返点金额」的 xlsx、只有表头的 xlsx。操作:点「提交审批」。期望:依次提示「仅支持 .xlsx 文件,请下载模板填写」「文件表头与模板不一致,请下载最新模板」「文件里没有数据行」,不出校验结果、不创建审批单。
- G-08-008 前置:结算期 2026-09;文件 8 行数据:第 2 行 亨利-国内 8630011 17000/1020/0/18020;第 3 行 亨利-出海 8527002 1200.456/0/108/1092.456;第 4 行 苹果ASA(自接苹果) 5130021 …;第 5 行 亨利-国内 9999999 …;第 6、7 行 亨利-出海 8527003 两行;第 8 行 亨利-国内 8630012 税费 -12;第 9 行 亨利-出海 8630013 …。操作:点「提交审批」。期望:弹「校验结果」:共 8 行,可入账 2 行,错误 6 行;错误清单:第 4 行「该账户系统由系统抓取渠道数据,不支持上传」、第 5 行「orgid 在系统中不存在」、第 6、7 行「orgid 在文件中重复出现(第 6、7 行)」、第 8 行「税费须为不小于 0 的数字」、第 9 行「orgid 不属于账户系统 亨利-出海」;汇总表 亨利-国内 可入账 1 行 总计 18,020.00 当前生效 29,746.02,亨利-出海 可入账 1 行 总计 1,092.46 当前生效 17,526.76;「入账影响」表置顶标红 3 行将清空:亨利-国内 青柠-iOS-TW 8630012 5,811.04 → -、亨利-国内 木棉记账 8630013 6,680.91 → -、亨利-出海 Kredi Plus 8527001 17,526.76 → -;金额变化 1 行:青柠-iOS-CN 8630011 17,254.07 → 18,020.00;新增 1 行:OfferGo 8527002 - → 1,092.46;没有「其余 N 个账户不变」行;提示含「错误行和文件里没有的 orgid,入账后渠道数据将清空」及两个账户系统在 2026-09 将被整批替换;「下载错误清单」得到 6 行带原 6 列与错误原因的 xlsx。
- G-08-009 前置:G-08-008 的校验结果。操作:「返回修改」;再「提交审批」→「继续提交」。期望:返回后结算期、文件、备注都在;继续提交后弱提示「已提交审批」,已提交审批 tab 出现一张审批中的渠道对账单,账户系统列「亨利-国内、亨利-出海」;渠道账单金额不变。
- G-08-010 前置:G-08-009 的单还在审批中(申请人 王敏)。操作:王敏再导入一份含亨利-出海的 2026-09 文件;再导入一份只含亨利-出海、结算期 2026-08 的文件(上线月为 2026-07)。期望:前者弹提示框(「知道了」)「亨利-出海 2026-09 已有审批中的渠道账单导入(审批单号 {G-08-009 审批单号},申请人 王敏),请等审批结束或撤回后再导入」,审批单号可点开详情,不能提交;后者可以正常校验提交。
- G-08-011 前置:文件全部行都有错。操作:「提交审批」。期望:可入账 0 行,「继续提交」置灰,提示「没有可入账的行,请修改文件后重新上传」。
2.4 渠道付款
2.4.1 功能描述
结算期结束后,有付款权限的用户对第一层一行(账户系统 × 结算期)发起渠道付款,应付 = 该行总计;可换结算币种;走「渠道对账中心—渠道付款」审批,通过后交给 09 生成付款单。
2.4.2 核心字段(渠道付款单)
| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|---|---|---|---|---|---|
| 结算期 | period | string(7) | 是 | — | 本行 | 只读 |
| 账户系统 | account_system | 关联对象 | 是 | — | 本行 | 只读 |
| 小计 / 税费 / 渠道返点 / 总计 | subtotal / tax / channel_rebate / total | decimal(2) | 是(渠道返点否) | — | 本行 | 本行币种,提交时快照 |
| 应付金额 | payable | decimal(2) | 是 | = 总计 | 总计 | 本行币种,不可改(R-08-041) |
| 结算币种 | settle_currency | enum | 是 | 人民币 / USD / USDT | 本行币种 | R-08-042 |
| 汇率 | fx_rate | decimal(4) | 是 | 1 本行币种 = x 结算币种 | 同币种为 1 | 日汇率四舍五入 4 位,显示与计算一致(D-00-74);提交当天锁定(D-00-62) |
| 汇率日期 | fx_date | date | 是 | 实际取到汇率的那天(UTC0) | — | 汇率后括号显示、进快照(R-08-042) |
| 收款主体 | payee | string | 否 | 该渠道填过的值 / 手填新值 | 空 | R-08-047 |
| 共享订单数 | shared_order_count | int | 是 | ≥ 0 | — | R-08-041 |
| 换算后应付金额 | payable_settle | decimal(2) | 是 | = 应付 × 汇率,四舍五入 | — | 结算币种 |
| 缺数据账户数 | missing_count | int | 是 | ≥ 0 | — | R-08-043 |
| 账户明细快照 | account_snapshot | 列表 | 是 | 第二层全部账户 | — | R-08-046 |
| 备注 | remark | text | 否 | 多行 | 空 | 即发起备注 |
| 付款单 | payment_order_id | 关联对象 | 否 | 09 付款单 | — | 通过后生成(R-08-053) |
渠道付款单不单独设状态:审批阶段看 12 审批单状态,通过后看 09 付款单状态。
2.4.3 业务规则
- R-08-040 「渠道付款」同时满足才显示:有「渠道付款」权限点;结算期已结束(今天 UTC0 ≥ 结算期次月 1 日);第一层总计不是「-」且 > 0(总计 0.00 的行按 R-08-056 视为已完成;总计 < 0 不能发起,线下处理,D-00-80、D-08-34);状态待完成;没有在途渠道付款单(审批中,或审批已通过但 09 付款单还不是「已完成」,即待汇出 / 待完成)(D-08-07)。
- R-08-041 渠道付款弹窗:标题「渠道付款」;只读 结算期、账户系统、小计、税费、渠道返点、总计(本行币种)、应付金额(= 总计,不可改,D-08-07);本行有共享订单(同一订单号挂在本行多个账户下)时,应付金额下方灰字「本行有 K 个共享订单,在各账户下全额重复列示;应付按订单号去重 = {总计} {币种}」,没有共享订单不显示(D-08-42);收款主体(选填,R-08-047);下方带本行第二层只读明细(账户名称、orgid、小计、税费、渠道返点、总计);原型的「充值金额」不做(D-08-06)。
- R-08-042 结算币种:必选单选 人民币 / USD / USDT,默认本行币种;与本行币种相同时不显示汇率;不同时显示「汇率:1 {本行币种} = x {结算币种}(yyyy-mm-dd)」与「换算后应付金额:{应付 × 汇率,四舍五入 2 位} {结算币种}」;汇率取当天(UTC0)的日汇率,当天没有向前取最近一天,括号里的日期 = 实际取到的那天;x = 日汇率四舍五入到 4 位,显示与计算都用这 4 位(D-00-74、D-08-37);提交时按提交当天重取并锁定(D-00-62),与弹窗展示不同时按 R-08-045 ② 确认;汇率与汇率日期随单进快照;取不到任何汇率时不能提交,提示「未取到 {本行币种}→{结算币种} 汇率,请稍后再试」;换算后应付为 0.00 时不能提交,提示「换算后应付金额为 0.00,请改用 {本行币种} 结算」(D-08-47)。
- R-08-043 本行有消耗、但渠道统计金额为「-」的账户数 N > 0 时,弹窗顶部黄色提示「本结算期有 N 个有消耗的账户还没有渠道统计金额,应付金额不含这些账户」,明细表里这些账户金额显示「-」;不拦提交(D-08-13)。
- R-08-044 备注:多行、选填,即审批发起备注;点「提交审批」校验结算币种与汇率,通过后二次确认(标题「提示」,同 R-05-078)「渠道付款需进行审批,是否提交审批单?」(取消 / 确定)。
- R-08-045 确定后服务端复核:权限点、R-08-040 全部条件、本行第一层与第二层金额与弹窗展示一致、汇率;不通过时不创建审批单、弹窗不关(D-08-36):①金额在弹窗打开期间变了 → 按最新数据就地重载,保留结算币种、收款主体、备注;值变了的金额(第一层与账户明细)标黄「系统计算值已由 X 变为 Y」,新出现或消失的账户行同样标黄;顶部提示「数据已更新,请核对后重新提交」,用户再点一次「提交审批」才建单;重载后总计不再 > 0 时「提交审批」置灰并提示「本行总计不大于 0,不能发起渠道付款」;②只有汇率变了(跨零点或当天汇率更新)→ 弹确认「汇率已更新为 1 {本行币种} = x {结算币种}(yyyy-mm-dd),换算后金额 Y {结算币种},是否按新汇率提交?」,确定后按新汇率建单,取消则回到弹窗、汇率与换算后金额显示新值;③已有在途渠道付款单 → 提示框(「知道了」):审批中写「该结算期已有审批中的渠道付款(审批单号 {审批单号},申请人 {姓名}),请等审批结束或撤回后再操作」,已通过、付款单未完成写「该结算期已有处理中的渠道付款(付款单 {财务ID},{待汇出 / 待完成}),待付款完成后再操作」,单号可点(无权限按 R-12-043),关闭后弹窗关闭、刷新列表(句式按 12 R-12-047,D-08-38);④按复核时的应付与汇率换算后应付为 0.00 → 同 R-08-042 拦截,提示「换算后应付金额为 0.00,请改用 {本行币种} 结算」(D-08-47);同一弹窗连续点击只提交一次,请求中按钮加载。
- R-08-046 复核通过后提交「渠道对账中心—渠道付款」审批(R-12-001、R-12-014):不传操作对象客户(D-08-10);按 D-00-76 传本行第二层账户(这类审批不提供动态选项,不影响审批人,D-08-41);业务单据 = 渠道付款单(弹窗全部内容 + 汇率与汇率日期 + 换算后应付金额 + 收款主体 + 第二层全部账户金额快照 + 缺数据账户数 + 共享订单数);发起备注 = 备注;提交后的弱提示按 12 R-12-018(同 R-08-038),关闭弹窗;审批中时操作列变「付款中」,免审即通过时按 R-08-053 处理。
- R-08-047 收款主体:渠道一方收钱的主体名称,选填,下拉可搜索;选项 = 该账户系统(渠道)填过的值,上线时每个渠道预置一项「渠道名称」(存量由技术迁移);可手填新值,提交审批成功后新值自动追加到该渠道的选项里,不另设维护页面;写入审批快照(R-08-046),随付款单给 09 显示(R-09-012);渠道收款账号本期不展示(D-08-31)。
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 验收标准
- G-08-015 前置:公共前置,2026-10 亨利-国内已有消耗、未上传。操作:查看 2026-10 该行与 2026-09 三行;赵磊登录。期望:2026-10 行「未上传」、总计「-」、没有「渠道付款」;2026-09 三行都有「渠道付款」;赵磊看不到「渠道付款」「导入渠道账单」。
- G-08-016 前置:公共前置。操作:王敏点亨利-出海 2026-09 行的「渠道付款」,结算币种改选人民币。期望:弹窗应付金额 17,526.76 USD 不可改,没有「充值金额」,没有共享订单说明;收款主体默认空,下拉里有「亨利-出海」;顶部黄条「本结算期有 2 个有消耗的账户还没有渠道统计金额,应付金额不含这些账户」;明细里 OfferGo、Moma Live 为「-」;结算币种默认 USD 时不显示汇率,改人民币后显示「汇率:1 USD = 7.1234 人民币(2026-10-20)」「换算后应付金额:124,850.12 人民币」。
- G-08-017 前置:G-08-016 弹窗已打开,收款主体选了「亨利-出海」;同时另一张亨利-出海 2026-09 的渠道对账单审批通过,8527001 总计变为 17,400.00。操作:王敏点「提交审批」→「确定」。期望:不创建审批单,弹窗不关;按最新数据重载:总计、应付标黄「系统计算值已由 17,526.76 变为 17,400.00」,账户明细 8527001 同样标黄;结算币种人民币、收款主体「亨利-出海」、备注保留;顶部提示「数据已更新,请核对后重新提交」;再点一次「提交审批」→「确定」才创建审批单,快照为 17,400.00 USD。
- G-08-018 前置:G-08-016 弹窗,数据未变,收款主体选「亨利-出海」。操作:提交审批 → 确定(连续点两次)。期望:二次确认框标题「提示」;只生成一张「渠道付款」审批单,快照里收款主体 亨利-出海、汇率 7.1234(2026-10-20);弱提示「已提交审批」;该行操作列变灰字「付款中」,与「变化记录」并列;已提交审批 tab 出现该单。
- G-08-019 前置:结算币种选 USDT,日汇率表没有任何 USD→USDT 汇率。操作:提交审批。期望:提示「未取到 USD→USDT 汇率,请稍后再试」,不能提交。
- G-08-029 前置:公共前置;王敏打开苹果ASA(自接苹果)2026-09 行的「渠道付款」。操作:查看弹窗;提交并打开审批详情。期望:应付金额 24,000.00 USD 下方灰字「本行有 1 个共享订单,在各账户下全额重复列示;应付按订单号去重 = 24,000.00 USD」;账户明细 20,000.00 + 12,000.00;审批内容区同样显示这句说明;亨利-出海行的弹窗不显示该说明。
- G-08-033 前置:G-08-016 的弹窗在 2026-10-20 23:58(UTC)打开,显示 7.1234(2026-10-20);2026-10-21 日汇率为 1 USD = 7.1301 人民币。操作:2026-10-21 00:20(UTC)点「提交审批」→「确定」;在汇率确认框点「确定」。期望:先不建单,弹确认「汇率已更新为 1 USD = 7.1301 人民币(2026-10-21),换算后金额 124,967.55 人民币,是否按新汇率提交?」;确定后建单,快照汇率 7.1301、汇率日期 2026-10-21、换算后应付 124,967.55 人民币;若点取消则回到弹窗,显示新汇率与 124,967.55。
- G-08-034 前置:王敏、周琳同时打开亨利-出海 2026-09 的「渠道付款」弹窗。操作:周琳先提交成功(审批中);王敏随后点「提交审批」→「确定」。期望:王敏看到提示框(「知道了」)「该结算期已有审批中的渠道付款(审批单号 {周琳的审批单号},申请人 周琳),请等审批结束或撤回后再操作」,审批单号可点;不创建审批单;点「知道了」后弹窗关闭、列表刷新为「付款中」。
- G-08-037 前置:公共前置。操作:王敏发起亨利-出海 2026-09 渠道付款,收款主体手填「Henry Overseas Ltd」并提交成功;该单被驳回后再次打开「渠道付款」。期望:第二次打开时收款主体下拉有「亨利-出海」「Henry Overseas Ltd」两项;该审批详情与 09 付款单(如通过)显示收款主体 Henry Overseas Ltd;页面没有收款账号字段。
2.5 审批结果处理
2.5.1 功能描述
两种审批结束后,本页怎么处理业务单据(12 只通知结果,R-12-025)。
2.5.2 业务规则
- R-08-050 两种审批流 0 节点或全部节点被跳过时提交即通过(R-12-018),立即按 R-08-051 / R-08-053 处理;渠道两类审批没有操作对象客户,12 审批配置不给这两类提供「绑定的销售 / 绑定的运营」动态选项(R-12-010,D-08-41),节点只能配指定用户。
- R-08-051 「渠道对账」审批通过:可入账行按 R-08-034 ③~⑥ 用当时数据再校验一次(①②⑦只看文件本身,结果不变),不通过的跳过、记入入账错误清单(原始行号 + 原因);其余行按 R-08-021 入账替换并写渠道统计金额、记变化日志(R-08-023)、通知下游(R-08-024);批次变「已入账」,记录入账行数、跳过行数(D-08-09);跳过行不算业务执行失败,全部跳过也照常「已入账」(入账 0 行,R-08-057)。审批结果通知申请人沿用 12(R-12-038)。
- R-08-052 「渠道对账」审批驳回、撤回或作废(作废效果同撤回,R-12-046,D-00-79③):批次变「已驳回 / 已撤回」,不入账,渠道数据不变;原单不能修改重提(R-12-034),要导入就重新上传。
- R-08-053 「渠道付款」审批通过(含免审即通过):生成一张 09 付款单,带 交易类型「渠道付款」、应付金额 = 换算后应付金额(同币种即应付金额;换算后为 0.00 的不能提交,所以 > 0,R-08-042、R-08-045)、币种 = 结算币种、关联审批单号、账户系统、结算期、收款主体(没填为空)、申请人、备注;本行保持待完成,操作列「付款中」;09 确认汇款(付款单 待汇出 → 待完成)不回写本页,本行仍是待完成、「付款中」(R-09-042、R-09-072)。
- R-08-054 该付款单在 09 变为已完成(确认到账才算完成,D-00-33;回写见 R-09-071)时:本行变「已完成」,记完成时间,已付总计快照 = 该渠道付款单的总计(本行币种);同时保留该单第二层每个账户的已付快照值(R-08-046 快照里该账户的总计,「-」的账户为空),供 10 详情展示(R-08-091)。
- R-08-055 「渠道付款」审批驳回、撤回或作废(作废效果同撤回,R-12-046,D-00-79③):本行保持待完成,「渠道付款」重新出现;原单不能修改重提。
- R-08-056 第一层总计为 0.00 的行(有值,不是「-」):结算期结束后、没有在途且没有已完成的渠道付款时视为已完成(无需付款),状态「已完成」、旁边灰字「无需付款」,不显示「渠道付款」,10 判该行账户渠道付完(R-08-091);之后总计变为不是 0.00、且该行从没有已完成的渠道付款时回到待完成,按 R-08-040 处理(10 按 D-00-66 退回重算)(D-08-44)。第一层总计 < 0 的行不能发起渠道付款,保持待完成、线下处理(已知限制)(D-00-80,D-08-34)。
- R-08-057 两种审批最后一个审批人通过时,本页不设业务执行失败情形(R-12-045,D-00-79①):渠道对账通过时再校验不通过的行跳过、其余照常入账(R-08-051);渠道付款通过时照常生成付款单(R-08-053);所以通过不会被业务回滚。持「审批配置」权限点的人可作废审批中的两类单,效果同撤回(R-12-046;本页按 R-08-052、R-08-055 处理,D-00-79③)。
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 验收标准
- G-08-012 前置:G-08-009 的渠道对账单。操作:审批通过。期望:亨利-国内 2026-09:8630011 总计 18,020.00,8630012、8630013 变「-」,第一层总计 18,020.00 人民币,数据来源显示新审批单号,SP-0901 的亨利-国内分段为「已被替换」;亨利-出海 2026-09:8527002 总计 1,092.46(1092.456 四舍五入),8527001 变「-」,第一层总计 1,092.46 USD;结果与提交时的「入账影响」一致;入账结果没有「因跳过而清空」行;每个变化的账户记一条变化日志,来源「渠道对账 {审批单号}」;06 对应账单的渠道统计金额同步更新。
- G-08-013 前置:某渠道对账单提交时 亨利-国内 8630012 一行可入账;审批期间该账户被技术造数改到账户系统 亨利-出海。操作:审批通过。期望:该行跳过不入账,审批详情显示「入账结果:入账 N−1 行,跳过 1 行」和「因跳过而清空:青柠-iOS-TW(8630012)」,入账错误清单该行「orgid 不属于账户系统 亨利-国内」;其余行正常入账;审批单照常变已通过(跳过不算执行失败)。
- G-08-014 前置:三张渠道对账单审批中。操作:审批人驳回第一张;王敏在已提交审批 tab 撤回第二张;持「审批配置」权限点的管理员作废第三张。期望:三张批次都不入账,渠道账单金额不变;第三张状态与撤回相同;可以再导入同账户系统同结算期的文件。
- G-08-020 前置:G-08-018 的渠道付款单。操作:审批通过;之后 09 对该付款单确认汇款;再确认到账。期望:通过时 09 生成付款单(待汇出):交易类型 渠道付款、应付金额 124,850.12、币种 人民币、关联审批单号、账户系统 亨利-出海、结算期 2026-09、收款主体 亨利-出海;行仍待完成、「付款中」;确认汇款后付款单变待完成,本行仍待完成、「付款中」,10 判断 Kredi Plus 2026-09 仍未渠道付完;确认到账、付款单变已完成后行变「已完成」、操作列只剩「变化记录」,给 10 的账户级已付快照 Kredi Plus 17,526.76 USD、OfferGo / Moma Live 为空;10 判断 Kredi Plus 2026-09 渠道付完、OfferGo 与 Moma Live 未付完(没有渠道统计金额)。
- G-08-021 前置:G-08-018 的单。操作:审批人驳回。期望:行保持待完成,「渠道付款」重新出现,可再发起。
- G-08-022 前置:G-08-020 后(亨利-出海 2026-09 已完成,已付总计 17,526.76 USD)。操作:再导入亨利-出海 2026-09 修正文件:8527001 总计 17,400.00、8527002 总计 1,092.46,审批通过;点「变化记录」。期望:行状态仍是已完成;状态旁出现橙色「金额有变化」,悬浮「已付 17,526.76 USD,现总计 18,492.46 USD,差额 965.70 USD」;「变化记录」弹窗按时间倒序依次:8527001 17,526.76 → 17,400.00、8527002 - → 1,092.46(来源都是该审批单号)、「付款完成 · {FK 财务ID}」、「付款提交 · {G-08-018 审批单号} · 快照总计 17,526.76 USD」、8527001 - → 17,526.76(来源 渠道对账 SP-0902);不生成新的付款单;没有「渠道付款」按钮;10 判 Kredi Plus、OfferGo 2026-09 都是渠道付完。
- G-08-027 前置:「渠道付款」审批流配置为 0 个节点(审批配置里这一类的节点下拉没有「绑定的销售」「绑定的运营」)。操作:王敏提交渠道付款。期望:审批单提交即为已通过,弱提示「提交成功,无需审批,已生效」;立即生成 09 付款单,该行操作列「付款中」;已提交审批 tab 里该单状态「已通过」。
- G-08-030 前置:在公共前置上另有上传类账户系统「亨利-测试」(USD),账户 8540001 2026-09 有消耗,已入账批次里该 orgid 总计 0.00;另由技术造数使苹果ASA 2026-08(上线月设为 2026-08)第一层总计为 -50.00 USD。操作:2026-10-20 查看两行;之后再导入亨利-测试 2026-09 修正文件 8540001 总计 100.00 并审批通过。期望:亨利-测试 2026-09 状态「已完成」、旁边灰字「无需付款」,没有「渠道付款」,10 判 8540001 2026-09 渠道付完;苹果ASA 2026-08 保持待完成、没有「渠道付款」;修正文件入账后亨利-测试 2026-09 回到待完成、出现「渠道付款」,10 把 8540001 2026-09 退回重算。
- G-08-035 前置:公共前置上苹果ASA 另有账户 橙子-iOS-TW(5130077),2026-09 消耗 300.00 USD、没有任何订单。操作:苹果ASA 2026-09 渠道付款完成,行变已完成;之后补到一张 5130077 的 2026-09 订单 PR-0904 总计 280.00 USD。期望:完成前 10 判 5130077 2026-09 渠道未付完;行已完成后第二层 5130077 仍显示「-」,10 判渠道付完、渠道成本按 0 计;PR-0904 到了以后 5130077 总计 280.00,记一条「订单数据更新」日志,行仍已完成并出现「金额有变化」,10 把 5130077 2026-09 退回重算、扣 280.00 后仍判渠道付完。
2.6 已提交审批
2.6.1 功能描述
列当前用户在本页提交的两种审批单,可看详情、撤回。
2.6.2 业务规则
- R-08-060 已提交审批只展示当前登录账号提交的「渠道对账」「渠道付款」审批单(含免审即通过的单,状态「已通过」);搜索框按审批单号包含匹配;筛选 审批类型 全部 / 渠道对账 / 渠道付款、审批状态 全部 / 审批中 / 已通过 / 已驳回 / 已撤回,默认都是全部。
- R-08-061 列依次:审批单号、审批类型、结算期、账户系统(渠道对账含多个时用「、」连接,过长省略、悬浮显示全部)、申请人、申请时间(yyyy-mm-dd hh:mm:ss,Asia/Shanghai)、审批状态、操作;原型的「操作对象」列改为「审批类型」;审批中置顶,其余按申请时间降序;分页 10 / 50 / 100 / 300,默认 10;没有数据显示「暂无数据」。
- R-08-062 行操作:所有状态都有「详情」,新页打开 12 的唯一审批详情地址(R-12-026);只有审批中有「撤回」,只校验申请人本人与审批中、不校验「导入渠道账单」「渠道付款」权限点(D-00-79②),确认文案、后果与通知按 12(R-12-032~R-12-035),撤回后按 R-08-052 / R-08-055 处理;被持「审批配置」权限点的人作废的,本页回调同撤回(R-12-046)。
2.6.3 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 没提交过 | — | — | 「暂无数据」 |
| 撤回时单子刚被审完 | 并发 | 按 12 处理,撤回失败 | 12 的提示,刷新后状态为最新 |
2.6.4 验收标准
- G-08-023 前置:王敏提交过 1 张渠道对账(审批中)、1 张渠道付款(已通过);赵磊提交过 1 张渠道付款。操作:王敏打开已提交审批,再筛审批类型「渠道付款」。期望:未筛时只有自己的 2 张,审批中在最上;列为 审批单号、审批类型、结算期、账户系统、申请人、申请时间、审批状态、操作;筛选后剩 1 张;审批中那张有「详情」「撤回」,已通过的只有「详情」。
2.7 审批内容区
2.7.1 功能描述
两种审批详情的「审批内容」区(审批信息、审批流、按钮由 12 通用框架提供,D-00-46)。
2.7.2 业务规则
- R-08-070 两种审批详情都用 12 的通用框架(R-12-026~R-12-031,D-00-44);标题「渠道对账中心/审批详情」(原型误写「返点管理/审批详情」);不启用变更高亮(R-12-030 的提交时基准高亮本页不用);审批内容一律展示提交时的快照,不随渠道数据变化;「渠道付款」审批在审批中、且该行当前第一层总计 ≠ 快照总计时,内容区顶部黄色提示「提交后本行总计已变为 {当前总计} {币种},差额 {当前 − 快照} {币种};本单按提交时金额付款」(当前总计为「-」时写「提交后本行总计已变为 -;本单按提交时金额付款」),审批结束后不显示(D-08-43)。
- R-08-071 「渠道对账」审批内容:结算期;渠道账单文件(文件名,点击下载原文件);校验结果「共 N 行,可入账 A 行,错误 M 行」,M > 0 时带「下载错误清单」;按账户系统汇总表(账户系统、可入账行数、小计、税费、渠道返点、总计、提交时当前生效总计,没有为「-」);「入账影响」表(R-08-026,提交时快照);可入账明细表(账户系统、账户名称、orgid、小计、税费、渠道返点、总计);备注;审批通过后另显示「入账结果:入账 X 行,跳过 Y 行」,Y > 0 时带「下载入账错误清单」,跳过行使账户变为「-」时另起一行「因跳过而清空:{账户名称}({orgid})」(多个用「、」连接)(D-08-33)。
- R-08-072 「渠道付款」审批内容:结算期、账户系统、小计、税费、渠道返点、总计、应付金额(本行币种)、共享订单说明(同 R-08-041,没有不显示)、结算币种、汇率(含汇率日期)与换算后应付金额(同币种不显示)、收款主体(没填显示「-」)、缺数据提示(N = 0 不显示)、账户明细表、备注;审批中总计变化提示见 R-08-070;审批通过后另显示「付款单:{财务ID} · {付款单状态}」(由 09 提供,待汇出 / 待完成 / 已完成,D-00-33);原型的「充值金额」不做(D-08-06)。
2.7.3 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 提交后渠道数据又变了 | — | 内容区仍是快照(R-08-070) | 金额不变;渠道付款审批中顶部黄色提示差额 |
| 原文件下载失败 | — | 沿用现有文件下载的失败提示 | — |
| 无查看权限 | — | R-08-082 | 「无权限查看」 |
2.7.4 验收标准
- G-08-024 前置:G-08-009 的渠道对账单。操作:审批人打开审批详情;通过后再打开。期望:标题「渠道对账中心/审批详情」;内容有 结算期 2026-09、文件名(可下载)、「共 8 行,可入账 2 行,错误 6 行」+ 下载错误清单、按账户系统汇总表(含当前生效总计 29,746.02 人民币 / 17,526.76 USD)、「入账影响」表(同 G-08-008:将清空 3 行置顶标红、金额变化 1 行、新增 1 行)、可入账明细 2 行、备注;没有标红高亮;通过后多出「入账结果:入账 2 行,跳过 0 行」,不显示下载入账错误清单。
- G-08-025 前置:G-08-018 的渠道付款单已通过。操作:打开审批详情。期望:内容有 结算期、账户系统 亨利-出海、小计 20,145.70、税费 0.00、渠道返点 2,618.94、总计 17,526.76、应付金额 17,526.76 USD、结算币种 人民币、汇率 1 USD = 7.1234 人民币(2026-10-20)、换算后应付金额 124,850.12 人民币、收款主体 亨利-出海、缺数据提示(2 个账户)、账户明细 3 行、备注、「付款单:{财务ID} · 待汇出」;没有「充值金额」、没有共享订单说明;之后渠道数据再变,详情里的金额不变、也不出现总计变化提示(审批已结束)。
- G-08-036 前置:G-08-018 的渠道付款单审批中;之后 G-08-022 的修正文件先审批通过,本行总计变为 18,492.46 USD。操作:审批人打开该渠道付款审批详情;审批通过后再打开。期望:审批中时内容区顶部黄色提示「提交后本行总计已变为 18,492.46 USD,差额 965.70 USD;本单按提交时金额付款」,内容仍是 17,526.76 USD 的快照;通过后再打开不显示该提示。
2.8 权限
2.8.1 业务规则
- R-08-080 新增 3 个权限点(D-00-45、D-08-11;全部财务权限点清单以 13 为准,D-00-78):「渠道对账中心」(进入页面、查看全部数据、只读查看两种审批详情)、「导入渠道账单」、「渠道付款」;后两个依赖「渠道对账中心」查看点,需同时有才看得到入口、才能操作(D-13-01),服务端同样校验;没有「渠道对账中心」时左侧菜单不显示,直接访问页面地址时在主布局内容区显示「无权限访问」、保留当前地址(R-13-005);权限 / 菜单加载失败时按 R-13-006 显示「加载失败,请刷新」,不跳登录页;没有对应权限点时按钮不显示。
- R-08-081 数据范围:有「渠道对账中心」即看全部账户系统、全部账户,不按账户数据权限过滤(D-08-11)。
- R-08-082 12 审批详情第②类只读查看(R-12-043、R-12-044):渠道对账审批单 = 有「渠道对账中心」权限点的人可只读查看;渠道付款审批单 = 有「渠道对账中心」或「收付款中心」权限点的人可只读查看(「收付款中心」只给审批详情只读查看资格,不给本页访问权,不显示通过 / 驳回 / 撤回,D-00-71、R-13-050);本页对「能否查看」判断按此返回。
2.8.2 验收标准
- G-08-026 前置:赵磊只有「渠道对账中心」;孙婷三个都没有。操作:赵磊打开页面与 G-08-025 的详情链接;孙婷直接访问页面地址与同一链接。期望:赵磊看到全部三个账户系统,没有导入、付款按钮;详情只读、没有通过 / 驳回 / 撤回;孙婷菜单没有渠道对账中心,页面内容区「无权限访问」、地址栏仍是渠道对账中心地址,详情「无权限查看」;直接调接口导入或付款被服务端拒绝。
- G-08-028 前置:钱芳只有「收付款中心」权限点,没有本页三个权限点,也不是申请人或审批流人员。操作:打开 G-08-025 的渠道付款审批详情链接、G-08-024 的渠道对账审批详情链接,再直接访问渠道对账中心地址。期望:渠道付款详情可只读打开、没有通过 / 驳回 / 撤回;渠道对账详情「无权限查看」;页面「无权限访问」(R-08-082)。
2.9 对外接口
- R-08-090 给 06:按「账户 × 结算期」提供上传来源的渠道统计金额(R-08-018 的总计);系统抓取(自接苹果)06 自己读订单数据(R-06-014、R-06-015),与本页 R-08-017 是同一份数据、同一口径;本页为「-」时 06 显示「-」。
- R-08-091 给 10:渠道统计金额 = 账户 × 结算期的总计(R-08-015);同一订单挂多个账户时本页与 06 都展示全额,10 按 R-10-006 拆分;「渠道付完」(D-00-65 ③)= 该账户该结算期渠道统计金额不是「-」,且该账户所属账户系统该结算期的第一层行状态为已完成(含按 R-08-056 视为已完成的 0.00 行)(D-08-23);付款后才有值或金额变化的账户同样算付完,差额由「金额有变化」提示(R-08-025)、线下处理(D-08-08);系统抓取的账户系统:所属行已完成后,本结算期有消耗但没有任何订单的账户视为渠道付完,本页照常显示「-」,10 按 0 计;之后订单到了按 R-08-024 通知、10 退回重算(D-08-35);向 10 提供账户级已付快照值(R-08-054:完成那张渠道付款单快照里该账户的总计,没有则为空),10 详情在「金额有变化」时据此展示「已付快照」;口径与 index D-00-65 ③、D-00-80 一致;渠道统计金额变化按 R-08-024 通知,触发 D-00-66 退回重算。
- R-08-092 给 09:渠道付款审批通过时按 R-08-053 生成付款单(含收款主体);09 需回写 付款单号、付款单状态(待汇出 / 待完成 / 已完成)与完成时间(R-09-071);本页向 09 提供该行当前第一层总计,供确认汇款弹窗比对快照总计并提示(R-09-040,D-09-22);只有「已完成」(确认到账,D-00-33)时本页按 R-08-054 变更行状态,确认汇款后的待完成不变(R-08-053);付款单本期不作废 / 退回,sys 兜底撤回也不含渠道付款单(D-00-69)。
验收见 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-66 | 10 |
| 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-012 | 09 |
4 非功能与埋点
- 单个导入文件的行数上限、解析校验耗时由技术评估(无依据,不设数字)。
- 三个权限点与审批详情查看都在服务端校验。
- 批次原文件、校验结果、入账结果永久留存;被替换的分段保留可追溯;渠道统计金额每次变化记日志(R-08-023)。
- 埋点:本期不加。
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 回写):
- 导入选错结算期不能清回「未上传」,等正确文件到了整批替换(§2.2.4,D-08-39)。
- 第一层总计 < 0 的行不能发起渠道付款,线下处理(R-08-056,D-08-34)。
- 渠道返点隔月单独打回的,本期系统不记,只按冲抵后的应付填总计(D-08-40)。
- 付款后金额变化(含付款后补导入的账户)只提示「金额有变化」,差额线下处理(R-08-025,D-08-08)。
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 样表观察(只参考格式)
- 亨利(国内):人民币,列 产品名称、账户ID、投放消耗、税费、渠道返点金额(原表另一叫法,见术语表)、结算金额。
- 亨利(出海):USD,没有税费列;同一产品拆成新客期 / 非新客期两行、续行没有账户 ID —— 按 D-08-03 这种文件要先合并成一行再导入。
- wanka:USD,结算金额 = 消耗 ×(1 − 优惠比例),没有税费列。