中转仓库存

01 功能介绍：按视图和业务周维护库存来源

中转仓库存是一张按业务视图＋业务周维护的周单。进入「仓储物流 → WMS → 中转仓库存」，先选视图和周次，再核对供应商、本地 SKU、箱规及件数。它不是按仓库实时查询收发存流水的页面，也没有逐笔占用明细。

本页负责维护来源表；锁定后可供符合条件的下游读取。录入“本周发货”或“下周交货”，不等于仓库已实际发货、到货或入库。安排发货还需核对调拨计划的运行、绑定周单与库存校验结果。

本文截图为真实前端连接本机只读 Mock，供应商与商品均为虚构资料。查询、周次切换和筛选已演示；保存、删除、导入、锁定、解锁及下游计算未演示，操作说明依据现行代码核对。

02 使用前：对齐业务视图、业务周与库存基准

1. 准备要维护的公司业务范围、业务周、供应商代号、本地 SKU 和经确认的库存数量。不要以供应商名称代替身份核对。
2. 选择「筛选视图」。首次加载默认取可用视图列表首项；这不代表系统已替你判断业务归属。
3. 查看「业务周」。默认使用服务端返回的当前周，采用 ISO 周次及周一至周日的日期范围。即使本周尚未建单，也会显示本周入口，不会自动复制上一周。
4. 对照当前周单状态、数据来源和行数。历史周有数据，不代表当前周已有草稿，更不代表下游绑定了那一周。

页面周次列表默认读取最近 26 张周单，并提供当前周。下拉框中的搜索是在已加载选项内筛选；搜不到更早的周次，应请管理员核查记录与页面加载范围，不要直接判断记录已删除。

03 读懂明细：供应商、SKU、箱规与件数

同一视图、同一周内，一行的业务识别键是供应商代号＋SKU。同 SKU 来自不同供应商可以分别存在；同一组合重复会被拒绝。供应商代号留空时仍按 SKU 识别，但不能据此保证下游供应商匹配完整。

• 型号、SKU、品名、供应商代号、供应商：用于核对商品和供应方。缺少型号、品名或供应商名称时，保存/导入可尝试按 SKU 或供应商代号补齐；不能保证每条都有主数据映射。SKU 必须有值，补齐后品名仍为空会报错。
• 下周可用发货数量：录入的件数来源值。当前实现保留输入，不自动按期初、发货、交货重新计算，也不表示已扣除所有调拨占用。
• 箱规：每箱件数，不是箱数。例如可发货 120 件、箱规 12，数量相当于 10 箱；本表仍保存件数，不会替你完成下游配箱。
• 期初总库存、本周发货、下周交货：分别保存对应业务口径的输入值。期初不会自动从上一周结转；三列也不会自动反推可发货数量。
• 模板中的其他列：新品首次发货、短交数量、备注、广州仓、工厂仓库、白云仓库由接口和导入导出保留，目前主表不展示这些列。仓库是数量列，不是页面上的仓库筛选器；不能承诺系统自动合计仓库列。

空数字表示未填写，零表示明确输入 0。界面把空值保留为空；下游可能按自己的规则将空值或负值折算为零，因此源表核对时必须保留区别。数量要求整数，现行校验并非所有列都禁止负数；业务上不合理的负数应先核实，不能当作允许负库存的承诺。

04 查询定位：先选周，再找商品

1. 选择「筛选视图」，打开「业务周」。可在周次搜索框输入周号、日期范围或状态文字，选择正确的一周。
2. 通过「全部」「草稿」「已锁定」定位周单。数字是已加载周单的数量，不是商品行数；点击「全部」会回到当前周，点击某状态会定位该状态的首个周单。
3. 在表格搜索栏选择「全部」或某个字段，再输入 SKU、供应商代号或品名片段。搜索作用于当前已加载周单的展示字段，不跨周，也不搜索隐藏的备注列。
4. 按需勾选「仅看不足2箱」。条件是箱规大于零且下周可用发货数量小于 2×箱规；正好两箱不命中，零件数在有效箱规下会命中，缺数量或箱规不命中。红色只是提醒，不是锁定失败或禁止发货状态。
5. 使用底部分页查看结果，默认每页 50 行，可切换 20/50/100 行。筛选后页码会重置；页面未提供列头排序，勿把当前行序当作按数量排名。

找不到商品时先清空搜索和「仅看不足2箱」，再核对视图与周次。「刷新」重新读取周单及周次信息，不重算库存，不同步仓库系统。

05 建立与修改草稿：先核对，再导入或编辑

操作前提：选择正确视图和周次，具有相应权限，周单未锁定。以下写操作未演示。

1. 新周没有数据时，点击「下载模板」，离线填写完整目标周单，再点「导入 Excel」（空表区也有「从 Excel 导入」）。页面没有独立“新建行”“复制上周”按钮；不要把后端保留的复制接口当作可点击入口。
2. 保留模板列名，如「供应商代号」「SKU」「品名」「下周可用发货数量」「箱规」。先校验组合键不重复、品名可确认、数字为整数、空值与零值符合来源资料。
3. 选中文件后会直接上传，没有独立预览或二次提交界面。导入会替换所选视图、所选周的全部行，不是追加，也不是只覆盖文件中匹配的行。需要保留的行必须一并放入完整文件。
4. 成功后核对提示中的导入行数、跳过行数，并重新查看商品与数量。空白行会跳过；重复组合键、非法整数或必需资料缺失会导致整次失败，不会把合法行当作部分成功提交。
5. 已有草稿的可编辑单元格可点击输入，按 Enter 或离开焦点会提交；按 Esc 取消当前输入。每次保存提交的是整张周单的行数据，隐藏列也随记录保留。等待“已保存…”反馈后再继续；失败时核对错误并重新读取。

导入前保留备份：空文件或没有可识别业务内容的文件可能形成空周单，覆盖原草稿。不要用空模板“测试导入”。重复导入也会重新替换整单，不能当作幂等追加。页面没有提供逐行删除；整周删除在业务周下拉菜单中进行。

尚在编辑框中的内容不是已保存证据。离开焦点本身会触发保存，不要把点击刷新当成取消修改；不想提交时先按 Esc。接口没有携带“你打开时的版本”做冲突校验，多人同时维护可能覆盖对方的整单内容。安排单人维护，交接前刷新核对，不要依赖自动合并。

06 权限与状态边界：锁定就是发布状态

• 草稿：后端状态 draft。可在具有对应权限时编辑、导入或删除；空周单不能锁定。
• 已锁定：后端状态 published。点击「锁定」即进入此状态并记录发布时间，没有另一步“审批通过后发布”。锁定后本页禁止编辑和导入。
• 解锁：将已锁定周单恢复为草稿并清除当前发布标记。它不是撤销已生成的下游结果，也不能保证所有下游立即失效。解锁前应与下游负责人核对绑定关系。
• 已归档：类型契约和状态文案保留此值，但本页没有归档操作或归档页签。遇到历史归档记录请核实来源，不编造归档流程或仅凭标签推断全部读写规则。

读取、编辑、导入、导出、锁定/解锁、删除为独立权限。只有编辑权限不代表可以锁定或删除；模板下载需要读取权限。本演示账号只有读取权限，因此维护、导出按钮禁用是预期结果。

需锁定时，先检查整单非空、供应商与 SKU、数量和目标周，在工具栏或业务周菜单点击「锁定」，核对状态变为「已锁定」及行数反馈。需删除时在业务周下拉菜单选择删除，核对确认框中的周号；只允许删除草稿整单，锁定单须先解锁。删除不可当作撤回下游发货安排。以上操作均未演示。

07 交接核验：绑定周次、占用与下游结果

1. 记录业务视图、业务周、供应商代号＋SKU、件数、箱规和锁定状态。周单行数不能代替 SKU 去重数，也不能把不同供应商的记录当作重复行随意删除。
2. 生成调拨供应商计划时，显式指定库存周就必须找到该视图该周的已锁定周单；缺失会报错，不回退到旧周。未显式指定时，创建链路才会按策略周选择不晚于该周的最新已锁定周单，并把实际周次写入运行。
3. 已创建计划的库存核验、手工调拨可用量等按运行绑定的精确周次读取，缺周时不能用另一周替代。库存核验可读取该精确周的草稿或已锁定记录，故“所有下游都只读锁定单”也不准确；最终可操作条件还要看下游当前校验。
4. 本表的可发货件数是来源池，不是扣减后余额。调拨端另按供应商＋SKU 汇总并结合计划分配、手工申请等核算占用与可用量；不要把这里的数量再次直接当成新增可发货量。
5. 库存投影按来源清单绑定周单及视图，聚合到本地 SKU 时可能合计多个供应商；采购预算投影也有自己的最近已锁定周单选择规则。核对各运行记录的实际来源，不能跨粒度相加，也不能将它们的回退规则套给已绑定的调拨运行。

保存或锁定来源不会替你执行新的投影、生成调拨、刷新已保存结果或完成真实收发货。交接时到库存投影或调拨计划核对运行与来源，再按各页正式流程处理；本次未执行这些下游操作。

08 导出与复查：整周导出，不限当前筛选

具有导出权限时，选定业务视图与周次后点击「导出」。文件包含该周已保存的全部行，不受当前搜索、分页或“仅看不足2箱”限制；包含模板中的隐藏列以及小批量发货提示，Excel 会提示不足两箱的行。

下载后核对周号、供应商代号、SKU、件数和空值。没有周单时导出可能只有表头，不能视为已确认全仓零库存。正在编辑但未成功保存的值也不是导出基准。本只读演示未提供模板/导出文件接口，下载验证未演示。

09 常见异常处理

• 没有模块权限：核对账号租户及中转仓读取权限；不要通过其他视图规避范围控制。
• 当前周未建草稿：确认周号后按模板准备完整周单，不要直接将上周数据当作本周库存。
• 筛选后空表：清除商品搜索、小批量筛选并检查页签；区分未建单、空周单和有记录但数量为零。
• 无法修改：核对已锁定状态、独立动作权限及是否仍在加载/保存。锁定冲突时重新读取，勿反复提交旧整单。
• 导入重复或数字报错：按供应商代号＋SKU 清理重复行，核对整数格式和品名，修正完整文件后再导入。不要仅重传失败行，否则可能覆盖掉其余原有记录。
• 名称没补齐或下游找不到供应商：核对 SKU 和供应商代号的主数据映射；同名不等于同一主体。
• 下游说缺库存周或数量不足：核对运行绑定周与视图、周单状态、供应商＋SKU 和下游占用。不要把锁定成功解释为下游一定可发货。

10 常见问题