财务费用入池 P0 闭环

1. P0 目标

P0 只解决“真实业务费用如何可靠进入应收应付费用池”。费用进入 Finance 后生成对账单、结算单、收付款及核销，继续沿用 Finance 自己的流程。

统一链路如下：

业务事实（头程 / 柜子 / 海外仓 / 尾程）
  -> 业务服务生成版本化费用来源
  -> 审核通过并发布完整不可变快照
  -> Finance 按 sourceSystem + sourceType + sourceFeeId + sourceVersion 幂等入池
  -> AVAILABLE 应收进入客户对账候选
  -> AVAILABLE 应付进入供应商结算候选
  -> Finance 生成对账单 / 结算单并完成后续财务流程

2. 统一费用来源字段

每笔费用必须保存以下口径：

维度	必填内容
业务归属	客户、来源类型、来源费用号和版本、业务类型、业务单号；有订单、入仓码、柜子或海外仓时保存真实引用
收付方向	`RECEIVABLE` 应收客户或 `PAYABLE` 应付供应商
费用内容	费用项目编码、名称、业务发生日
计费依据	数量、单位、单价；仓租等周期费用同时保存开始和结束日期
金额	原币、原币金额、结算币 CNY、月度汇率和汇率月份
应付结算	供应商、供应商分类、`ON_ACCOUNT` 或 `DIRECT_PAID`；直接支付必须保存支付时间、方式、流水号和凭证
生命周期	草稿、待审核、审核通过、驳回、发布、调整新版本、作废及操作幂等键

USD 费用必须命中业务日期所在月份的有效 USD/CNY 汇率。入池金额统一为 CNY，同时保留原币、原币金额和汇率，保证页面、导出和审计可以还原。

3. 来源覆盖矩阵

大类	实际费用	归属与入池规则
头程	单票运费、操作费及其他入仓费用	按真实入仓单和入仓码发布；应收、应付分别形成独立来源
柜子	海运、港杂、拖车、吊柜、维修等单一客户费用	按真实柜和客户发布
柜子	跨客户公共柜费	先按柜内真实订单归属原子分组和守恒分摊，再逐客户发布；审核、调整、驳回和作废整组处理
海外仓	海外入仓、仓租、入库/出库操作、托盘费	按客户和海外仓发布；能关联尾程订单或入仓码时必须带真实引用；仓租保存计费周期
尾程	派送、装车、预约、转仓	按真实派送单或尾程订单发布
增值服务	换标、换箱、异常处理	按真实换标单或尾程订单发布；自动完结的换标费用自动审核发布
海外采购	采购服务费	采购费用形成统一来源，并与资金账户结算记录关联

4. 分摊与供应商结算

分摊回答“这笔公共成本由哪些客户承担、每个客户分多少”，供应商结算回答“平台应向哪个供应商支付多少”。两者分别保存，不能用客户分摊行替代供应商应付。

公共柜费的客户分摊金额必须守恒：所有客户分摊之和等于柜费总额。若同一柜费还需要支付供应商，应另有一笔带供应商的 PAYABLE 来源；分摊规则不会自动改变供应商应付金额。

5. 入池状态与防重复结算

来源状态	Finance 处理
审核通过、发布、赊账	`AVAILABLE`，进入应收或应付待结算池
`DIRECT_PAID` 应付	保留为已确认成本，不进入应付待结算池
已由资金账户结算的应收	关联 `walletHoldId` 并标记 `SETTLED`，不再进入客户对账候选
已进入有效账单或结算单	冻结来源版本，禁止覆盖和作废
调整	新版本替换旧版本；Finance 仍按来源费用号和版本幂等消费
作废	仅未冻结来源允许作废；已结算或已出单来源必须走财务调整流程

客户应收应付默认按 sourceSystem + sourceType + sourceFeeId 展示同一费用的最新版本，计数、分页和金额均采用该口径；明确筛选“已被调整替代”时才单独查询旧版本。同名费用项目但来源费用号不同的记录不得合并。业务调整重新审核发布后更新该费用的当前展示，旧快照保留用于账单追溯，不能覆盖已出单或已结清事实。费用详情的操作记录串联同客户、同收付方向的历次版本及财务审计，记录版本、调整前后金额；同步记录明确显示系统同步时间，不冒充原业务操作者或审批时间。历史版本详情只展示当时及此前记录。

资金账户事件和费用来源事件可能先后到达。Finance 会在任一事件到达时尝试按客户、业务类型、业务单号和金额互相绑定，保证同一业务不会既自动扣款又再次生成对账单。

6. P0 验收标准

CNY、USD 应收和应付均能生成来源并进入 Finance，USD 能还原原币和月度汇率。
单票费、柜级单客费、跨客户公共柜费、海外仓周期费、尾程派送费、换标费、换箱费和采购费均有唯一业务归属。
相同幂等键和相同请求只产生一笔结果；相同幂等键不同请求被拒绝。
调整生成新版本，作废和审核遵守来源冻结规则。
AVAILABLE 才进入待生成对账单或结算单范围；DIRECT_PAID 和 SETTLED 不得重复进入。
业务费用详情、Finance 费用池、导出均能看到相同的原币、结算金额和计费依据。

5.4 KiB Raw Permalink Blame History