# 虫虫出海二期头程计费模块规划

> 创建日期：2026-07-28  
> 更新日期：2026-07-31  
> 状态：产品已确认范围，计费规则细节确认中  
> 历史文件名保留：`二期计费财务模块规划.md`  
> 关联规划：[二期开发规划](二期开发规划.md)  
> 产品确认记录：[2026-07-31 二期产品确认合并记录](产品回传/2026-07-31-产品确认合并记录.md)

## 一、产品确认的范围结论

二期只做头程业务的费用计算，不建设后续财务闭环。计费结果是头程订单的业务费用明细，不自动形成应收、应付、账单、付款、核销、发票或利润数据。

```text
头程订单 / 到仓实测 / 业务事件
                ↓
费用项目与计费规则匹配
                ↓
费用试算与计算过程快照
                ↓
人工补录 / 调整 / 审核
                ↓
头程费用明细确认
```

## 二、二期纳入范围

### 1. 头程费用项目

- 维护费用编码、名称、费用性质、计费单位、默认币种、税率/税务属性、启停状态和适用业务阶段。
- 费用项目只覆盖头程及“02 到仓”实际使用的费用，不因原型存在而自动纳入。
- 费用白名单由 P2-Q14 确认；白名单外费用允许人工补录时，必须记录原因和操作者。

### 2. 计费规则版本

- 规则支持按客户、往来单位、仓库、服务类型、货物属性和生效区间等维度匹配，最终维度由 P2-Q15 确认。
- 支持固定金额和“数量 × 单价”的基础计费；阶梯价、最低收费、封顶和组合价未确认前不写死。
- 每次规则发布生成新版本。历史费用保存规则版本、计费输入和计算结果快照，不因新版本发布而改变。

### 3. 费用生成与试算

- 费用可由头程订单、到仓实测、上架或其他已确认业务事件触发，具体节点由 P2-Q16 确认。
- 同一来源事件使用稳定来源键，重复投递不得重复生成费用。
- 费用计算保存原始数量、计费数量、单价、单位、币种、税率、金额、规则版本和计算过程。
- 测量和计费业务结果按产品确认执行“小数点三位向上取整”，同时保存未舍入原始值。

### 4. 费用明细与调整

- 支持自动生成和人工补录的头程费用明细。
- 费用状态采用：草稿、已试算、已确认、已作废。
- 已确认费用不直接覆盖；修改通过调整记录处理，保留原费用、调整前后值、原因、操作者和时间。
- 支持按订单、到仓单、费用项目、客户、仓库、币种和状态查询、查看计算明细与导出。

### 5. 权限与审计

| 角色 | 权限 |
|---|---|
| 计费专员 | 维护费用草稿、执行试算、人工补录和发起调整 |
| 计费审核员 | 确认费用、审核调整和作废 |
| 计费管理员 | 维护费用项目、规则版本和计费权限 |
| 客服/运营 | 查看授权订单的对客费用，不维护规则 |
| 企业客户 | 是否展示头程费用明细由客户端范围决定；不得查看内部备注或其他企业数据 |

费用项目、规则发布、试算、人工补录、调整、确认、作废和导出均需记录审计日志。

## 三、二期明确不纳入

- 应收、应付台账及账龄。
- 客户或供应商对账单、结算周期、账单确认和争议处理。
- 收款、付款、退款、部分核销、多对多核销和反核销。
- 发票申请、开票/收票登记、电子税局或第三方开票接口。
- 汇率结算、汇兑差额、本位币折算、单票利润和利润率报表。
- 在线支付、银企直连、银行流水自动认领。
- 会计科目、会计凭证、总账和法定财务报表。

原型中的上述页面仅作为后续阶段参考，不进入二期任务、排期或验收。

## 四、核心数据对象

| 数据对象 | 关键内容 |
|---|---|
| 费用项目 | 编码、名称、费用性质、计费单位、默认币种、税务属性、业务阶段和状态 |
| 计费规则版本 | 适用范围、计费方式、价格参数、生效区间、版本号、发布状态和审计信息 |
| 费用计算记录 | 业务来源、来源键、计费输入、规则版本、原始结果、舍入结果和计算时间 |
| 头程费用明细 | 订单/到仓单、费用项目、数量、单价、单位、币种、税率、金额、来源和状态 |
| 费用调整记录 | 原费用、调整前后值、原因、操作者、审核结果和时间 |

金额和计量值使用定点小数，不使用浮点数。原始值、三位向上取整结果和规则版本必须同时可追溯。

## 五、开发任务

| ID | 端 | 模块 | 交付内容 | 优先级 | 依赖 |
|---|---|---|---|---|---|
| P2-FEE-01 | 后台 | 费用项目 | 费用项目、单位、币种、税务属性、业务阶段和启停 | P0 | P2-BASE-01、P2-Q14 |
| P2-RATE-01 | 后台/服务端 | 计费规则 | 规则维度、版本、生效区间、基础价格结构和发布审核 | P0 | P2-FEE-01、P2-Q15 |
| P2-CALC-01 | 服务端 | 计费引擎 | 规则匹配、试算、事件触发、幂等、三位向上取整、快照和复算 | P0 | P2-RATE-01、P2-Q16、P2-WH-02 |
| P2-FEE-02 | 后台 | 头程费用明细 | 自动/人工费用、确认、调整、作废、查询、导出和审计 | P0 | P2-CALC-01 |

## 六、仍需确认的三项

| 编号 | 待确认问题 | 回传处理 |
|---|---|---|
| P2-Q14 | “02 到仓”首批费用项目、计费单位、币种、税率和触发节点 | 回传中的“63”无业务含义，未合并 |
| P2-Q15 | 计费规则维度，以及是否支持阶梯价、最低收费、封顶、组合价和冲突优先级 | 回传中的“63”无业务含义，未合并 |
| P2-Q16 | 各类费用在哪个节点试算、生成、确认和作废，人工费用何时生效 | 回传中的“63”无业务含义，未合并 |

P2-Q13 已确认：二期只做到头程费用计算。P2-Q17 至 P2-Q24 对应的应收应付、对账、收付款、发票、汇率结算和利润能力不适用于二期。

## 七、验收重点

- 相同业务事件重试不会重复生成费用。
- 每条费用能够追溯到订单/到仓单、费用项目、规则版本、计费输入和来源事件。
- 原始计算值和三位向上取整结果同时保存，历史费用能够复算一致。
- 已确认费用不能静默覆盖，调整和作废具有完整审计链。
- 禁用或更新规则不会改变历史费用结果。
- 未授权用户不能查看、修改或导出其他企业、仓库或业务范围的费用。
- 系统不产生应收应付、对账单、收付款、核销、发票或利润数据。