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

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

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

一、优化结论

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

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

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

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

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. 作废、驳回、审核、文件访问和费用操作均有审计记录。