docs/入库测量与计费/入库测量与计费需求优化版-原型对照.md

# 虫虫出海入库测量与计费需求优化版：头程入库测量闭环

> 形成日期：2026-08-01
> 需求依据：`D:\docs\悦` 原型、WMS 文档、头程物流流程图及现有入库测量与计费文档
> 优化原则：以实际原型可见流程为主，优先复用客户订单与现有微服务，不建设当前业务不需要的完整 WMS 和计费平台。

## 一、优化结论

入库测量与计费主目标收缩为：订单与客户头程订单提交后，后台能够完成入库单查看、实际测量、测量审核、接收审核，并记录简单库位和头程费用。

```text
订单与客户头程订单
  → 入库单列表/详情
  → 录入实际测量数据与图片
  → 测量审核
  → 接收审核
  → 填写库位
  → 人工录入并审核头程费用
```

不再单独建设到仓预约单、分批收货、处理单元、上架任务、位置历史和自动计费引擎。

## 二、入库测量与计费纳入范围

### 1. 入库单列表和详情

- 直接复用订单与客户头程订单生成或展示入库单，不新增“订单—到仓单 1:N”模型。
- 支持按入仓码、订单状态、测量审核状态、费用审核状态、客户、仓库和预计到达时间查询。
- 详情展示基本信息、货物明细、测量数据、费用信息、状态历史和其他信息。
- 其他信息包括快递公司、快递单号、关联文件、备注和客服内部备注。
- 支持作废操作，作废必须填写原因并保留操作记录。

### 2. 入库测量

- 录入实际箱数、总毛重、总体积和实际品名。
- 按箱规录入长、宽、高、箱数、每箱重量、体积、周长和备注。
- 保存客户下单数据、外箱规数据和实际测量数据，便于审核对比。
- 体积、材积重和汇总值由服务端计算，小数点三位向上取整。
- 测量图片必传；测量视频作为 P1 可选附件，不作为提交必填项。
- 修改已提交测量数据需要退回后重新提交，不建设多版本复测系统。

### 3. 测量审核

- 独立的待审核列表和审核详情。
- 对比原单总箱数、毛重、体积、材积与实测结果。
- 审核结果：审核通过、审核不通过。
- 审核不通过必须填写原因，并退回测量人员修改。
- 审核通过后进入接收审核。

### 4. 接收审核

- 独立的待接收审核列表。
- 展示入仓码、仓库、客户、业务类型、渠道、箱数、重量和测量审核结果。
- 只有测量审核通过的数据才能接收。
- 接收结果：接收通过、接收不通过。
- 接收不通过必须填写原因；接收通过后入库单状态变为已入库。

### 5. 差异展示

- 差异不再建设独立差异单、客户确认、通知补偿和关闭流程。
- 在测量审核页面直接展示原单与实测箱数、重量、体积和材积差值。
- 差异仅用于审核参考和历史记录，不阻塞审核人员主动通过。
- 原型中的“待客户确认”页签不纳入入库测量与计费，应删除或改为“测量待审核”。

### 6. 库位

- 复用仓库服务中的库位基础资料。
- 入库接收时人工选择或填写一个库位。
- 只校验库位属于当前仓库且未停用。
- 不建设库区容量、承重校验、上架任务、任务分配、拆分和位置流水。

### 7. 头程费用

- 只维护入库测量与计费实际使用的头程费用项目白名单。
- 在入库单详情人工新增费用项目、数量、单价、币种、金额和备注。
- 金额由服务端按“数量 × 单价”计算，也允许固定金额。
- 费用状态：草稿、待审核、审核通过、审核不通过、作废。
- 审核通过的费用不能直接覆盖，只能作废后重新录入。
- 不建设头程/FBA 计费维度匹配、阶梯价、最低收费、封顶、组合价、规则版本和事件计费引擎。
- 不生成应收、应付、对账单、收付款、核销、发票和利润数据。

### 8. 文件、打印和导出

- 测量图片和关联文件使用现有文件服务，下载时校验租户和订单权限。
- 打印唛头复用现有打印服务；入库测量与计费只要求按入库单打印，不建设处理单元标签生命周期。
- 单票入库清单导出列为 P1；FBA 流转单、批量 ZIP 和自定义列暂不纳入。

## 三、状态模型

| 状态 | 说明 |
|---|---|
| `WAIT_MEASURE` | 等待录入测量数据 |
| `MEASURE_PENDING` | 测量数据已提交，等待审核 |
| `MEASURE_REJECTED` | 测量审核不通过，等待修改 |
| `RECEIVE_PENDING` | 测量审核通过，等待接收审核 |
| `RECEIVE_REJECTED` | 接收审核不通过 |
| `RECEIVED` | 接收审核通过，完成入库 |
| `VOIDED` | 入库单已作废 |

不使用“待客户确认、差异关闭、上架中、上架完成”等入库测量与计费无实际操作页面的状态。

## 四、角色与按钮权限

| 角色 | 主要按钮 |
|---|---|
| 仓库测量员 | 查看入库单、录入/修改测量、上传图片、提交审核 |
| 仓库审核员 | 测量审核通过/不通过、接收审核通过/不通过 |
| 运营/客服 | 查看详情、维护快递信息、关联文件、备注、作废 |
| 计费操作员 | 新增、编辑、提交头程费用 |
| 计费审核员 | 费用审核、驳回和作废 |
| 平台管理员 | 费用项目、库位及权限配置 |

所有查询和操作必须按租户、企业和仓库进行服务端数据隔离。

## 五、精简后的开发任务

| ID | 模块 | 交付内容 | 优先级 |
|---|---|---|---|
| P2-01 | 契约与权限 | 状态、错误码、按钮权限、租户/仓库数据范围 | P0 |
| P2-02 | 入库单列表 | 查询、分页、筛选和状态页签 | P0 |
| P2-03 | 入库单详情 | 基本信息、货物、测量、费用、历史和其他信息 | P0 |
| P2-04 | 入库测量 | 箱规明细、汇总计算、图片上传和提交 | P0 |
| P2-05 | 测量审核 | 原单实测对比、通过、驳回和原因 | P0 |
| P2-06 | 接收审核 | 待接收列表、通过、驳回和完成入库 | P0 |
| P2-07 | 库位记录 | 库位查询、选择、停用校验和入库单库位字段 | P0 |
| P2-08 | 费用项目 | 头程费用项目白名单和启停 | P0 |
| P2-09 | 入库费用 | 人工录入、计算、提交、审核、驳回和作废 | P0 |
| P2-10 | 文件与打印 | 测量图片、关联文件、鉴权下载和打印唛头 | P0 |
| P2-11 | 客户端展示 | 在客户订单详情只读展示实测、入库状态和公开费用 | P1 |
| P2-12 | 测试发布 | 权限、越权、状态、重复提交、金额计算、文件和回归测试 | P0 |

原 24 项任务收缩为 12 项，不新增微服务：入库和审核放在头程服务，库位/快递公司继续使用仓库服务，文件与打印复用现有服务。

## 六、从原型发现但原入库测量与计费文档覆盖不足

| 原型内容 | 当前覆盖情况 | 优化处理 |
|---|---|---|
| 测量数据审核独立页面 | 有提及，但任务粒度不清 | 明确为独立 P0 功能 |
| 接收审核独立页面 | 原计划被分批收货、上架流程稀释 | 明确为完成入库的最后审核节点 |
| 客户下单/外箱规/实际测量三组对比 | 未完整描述 | 纳入测量详情和审核页 |
| 审核不通过及失败原因 | 未完整描述 | 测量和接收审核均必须支持驳回原因 |
| 测量视频 | 原文只写照片 | 改为 P1 可选附件 |
| 快递公司、快递单号 | 有订单与客户字段，但未进入入库详情 | 纳入“其他信息” |
| 关联文件、备注、客服内部备注 | 覆盖不足 | 纳入详情，内部备注不对客户展示 |
| 作废、打印唛头、单票导出 | 覆盖不完整 | 作废和打印 P0，单票导出 P1 |
| 费用审核状态 | 计费方案过度复杂 | 改为人工费用提交与审核 |
| 状态历史 | 有数据对象但没有明确页面 | 详情页只读展示操作时间线 |

## 七、原型存在但入库测量与计费不纳入

- 智能装柜、合关报关、配载、船期和 FIST 推送。
- 到仓预约容量、自动服务商分配和多批次收货。
- 托盘管理、处理单元、标签换标/补打/作废生命周期。
- 独立差异单、客户确认、隔离区、上架任务和位置历史。
- OCR 智能识别和自动测量设备接入。
- 海外仓库存、退货、换标、派送、PDA 和完整 WMS；仅纳入客户级天数阶梯仓储费基础资料 CRUD。
- 头程/FBA 阶梯计费、规则引擎、应收应付、对账和完整财务模块。
- 批量导入导出、自定义列、批量 ZIP 和复杂报表。

### 7.1 海外仓阶梯费用补充边界（2026-08-05）

Warehouse 服务已提供海外仓客户级天数阶梯仓储费的分页、详情、新增、编辑和删除接口。该功能属于基础资料配置，不代表海外仓 WMS 或自动计费已经纳入入库测量与计费。当前配置不参与入库/FBA 费用计算、费用发送、账单或结算。

## 八、仍需产品确认的最少事项

1. 测量审核和接收审核是否必须由不同账号完成。
2. 接收审核不通过后退回到测量环节，还是直接作废入库单。
3. 入库测量与计费首批费用项目清单，以及哪些费用允许人工录入。
4. 客户端是否展示费用；如果展示，只展示审核通过的费用。
5. “是否扣货/扣货理由”只作为备注字段，还是需要真实业务状态。
6. 测量视频是否保留；建议非必填并放入 P1。

## 九、验收主流程

1. 订单与客户审核通过的头程订单出现在后台入库单列表。
2. 测量员录入箱规、重量和体积，上传测量图片并提交。
3. 审核员查看原单与实测对比，驳回时必须填写原因。
4. 测量通过后进入接收审核，接收通过后状态变为已入库。
5. 入库单能够保存库位、快递信息、关联文件和备注。
6. 计费人员录入头程费用并提交审核，审核通过后客户按权限只读查看。
7. 重复提交不产生重复记录，跨企业和跨仓库访问被拒绝。
8. 作废、驳回、审核、文件访问和费用操作均有审计记录。