周发货台账

01 功能介绍：按周核对发货台账

周发货台账用于在一个业务视图、一个业务周内，记录商品的计划出货、实发数量、物流渠道及跟单备注。入口是 仓储物流 → WMS → 周发货台账，也可从本文顶部进入业务页面。

先用它回答“这一周、这个视图记录了哪些发货行”，再到物流和库存责任页面核对执行证据。计划出货不是实际发货，实发数量是台账填写值，不是承运签收或仓库入库凭证。已锁定也不代表外部物流单、库存扣减、收货状态已经同步。

本页没有仓库筛选、订单详情下钻、创建物流单或入库按钮。需要了解其他 WMS 模块时，参阅 库存操作总览；运输单据与履约状态参阅 物流协同。

本文截图使用真实前端连接本机只读内存 Mock，日期、数量与状态都是预置演示样例。保存、导入、锁定、解锁、删除均 未演示，截图不证明这些操作成功。

02 使用前：确认视图、业务周与权限

1. 确认你具有周发货台账读取权限，并能加载业务视图列表。视图列表来自库存投影的视图选项接口；仅有台账权限但视图加载失败时，也不能继续定位周单。
2. 先选业务视图，再选 业务周。首次进入默认取接口返回的当前周；即使历史周有数据，当前周也可能显示“未建台账”。切换视图会清空当前周选择并重新加载新视图的当前周。
3. 展开业务周，核对周号和周一至周日的日期范围。候选包含当前周、当前已选周及接口返回的历史周单，历史列表默认最多 26 条。下拉没有“新建任意周”或“复制上周”入口。
4. 核对标题旁状态、记录行数、数据来源和“更新”时间，再继续查看。来源“手工维护”或“模板导入”是周单最后保存方式，不是外部物流同步证明。

业务周是周单归属，发货日期是行字段，后台更新时间是台账维护时间，发布时间是锁定操作时间。页面汇总只显示一个“更新”时间：优先显示发布时间，否则显示更新时间。当前保存校验没有强制行日期落在所选周内；跨周日期应由负责人核实，不能据此自动转周或跨周重复累计。

03 查询定位：选周、切状态、搜索商品

1. 在视图下拉选择目标业务范围，展开 业务周，搜索周号或日期范围并点选目标周。
2. 如需查最近已发布周，点击 已锁定。状态页签用于跳转到列表中首个匹配状态的周单，不是把多个周的行合并起来筛选。全部会选列表首周或当前周；未锁定无匹配时回到当前周；已锁定无匹配时可能仍停留原周，务必看标题实际状态。
3. 在 搜索字段 选择“全部”或具体列，如 MSKU、供应商、产品SKU，再输入关键字。搜索忽略大小写、做文本包含匹配；数字和日期也是文本匹配，不是区间查询。
4. 核对行中的国家、店铺和商品标识，再横向滚动查看数量、渠道和备注。默认每页 50 行，搜索及分页只作用于已经读取的这一张周单。
5. 切换视图或周次后，原搜索词可能仍保留。看到空表时先清除搜索，再点 刷新；刷新只重新读取周单，不同步外部发货数据。

04 阅读明细：身份、数量与备注

一行是台账中的一条发货记录，不是唯一商品、唯一物流单或一笔采购订单。同一商品可以有多行；同一业务键的重复行也会保留，不能按 MSKU 自行去重。

空值显示 —，真实数字零显示 0。演示第三行实发未填，不能按零发货解释；第二行实发 0，只表示台账记录值为零，延期、取消或待发原因仍需查证。列表行数是记录数，不是箱数或件数汇总；不要把不同商品的箱规相加当作数量。

汇总栏的计划、实发按整张周单求和，空数量按零参与；差异为实发合计减计划合计，“问题”是问题备注非空的行数，不是系统自动诊断数量。它们不随搜索或分页缩小范围。演示周计划 260、实发 100、差异 -160，其中有一条实发未填，所以差异不等于已经确认的少发数量。状态页签旁数字统计返回的周单数，也不是商品行数。

05 维护已有行：保存及并发边界

本节操作未演示。 前提是已有未锁定周单、具备写入权限，且没有正在进行的操作。当前页面没有独立的新建、复制、增行、删行或“保存全部”按钮；空周主要通过模板导入建立台账，已有行通过单元格维护。

1. 点击要修改的单元格，输入值。按 Enter 或离开单元格会触发保存；按 Esc 取消当前编辑。值未变化不会提交。
2. 保存请求携带当前周单的全部行，不仅是当前页或命中的搜索行。后端替换整单明细后返回保存结果；等待“已保存……”提示，再刷新核对目标行。
3. 必填字段包括发货日期、国家、店铺、MSKU、物流渠道。箱规、箱数、计划出货、实发数量必须是非负整数；不接受小数、负数或布尔值。日期无法识别、供应商代码无效会报错。
4. 保存失败时会显示错误，单元格仍可能保持编辑态；先修正再提交，或用 Esc 放弃。供应商名称由后端回填，保存后应刷新核对，不只看编辑后的临时文本。

页面没有离开页面的未保存确认，也没有针对多人的版本冲突提示。后端行锁保护单次事务，但请求未携带旧版本校验；两人同时编辑可能发生后提交整单覆盖先前改动。交接编辑权、先刷新、保存后再核对，尤其不要在保存未结束时切换周或关闭页面。

06 模板、导入与导出范围

导入及下载操作未演示，以下按当前调用链说明。

1. 在正确视图和业务周，点击 模板 下载空白 XLSX。沿用模板列名；模板中的“时间”“出货数量”“物流渠道1”“备注（运营）”分别对应页面“发货日期”“计划出货”“物流渠道”“运营备注”。不要随意改列名，未识别列不会成为台账字段。
2. 填写所有要保留的行，再用 导入 Excel 选择 XLSX 或 CSV。导入是对所选视图、所选周的整单替换，既不是追加，也不是按商品键覆盖几行。先导出备份；空文件或只有空白行的导入可能清空原明细。
3. 校验通过才持久化。任一有效行缺必填字段、数量非法或供应商代码无法匹配，会使本次整体失败；全空白行跳过。错误会带行号，修正原文件后重试，不应按“其他行已成功”继续交接。
4. 成功时核对提示中的成功、跳过、失败行数，随后刷新核对周单来源、行数和样例值。不能只以文件选择成功或按钮结束转圈判断导入完成。
5. 点击 导出 读取所选视图、所选周单的全部行，包含当前搜索未命中的行和其他分页；不会导出全部业务周。无周单时后端可返回只有表头的文件，不应误判为数据恢复。

业务键由发货日期、国家、店铺、MSKU、ASIN、产品SKU、物流渠道组合，文本部分去首尾空格并转小写。同键按文件顺序分配拆分序号；完全相同的重复行也会保留，不自动去重。导入前检查重复，序号不应作为跨次导入稳定的业务身份。

07 权限与状态边界：锁定、解锁、删除

锁定、解锁和删除均未演示。 在业务周下拉定位对应周右侧按钮，先核对它是目标周，不只看主表当前周。锁定前确认行数大于零、整单已保存且字段和重复行已人工复核；锁定接口不会重新核验物流履约，也不要求每行实发都大于零。

锁定成功应看到“已锁定”提示、标题状态与汇总“更新”时间变化，刷新后仍一致。解锁只允许已发布周，成功后回到草稿并清除发布时间；必须重新锁定才恢复发布状态。删除只允许草稿，且有确认框，会删除整张周单及明细，不是删除选中商品；本页没有撤销删除功能。

若返回 403，核对对应权限；409 通常表示该周已锁定；404 表示目标周单不存在；400 要按具体字段或状态错误处理。发生失败不得写成操作已完成。

08 与下游核对：周次、来源与历史风险

1. 台账发布后，先记录业务视图、周号、锁定时间和关键行。再到 库存投影 对照运行的来源清单与版本，不要拿页面当前周直接代表某次历史运行使用的周。
2. 当前投影链路对名称包含 Skysper/Freesoo 的视图启用周发货来源；来源清单选择同视图、不晚于运行当前周的最新已发布周单，并记录所选周单身份。可读取正数实发数量作为条件在途来源，计划数量不替代实发；后续还依赖商品、区域、渠道及时间映射。不是所有视图都自动使用，也不保证每行进入计算。
3. 当前采购决策的特定 KUN 规则另按投影运行的业务周、同视图、已发布周单读取正数实发；先按 MSKU、国家/站点和店铺匹配，本地 SKU 唯一时才允许部分回退匹配，无法匹配的数量单独审计。它与投影“最近可用历史周”不是同一选周规则。
4. 另有采购回放与调拨求解的兼容读取：当投影尚未嵌入周发货时，按运行周读取已发布正数实发行，再做商品与渠道匹配；这些旧路径不具备与新来源清单完全相同的视图隔离。不能把某个下游合计直接当作本页当前视图的合计。
5. 对照下游实际来源周、运行号、未匹配记录，再去 物流协同 和库存责任页面找实物证据。发布动作本身没有调用重算或外部物流同步，分析变化也不等于实物到货。

历史边界：不能承诺解锁修改不影响历史展示。 当前部分投影查询会按运行记录的周单 ID 回查现有明细；旧兼容路径按周查已发布记录，隔离条件也与新路径不同。解锁后整单修改、重新发布或删除，可能改变这些回查结果；已有计算结果不会因此自动重算；新 KUN 采购决策快照会固化本周发货量、在途合计和来源身份，历史采购快照按冻结值读取，不应与投影明细的实时回查混为一谈。历史核对应同时保留导出、来源身份和当时结果，修改前交由投影负责人评估。

09 常见异常处理：先排除范围与状态

• 未建台账 / 当前周为空：先核对视图和周次，再清空搜索。当前周没有周单时，不会自动复制上一周；切到有数据的历史周确认。
• 状态页签和表格预期不一致：页签只是选周动作。无匹配周时可能保留原选择，以实际周号和标题状态为准。
• 数量显示 — 或 0：— 是字段未填，0 是已记录的零；都不能直接推断货物已取消、到货或完成入库。
• 缺某个商品：确认搜索字段、分页及视图周次；同商品可能有多条发货行，不能只找首行。缺少 ASIN 等可选字段也不代表接口失败。
• 读取失败 / 服务未准备好：保留错误提示、视图、周号和时间给维护人员。503、网络失败与正常返回空周单是不同情况，不能用上一周值填补。
• 保存、导入失败或供应商名称异常：按错误行修复必填和非负整数；供应商必须按代码匹配，不能只填名称。修正后刷新核对。
• 多人改后数据回退：暂停并发维护，比较导出和更新时间，确定一份完整周单后再由负责人处理；页面没有自动合并冲突能力。

组件中的 previewData 可以在本地变更预览状态，但生产路由通过真实接口处理。本文演示走正式页面与只读 Mock，不把组件预览的“本地 mock 成功”提示当作生产保存能力证据。

10 常见问题