> ## Documentation Index
> Fetch the complete documentation index at: https://docs.garmentflow.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# 物料表
> 款式据以制作的物料清单——以款式、以版本区分的面料与辅料明细，生产、采购、成本与就绪判读全都读取此清单。
[物料表](/zh-Hans/reference/glossary#bom-bill-of-materials)
是一[款式](/zh-Hans/reference/glossary#style)
的物料骨干：做出一件成衣所需的面料与辅料清单，以版本为单位保存——让款式得以演进，而每个较早的版本仍完整保留，
供当初依该版本下单的订单使用。
## 它是什么
物料表是**以款式、以版本区分**。单张物料表即款式物料清单的单一修订版本——上面每一条明细都是一件成衣所用到的
一项面料或一项辅料。表头承载该版本的标识与核准状态；明细承载物料本身。
每一条明细记下一项物料、它位于成衣上的部位、一件成衣会用掉多少、以及它从何而来。明细从
[面料主档](/zh-Hans/reference/glossary#fabric-master)
或
[辅料主档](/zh-Hans/reference/glossary#accessory-master)
挑出所用物料，让物料表、成本表，以及下游的采购单都指向同一条记录——而不是对同一项物料写出三份各自为政的自由文本描述。
物料表是"这件成衣由什么构成"的真实来源。[成本表](/zh-Hans/modules/cost-sheet)、采购单、就绪引擎与生产检查
都从这里读取。
## 为什么存在
成衣的生产始于一份已底定的物料清单。成本要知道哪些物料会进入每件成衣的成本构成；采购要知道要为哪个款式、向哪个供应商、
买哪些东西；生产要知道裁切、辅料仓与车缝线上各自会收到什么；就绪引擎要知道物料端是否已签核，才能判读哪些后续工作
已经没有阻挡。四方都读取物料表，所以物料表必须是大家都认可的同一份记录。
版本制让物料清单得以变更，而当初下单所依据的版本不会跟着走失。每一次修订都是同一款式上的新物料表版本——
换了供应商、替换了某种面料、加了一项辅料——而较早的版本仍可读取，供任何指向该版本的订单或成本表版本使用。
## 何时会用到
* **在开发期间**，随款式成形而捕捉所用的面料与辅料——物料表就是[成本表](/zh-Hans/modules/cost-sheet)
复制其物料明细的来源。
* **在采购开始时**，把物料清单签核，让系统可以据此产生草稿采购单。
* **再次下单或物料变更时**，创建新的版本、编辑清单、重新核准——较早的版本仍完整保留。
物料表挂在款式上——打开款式，前往**物料表**标签页。
## 依赖项
* 一个**款式**——每张物料表都属于一个款式。详见[款式模块指南](/zh-Hans/modules/styles)。
* 每条面料明细所对应的[面料主档](/zh-Hans/admin/master-catalogs#面料)记录，与每条辅料明细所对应的[辅料主档](/zh-Hans/admin/master-catalogs#辅料)记录。允许使用自由文本物料描述，
但没有关联到主档的明细无法解析到供应商，会被下游的采购单生成略过。
* **物料表写入权限**，给创建版本、编辑明细或核准的用户。读取对您租户内任何已登录的用户开放。
## 哪些东西依赖它
* 款式的**成本表**——成本表会以款式当前的物料表版本为对象执行**从物料表复制**，据以种入它的面料与辅料明细。
详见[成本表](/zh-Hans/modules/cost-sheet)与[构建成本表](/zh-Hans/modules/build-the-cost-sheet)。
* **草稿采购单**——已核准的物料表是平台据以为各供应商种入草稿
[采购单](/zh-Hans/reference/glossary#po-purchase-order)的依据。
每条采购单明细承载该物料表明细的物料、解析后的供应商、该订单对此明细所需的数量，以及核准时自关联的面料或辅料主档捕获的单价。
没有关联到主档的物料表明细没有价格来源，也不会捕获到任何单价。
* **就绪引擎**与生产管理预检——两者都把**已核准**视为开启物料端工作的闸门。
* 订单对物料表的
[文件版本](/zh-Hans/reference/glossary#artifact-version)
绑定——当某张订单的物料表版本被创建、被标记为当前版本、或被切换时，该订单的绑定会同步推进。详见
[物料表、成本表与文件版本](/zh-Hans/concepts/bom-cost-sheet-artifact-versions)。
## 字段
物料表的字段分为**表头**（标识、状态、审计）与**明细**（每一项物料）。表头由所有明细共用；明细承载物料本身。
### 表头——标识
* `版本`——此款式物料表的版本号。版本创建时由平台分配；第一个版本为 1，之后在同一款式（绑定订单时，在同一订单）
每创建一个新版本即加一。
* `款式`——上层款式。在版本创建时设定，之后不再编辑。
* `订单`——当物料表在订单上下文中创建时，所绑定的订单。当设定时，把此版本标记为当前版本会推进该订单对物料表的绑定。
选填；款式层级的物料表没有订单绑定。
### 表头——状态与审计
* `状态`——**草稿**或**已核准**。由平台在状态转换时设定；不可直接编辑。
* `核准者`、`核准时间`——版本被核准的用户与时间。在转为**已核准**时设定；若版本退回为**草稿**则清空。
* `创建时间`、`最后更新时间`——由平台设定。物料表标签页上会把`最后更新时间`标示为"更新日期"。
### 明细——标识与显示
每一条明细记录成衣上的一项物料。
* `说明`——这项物料是什么。**必填**，上限 300 字符。
* `规格`——自由文本规格备注。选填，上限 300 字符。
* `部位`——物料位于成衣上的部位（例如身片、领子、袖口）。选填，上限 100 字符。
* `状态`——明细上的自由文本状态备注（例如"已合格"、"待样品"）。选填，上限 50 字符。
* `采购需求`——明细上的自由文本采购备注。选填，上限 255 字符。
* `排序`——明细在此版本中的位置。拖曳重新排序会写入此字段。
### 明细——物料
* `类型`——**面料**或**辅料**。明细从对应的主档挑出所用物料；类型决定下游读取这条明细的方式——
只有面料与辅料明细才符合**从物料表复制**到成本表的条件。
* `面料`或`辅料`——明细所对应的物料主档。一条明细不能同时承载两者。供应商、交期、物料编号与默认单价皆来自此记录。
* `物料编号`——下游使用的物料代号。默认为主档的物料编号；当此款式以不同代号采购该物料时，可在明细上覆盖。
* `身体部位`——一个自由文本标示，指出此物料用在身体的哪个部位。选填。
* `明细配色`——明细层级结构化的配色清单，从款式的配色清单中挑选，让物料表明细与其所属的配色共用同一个标识。
每一条可覆盖物料编号、供应商与备注。
* `辅料颜色`——自由文本辅料颜色（副料颜色），设定于辅料明细上。
### 明细——数量与来源
* `单位`——`每件用量`所采用的计量单位（例如 yd、pc、m）。默认为 `PCS`。
* `每件用量`——一件成衣会用掉多少此物料。以件计，而非以订单计。成本表会把它复制为明细的每件用量。
* `供应商`——明细层级的供应商覆盖。当设定时，会优先于关联的面料或辅料主档上的默认供应商。
### 明细——核准时捕获的副本
在**核准**时，平台会把即时主档的标识副本写入明细，让已核准的版本即使主档之后变动也仍然有效：
* `说明（核准时捕获）`——核准当下，即时主档的说明。
* `供应商名称（核准时捕获）`——核准当下，即时主档的供应商名称。
* `分类（核准时捕获）`——核准当下，即时主档的分类。
* `交期（核准时捕获）`——核准当下，即时主档的交期。
* `物料编号（核准时捕获）`——若设有覆盖则为覆盖值；否则为核准当下即时主档的物料编号。
捕获仅在**核准**时执行。核准后再编辑主档，不会改变已捕获的副本——它们是物料表明细对"当初签核了什么"的记录。
### 明细——附件
* `明细图片`——针对明细上传的图片，可排序。
* `明细配色`——详见*明细——物料*。
某条辅料明细的核准轮——辅料在大货前被寄到厂商签核——位于
[辅料样品送样](/zh-Hans/reference/glossary#trim-submission)，
键到物料表明细所挑的同一份辅料主档。送样是辅料核准的审计轨迹；
它不挡下辅料采购单。详见[辅料样品送样](/zh-Hans/modules/trim-submissions)。
## 业务规则
1. **物料表版本是款式物料清单的一次修订。** 同一款式上的每个新版本，都从一张全新的物料表起算——表头加上自己的明细——
而较早的版本仍完整保留。新版本以**草稿**起算。
2. **版本可绑定到订单，也可保持在款式层级。** 当版本在
[订单](/zh-Hans/reference/glossary#order)
上下文中创建时，版本即绑定到该订单，且该订单对物料表的绑定会在版本被创建、被标记为当前版本、或被切换时同步推进。
无此上下文时，版本为款式层级。同一款式上两者可并存。
3. **明细不是面料就是辅料。** 每条明细从**面料**主档或**辅料**主档择一挑出物料，由明细的`类型`决定。
选择器会在行层级强制此选择，让明细只承载单一物料标识。
4. **核准依版本进行，并依其绑定的订单。** 因为每张绑定的订单各自保有对物料表的绑定，核准订单 A 的物料表版本
并不会同时核准订单 B 的版本，即使在同一款式主档上也一样。从款式层级核准则只是核准该版本，不会推进任何订单的绑定。
5. **核准会捕获明细快照。** 在**草稿 → 已核准**的转换上，每条明细会把即时主档的标识副本（说明、供应商名称、
分类、交期、物料编号）写入明细。只要版本还在，捕获的副本就会一直留在明细上；之后对主档的编辑不会更动它们。
6. **对已核准的版本再次核准是无作用，反之退回已是草稿的版本也是。** 对处于目标状态的版本再次执行该操作，
不会改变任何东西，也不会报告错误。
7. **把已核准的版本退回草稿，不会回溯下游已产生的影响。** 已从该已核准版本生成的草稿采购单仍保留。
首次核准所触发的订单阶段推进也仍保留。退回让您重新进入编辑模式并可再次核准；但不会回收先前核准已启动的东西。
8. **新的修订是新的版本，不是把旧版本再次核准。** 开新版本（会以**草稿**起算）并核准它。较早的版本仍可在历史中读取，
并且不再是当前的版本——不论是对整个款式而言，或对绑定该较早版本的订单而言。
9. **物料表的写入操作受权限管控。** 由具备物料表写入权限的用户创建版本、新增与编辑明细、重新排序、核准或退回。
读取对您租户内任何已登录的用户开放。
10. **没有关联到主档的面料或辅料明细无法解析到供应商。** 在物料表还在组稿时允许使用自由文本明细，但下游的
[采购单](/zh-Hans/reference/glossary#po-purchase-order)
生成会把没有可解析供应商的明细略过并报告为已跳过。
## 校验
| 时机 | 检查 | 失败时会发生什么 |
| -------- | -------------------------------------------------------------------------------- | -------------------------------- |
| 新增或编辑明细 | `说明`已填入且不超过 300 字符 | 保存被拒。 |
| 新增或编辑明细 | `规格` ≤ 300、`部位` ≤ 100、`状态` ≤ 50、`采购需求` ≤ 255、`物料编号` ≤ 100、`单位` ≤ 20、`辅料颜色` ≤ 500 | 哪个字段超过上限就在该字段上被拒。 |
| 新增或编辑明细 | `每件用量`为零或更大 | 保存被拒。 |
| 重新排序明细 | 重新排序的集合不引用任何未知明细 | 重新排序被拒，回应"重新排序清单引用未知的明细"。 |
| 重新排序明细 | 重新排序的集合恰好包含此版本上的每一条明细各一次 | 重新排序被拒，回应"重新排序清单必须恰好包含每一条明细各一次"。 |
| 依版本打开物料表 | 该版本属于此款式与租户，且有对应的表头 | 读取被拒，回应"找不到此版本的物料表"。 |
**没有**任何保存时校验会在核准之前检查物料表至少有一条明细、或每条明细都有供应商。强制执行"有明细"与
"有供应商"的把关位在下游——草稿采购单生成会报告它必须跳过的明细；当物料表尚未核准时，就绪引擎与预检默认不放行。
## 日期逻辑
物料表有一个具业务意义的日期：
* **`核准时间`**——版本被核准的当下。由平台在**草稿 → 已核准**转换时设定；若版本退回为**草稿**则清空。
就绪引擎与草稿采购单生成皆把**已核准**视为其前提，而非时间戳本身。
平台会记录两个审计时间戳：
* **`创建时间`**——版本被打开的时间。
* **`最后更新时间`**——版本最近一次被写入的时间。物料表标签页上会把它标示为"更新日期"。
物料表并无`目标`日期、`生效起始`日期或`有效期限`日期。业务上限制订单的日期住在[订单](/zh-Hans/modules/orders)上，
不在物料表上。
## 状态与转换
物料表版本有两种状态：**草稿**与**已核准**。
* **草稿**——版本可编辑。新增、编辑、重新排序、删除明细；挑选主档；设定数量与供应商。新版本从这里起算。
* **已核准**——版本已签核，作为已认证的物料清单可被读取。所有以**已核准**为闸门的下游消费者——草稿采购单生成、
就绪引擎、生产管理预检——皆解锁。
转换：
* （创建） → **草稿**：新的物料表版本永远以**草稿**打开。
* **草稿 → 已核准**：具备物料表核准权限的用户核准版本。平台会设定`核准者`与`核准时间`、捕获每条明细的主档快照
（详见业务规则 5）、记录核准事件，并且——当这是版本的首次核准且版本绑定到某张订单时——把
[订单阶段](/zh-Hans/concepts/order-lifecycle)从 **PO 已收**推进到**采购**。
* **已核准 → 草稿**：具备物料表核准权限的用户把版本退回为草稿。平台会清除`核准者`与`核准时间`并记录退回事件。
明细上已捕获的副本仍会留下；已产生的下游影响（草稿采购单、已推进的订单阶段）不会被回收。
在**已核准**的版本上编辑明细是允许的——平台与物料表标签页都不会挡下——但编辑不会重新捕获明细副本。
若要对即时主档重新捕获，请退回该版本再重新核准，或另开新版本、编辑后核准。
对已核准的版本再次核准是无作用，对已是草稿的版本再次退回也是无作用（业务规则 6）。
## 计算
物料表**不会产生每件总成本**——物料的成本构成在[成本表](/zh-Hans/modules/cost-sheet)上累计，
而成本表的面料与辅料明细就是从物料表复制过来，并在那里套用每条明细的成本。
物料表对下游消费者的贡献：
* **对成本表**，在**从物料表复制**时：每一条合格的物料表明细会种入一条成本明细——成本表会捕获该物料表明细的说明、
物料编号、部位、供应商、单位、每件用量与单位成本到成本明细上，供应商与单位成本取自关联的面料或辅料主档，
若主档不可用则改用物料表明细的核准时捕获副本。自此刻起，这条成本明细就是该物料在此成本表上的真实来源。详见
[成本表——变更的影响](/zh-Hans/modules/cost-sheet#变更的影响)。
* **对采购单生成**：已核准的物料表为各供应商种入一张草稿
[采购单](/zh-Hans/reference/glossary#po-purchase-order)。
每条采购单明细承载该物料表明细的物料、解析后的供应商、该订单对此明细所需的数量，以及核准时自关联的面料或辅料主档捕获的单价。
没有关联到主档的物料表明细没有价格来源，因此采购单明细上不会有捕获到的单价；无法解析到供应商的明细会被略过并报告为已跳过。
* **对就绪引擎与生产管理预检**：状态（是否**已核准**）即为闸门；两者皆不读取明细上的数值。
## 变更的影响
* **在草稿版本上编辑明细。** 变更会被保存。在版本被核准前，捕获副本维持为空。
* **在已核准版本上编辑明细。** 变更会保存到明细上，但捕获副本不会被重新捕获。版本仍是该已核准版本——
若要对即时主档重新捕获副本，请退回再重新核准，或另开新版本。
* **删除明细。** 该明细及其图片与配色项目会从版本中移除。
* **变更明细所指向的面料或辅料主档。** 物料表标签页上显示的即时供应商会立刻自新主档重新读取；捕获副本不会变动。
* **核准版本。** 每条明细写入即时主档的标识副本（详见业务规则 5）。所有以**已核准**为闸门的下游消费者皆解锁。
当这是版本的首次核准且版本绑定到某张订单时，该订单阶段会从 **PO 已收**推进到**采购**。
* **把版本退回为草稿。** `核准者`与`核准时间`会清除；捕获副本仍留在明细上；已产生的下游影响仍保留。
版本重新可编辑。
* **在草稿成本表上执行从物料表复制。** 每一条尚未关联到成本明细的面料或辅料物料表明细会种入一条新的成本明细，
捕获该物料表明细的说明、物料编号、部位、供应商、单位、每件用量与单位成本。从那一刻起，这条成本明细就是该物料
在此成本表上的真实来源。再次执行复制是安全的：已关联到某条物料表明细的明细会被保留不动。详见
[成本表](/zh-Hans/modules/cost-sheet#变更的影响)。
* **从已核准的物料表生成草稿采购单。** 物料表为各供应商种入一张或多张草稿采购单。
每条采购单明细承载该物料表明细的物料、解析后的供应商、该订单对此明细所需的数量，以及核准时自关联主档捕获的单价。
没有关联到主档的物料表明细上不会有捕获到的单价；无法解析到供应商的明细会被略过并报告为已跳过。
此订单先前已开立给同一供应商的采购单不会被重新生成。
* **开新版本。** 一个新的**草稿**版本会在款式上打开并成为当前版本；原本的当前版本不再是当前，但仍可读取。
* **把不同版本标记为当前。** 下游消费者会重新读取新当前版本的状态。当版本绑定到某张订单时，该订单的绑定会同步推进。
## 最佳实践
* **每条明细都关联一个面料或辅料主档。** 自由文本明细在您组稿时可用，但没有关联到主档的明细无法解析到供应商，
会从草稿采购单生成中被略过。请在核准前挑好主档。
* **`每件用量`要审慎设定。** 成本表会把它复制为每件用量，所以随手填的占位值会一路跟到计价环节。
* **只在这条明细确实向不同于主档默认供应商的对象采购时，才使用明细层级的`供应商`覆盖。** 否则就让主档的供应商
发挥作用——少一个可变动的环节。
* **物料清单完备时才核准。** 平台不会挡下不完整物料表的核准；核准只是捕获明细副本并开启下游闸门。请只捕获您
准备好为其背书的清单。
* **物料变更请另开新版本，而非编辑旧版本。** 平台允许在已核准的版本上编辑，但不会在编辑时重新捕获明细副本。
另开新版本能保持审计轨迹清楚。
* **在版本上一次性把明细排好顺序。** 您设定的顺序就是成本表、物料表标签页与下游消费者所显示的顺序。
## 相关页面
* [开发款式](/zh-Hans/modules/develop-a-style)
* [构建物料表](/zh-Hans/modules/build-the-bom)
* [成本表](/zh-Hans/modules/cost-sheet)
* [构建成本表](/zh-Hans/modules/build-the-cost-sheet)
* [物料表、成本表与文件版本](/zh-Hans/concepts/bom-cost-sheet-artifact-versions)
* [款式](/zh-Hans/modules/styles)
* [辅料样品送样](/zh-Hans/modules/trim-submissions)