催货与生产进度

01 功能介绍：把缺口落实到可沟通的 PO

从 催货/生产进度 进入。本页以供应商备货计划的结果运行（Supplier Plan run）为范围，展示需要协调的 Local SKU，以及匹配的 ERP 待交付 PO。它不是全部采购订单台账，也不是所有生产中的 SKU 清单。

• 父任务行：同一结果运行中的一个 Local SKU，汇总供应商、待交付数量和 PO。
• MSKU 子项：默认展开，展示对应 MSKU、SID、备货策略、需求及等级线索。同名 MSKU 在不同 SID 下可以是不同子项，不能跨店铺当成一个身份。
• PO 跟进：在该 Local SKU 内按 PO 汇总匹配明细，记录实际协调催货数量、确认交货日期、成功或失败及本次备注。

要核对完整采购单，请查看 采购订单说明；要维护生产阶段和完成批次，请使用 生产跟踪。本篇保留催货的独立操作路径，三个页面的状态不应混用。

02 使用前：确认视图、运行与来源版本

1. 先确认当前租户和业务视图，以及要跟进的 Supplier Plan 结果运行。
2. 准备 Local SKU、PO、供应商沟通依据和目标交货窗口。不要只凭周编号确认版本。
3. 核对页面右下角「生成时间」「窗口」，必要时保留地址中的 view_id 和 supplier_plan_run_id，交给责任人定位同一批结果。

运行下拉显示 week 编号，来自调拨表周、缺失时使用策略周。页面请求所选视图的成功运行第一页，最多 100 条；这不是全部历史运行入口，同一周也可能有多个运行。默认保留仍有效的选择，否则选择返回列表首项。

当前实现以运行创建时间的北京时间业务日期确定业务周：该周周四是当前节点，下周周四至再下一周周三是目标窗口，再下一周周四起的待交付记录进入可催候选范围。例如 2026-09-29 创建的样例，目标窗口是 10-08 至 10-14，可催 PO 起始日是 10-15。这不是今天往后滚动的固定天数查询。

后端按运行读取催货快照；尚无快照时，首次读取会构建并保存，后续复用，再叠加该运行的跟进状态和备注。部分展示字段缺失时会补充来源信息，因此也不要称为每个字节都不变的历史镜像。页面「刷新催货任务」不能当成重新计算快照。本演示用内存响应替代整个读取链路，不会触发真实快照写入。

03 查询定位：先选范围，再找任务

1. 选择「视图」，再选 Supplier Plan Run。
2. 按「供应商代号」「店铺」「国家」「产品等级」「销量等级」「利润等级」「状态」组合筛选。
3. 在搜索字段中选择「Local SKU」「MSKU」或「PO 摘要」，输入关键词。输入即时过滤，匹配不区分英文大小写，前后空格忽略；没有额外的查询按钮。
4. 查看「任务总数／待处理／成功／失败」及底部条数，核对结果是否符合目标。

这些筛选在当前已加载的整批任务上执行，不是重新按供应商向后端取一批 PO。不同条件可能分别命中父任务内的不同子项；命中后会保留整条父任务及其子项，不保证每个展开子项都同时满足全部条件。筛选某供应商后，同一任务的其他供应商或 PO 仍可能出现。

切换视图会重置运行与筛选；切换运行会清空筛选。改变筛选、搜索字段、关键词、视图或运行会清空勾选。刷新图标只重读当前任务，不重新加载视图和运行列表。页面没有独立的日期范围控件、手动列排序或任务分页按钮。

04 读懂数量：需求、待交付与协调不能相加

列较多时横向滚动；前三列固定。Local SKU 左侧箭头可折叠、展开 MSKU 子项，拖动表头边缘可调整列宽。等级、国家、Blocked 原因与 Blocked 数量等按 MSKU 展示，父行留白属于树形布局，不表示对应值为零。

当前任务构建以目标窗口内「既调拨又采购」需求为依据。可用量是中转仓可发量扣除当前 Plan 已分配量后取非负，再加规定窗口内的待交付量；净缺口是需求减可用量后取非负。只有净缺口大于零、且有匹配的正数量可催候选记录时才形成任务。

本页没有另外一列“确认数量”或整单“订单数量”。供应商确认的数量记录在「实际协调」中；订单原始数量应回采购订单按 PO＋SKU 核对，不能把这几种叫法都当作同一口径。

候选来自运行绑定版本（缺失时使用来源库存周）的 Amazon ERP 待交付事实，并同时匹配 Local SKU、MSKU 与 SID。没有来源版本和来源周时不能凭空补数据；找不到任务不等于没有订单或缺口为零。上述计算字段部分仅在接口及导出中提供，不应把它们写成主表现有的独立列。

05 区分协调窗口、原预计日期与确认交货

• 协调时间：列表优先显示目标窗口起止日期；旧记录缺失时回退到其窗口，再回退到协调日期。它不是本次打电话或保存记录的时间。
• 生成时间：所选结果运行的创建时间，不是最后一次 PO 备注时间。
• PO 跟进的「到货」：匹配待交付明细中的原预计到货日期；同 PO 多行时取最早值。悬停「PO 摘要」可核对各条 ERP 待交付明细的预计日期、数量、MSKU、SID 和运输方式。
• 确认交货：跟单人员记录的供应商确认日期，与原预计到货日期分开保存。它不是已完成的实际到货、发货或入库日期。

样例中 PO 原预计日期为 10-16，供应商确认交货日期为 10-09，只表示预置的协调承诺；不证明货物已经到仓。若日期超出目标窗口，先核实沟通依据和影响，再交接责任人，不把系统允许保存当成业务已达标。

06 PO 协调：核对对象后逐条记录

前提：有催货读取与维护权限，且已选定视图和有效结果运行。保存未演示。

1. 定位 Local SKU，横向滚动到右侧「操作」，点击对话气泡图标（无障碍名称为「跟进该 Local SKU PO」），打开「PO 跟进」。
2. 逐 PO 核对供应商、「数量」「到货」与当前「状态」。一个弹窗可能有多个 PO，操作按钮仅针对所在 PO 行。
3. 填写「实际协调」「确认交货」「本次备注」。数量输入只接受数字；标记成功要求实际协调数量大于 0，并填写确认交货日期。
4. 点击该行的勾号标记「成功」，或叉号标记「失败」。这里没有独立的「保存备注」按钮；备注随该次状态提交。
5. 正式使用时应看到「已更新 Local SKU / PO：成功或失败」，随后检查重读后的弹窗数值、日期、状态和历史备注，关闭后再刷新列表核对。

成功校验没有证明“已满足全部缺口”，也没有替代人工核对数量是否超过候选量或日期是否落入目标窗口。当前链路未提供这两项业务上限/窗口校验，不能依靠点击成功自动保证合理。

失败不要求成功时的数量和日期条件；标记失败会清空该 PO 的当前确认交货日期，但已填写或已存的实际协调数量可能保留。再次标记成功可以重新填写数量与日期。当前弹窗没有“恢复待处理”按钮，也没有草稿保存；关闭前未提交的编辑不算已保存。

遇到红色错误提示，先核对权限、数量、日期和对象是否仍属于当前运行。状态提交后如果列表重读失败，页面可能仍显示旧数据；应重新查询确认，不能直接断言写入完全没发生，更不要反复点击造成重复备注。

07 状态与备注历史：先分清任务和 PO

任务总数与状态计数按当前筛选后的父任务计算，MSKU 子项不额外计数：

• 当任务级状态已经是成功或失败时，主表以该状态为准。
• 任务级仍待处理、且有 PO 时，全部 PO 成功才显示成功，全部 PO 失败才显示失败；混合结果仍属于待处理，可显示「1/2 成功」等进度。
• 「成功」是协调标记，不是生产完成；「失败」是跟进结果或任务打叉，不是后台计算运行失败。

非空的「本次备注」随 PO 状态提交追加到历史；当前读取每个 Local SKU＋PO 最近 10 条，按新到旧排列。历史展示状态、确认日期与备注，不是完整订单审计日志，也不展示操作人的完整信息。清空当前备注不会删除历史；重复提交相同非空备注仍可能增加一条。本页没有删除、编辑历史备注的入口。

主表「PO备注历史」只摘要展示，多个 PO 时会截断为加号数量；应打开对应 PO 跟进阅读，不把摘要当成全部沟通记录。只具备读取权限时弹窗入口禁用，应由有维护权限的责任人核对完整备注。

08 批量打叉与导出：范围不同

批量打叉未演示。 有维护权限时，勾选父任务行；表头全选仅选中当前筛选结果。底部出现「已选择 N 条任务，批量范围为当前筛选结果」，可以「清空选择」或「批量打叉」。请求按选中的任务 ID 执行，成功后页面重读并提示更新条数。

批量打叉写的是任务级失败状态，不是逐 PO 标记失败，不删除任务或采购单，也不是排除订单参与所有下游计算的开关。当前界面没有撤销批量打叉或恢复任务待处理的入口；即使以后把 PO 标记成功，任务级失败仍优先显示。误操作应带运行 ID 和任务信息交给负责人排查，不能承诺在弹窗勾回来就能恢复整条任务。

导出未演示。 有读取和导出权限、且选好视图与运行时，点击「导出」下载 Excel。页面仅把视图与运行传给接口，不会传当前供应商、店铺、等级、状态、搜索或勾选条件；导出的是该运行下服务返回的全部催货任务，不是当前筛选结果，也不是全部采购订单。整批无任务时导出会报空结果。

导出列还包括需求、可用量、缺口和可提前数量等。当前导出的“实际协调数量／状态”取任务级字段，而主表会优先汇总 PO 数量、派生 PO 状态，两者可能不同。核对时应同时留存运行、Local SKU、PO 明细，不能用文件单元格反推全部 PO 已处理。

09 权限与状态边界

旧 inventory:read/write 不替代本页专属权限。页面权限也不等于采购订单或生产跟踪的维护权限。租户及运行所属视图必须一致，不能修改地址把其他视图运行混进来。

本演示提供“界面维护权限”账号用于查看弹窗，但所有业务 PUT、POST、PATCH、DELETE 仍返回只读拒绝，未模拟保存或批量处理成功。另有纯读取账号用于检查禁用状态。

10 核对版本并交接责任页面

1. 在同一视图、同一运行内重新查 Local SKU 和 PO；核对数量、原预计日期、确认日期及备注。
2. 不同运行的任务身份包含运行 ID＋Local SKU，PO 身份再包含 PO 单号；状态和备注按运行读取。不能因 SKU、PO 或 week 标签一样就假设跨版本继承。
3. 需要修正采购订单来源日期、供应商或订单数量时，转到 采购订单，按 PO＋SKU 定位，并遵循该页权限和维护流程。
4. 需要确认备料、开料、上线、下线和工厂完成批次时，转到 生产跟踪 核对。实际到货和入库仍需对应订单/仓储证据。
5. 延期交接至少附上视图、运行、Local SKU、MSKU/SID、PO、原预计日期、供应商承诺、缺口影响和责任人。

本页操作链路保存跟进状态与备注，没有证明它会自动修改采购订单、生产阶段、库存事实或重新生成备货计划。催货结论和业务动作完成是两件需要分别核对的事。

11 常见异常处理

• 没有视图或运行：先确认租户、权限和可用视图；仅成功运行进入下拉，超过本页前 100 条的历史不能据此判断不存在。
• 当前筛选条件下没有可催货任务：清空关键词与筛选并检查运行。仍为空时核对目标窗口、策略准入、净缺口、候选 PO、MSKU＋SID 和来源版本；不代表所有订单已交付。
• 加载失败或视图不匹配：查看红色提示，重新选择正确范围。失败提示与业务零条不同，不用旧截图代替当前读取结果。
• 看到“—”或树形父行空白：区分缺字段、尚未录入、父行省略重复数据和真实零。实际协调为 0 也不能标记成功。
• PO 跟进为空或摘要缺 PO：匹配明细缺 PO 单号时不能生成相应 PO 跟进项；转到来源记录核对，不自行补一个相似单号。
• 主表失败但某 PO 成功：检查是否曾批量打叉；任务级状态优先。若无任务级覆盖，再核对是否还有未成功的 PO。
• 导出与筛选行数或状态不一致：先检查导出全运行范围与任务级字段口径，见上一节，不直接认定数据丢失。
• 旧运行没有最新订单或新备注：确认来源快照和运行 ID。刷新不等于重建，不在旧记录上假设继承最新版本。

12 常见问题