docs/二期/二期计费财务模块规划.md

# 虫虫出海二期计费与财务模块规划

> 创建日期：2026-07-28  
> 状态：开发已启动，范围确认并行  
> 关联规划：[二期开发规划](二期开发规划.md)  
> 原型依据：`docs/悦/货代SAAS平台后台/货代SaaS平台原型.html`、`docs/悦/头程下单/柏悦客户端.html`

## 一、建设目标

二期在“02 到仓”作业闭环上增加最小可用的计费与财务闭环，使每票到仓业务能够回答：按什么规则计费、产生了哪些应收和应付、是否完成对账、已收付多少、剩余多少，以及本票业务的收入、成本和毛利是多少。

```text
到仓实测/业务事件
        ↓
费用规则匹配与试算
        ↓
费用审核、调整与锁定
        ↓
应收 / 应付费用台账
        ↓
客户 / 供应商对账单
        ↓
收付款登记与核销
        ↓
单票利润与财务状态
```

## 二、二期纳入范围

### 1. 费用项目与计费规则

- 维护费用项目、应收/应付方向、默认币种、计费单位、税务属性和启停状态。
- 计费规则支持客户、供应商/往来单位、仓库、服务类型、货物属性、生效日期和失效日期等适用维度。
- 支持按票、箱、托、件、重量、体积、计费重、次数和固定金额计费；阶梯价、最低收费和封顶规则是否进入二期由业务确认。
- 规则必须版本化。历史费用保存规则版本、计费输入、计算过程和结果快照，不因新规则发布而变化。
- 二期的计费规则用于实际业务计费，不等同于对客询价或正式报价体系。

### 2. 费用生成与调整

- 到仓签到、实测确认、异常处理或指定库位完成后，根据已确认的触发节点生成费用草稿。
- 自动费用与人工费用均关联订单、到仓单、收货批次或处理单元，并记录客户/供应商、费用项目、数量、单价、币种、汇率、税额和来源。
- 同一业务事件重复投递不得重复生成费用；费用生成使用稳定来源键保证幂等。
- 费用支持试算、待审核、生效、已锁定、已冲销和作废状态。
- 生效费用不允许直接覆盖。调整通过新增调整行或红冲行处理，并保留原因、原记录、申请人和审核人。

### 3. 应收与应付

- 应收面向客户企业，应付面向快递公司、仓库服务商或其他往来单位。
- 支持按订单、到仓单、客户、供应商、费用项目、币种、审核状态和结算状态查询。
- 应收和应付分别授权；客户侧永不返回供应商成本、内部利润和内部调整备注。
- 多币种费用按原币保存，不允许直接跨币种相加；折算金额使用锁定汇率和汇率日期。

### 4. 对账单与账单

- 支持按票结算或按结算周期汇总生成客户/供应商对账单。
- 对账单包含期初、当期费用、调整、已核销、未核销、结算起止日期和到期日。
- 支持草稿、待审核、待对方确认、已确认、有争议、已关闭和已作废状态。
- 对账单确认后锁定明细；争议通过退回、调整费用和重新生成版本处理，不直接修改已确认版本。
- 企业客户端可以查看账单列表和明细、确认或提出异议；二期供应商对账采用后台登记确认结果，不建设供应商端。

### 5. 收付款与核销

- 二期支持线下收款、付款、退款和调整的登记，不接在线支付渠道。
- 支持部分核销、一笔收付款核销多张账单、一张账单被多笔收付款核销。
- 保存交易日期、往来单位、金额、币种、流水号、凭证、经办人和审核记录。
- 已审核核销不得删除；错误处理采用反核销或冲正，并保留完整审计链。
- 二期不纳入预收、预付及跨币种核销；确需支持时按范围变更处理。

### 6. 发票与利润

- 二期只登记发票申请、发票号码、金额、税率、开票/收票日期、状态和附件，不直接连接电子税局。
- 单票利润按已生效应收减已生效应付计算，同时展示未对账、未核销和异常费用提示。
- 利润报表至少支持按订单、客户、供应商、仓库和月份筛选；不同币种先按锁定汇率折算到本位币。
- 利润和成本只向财务及授权管理角色开放。

## 三、明确不纳入二期

- 对客询价、报价审批、报价转订单和合约报价体系。
- 在线支付、支付网关、自动扣款、银企直连和银行流水自动认领。
- 电子税局或第三方开票平台直连、税务申报和税控设备集成。
- 会计科目、会计凭证、总账、资产负债表、现金流量表及法定财务报表。
- 自动获取外部汇率；二期由财务维护并锁定业务使用汇率。
- 预算、资金计划、信用保险和复杂授信管理。

## 四、角色与权限

| 角色 | 主要权限 | 数据边界 |
|---|---|---|
| 计费专员 | 维护费用草稿、试算、发起调整 | 授权客户、仓库和业务范围 |
| 财务审核员 | 审核费用、对账单、收付款和核销 | 平台授权范围 |
| 财务管理员 | 维护费用项目、规则、汇率、结算参数和财务权限 | 平台授权范围 |
| 客服/运营 | 查看对客费用、发起对账、处理争议 | 授权客户范围，不可查看供应商成本和利润 |
| 企业客户 | 查看本企业账单、明细、付款状态并确认或提出异议 | 当前企业 |
| 平台管理员 | 配置角色权限和审计查询 | 不因管理员身份默认获得财务明细权限 |

关键动作至少拆分为：规则发布、费用新增、费用调整、费用审核、对账单审核、收款登记、付款登记、核销、反核销、发票登记、利润查看和财务导出。

## 五、核心数据对象

| 数据对象 | 关键内容 |
|---|---|
| 费用项目 | 编码、名称、应收/应付方向、计费单位、默认币种、税务属性和状态 |
| 计费规则版本 | 适用客户/供应商/仓库/服务、计费方式、阶梯、最低价、币种、生效区间和版本状态 |
| 费用记录 | 业务来源、应收/应付、往来方、计费输入、单价、金额、税额、币种、汇率、规则快照和状态 |
| 费用调整 | 原费用、调整类型、差额、原因、申请人、审核人和冲销链 |
| 对账单 | 对账对象、结算周期、币种、期初、费用、调整、核销、余额、到期日、状态和版本 |
| 对账单明细 | 对账单、费用记录、业务单据、原币金额、折算金额和争议状态 |
| 收付款记录 | 收/付/退/调、往来方、金额、币种、日期、流水号、凭证和审核状态 |
| 核销记录 | 收付款记录、账单/费用、核销金额、汇兑差额、操作者、时间和冲正关系 |
| 发票记录 | 发票方向、抬头、税号、号码、金额、税率、日期、状态、附件和关联账单 |
| 汇率版本 | 原币、目标币、汇率、汇率日期、来源、审核人和锁定状态 |

所有金额使用定点小数，不使用浮点数。金额和税额保留 2 位、业务汇率保留 6 位，由服务端统一四舍五入；原币金额、折算金额和使用汇率必须同时保存。

## 六、开发任务建议

| ID | 端 | 模块 | 交付内容 | 优先级 | 依赖 |
|---|---|---|---|---|---|
| P2-FEE-01 | 后台 | 费用项目 | 费用项目、方向、单位、币种、税务属性和启停 | P0 | P2-BASE-01 |
| P2-RATE-01 | 后台/服务端 | 计费规则 | 规则维度、版本、生效区间、阶梯/最低价和发布审核 | P0 | P2-FEE-01、P2-WH-02 |
| P2-CALC-01 | 服务端 | 计费引擎 | 规则匹配、试算、事件触发、幂等、计算快照和复算 | P0 | P2-RATE-01 |
| P2-FEE-02 | 后台 | 费用台账 | 自动/人工费用、审核、调整、红冲、锁定和审计 | P0 | P2-CALC-01 |
| P2-ARAP-01 | 后台 | 应收应付 | 客户应收、供应商应付、查询汇总、权限和导出 | P0 | P2-FEE-02、一期往来单位 |
| P2-RECON-01 | 后台 | 对账单 | 按票/月结生成、审核、确认、争议、版本和关闭 | P0 | P2-ARAP-01 |
| P2-CLI-03 | 客户端 | 账单中心 | 对客账单列表、明细、确认、异议和付款状态 | P0 | P2-RECON-01 |
| P2-CASH-01 | 后台 | 收付款核销 | 收付款登记、凭证、审核、部分核销、反核销和余额 | P0 | P2-RECON-01 |
| P2-INV-01 | 后台 | 发票登记 | 开票/收票申请、号码、金额、税率、状态和附件 | P1 | P2-RECON-01 |
| P2-PROFIT-01 | 后台 | 单票利润 | 收入、成本、毛利、毛利率、折算和权限控制 | P1 | P2-ARAP-01、汇率版本 |

## 七、启动前业务确认

### 仍需产品确认

| 编号 | 待确认问题 | 当前建议 |
|---|---|---|
| P2-Q13 | 二期计费财务做到哪一个闭环终点？ | 做到线下收付款登记和核销，不做在线支付、会计凭证和总账 |
| P2-Q14 | “02 到仓”首批费用项目及应收/应付方向是什么？ | 建立费用白名单，白名单外费用只允许人工新增并审核 |
| P2-Q15 | 计费规则需要哪些维度、阶梯和最低收费？ | 至少支持客户、往来单位、仓库、服务和有效期；复杂价格结构按实际需要裁剪 |
| P2-Q16 | 各类费用在什么业务节点生成、审核和锁定？ | 实测完成试算，差异确认后生效；其他费用按已确认事件生成 |

### 已由原型和实现基线确定

| 编号 | 已确定结论 | 原型依据摘要 |
|---|---|---|
| P2-Q17 | 本位币 CNY；保存原币、人工业务汇率和折算金额，费用生效时锁定汇率快照 | 币种、汇率、CNY/USD/EUR 及人民币:美元汇率字段 |
| P2-Q18 | 保存未税金额、税率、税额、含税总额；金额/税额 2 位、汇率 6 位，服务端统一舍入 | 0%/6%/9%/13% 税率及税额、含税合计 |
| P2-Q19 | 经办提交、财务审核；生效费用只能调整、红冲或作废并留痕 | 新增、客服提交、财务通过等状态 |
| P2-Q20 | 支持按选择和按截止时间生成账单，保存结算期间、账期和到期日 | 两种生成账单入口及结算字段 |
| P2-Q21 | 账单审核、确认、拒绝、锁定和争议后新版本流程 | 待审核、审核通过、审核拒绝、待确认及明细/历史 |
| P2-Q22 | 线下收付款、部分收付、余额、核销和反核销；不含预收预付、跨币种和银行自动认领 | 待收款、部分收款、已结清、余额、支付历史和核销入口 |
| P2-Q23 | 只做发票信息和状态登记，不接外部开票平台 | 发票抬头、日期、状态、税率和税额字段 |
| P2-Q24 | 利润＝已生效应收－已生效应付，利润率＝利润÷收入；仅财务授权角色可见 | 收入、成本、利润、利润率及多维报表 |

P2-Q13 至 P2-Q16 纳入 [二期需求确认清单](二期需求确认清单.md)。产品岗位空缺期间可先开发费用、账单和审计基础结构，但闭环范围、费用白名单、复杂价格规则和自动计费节点必须配置化；四项临时结论回写后再锁定最终业务流。P2-Q17 至 P2-Q24 不再要求重复确认。

## 八、验收重点

- 相同业务事件重试不会重复生成费用。
- 历史费用使用保存的规则版本、计费输入和汇率能够复算一致。
- 费用调整、红冲、核销和反核销形成不可删除的完整审计链。
- 多币种不直接汇总；所有折算都能追溯到汇率版本和日期。
- 对账单明细之和、调整、核销和余额能够勾稽一致。
- 部分核销、多对多核销和反核销后的未结余额正确且不为负数。
- 客户不能查看供应商成本、内部利润、内部备注或其他企业账单。
- 未授权运营人员不能查看利润、付款和供应商成本。
- 已确认对账单不能静默修改，重新计算必须生成调整或新版本。
- 财务导出、凭证下载和敏感金额查询具有权限与审计记录。