采购计划

01 功能介绍

采购计划用于跟踪从采购决策发布到领星采购计划落地的完整链路。先分清四种对象：

• 采购决策结果：是上游视图与快照下的决策数据，尚未发布时不在本页待创建工作区。

• 内部草稿批次：采购决策发布后固化商品、数量、供应商和日期；内部批次号不是领星计划号，状态为「待创建」也不表示已向外部提交。

• 领星采购计划：创建返回外部计划编号后，还要同步到本地事实并核验；创建批次号与单个计划编号需分别核对。

• 外部采购订单：属于计划后续的审批、下单链路。「创建到领星」创建的是采购计划，不是采购订单。

• 一条计划依次经过四个阶段：采购决策发布生成待创建批次，创建到领星，同步回写外部数据，核验确认事实一致。后续同步和核验可以由创建工作流自动推进，但必须观察实际终态；请求已接受或 HTTP 成功都不等于核验通过。

• 页面数据有两个来源：领星已创建的计划按创建批次分组展示；本地待创建批次在「待创建」页签单独处理，计划编号显示「待生成」。

• 「核验通过」只表示创建、同步及事实核查通过，不代表货物已经采购完成或到货。

02 查询与定位记录

进入「计划采购 → SCM → 采购计划」，先定位要处理的记录：

1. 选择平台，当前仅支持 Amazon。
2. 默认时间字段为创建时间，但日期范围是「全部时间」，未加日期限制。需要限定范围时，再选择时间字段和起止日期；不是默认只查最近一个月或 90 天。
3. 也可以按关键词搜索，支持计划编号、创建批次号、SKU、品名、供应商和仓库名称；输入后列表重新查询。
4. 点击「重置」恢复默认条件，点击「刷新」重新加载当前结果。

生效范围提醒：上述日期、关键词和外部状态条件用于已同步的领星计划。「待创建」另行读取内部批次，目前不应用日期和关键词条件，不能用搜索结果判断待创建批次已消失。页面上的国家(地区)、全部店铺、供应商、采购仓库、加急下拉目前没有连接列表查询参数；「更多筛选」也未接入，不能把它们当作已生效的业务范围筛选。按供应商定位请用关键词。

时间字段有三种口径，代表不同范围，不要混用：

• 创建时间：计划在领星的创建时间，默认口径。
• 预计到货时间：计划行的期望到货日期。
• 更新时间：计划最近一次外部更新时间，不是本次点击刷新的时间。

快捷日期以北京时间的业务日为准；显式选择起止日期时包含结束日。普通查询可用「全部时间」，但「同步领星」需要明确日期范围。「刷新」只重新读取本地记录，不拉取外部服务。

03 按状态页签分流

页面顶部的状态页签显示各状态的商品计划行数，不是批次数或采购件数。外部页签计数保留平台、关键词和日期范围，但不受当前所选状态限制；「待创建」单独统计内部未核验批次的商品行。「全部」列出已同步外部计划，不包含内部待创建批次。

点击页签即可按状态分流：

• 待创建：本地已发布但尚未核验通过的批次，包含尚未创建和已创建待同步/核验的情况，在独立工作区处理，见「处理待创建批次」。
• 待审批：已创建到领星、等待审批的计划。
• 待采购：已进入采购执行的计划；该页签同时包含「部分采购」——部分数量已下单、剩余数量仍在待采购。
• 已完成：外部计划返回的完成状态，不是本页根据数量自动判定；仍需核对关联采购单和数量，不代表已经到货。
• 已驳回：外部状态为驳回，应核对外部单据及原因；本页没有重新审批或直接改状态入口。
• 已作废：已作废的计划，按只读历史处理。

04 核对列表与详情

列表按创建批次分组，批次头显示创建批次号、创建人、创建时间、批次备注和批次计划采购量。单个批次超过 5 个商品时默认收起，点击「展开剩余」查看该批次本次查询命中的其他商品。

底部分别显示批次与商品总数，按批次分页，一页可以超过所选条数的商品行。外部批次用创建批次号分组，缺少批次号时回退到计划编号；一批可有多个计划，一计划又可有多条商品行。筛选后批次头数量及页内「总计」只是当前返回行的合计，不要当作所有分页或整批未筛选总量。

1. 在行内核对计划采购量、已采购量和待采购量；已采购量来自匹配该计划及商品的未删除采购订单明细，待采购量为计划采购量减已采购量并以 0 为下限。它们不等于到货量；订单未同步或关联不全时也需先排查来源。
2. 箱数由计划采购量除以有效单箱数量向上取整得出，不直接填写；单箱数量缺失或非正时不能据此推断实际装箱数。
3. 点击行内「详情」，打开计划详情。

列较多时可横向滚动；支持拖拽调整列宽，调整结果保存在本机。

详情按所点的计划编号加载，不是整个创建批次。顶部状态来自计划明细；同计划各行存在疑问时应进一步核对原始单据。

顶部固定显示「提交、审批、生成采购单」三个节点，缺少相关记录时可能回退显示创建人和创建时间，不能凭节点出现或时间相同认定审批、下单已经完成。内容分三个页签：

• 产品信息：核对 SKU、店铺、仓库、计划采购量、单箱数量、箱数、期望到货时间及备注。
• 关联单据：查看该计划生成的采购单及到货量、待到货量；存在关联采购单不代表已经到货。
• 操作记录：当前由本地计划事实和关联采购单构造创建、审核、生成采购单记录，不是完整领星审批审计流水。审批人、审批时间等关键证据还需到外部单据核对。

「关联单据」括号内数字按返回的订单明细行计数，不保证是去重后的采购单数。核对采购单号、SKU、供应商、预计到货日与到货/待到货数量后，再到采购跟单及生产跟踪继续跟进；关联单号文字不代表本页已提供可点击跳转。

05 处理待创建批次

采购决策发布后，计划先进入「待创建」页签，此时计划编号尚未生成。批次头显示本地批次号、来源视图、采购月与截止周；手工追加的批次显示当前视图和追加原因。

1. 切换到「待创建」页签，按批次号核对来源视图、快照、采购月/截止周及系统或手工来源。相同 SKU 可以有系统行与手工追加行，必须逐行核对数量和追加原因，不能仅按 SKU 合并去重。
2. 核对 SKU 非空、采购量为正、有效主供应商、期望到货日期及与最早下单日的先后关系。预检不通过的行计入批次受阻数；缺少主供应商、交货日期缺失或早于下单日等需先回采购决策及来源资料修正，按允许流程撤回/重新发布。本页不是编辑数量、供应商、日期的表单。
3. 有创建权限、没有处理中任务且存在无受阻的待创建/创建失败批次时，工具栏显示「创建到领星（N 个批次）」。执行前核对 N 与所有候选批次：它会收集当前租户符合条件的批次串行处理，不是只创建勾选行、当前页或关键词命中的行。确认来源及数量后才执行；本次创建未演示。

批次在工作区内可能显示以下状态；失败、结果未知不是每批必经阶段：

• 待创建 / 创建失败：可创建或撤回；「撤回并继续编辑」保留采购决策修改和手工追加，可编辑后重新发布。
• 已排队 / 正在创建：系统处理中，等待结果，不要重复操作。
• 创建结果待核对：创建请求结果未知；必须人工确认领星不存在对应计划，且系统没有已有计划标识或活动运行证据，才可能允许「核对后删除」。已存在外部计划时不能删除后重建。
• 已创建，待同步 / 等待同步 / 同步核验中：创建成功，系统自动排队同步与核验。
• 同步失败 / 核验未通过：通过操作菜单「重新同步」重试，不要重新创建。
• 已核验：从待创建集合移除。批量运行结束后，只有没有失败项且成功批次去向一致才自动切换对应页签；有失败或去向不同会留在当前工作区，需查看结果提示后自行定位。成功计划可短暂高亮，不是永久状态标记。

同一租户只允许一个活动批量创建运行，服务端还会锁定和领取批次；“已排队/正在创建”时不要再次提交。批量进度中的“成功”只统计已核验项，可能出现部分成功、部分失败，要逐个处理失败批次。

演示环境预置待创建、创建结果未知、同步失败、核验未通过和受阻批次。只有读取权限，创建、撤回、同步及重试均未演示；页面预置状态不代表本次执行结果。

06 创建、同步与核验

• 创建：在「待创建」页签执行，需要创建领星采购计划权限；创建是串行任务，中途不要重复发起。
• 同步：创建取得计划号后进入按计划号的定向同步；其他活动同步占用时显示等待同步。有创建权限时，页面还可能恢复未完成创建任务或继续等待中的定向同步，重新打开页面不是“从头创建”。筛选区的「同步领星」是另一个范围同步入口，需要同步权限、明确日期范围且不在待创建页签；它带平台、时间、状态条件，不带关键词，不能当作只同步搜索命中的一条记录。
• 核验：系统检查返回的计划号是否齐全、创建批次号是否一致，并按 SKU、供应商 ID、数量、预计到货日期核对行及重复次数，同时检查外部状态是否存在且可识别。仅合计数量相等也可能核验不通过；该核验不证明价格、质量或真实到货已确认。页面没有独立的人工「核验」按钮。

范围同步请求返回只表示任务已受理，页面随即刷新不保证后台已完成。应等待任务和事实更新后再核对；定向流程以「已核验」及实际计划去向为准。

核验通过不等于采购完成：审批、下单、到货在领星侧继续推进，本页按状态页签跟踪结果。

演示环境未执行真实的创建、同步与核验（演练接口不模拟这些动作），以上流程以页面实际状态和提示为准。

07 常见异常处理

• 创建失败：先读错误原因。外部明确拒绝，或系统能够证明请求未发出，才属于可修正后重试的失败；提示草稿失效或受阻时必须先回采购决策处理并重新发布。不要仅凭本地没有计划号就判断“可以安全重试”。
• 创建结果未知：调用异常、返回缺少计划号或创建中断超时都可能进入此状态。先按来源、批次、商品、数量和日期人工核对外部；若已存在计划，保留批次并交由负责人核对同步关联，不能直接重建。只有确认外部不存在且满足服务端安全限制时，才允许「核对后删除」；这不是撤销外部计划。
• 同步失败：外部计划可能已创建成功；先确认计划号、错误原因和服务状态，再由有创建权限的人员使用批次「操作 → 重新同步」。它重试定向同步及核验，不重新创建计划；缺少计划号时接口会拒绝，需人工核对。
• 核验未通过：检查计划号、批次号、SKU、供应商、数量、日期、缺失/多余行以及外部状态差异。查清并修正来源后再按允许流程重新同步；持续不一致不会靠盲目重试自动修复。当前工作区主要显示状态和提示，未提供完整核验差异明细面板，详细证据需由负责人结合运行记录排查。
• 长时间处理中 / 等待同步：先查看运行状态及外部单据，不要通过刷新或重复提交强行重建。活动运行不能撤回；等待同步可能因其他同步任务占用。
• 撤回/删除被拒绝：仅 draft、failed、create_unknown 状态可能允许；活动创建运行、批次或历史运行项已保存外部计划标识时仍会拒绝。状态看似可操作不等于绕过这些限制。
• 撤回成功但刷新失败：操作可能已经完成，按提示刷新待创建集合确认；不要把列表刷新错误当成撤回失败再次操作。

08 权限与状态边界

• 能查看计划列表，不代表具有创建或同步权限；读取、范围同步、创建、删除分别为 procurement_purchase_plan:read / sync / create / delete，操作还要求读取权限。发布属于采购决策发布权限，不是本页读取权限。
• 批次「重新同步」要求的是创建权限，与筛选栏「同步领星」使用的同步权限不同；受阻行或处理中也会限制操作。入口不可用或显示「无操作权限」时，先核对权限和批次状态。
• 本页没有直接审批、生成采购订单、导入或导出计划文件的可执行入口；不要把表头勾选、行内占位操作或详情节点当作这些能力。
• 发布内部计划不等于外部采购单已创建成功。
• 「核验通过」表示创建、同步及事实核查通过，不代表货物已经采购完成或到货。
• 结果未知时不要重复创建，应先核验外部状态。
• 创建结果未知的批次，删除不会撤销领星已生成的数据，必须先人工核对。

09 常见问题