采购订单

01 功能介绍：先分清计划、订单和履约

采购订单入口是「计划采购 → SRM → 采购订单」。它查询当前租户从领星同步到 Tower 的采购单与明细，用于定位单据、检查来源状态并交接跟单。它不是在 Tower 创建、审批或修改领星订单的工作台。

• 内部采购计划：采购决策发布后的内部批次与计划行，需在采购计划继续处理外部创建、同步与核验。内部批次号不等于领星计划号，更不等于采购单号。
• 外部采购单：领星采购订单是本页同步来源。主单按租户、来源系统与采购单号区分，列表一行是一张主单；不是一个 SKU 一行。创建领星采购计划不代表已经生成采购订单。
• 催货/生产进度：来自业务视图下所选 Supplier Plan 结果运行的任务，按 Local SKU、关联 PO 记录人工协调结果，详见独立催货说明。
• 生产跟踪：按采购单明细追踪来源信息、人工生产阶段与工厂完成批次，详见生产跟踪。

订单同步会更新订单当前记录及生产跟踪的采购来源信息；不会替跟单人员完成 PO 协调或登记工厂完成批次。订单状态、承诺交期、实物收货与入库必须分别核实。

02 开始前：确认租户、来源与读取范围

本页读取本地已同步的领星当前记录，不会在打开列表或详情时即时拉取领星订单。先确认账号所在租户、采购单号及要核查的是外部更新时间还是业务预计到货日。

主单明细按「租户＋采购单号＋来源明细ID」区分；相同 SKU 可以有多条明细，不能按 SKU 自行去重。来源缺少明细ID时同步会使用数组序号，跨次定位应结合单号、商品与实际来源核查。

本篇新增截图来自真实前端和本机只读内存 Mock。样例有部分到货、全部到货、真实零量、缺失字段以及预置同步失败；所有写入、审批、外部同步均未演示。保留的催货历史插图仅说明界面与填写位置，不作为本次保存成功证据。

03 查询定位：先选日期，再找采购单

前提是账号具有采购订单查看权限，且当前租户已有同步数据。按以下顺序查询：

1. 在「时间维度」选择更新时间、创建时间或预计到货。首次打开和「重置」默认按更新时间查询最近 7×24 小时，时间值来自浏览器本地时钟；它不是本次点击刷新的时间。
2. 点击日期范围，可选今天、昨天、最近7天、最近30天、本月、上月、本年、去年；或在双月日历依次点起止日。快捷范围和手选范围按日提交开始、结束边界；与首次打开的滚动七天起点不完全相同。
3. 在「到货状态」选未到货、部分到货或全部到货；在「付款状态」选未申请、已申请、部分付款或已付清，点击下拉内「确定」生效。
4. 按供应商、采购仓库筛选。下拉候选由当前页生成，不是完整基础资料；无匹配候选时可输入名称文本确认。已选条件会保留，必要时先选「全部」再输入另一名称。
5. 用字段搜索选择采购单号、物流单号、计划编号、1688订单号、单据备注或品名，再输入关键词。文本是包含匹配，不要求完整单号；切换搜索字段会清掉上一个字段的文本，其他筛选仍保留。

「计划编号」检索的是外部主单的自定义编号字段，不承诺等于 Tower 内部批次或明细关联的采购计划号。品名检索订单明细中的来源品名，不是 MSKU、ASIN 或专门的 SKU 检索。

预计到货按任一明细的预计到货日匹配；品名和物流单号也通过子项匹配主单。一张单有多条命中明细仍只计一单，打开详情仍返回该单明细，不会只显示命中的商品。多种子项条件可以命中同一订单的不同明细。

列表每页固定50条，「共X条」是完整筛选后的订单头数量。默认按来源更新时间优先、再按采购单号倒序；页面没有列排序入口。修改普通筛选不会自动回第一页，在后续页查不到结果时点页码「1」；「重置」恢复默认查询与第一页。

更多筛选和暂未接入项

「更多筛选 → 总采购金额」支持金额上下界或等值。界面符号虽为“大于/小于”，实际查询分别包含等于边界；它比较主单采购金额原始数值，没有币种折算。输入会触发查询，「搜索」收起面板；「取消」也只是关闭面板，不撤销已输入条件。

国家(地区)、店铺、加急、计划批次号、跟单记录、其余更多筛选以及筛选条件配置会提示暂未接入，不能作为已生效条件。「待提交、待下单、待到货、已完成、已作废」页签也未接入精确状态参数；「待到货」旁数字仅按当前页待到货量大于零的订单计数，不是全库该状态总数。

日期边界还需注意：前端提交不带时区的本地时间文本，后端按 UTC 解析；页面日期显示则使用浏览器时区。跨日或跨时区对账先扩大范围并请数据负责人核对源时间，不宣称本页已统一按北京时间结算。

04 阅读订单：数量、金额和状态分别核对

列表包含采购单号、采购状态、供应商、采购仓库、采购员、采购产品预览、四类金额、采购量/到货量/待到货量、付款状态与创建时间。列较多时横向滚动，不要把未滚到的列误判为缺失。

三个派生金额如何得到

每条明细先依次取实际采购量、计划数量、收货量中第一个非空值作为计算基数，全部缺失时为0；真实0不会跳过。基数大于0时，行单价取“行金额÷基数”，行金额为空才用“来源单价×基数”，仍缺失则用0；基数不大于0时取来源单价，缺失用0。

然后逐明细相加：到货金额为行单价×收货量；待到货金额为行单价×不小于0的“基数－收货量”；退款金额为行单价×退货量。缺失收货量、退货量在该计算中按0处理。无明细也返回这三个金额为0，所以看到金额0不能独立证明业务没有发生。

行金额显示来源货币符号并保留两位小数，符号缺失时界面默认“¥”，不能反推真实币种一定是人民币。本页没有汇率折算。底部「本页合计」仅加总当前50条内的已加载行，缺失值不参与数值累加，金额统一使用首行符号；混合币种或计量单位时不能把它当作同口径经营总额，也不是全部筛选结果合计。

商品预览最多显示前三条有效明细，旁边“+N”代表剩余条目。无图不等于无商品；数量角标依次取明细实际、计划、收货数量。预览品名/图片可以用同租户、同 SKU 的最新未删除 Amazon 本地产品资料补足，详情品名仍读订单明细，二者可能不同；不表示已经建立跨店铺唯一商品关系。

05 查看详情：按采购单核对商品和物流

1. 先在列表核对采购单号与供应商。横向滚动至「操作」，点击行尾「详情」（辅助名称为「查看详情」）。
2. 等待「采购单明细」抽屉加载。主单摘要只有采购单号、供应商、仓库和状态；「子项明细」显示 SKU、品名与采购量；「物流信息」显示物流公司与物流单号。
3. 逐项检查商品身份与数量。同 SKU 的不同来源明细可能分行；子项采购量取 quantity_real，缺失显示“-”，不会沿用预览的计划数量兜底。详情不是按来源明细ID以外的商品关系聚合的汇总表。
4. 查看后关闭抽屉，回到原筛选列表。页面没有详情编辑、商品映射修复、审批或导出按钮。

预计到货、单价、币种代码、计划关联等即使存在于后端合同，当前抽屉也不展示。要核对工厂确认交期，转到生产跟踪的采购单明细；商品资料异常转交本地产品责任人核对 SKU，不能在本页补映射。

「当前采购单没有子项数据」「当前采购单没有物流数据」表示当前读取的子集为空，不是已证明无需交货或没有发运。详情返回404或503时可能显示「暂无详情」，同时检查页面错误提示；先关闭抽屉再查，不把请求失败当业务空单。同步会替换该单当前明细和物流子集，来源数组为空可能清掉旧子集，页面没有子项历史版本恢复入口。

06 同步采购订单：核对任务终态再查目标单

本节写操作未演示。Mock 拒绝发起同步，截图仅展示预置任务状态。真实环境需同时具有采购订单查看与同步权限。

1. 先看右上角徽标。显示「同步中」时等待并使用「刷新」重读状态；按钮不一定因已有后台任务置灰，避免重复点击。
2. 核对当前选择的时间维度，再点击「同步」。页面只沿用这个时间字段，自动取发起时刻的前一年至后一年作为同步窗口；不会沿用列表选中的起止日期、订单号、供应商、金额或其他条件。因此搜索一张单再点同步，不是单单同步。
3. 接受请求只代表任务已创建。页面对待处理/执行中任务约每4秒读取一次状态，没有百分比、逐页进度条或完整任务历史面板。
4. 在同一页面观察任务结束提示。成功时显示「同步完成」与本次来源条数、新增/更新条数，然后重新读取列表与最近任务；失败时按错误提示处理，仍要重新查询目标单核对。
5. 用采购单号、明细和来源状态逐项复核。来源返回0条也可能得到成功终态，不能据此断言所有预期订单均已同步。

重新打开页面时，已结束任务通常只显示终态徽标。计数摘要和具体失败文本并非固定展示区，不能保证重开后仍能看到上次提示。需要任务窗口、任务ID、来源请求ID和错误详情时，交由有权限的数据负责人核查对应任务；页面没有任务历史下载入口。

每租户最多一个待处理/执行中任务，重复发起会被后端拒绝。超过180分钟的活动任务在相关状态查询或创建检查时可标记超时失败；这不等于页面能取消后台工作，不要直接反复重试。失败也可能来自本地生产来源投影校验，而不是领星请求本身。

“新增”按本地订单唯一键之前是否存在计数，“更新”按命中既有订单计数，不是实际字段发生变化的订单数。本次同步未返回的旧订单不会因此删除；数据是当前记录，没有本页可切换的历史快照。

07 选择业务视图与结果运行

进入「计划采购 → SRM → 催货/生产进度」，先选对数据口径，再定位记录：

1. 选择业务视图，下拉只列出启用中的视图。
2. 选择结果运行，下拉只列出已成功的 Supplier Plan 运行，按周标记，同周可有多个运行，周名不是唯一版本。
3. 页面加载该运行的催货任务，在右下角核对生成时间与窗口范围，确认是本轮要处理的数据。

定位待跟进记录时：

1. 按供应商代号、店铺、国家、产品等级、销量等级、利润等级或状态组合筛选。
2. 或用字段搜索，按 Local SKU、MSKU、PO 摘要关键词定位。
3. 核对任务总数和状态。筛选按整个Local SKU父任务生效，保留其其他MSKU/SID和PO，不是只剩命中子项。具体数量和运行边界见催货独立文章。

08 跟进 PO 协调

1. 在任务行点击「PO 跟进」，逐条核对 PO 单号、供应商、数量、到货日期和当前状态。
2. 与供应商确认后，填写实际协调数量、确认交货日期和本次备注。
3. 点击行尾对应的状态按钮提交，等待页面「已更新」提示。
4. 重新核对任务状态与备注历史，确认结果已经保存。

提交时遵守以下规则：

• 标记成功必须填写大于 0 的实际协调数量和确认交货日期，缺任一项会被页面拦下并提示；只填备注不能替代这两项。
• 标记失败用于确认无法协调的 PO，不保留确认交货日期。
• 打开「PO 跟进」也需要查看及维护权限；输入框与按钮不可用时先核对权限和页面状态，不因选中历史运行就推定已冻结或可写。

旧演示图示例为18件、9月22日交货，用于解释字段与状态。本次协调保存未演示，图中预置成功不证明本次执行过保存；真实操作仍需检查更新提示、任务状态及备注。

协调成功不代表货物已经到货。 确认交货日期是本次协调的承诺日期，实际到货、入库及物流进度应在对应流程中继续核实。

09 阅读任务状态与备注历史

任务状态有三种，逐项阅读：

• 待处理：任务自身仍待处理，PO尚未全部成功或全部失败；部分提交时显示「x/y 成功」。
• 成功：任务级已成功，或任务仍待处理但全部PO成功。
• 失败：任务级已失败（如批量打叉），或任务仍待处理但全部PO失败。

任务自身的非待处理状态优先于PO汇总。任务失败与其中一个PO成功可以同时存在。仅在任务仍待处理时按PO汇总，混合成功/失败仍属待处理，不能只看任务行判断单个PO。

每次提交只要填写了备注，就会记入该 PO 的历史备注，最新一条排在最前；历史保留当时的状态与确认交货日期，用于追溯每次协调的口径变化。每个PO当前读取最近10条，不能当作完整审计历史；按结果运行、任务与PO定位，不承诺跨运行继承。

10 批量打叉与导出

• 勾选任务后页面底部出现批量操作栏，点击「批量打叉」将所选任务批量标记为失败，写的是任务级失败，不删除订单或标记全局排除；页面没有直接撤销任务级失败的入口，后续单个PO成功不覆盖它；点击「清空选择」退出批量模式。
• 点击「导出」下载当前结果运行下的催货任务表格，导出需要单独的导出权限。请求只带业务视图与结果运行，不带本地搜索、状态筛选或勾选项；不是当前可见行导出，导出字段与主表PO派生状态/数量还需分别核对。

上述催货写操作和导出均未演示。它们不是采购订单页面的批量维护或导出能力。

11 生产跟踪与延期交接

订单同步会按采购单明细刷新生产跟踪中的采购单号、SKU/品名、来源创建时间、采购状态、到货状态、工厂确认交期以及收货/入库来源数量。采购单创建时间缺失保持空值；明细预计到货投影为工厂确认交期，不能替代人工计划交货时间。

工厂完成数量来自完成批次或已有人工记录，订单来源状态不会直接生成生产完成事实。采购计划期望到货关联要求来源计划号、SKU和产品身份匹配且唯一，不把同名商品视为必然关联。

发现延期或数量差异时：

1. 在采购订单定位单号，核对明细SKU、来源状态与当前查询范围。
2. 在催货/生产进度选择责任视图与结果运行，核对是否存在对应PO及人工协调记录。订单更新不等于该运行的催货任务已重新生成，也不保证当前快照立刻追加新订单。
3. 在生产跟踪按采购单与SKU继续核对来源交期、计划交期和工厂完成批次；需要实物收货/入库证据时交给仓库或库存业务责任人查对应单据。
4. 交接单号、SKU、原交期、新承诺日期、数量差异、原因与跟进人。分析和交接不等于责任页面业务动作完成。

本次未执行协调、生产阶段维护、收货或入库写操作。

12 权限与状态边界

• 采购订单列表、详情和任务状态读取需要采购订单查看权限；发起同步同时需要查看与同步权限。只有查看权限时列表可读，「同步」禁用。
• 「创建采购单」「导入采购单」「加急」「采购单看板」「产品」为禁用入口；「打印」「更多」仅提示未接入。「单据」为当前视图，不代表可切换其他已实现工作台。行勾选没有已接入的批量写入动作。
• 页面没有订单编辑、删除、审批、收货确认、入库确认或可用导出。不能从其他页面的权限或能力推导本页支持。
• 采购状态、付款/到货来源状态与 pending/syncing/success/failed 同步任务状态各有对象；催货任务和工厂生产状态又是独立链路。
• 「刷新」重新读取本地列表和最近任务状态，不向领星发起新订单同步；「重置」恢复筛选，不清理订单。原有后台任务若正在运行仍会继续。
• 真实后端的任务状态读取可能将超时活动任务标记失败；演示完全走本机内存Mock，不访问真实后端。所有真实业务写操作均未演示。

13 常见异常：先区分查询、同步和来源问题

• 列表为空但源端有单：先查租户、时间字段及范围，清除到货/付款/金额条件，回到第1页；确认该单在成功同步窗口内。不要因空表立即重复同步。
• 显示0与“-”：主单数量、金额缺失显示“-”；真实0显示0或0.00。但三个派生金额可能因无明细或输入缺失按0计算，需结合详情，不能统一解读为真实零业务。
• 错误横幅与空表同时出现：加载失败会清空列表，优先处理错误而非认定没有订单。401先重新登录，403核对租户与权限；503交由数据负责人检查来源准备状态，不自行执行数据库初始化或迁移。
• 订单可查但「同步失败」：读取与最近同步任务是两回事，旧记录或已成功分页仍可能存在。提交单号、时间字段、实际窗口与错误截图，请负责人区分源请求失败、超时或生产来源投影校验失败。
• 只查到部分商品或预览/详情不一致：先看“+N”并打开详情；预览仅有效明细且最多三条，详情不按同一预览过滤规则裁剪。品名/图片兜底也可能造成展示差别。
• 同步完成但看不到计数：重开页面的终态徽标不保留上次操作提示。请负责人查任务记录，再以目标单与明细核对，不根据徽标推断全部来源覆盖。
• 点击打印、更多或其他筛选无结果：若提示「暂未接入」，停止按该控件推断能力。采购订单当前没有可用导出；催货和生产跟踪的导出是各自页面能力，不是采购订单导出。

14 常见问题