# 财务费用入池 P0 闭环

## 1. P0 目标

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

统一链路如下：

```text
业务事实（头程 / 柜子 / 海外仓 / 尾程）
  -> 业务服务生成版本化费用来源
  -> 审核通过并发布完整不可变快照
  -> 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 仍按来源费用号和版本幂等消费 |
| 作废 | 仅未冻结来源允许作废；已结算或已出单来源必须走财务调整流程 |

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

## 6. P0 验收标准

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