生产跟踪

01 功能介绍

生产跟踪用于按采购订单明细跟踪工厂的生产节点、完成情况和延期风险。底层一条记录对应当前租户的一张采购订单中的一条来源明细，同一采购单内相同 SKU 也可能有多条记录；不能仅凭 SKU 相同就合并维护。供应商来自采购订单，工厂是人工维护字段，两者不必相同。

• 数据有两个来源：采购单号、采购单状态、到货状态等来自采购订单同步，属于来源信息，不在本页重复填写；工厂、产线、生产阶段和完成数量由跟单人员维护。
• 页面分两个视图：明细跟单按采购单逐 SKU 跟踪，工厂 SKU 进度汇总按工厂和 SKU 聚合。
• 生产阶段依次为备料、开料、上线、下线；「工厂完成」数量由完成批次汇总得出，不直接编辑。

02 查询与定位记录

进入「计划采购 → SRM → 生产跟踪」，先定位要处理的记录：

1. 按供应商、采购仓库、采购单状态、到货状态、生产状态或是否延期组合筛选。
2. 选择时间字段和日期范围；默认选择计划交货时间，但默认日期范围为空，不自动限定某个月。可切换采购单创建时间、工厂确认交期或可出货时间；日期范围含起止当天，缺少所选日期的记录不会命中该范围。
3. 也可以用字段搜索，选择「全部字段」「采购单号」「SKU」或「工厂」；品名、供应商关键词使用「全部字段」，输入后点击「搜索」；移除筛选标签或点击「重置」后重新定位。

生产状态支持待排产、待生产、生产中、已完成、已延期、已关闭六种；定位延期记录时直接使用「是否延期」筛选。

采购单状态、到货状态和生产状态是三个独立条件，组合后取交集。页脚「共…个采购单」按采购单分页，「…条 SKU 明细」是当前筛选的明细总数；同单命中明细不会跨页。采购单父行只汇总当前筛选命中的子行，不一定代表整张订单。

列较多时可横向滚动；支持按列排序、拖拽调整列宽，并通过「列配置」控制显示、顺序及左侧冻结，布局按视图保存在当前浏览器。带排序按钮的日期、数量等列支持升降序，空值排在末尾；先排采购单父行再排页内 SKU，不能把父行日期区间误当单条日期。「刷新」重新读取当前视图，不触发外部采购订单同步。

03 查看明细与详情

1. 点击采购单左侧箭头展开该单的 SKU 明细行。
2. 点击 SKU 行「查看详情」，核对采购来源、计划日期、到货状态与同步时间。
3. 在详情的操作记录中追溯该记录的维护历史。

采购订单同步提供的采购单状态、到货状态、工厂确认交期与计划交货时间各有来源，不能互相替代。

• 采购单创建时间来自采购订单创建时间，页面按 UTC 显示，来源为空就留空，不用同步时间补齐。
• 工厂确认交期来自采购订单明细预计到货日；计划交货时间来自唯一匹配的采购计划。同租户、SKU、产品及计划号关联无法唯一确定时，计划日期留空。
• 判断延期时先用工厂确认交期，缺失才用计划交货时间；可出货时间和首次双方确认交期不参与当前延期判定。
• 核对采购已收货、采购已入库、来源状态、关闭原因和来源同步时间。空日期不等于今天，缺失字段不应当作实际零值；数量为 0 则按该字段实际含义核对。

详情中的「采购订单」是来源标识，并非跳转按钮；需要查原单时另从采购订单页面按单号定位。生产阶段和完成批次需回到主表各自入口查看。

04 维护生产阶段

1. 在 SKU 明细行点击备料、开料、上线或下线的阶段单元格，打开「生产阶段维护」。
2. 选择阶段状态，按实际反馈填写计划日期、实际日期和备注。
3. 点击「保存阶段」，出现「生产阶段已更新」提示后，重新打开阶段确认内容已保存。

维护前需具备生产进度写入权限且来源有效。当前阶段可选「待处理」「进行中」「已完成」「受阻」「不适用」；「未维护」表示还没有保存过该节点，不能与已维护的「待处理」混为一谈。

维护时遵守以下规则：

• 阶段按备料、开料、上线、下线顺序推进；前一阶段完成或标记不适用后，下一阶段解锁。锁定阶段仍可提前填写计划日期和备注并点击「保存计划」，但不可开始该阶段或填写实际日期。
• 后续阶段已经开始（状态不再是待处理，或已有实际日期）后，前置阶段不能退回未结束状态。日期和备注仍需按事实修正。
• 阶段状态、日期应与供应商的真实反馈一致，不提前填写未发生的进度。当前实现未强制要求标记完成时必须有实际日期，也未自动根据日期判定阶段完成，不能把空日期解释为系统补齐。
• 四个阶段只记录节点事实，不自动增加工厂完成数量；全部下线也不代表整条记录已经「已完成」。
• 来源已关闭的记录按只读历史处理，不应通过修改历史记录表达新进度。

05 记录工厂完成批次

工厂完成数量不直接编辑，通过完成批次逐次登记：

1. 在 SKU 明细行点击「完成批次」列，打开批次窗口。
2. 按真实完成事实填写「本批完成数量」「完成日期」和可选备注，点击「新增批次」；修改既有批次时点击对应「编辑」，确认后「保存修改」。批次号按本条明细依次生成 B001、B002，创建后不可改，状态由数量或日期事实推导。
3. 出现「批次已新增」或「批次已更新」后，重新打开批次窗口，核对批次数、累计数量、完成日期和操作记录；外层「工厂完成」列取全部批次数量合计。保存未演示。

累计完成量不得超过该条采购明细的采购数量；编辑时是替换原批数量，不是再次累计。当前普通表单/API 对空数量按 0、空日期按空处理，不应称其已有必填拦截；登记真实完成时请同时核对数量和日期。不要把同一批重复新增；页面没有批次删除入口，发现重复应核对原始记录后修正既有批次，不能承诺删除或自动去重。

阅读「工厂完成」数量旁的两种提示，再通过「完成批次」列核对：

• 显示「批次汇总」：该行的工厂完成数已由批次汇总，需要修改时请调整对应批次。
• 显示「历史只读」：历史数据没有批次记录。新增首个批次后，累计完成量改为批次合计，并非“原历史数 + 新批次”。先核清历史完成数量与日期并协调补录，避免累计数被少记；不得猜测历史完成日期。

例如演示记录采购 200，两个批次 70 和 50，累计完成 120、工厂库存 120、工厂待生产 80。它仍可显示采购已收货 0、已入库 0，这并不矛盾。

06 行内编辑与批量维护

在明细行上可直接维护工厂名称、可出货时间、产线、产线人数、延期原因、跟单备注和内部备注。需具备写入权限且来源有效。点击目标单元格，修改后按 Enter 或移出焦点保存，Esc 取消；等「字段名已更新」提示后刷新核对。失败提示意味着不能按已保存交接。产线人数须为非负整数，可留空；空白文本或日期会清空该字段，与导入空白单元格的“不修改”不同。

需要批量处理时：

1. 勾选目标采购单或 SKU 行，页面顶部出现批量操作栏。父行选择的是当前筛选下该单可维护子行，「选择当前页」不代表所有页；已关闭行不可选，已选数量按明细条数显示。
2. 选择要批量设置的字段——批量支持可出货时间、跟单备注和内部备注。
3. 填写字段值，点击「批量应用」，核对「已批量更新…条记录」与目标行；点击「清空选择」退出批量模式。批量空值同样会清空所选字段，应用前先核对范围。失败时按提示检查权限、来源是否已关闭和字段值，不要假定部分已写入。行内和批量写入均未演示。

07 工厂 SKU 进度汇总

切换到「工厂 SKU 进度汇总」视图，按工厂和 SKU 核对采购总量与工厂完成数量的聚合结果。

需要来源明细时，点击行内「查看构成」下钻到构成该汇总的采购单明细，再点击构成行的「打开明细」核对来源。比较前保持供应商、日期、状态与工厂等筛选一致；汇总只统计来源有效记录，即使明细列表能查到已关闭行，也不会计入当前汇总。

• 工厂按人工名称分组；为空时回退供应商名称，两者都空才显示「未维护工厂」。同一工厂和 SKU 可以跨多张采购订单聚合，不按供应商再拆一组。
• 「执行采购单数」按订单号去重，「执行明细数」按记录计数；采购总量、工厂完成量按命中明细求和，不因 SKU 同名就去掉合法明细。
• 工厂库存等于累计工厂完成量，不扣采购收货、入库或发货；它不是 WMS 实盘可用库存。工厂待生产先逐条取 max(采购数量−工厂完成数量, 0)，再合计，不能先跨行相减抵消。
• 最早/最晚交期取上述有效交期的区间；全为空就留空。延期明细数是条数，不是数量，也不是全部采购单数。页面没有完成率百分比；如自行核算比例，应以相同筛选的采购数量为分母，分母为 0 时不能推导完成率。
• 「工厂库存」「工厂待生产」筛选先筛明细再聚合。例如一组含零完成与非零完成两行，选择有工厂库存后，只统计后者，不能再与未筛选总量混比。

若工厂为空、汇总显示供应商名称，但「查看构成」未能打开，先回「明细跟单」按供应商和 SKU 核对原记录，不把加载失败解释为数量为零。

本次示例 DEMO 东莞工厂 + DEMO-BAG-A 来自两张采购单：采购 200+100=300，完成 120+40=160，库存 160，待生产 80+60=140，延期明细 1 条。

08 导出与导入

导出菜单区分三种用途，不要混用：

• 导出当前明细：只读留档，不能作为回填模板；汇总视图下为「导出当前 SKU 汇总」。
• 下载维护模板：用于回填工厂、交期、产线和备注后再导入。
• 下载完成批次模板：每行新增一次工厂完成事件。

导入按以下顺序进行：

1. 先按业务范围筛选，再选择所需模板及文件格式。只读导出与模板按当前筛选和排序输出，不仅是当前页或勾选行；明细仍为采购明细粒度。导出文件下载未演示。
2. 维护模板可回填工厂、产线/人数、首次确认交期、可出货日、延期原因和两类备注；来源交期、工厂完成、库存及状态不直接回填。普通维护空白格表示不修改，不是清空。完成批次模板每行登记一次完成数量、完成日期及备注。
3. 点击「导入表格」上传 CSV/XLSX（最多 10,000 数据行）。系统先按当前租户的采购单号 + SKU 匹配；多条时用明细序号、仓库、供应商消歧，仍不唯一则报错，不能擅自选一条。
4. 在「导入预检」核对文件总行数、将执行、无变化/空行、错误行与变更预览。预览最多显示 50 行，错误最多展示和导出前 500 条，总错误数按全文件统计；报告截断时修正后再预检。
5. 没有错误时按钮为「确认执行（…）」；存在有效行和错误行时为「执行有效行（…）」，确认只写有效行，错误行不会写入。没有可执行行则不能提交，不是所有错误都要求整份文件零错误才能执行。
6. 执行重新核验同一文件及当前记录；预检确认有效期 15 分钟，文件或目标记录变化应重新预检。核对完成提示中的成功更新、错误跳过、无变化/空行数，再回列表与操作记录核对。有效行落库异常会使本次事务回滚，不能把请求发出当成导入成功。

重复导入不能一概说“覆盖”或“自动去重”：普通维护相同值可无变化跳过；普通完成批次按同一文件指纹、来源行号和目标记录防重，改文件或换行号不能当作安全重试。39 列 WPS 兼容表按已有同日期、同数量批次的出现次数匹配跳过；只填数量或只填日期的批次不写入并提示，其余有效内容仍可能执行。实际回填优先使用当前模板；发现不确定结果先查看批次和操作记录。

导入需要生产进度写入及导入权限。上传预检、确认写入及错误报告下载均未演示；演示 API 拒绝业务 POST/PATCH/DELETE。

09 从采购单生成

前提是当前租户的采购订单已经落库，且账号有生产进度写入权限。点击工具栏「从采购单生成」，系统针对该租户已落库的采购订单生成或刷新执行记录，并提示本次涉及的采购单数、新增条数和更新条数；不是只处理当前筛选或勾选订单，也不是去外部服务重新拉取采购订单。操作未演示。

生成结果仍需人工核对：采购订单同步链路会建立/更新跟踪记录；手动生成复用同一幂等逻辑，不因再次点击就为同一来源明细新增一条。工厂人工字段、阶段和完成批次保留，不通过生成按钮填写进度。

采购单作废、来源明细删除或从完整来源明细中移除时，既有记录转为已关闭并保留历史；来源恢复后可重新激活。没有订单时先核对采购订单同步和当前租户，不要靠反复生成补造来源。请求失败或结果不明时先刷新核对来源与记录，再按明确错误排查，不盲目重复提交。

10 权限与状态边界

• 生产进度不等于货物已经发运或入库；发货与入库状态应在对应物流或订单流程中确认。
• 节点状态应以真实业务反馈和系统记录为准。
• 查看需要生产进度读取权限；主记录、阶段、完成批次、批量维护及「从采购单生成」使用生产进度写入权限。页面生成按钮的旧提示可能仍写“采购写入权限”，应按实际权限配置核对。
• 导出及下载模板需要读取和导出权限；导入预检与执行需要读取、写入和导入权限。没有写权限或来源已关闭时维护控件不可用，不应尝试绕过。
• 已关闭优先于其他状态；有效来源且采购量大于 0、累计完成量达到采购量时为已完成。尚未完成且已过有效交期为已延期；其余有完成量为生产中，无完成量但有交期为待生产，无完成量且无交期为待排产。阶段卡的“进行中/已完成”不会替代此计算，采购量为 0 也不会仅因 0=0 就判为已完成。
• 已完成记录不再按本页规则计延期，但不代表采购订单或到货状态也已完成。采购收货和入库是独立来源事实，可出货日期只是人工预计日期。

11 常见问题