第7章 供应链（采购）场景

采购是把货买进来的全过程：建供应商 → 开订单 → 走货运 → 入库 → 结算。本章按这个顺序讲。

入口：左侧菜单 供应链（供应链看板 / 供应商管理 / 供应商类别 / 供应链订单 / 供应链采购 / 装载测算 / 供应链结算）。

7.1 建立供应商档案与供应商类别

1. 供应链 → 供应商类别 → 新增类别；行内操作：管理供应商 / 编辑 / 删除。
   • 「管理供应商」弹窗里给类别分配供应商：支持搜索、仅看已选、全选 / 清空，勾好后保存。
2. 供应链 → 供应商管理 → 新增供应商，字段：名称、BP 码、国家、邮箱、电话、账期、备注。
3. 供应商行内操作：编辑 / SKU 映射 / 删除。
   • SKU 映射：维护「我方 SKU 编码 ↔ 供应商货号」的对应关系，下单和对账时不用人工翻译编码。

供应商类别便于筛选与管理；开供应链订单时按供应商选。账期字段影响应付跟踪。

完整保存供应商 SKU 映射

对照表按供应商分别维护，读取与修改受主账户及子账户的供应商可见范围和权限约束。窗口完整加载所有映射，展示已保存的我方 SKU 编码，表格支持每页 20、50 或 100 条。新增、改名和删除先暂存为草稿，保存统一应用所有分页的完整结果；清空已有映射须确认。每行须有唯一供应商货号及有效我方 SKU；失效 SKU 应修正或移除。

若同事先保存了修改，版本冲突会保留草稿并阻止覆盖。先记录需要保留的修改，再重新加载最新版本并编辑保存。只读 API Key 可经 HTTP 或 MCP 查询完整对照表，替换操作需写入权限及匹配版本。详见伙伴货号映射指南。

7.2 创建供应链订单

供应链 → 供应链订单 → 创建供应链订单。选择供应商并填写备注，确认后先保存草稿，再打开订单编辑页。随后在该订单中完成其余业务步骤：

采购价在第②步录入，是后续成本与结算的基准（见 2.7 快照：订单里的价格会被冻结）。「查看历史采购价」能直接对比该 SKU 历次进价，别凭记忆填价。

订单列表页的常用操作：

• 顶部：导出（当前筛选的全部已保存订单汇总，Excel 格式）、创建供应链订单。

订单表格按当前页查询，总条数表示全部匹配订单。修改筛选会清除上一范围的行；快速连续查询只接受最新结果，查询失败请调整条件或刷新重试。无效系统单号不会被忽略成全量查询；系统单号只接受正整数，可带 # 前缀。查看其他订单详情或进入出入库选单不会扩大当前分页范围。导出仍包含全部匹配订单。

系统单号筛选非空但无效时，导出会要求先纠正或清空，不会忽略单号后导出全部订单。导出覆盖全部匹配订单，不限于当前分页，也不会替换正在查看的列表。Orders 表包含系统单号、已保存的导入来源映射编号、供应商、状态、业务时间、商品金额、订单折扣、应付金额、单独记录的税额及备注；Export 表保留筛选范围和导出时间。金额按订单已保存值输出，货运单独核算，权限脱敏值仍为 *。原生订单没有导入映射时来源列留空；多个来源映射分行保留，长编号按文本存储。商品明细、货运明细、实际付款和附件须另行核对。切换筛选、账户或离开页面后，未完成的旧导出不会下载文件；读取不完整时也不保存部分文件。

• 筛选：按 订单号 / SKU / 供应商 / 状态 / 日期范围，配查询/重置/刷新。
• 行操作：商品清单（快速看该单 SKU 明细）/ 查看 / 编辑（状态 < 9 可编）/ 结算（状态 8 或 9 可进结算页）/ 修改状态（下拉按当前状态推进）。
• 展开行的货运信息：支持 复制 / 粘贴 / 保存 / 删除（多柜录入时复制一行改字段最快）；可查看快照（下单时刻的商品信息，见 2.7）；可查看订单附件文件。

编辑详情只显示当前订单的读取结果。快速换单、新建订单或关闭编辑页时，尚未完成的旧读取不会把上一单的商品、货运、付款或收货记录带入新表单；新建订单也不会携带上一单的附件字段。同一账户返回缓存页面时，已打开的订单保留尚未保存的表单输入，并重新读取付款和收货记录；首次详情尚未加载完成则重新加载。账户会话变化后，旧编辑页清空并返回列表。

一次保存商品与订单

订单编辑器的 保存 会把修改后的商品清单与订单字段一起保存；没有修改时不发送保存请求。只改备注或附件引用时保留原商品清单。商品金额、税额及应付由服务器计算，应付为商品金额＋订单折扣，货运费用另行核算。

提交审批 会同时保存当前商品及表单修改，再进入待审批；审批窗口确认时也保存当前修改和审批意见。保存期间暂时禁止编辑内容及重复提交。切换订单、关闭或离开页面后，旧结果不会改变新表单；已发出的请求仍可能在服务器完成，离页不等于撤销。

校验或数据库提交前失败会保留原订单和当前草稿，纠正后可再次保存。已收到保存成功响应但后续刷新失败时，修改仍已保存；超时或连接中断时先重新打开原订单核对实际状态，再决定是否重试。货运资料的失焦保存、文件存储、收货和付款各有独立操作。

打开订单会保留各行记录的币种、汇率及采购价格。审批锁定后的价格不会随汇率刷新改变；审批前主动调整币种或汇率时须重新核对报价。

订单附件

发票、合同和 Velox 附件按当前订单分别维护。上传期间同一附件字段不重复提交；成功后把文件加入该订单的表单清单。上传或移除后的附件引用仍需点击订单的 保存 才写入订单字段，文件存储操作和表单保存不是同一个事务。

删除确认固定选择的文件和订单。文件删除成功后才移除表单引用，失败保留清单供重试；等待时新增的其他文件会保留。换单、关闭或离开页面会关闭旧确认框，过期操作结果不会改变新表单。已发出的存储请求仍可能完成，不能把离开页面当作服务器撤销；返回原订单后应重新核对实际文件和保存的清单。

手机基础表单按单列展开，长文件名换行显示。文件名是可用键盘操作的按钮，删除按钮会标明具体文件。详情及列表附件窗口每次打开文件都重新获取临时地址；关闭窗口、换单、离页或账户会话变化后，未完成的旧地址不会再打开文件。

在控制台或通过 Agent 恢复采购草稿

控制台发送新草稿前，按当前主账户及成员保存创建标识和原始内容。响应丢失后，刷新供应链订单页仍会保留请求，并显示原供应商、备注和商品数量。先点击查找已创建订单；找到后，打开已创建订单会读取当前详情，不会把后续修改覆盖回原表单。匹配订单成功打开后，才清除本地恢复记录。

只有查询确认未创建时，才允许使用原内容继续创建，沿用同一标识及原始内容。查询失败不能直接另发一张新单。已创建订单后来被删除时，需明确移除本地恢复记录，再开始另一张草稿；浏览器无法保存原请求时会停止创建，请恢复存储访问并刷新后继续。

已连接的 Agent 可使用相同采购创建约定：先保存固定标识和完整请求，响应不确定时使用只读权限查询。重发相同原请求只返回同一订单与商品；不同内容不能复用标识，已删除订单不能用原标识重建。

恢复范围是草稿创建。货运、收货、付款、商品修改和迁移检查点各有独立操作；历史订单导入使用自己的来源编号。请求顺序和实时能力检查见 Agent 接入说明与可下载 Skill。

7.3 提交审批与审批处理

1. 草稿订单提交 → 状态变 待审批（1）。
2. 审批人（系统管理 → 待审批）通过或驳回。
3. 通过后状态 审批确定（2）；开单人「确认下单」→ 状态 已下单（3），正式发给供应商。

新订单先保存为草稿；未添加商品时可继续保留草稿。订单编辑器把当前商品、表单修改与提交审批放在一次保存中，货运信息另行保存。审批通过与驳回均要求主账户或拥有采购审批权限的子账户（见 4.5）。

审批确定后，供应商、商品 SKU、采购单价和订单价格字段锁定，不能退回草稿来改价。开始入库前仍可调整数量；已关联货运的商品须先调整货运清单再移除。草稿移除商品时会同步移除货运中的关联。首次实际入库后，数量和商品清单锁定；备注和附件仍可补充。有入库、发票、税票或核算记录的订单不能删除。

7.4 订单履约状态推进

已下单后，按实物进度推进状态。下面这张图是供应链订单的完整 10 态状态机——从草稿到结清：

st=>start: 0 申请
s1=>operation: 1 待审批
ap=>condition: 审批通过？
s2=>operation: 2 审批确定
s3=>operation: 3 已下单
s4=>operation: 4 已发货
s5=>operation: 5 已到港
s6=>operation: 6 已清关
s7=>operation: 7 转运中
s8=>inputoutput: 8 已入库
e=>end: 9 已结算
st->s1->ap
ap(yes)->s2->s3->s4->s5->s6->s7->s8->e
ap(no)->st

0/1/2 为申请、待审批与审批确定。通过审批后再确认下单；物流状态按流程推进，已到港可进入转运中。已入库（8）由实际完整收货产生，已分析核算（9）由成本核算操作产生，普通状态编辑不能直接设置这两个状态。

物流阶段通过订单列表的修改状态按流程推进；货运信息中的各节点时间用于跟踪到货和计算运输周期：

这些节点时间（船期、到港、清关、到仓）都在货运信息里维护，详见 7.5。

7.5 维护货运信息

一张供应链订单可以关联多个货运信息（一笔采购可能分多柜发运），每个货运信息有独立的物流、费用和商品分配。

1. 进入供应链订单 → 货运信息 → 新建。
2. 填写物流节点：

3. 把本柜的商品（订单商品行的快照）分配到该货运信息下。
4. 填写费用：海运费 (freight_cost)、拖柜/货代费 (delivery_cost) 等。

商品分配保存会在一次事务中把所选采购行移到目标货运，并从其他货运移除相同行；未选行不受影响。保存前比较打开窗口时的全部分柜和采购商品清单。失败保留原分柜及当前选择；若提示清单已变化，关闭分配窗口、重新打开订单，核对最新分柜后再操作。分柜不重放收货、不修改数量、运费或付款；成本核算后禁止变更。

货运字段在编辑后失焦保存。同一货运的保存按顺序执行，返回结果会保留表单里更新的输入，只提交发生变化的字段。清空可空日期、文本或附件引用会移除旧值；清空外币会移除外币金额及汇率，保留 CAD 费用。已核算的费用和汇率继续锁定，清空也不能绕过锁定。

保存或粘贴失败会保留可见草稿，可纠正后再次失焦重试。粘贴会复制货运资料和费用，须核对费用，避免重复计入。切换订单、离开编辑页或切换账户后，早先的货运请求不会修改新页面。已核算订单清空物流日期会同步时间线，不重新计算库存成本。

一个订单多柜时，每柜单独建货运信息、单独分配商品和费用——结算时各柜费用独立分摊。

7.6 装载测算

1. 供应链 → 装载测算。
2. 在参数卡里选箱型（集装箱规格）与可用容积，在商品行卡里加入要装的 SKU 与数量。
3. 点 测算，系统按各 SKU 的**体积（m³）**算出装载率，汇总卡显示能装多少、怎么装，并可关联到订单表。
4. 需要修正个别 SKU 体积时，用体积设置 / 结算 SKU 体积编辑临时覆盖（不改商品主数据）。

体积字段填得准，这里才算得准（见 6.3）。装载测算帮你在发货前预估装柜方案。

7.7 供应链看板与采购看板

• 供应链看板：查看在途订单、已入库量、待结算和各阶段时效，点击指标进入对应页面。
• 采购看板：从品牌墙选品，按各 SKU 的库存单位填写数量，为每一行选择供应商。在采购清单里检查供应商分组；浏览器清单按当前主账户及成员分别保存。
• 点击预览供应商草稿，检查分组后确认。每个供应商创建一张草稿，订单及商品行一起保存。打开已创建订单核对价格并完成审批，再处理货运、入库和付款。尚未填写价格的草稿不表示采购成本已经确认。
• 成功创建的分组从清单移除，失败分组保留。结果未知时停止后续分组，保留原请求；刷新后使用查找已创建订单。找到后打开对应草稿；只有明确查无结果时才能继续原创建。不要清除浏览器存储或换一个请求绕过未知结果。

创建采购草稿不会入库或记付款。旧版未记录账户归属的浏览器清单不会自动归入登录账户；需要按原始清单重新核对。

旧系统或表格中的采购计划可以通过自由导入交给 Agent。Agent 核对当前 MCP 指南后，可将未完成的采购意图整理为原生草稿。历史采购回放属于另一条迁移路径，可能影响库存，须先核对截止口径和来源记录。

7.8 到货入库（衔接仓库板块）

货到仓后，在 仓库 → 入库与出库 → 采购入库 选这张供应链订单，录数量、货架位、过期日。

• 可分多批入库：每次入一部分，全部入完订单才到「已入库(8)」。
• 入库后，该 SKU 在仓库生成实物库存（五维：SKU×仓库×过期日×供应链订单×货架位）。

详细操作见第 10 章仓库场景。

7.9 供应链结算

1. 订单列表 → 状态 8/9 的订单行点 结算，进入结算页。
2. 结算页顶部是关键节点时间线（下单→发货→到港→清关→入库），一眼看清履约全程。
3. 系统按各货运信息、各 SKU 的体积占比分摊运费（海运费 + 拖柜费等）到成本；个别 SKU 体积不准时可在结算页编辑 SKU 体积覆盖值（只影响本次分摊，不改商品主数据）。
4. 可查看快照核对下单时的商品与价格。
5. 所有采购商品行必须且只能分配到一条货运信息。计划一行分多柜时，须在审批前拆成独立采购行；空清单、重复分配或缺失体积会阻止核算。
6. 确认后，系统汇总同一 SKU 的采购金额与订单折扣、各柜分摊运费，再按原始采购数量计算加权单位成本。已售出或移库的数量不会改变分摊分母。订单状态变 已分析核算(9)。

采购应付金额为 商品金额＋订单折扣，货运费用单独记录；库存总成本包含分摊运费，税额单独登记。审批后调整数量时，系统同事务更新商品金额和采购应付金额。

详情的 Finance 页以同一口径显示应付和剩余应付，实际付款及收回的款项参与剩余金额核对；货运合计单独列出。成本 页的税前总成本包含货运，不能当作应付给供应商的商品金额。

核算会保存本次体积和成本快照，单位采购及货运成本保留六位小数。核算后，货运费用、汇率和商品分配不可修改，也不能新增或删除货运信息；物流时间、柜号和附件仍可补充。重复确认不会重复生成分析记录。历史已核算订单保留原记录，不按今天的商品体积自动重算。

结算 = 把采购成本（含分摊运费）确认清楚。这一步必须在销售结算之前完成（销售结算依赖上游供应链订单已结算，见 8.5、11.7）。

7.10 常见问题

本章小结

• 采购流程：建供应商 → 开订单(录采购价) → 审批 → 确认下单 → 走货运 → 入库 → 结算。
• 货运信息可多柜：每柜独立物流、费用、商品分配。
• 履约状态（已发货/到港/清关/转运中）按流程手动推进；节点时间用于履约记录与周期统计。
• 结算按体积分摊运费到成本，且必须先于销售结算完成。
• 未履约订单可编辑/作废；部分到货分批改入库。

下一章讲 销售场景。

了解相关产品功能：Supply chain