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

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

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

一、产品确认的范围结论

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

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

二、二期纳入范围

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 对应的应收应付、对账、收付款、发票、汇率结算和利润能力不适用于二期。

七、验收重点

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