> ## 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-Hant/reference/glossary#bom-bill-of-materials)
是一[款式](/zh-Hant/reference/glossary#style)
的物料骨幹：做出一件成衣所需的布料與輔料清單，以版本為單位保存——讓款式得以演進，而每個較早的版本仍完整保留，
供當初依該版本下單的訂單使用。
## 它是什麼
物料表是**以款式、以版本區分**。單一張物料表即款式物料清單的單一修訂版本——上面每一條明細都是一件成衣所用到的
一項布料或一項輔料。表頭承載該版本的識別與核准狀態；明細承載物料本身。
每一條明細記下一項物料、它位於成衣上的部位、一件成衣會用掉多少、以及它從何而來。明細從
[布料主檔](/zh-Hant/reference/glossary#fabric-master)
或
[輔料主檔](/zh-Hant/reference/glossary#accessory-master)
挑出所用物料，讓物料表、成本表，以及下游的採購單都指向同一筆紀錄——而不是對同一項物料寫出三份各自為政的自由文字描述。
物料表是「這件成衣由什麼構成」的真實來源。[成本表](/zh-Hant/modules/cost-sheet)、採購單、就緒引擎與生產檢查
都從這裡讀取。
## 為什麼存在
成衣的生產始於一份已底定的物料清單。成本要知道哪些物料會進入每件成衣的成本構成；採購要知道要為哪個款式、向哪個供應商、
買哪些東西；生產要知道裁切、輔料倉與車縫線上各自會收到什麼；就緒引擎要知道物料端是否已簽核，才能判讀哪些後續工作
已經沒有阻擋。四方都讀取物料表，所以物料表必須是大家都認可的同一份紀錄。
版本制讓物料清單得以變更，而當初下單所依據的版本不會跟著走失。每一次修訂都是同一款式上的新物料表版本——
換了供應商、替換了某種布料、加了一項輔料——而較早的版本仍可讀取，供任何指向該版本的訂單或成本表版本使用。
## 何時會用到
* **在開發期間**，隨款式成形而捕捉所用的布料與輔料——物料表就是[成本表](/zh-Hant/modules/cost-sheet)
複製其物料明細的來源。
* **在採購開始時**，把物料清單簽核，讓系統可以據此產生草稿採購單。
* **再次下單或物料變更時**，建立新的版本、編輯清單、重新核准——較早的版本仍完整保留。
物料表掛在款式上——開啟款式，前往**物料表**頁籤。
## 依賴項
* 一個**款式**——每張物料表都屬於一個款式。詳見[款式模組指南](/zh-Hant/modules/styles)。
* 每條布料明細所對應的[布料主檔](/zh-Hant/admin/master-catalogs#布料)紀錄，與每條輔料明細所對應的[輔料主檔](/zh-Hant/admin/master-catalogs#輔料)紀錄。允許使用自由文字物料描述，
但沒有連結到主檔的明細無法解析到供應商，會被下游的採購單生成略過。
* **物料表寫入權限**，給建立版本、編輯明細或核准的使用者。讀取對您租戶內任何已登入的使用者開放。
## 哪些東西依賴它
* 款式的**成本表**——成本表會以款式目前的物料表版本為對象執行**從物料表複製**，據以種入它的布料與輔料明細。
詳見[成本表](/zh-Hant/modules/cost-sheet)與[建立成本表](/zh-Hant/modules/build-the-cost-sheet)。
* **草稿採購單**——已核准的物料表是平台據以為各供應商種入草稿
[採購單](/zh-Hant/reference/glossary#po-purchase-order)的依據。
每條採購單明細承載該物料表明細的物料、解析後的供應商、該訂單對此明細所需的數量，以及核准時自連結的布料或輔料主檔擷取的單價。
沒有連結到主檔的物料表明細沒有價格來源，也不會擷取到任何單價。
* **就緒引擎**與生產管理預檢——兩者都把**已核准**視為開啟物料端工作的閘門。
* 訂單對物料表的
[文件版本](/zh-Hant/reference/glossary#artifact-version)
綁定——當某張訂單的物料表版本被建立、被標記為目前版本、或被切換時，該訂單的綁定會同步推進。詳見
[物料表、成本表與文件版本](/zh-Hant/concepts/bom-cost-sheet-artifact-versions)。
## 欄位
物料表的欄位分為**表頭**（識別、狀態、稽核）與**明細**（每一項物料）。表頭由所有明細共用；明細承載物料本身。
### 表頭——識別
* `版本`——此款式物料表的版本號。版本建立時由平台指派；第一個版本為 1，之後在同一款式（綁定訂單時，在同一訂單）
每建立一個新版本即加一。
* `款式`——上層款式。在版本建立時設定，之後不再編輯。
* `訂單`——當物料表在訂單脈絡下建立時，所綁定的訂單。當設定時，把此版本標記為目前版本會推進該訂單對物料表的綁定。
選填；款式層級的物料表沒有訂單綁定。
### 表頭——狀態與稽核
* `狀態`——**草稿**或**已核准**。由平台在狀態轉換時設定；不可直接編輯。
* `核准者`、`核准時間`——版本被核准的使用者與時間。在轉為**已核准**時設定；若版本退回為**草稿**則清空。
* `建立時間`、`最後更新時間`——由平台設定。物料表頁籤上會把`最後更新時間`標示為「更新日期」。
### 明細——識別與顯示
每一條明細記錄成衣上的一項物料。
* `說明`——這項物料是什麼。**必填**，上限 300 字元。
* `規格`——自由文字規格備註。選填，上限 300 字元。
* `部位`——物料位於成衣上的部位（例如身片、領子、袖口）。選填，上限 100 字元。
* `狀態`——明細上的自由文字狀態備註（例如「已合格」、「待樣品」）。選填，上限 50 字元。
* `採購需求`——明細上的自由文字採購備註。選填，上限 255 字元。
* `排序`——明細在此版本中的位置。拖曳重新排序會寫入此欄。
### 明細——物料
* `類型`——**布料**或**輔料**。明細從對應的主檔挑出所用物料；類型決定下游讀取這條明細的方式——
只有布料與輔料明細才符合**從物料表複製**到成本表的條件。
* `布料`或`輔料`——明細所對應的物料主檔。一條明細不能同時承載兩者。供應商、交期、物料編號與預設單價皆來自此紀錄。
* `物料編號`——下游使用的物料代號。預設為主檔的物料編號；當此款式以不同代號採購該物料時，可在明細上覆寫。
* `身體部位`——一個自由文字標示，指出此物料用在身體的哪個部位。選填。
* `明細配色`——明細層級結構化的配色清單，從款式的配色清單中挑選，讓物料表明細與其所屬的配色共用同一個識別。
每一筆可覆寫物料編號、供應商與備註。
* `副料顏色`——自由文字輔料顏色（副料顏色），設定於輔料明細上。
### 明細——數量與來源
* `單位`——`每件用量`所採用的計量單位（例如 yd、pc、m）。預設為 `PCS`。
* `每件用量`——一件成衣會用掉多少此物料。以件計，而非以訂單計。成本表會把它複製為明細的每件用量。
* `供應商`——明細層級的供應商覆寫。當設定時，會優先於連結的布料或輔料主檔上的預設供應商。
### 明細——核准時擷取的副本
在**核准**時，平台會把即時主檔的識別副本寫入明細，讓已核准的版本即使主檔之後變動也仍然有效：
* `說明（核准時擷取）`——核准當下，即時主檔的說明。
* `供應商名稱（核准時擷取）`——核准當下，即時主檔的供應商名稱。
* `分類（核准時擷取）`——核准當下，即時主檔的分類。
* `交期（核准時擷取）`——核准當下，即時主檔的交期。
* `物料編號（核准時擷取）`——若設有覆寫則為覆寫值；否則為核准當下即時主檔的物料編號。
擷取僅在**核准**時執行。核准後再編輯主檔，不會改變已擷取的副本——它們是物料表明細對「當初簽核了什麼」的紀錄。
### 明細——附件
* `明細圖片`——針對明細上傳的圖片，可排序。
* `明細配色`——詳見*明細——物料*。
某條輔料明細的核准輪——輔料在大貨前被寄到廠商簽核——位於
[輔料樣品送樣](/zh-Hant/reference/glossary#trim-submission),
鍵到物料表明細所挑的同一份輔料主檔。送樣是輔料核准的稽核軌跡;
它不擋下輔料採購單。詳見[輔料樣品送樣](/zh-Hant/modules/trim-submissions)。
## 業務規則
1. **物料表版本是款式物料清單的一次修訂。** 同一款式上的每個新版本，都從一張全新的物料表起算——表頭加上自己的明細——
而較早的版本仍完整保留。新版本以**草稿**起算。
2. **版本可綁定到訂單，也可保持在款式層級。** 當版本在
[訂單](/zh-Hant/reference/glossary#order)
脈絡下建立時，版本即綁定到該訂單，且該訂單對物料表的綁定會在版本被建立、被標記為目前版本、或被切換時同步推進。
無此脈絡時，版本為款式層級。同一款式上兩者可並存。
3. **明細不是布料就是輔料。** 每條明細從**布料**主檔或**輔料**主檔擇一挑出物料，由明細的`類型`決定。
選擇器會在列層級強制此選擇，讓明細只承載單一物料識別。
4. **核准依版本進行，並依其綁定的訂單。** 因為每張綁定的訂單各自保有對物料表的綁定，核准訂單 A 的物料表版本
並不會同時核准訂單 B 的版本，即使在同一款式主檔上也一樣。從款式層級核准則只是核准該版本，不會推進任何訂單的綁定。
5. **核准會擷取明細快照。** 在**草稿 → 已核准**的轉換上，每條明細會把即時主檔的識別副本（說明、供應商名稱、
分類、交期、物料編號）寫入明細。只要版本還在，擷取的副本就會一直留在明細上；之後對主檔的編輯不會更動它們。
6. **對已核准的版本再次核准是無作用，反之退回已是草稿的版本也是。** 對處於目標狀態的版本再次執行該動作，
不會改變任何東西，也不會回報錯誤。
7. **把已核准的版本退回草稿，不會回溯下游已產生的影響。** 已從該已核准版本生成的草稿採購單仍保留。
首次核准所觸發的訂單階段推進也仍保留。退回讓您重新進入編輯模式並可再次核准；但不會回收先前核准已啟動的東西。
8. **新的修訂是新的版本，不是把舊版本再次核准。** 開新版本（會以**草稿**起算）並核准它。較早的版本仍可在歷史中讀取，
並且不再是目前的版本——不論是對整個款式而言，或對綁定該較早版本的訂單而言。
9. **物料表的寫入動作受權限管控。** 由具備物料表寫入權限的使用者建立版本、新增與編輯明細、重新排序、核准或退回。
讀取對您租戶內任何已登入的使用者開放。
10. **沒有連結到主檔的布料或輔料明細無法解析到供應商。** 在物料表還在組稿時允許使用自由文字明細，但下游的
[採購單](/zh-Hant/reference/glossary#po-purchase-order)
生成會把沒有可解析供應商的明細略過並回報為已跳過。
## 驗證
| 時機 | 檢查 | 失敗時會發生什麼 |
| -------- | -------------------------------------------------------------------------------- | -------------------------------- |
| 新增或編輯明細 | `說明`已填入且不超過 300 字元 | 儲存被拒。 |
| 新增或編輯明細 | `規格` ≤ 300、`部位` ≤ 100、`狀態` ≤ 50、`採購需求` ≤ 255、`物料編號` ≤ 100、`單位` ≤ 20、`副料顏色` ≤ 500 | 哪個欄位超過上限就在該欄位上被拒。 |
| 新增或編輯明細 | `每件用量`為零或更大 | 儲存被拒。 |
| 重新排序明細 | 重新排序的集合不引用任何未知明細 | 重新排序被拒，回應「重新排序清單引用未知的明細」。 |
| 重新排序明細 | 重新排序的集合恰好包含此版本上的每一條明細各一次 | 重新排序被拒，回應「重新排序清單必須恰好包含每一條明細各一次」。 |
| 依版本開啟物料表 | 該版本屬於此款式與租戶，且有對應的表頭 | 讀取被拒，回應「找不到此版本的物料表」。 |
**沒有**任何儲存時驗證會在核准之前檢查物料表至少有一條明細、或每條明細都有供應商。強制執行「有明細」與
「有供應商」的把關位在下游——草稿採購單生成會回報它必須跳過的明細；當物料表尚未核准時，就緒引擎與預檢預設不放行。
## 日期邏輯
物料表有一個具商業意義的日期：
* **`核准時間`**——版本被核准的當下。由平台在**草稿 → 已核准**轉換時設定；若版本退回為**草稿**則清空。
就緒引擎與草稿採購單生成皆把**已核准**視為其前提，而非時間戳本身。
平台會記錄兩個稽核時間戳：
* **`建立時間`**——版本被開啟的時間。
* **`最後更新時間`**——版本最近一次被寫入的時間。物料表頁籤上會把它標示為「更新日期」。
物料表並無`目標`日期、`生效起始`日期或`有效期限`日期。商業上限制訂單的日期住在[訂單](/zh-Hant/modules/orders)上，
不在物料表上。
## 狀態與轉換
物料表版本有兩種狀態：**草稿**與**已核准**。
* **草稿**——版本可編輯。新增、編輯、重新排序、刪除明細；挑選主檔；設定數量與供應商。新版本從這裡起算。
* **已核准**——版本已簽核，作為已認證的物料清單可被讀取。所有以**已核准**為閘門的下游消費者——草稿採購單生成、
就緒引擎、生產管理預檢——皆解鎖。
轉換：
* （建立） → **草稿**：新的物料表版本永遠以**草稿**開啟。
* **草稿 → 已核准**：具備物料表核准權限的使用者核准版本。平台會設定`核准者`與`核准時間`、擷取每條明細的主檔快照
（詳見業務規則 5）、記錄核准事件，並且——當這是版本的首次核准且版本綁定到某張訂單時——把
[訂單階段](/zh-Hant/concepts/order-lifecycle)從 **PO 已收**推進到**採購**。
* **已核准 → 草稿**：具備物料表核准權限的使用者把版本退回為草稿。平台會清除`核准者`與`核准時間`並記錄退回事件。
明細上已擷取的副本仍會留下；已產生的下游影響（草稿採購單、已推進的訂單階段）不會被回收。
在**已核准**的版本上編輯明細是允許的——平台與物料表頁籤都不會擋下——但編輯不會重新擷取明細副本。
若要對即時主檔重新擷取，請退回該版本再重新核准，或另開新版本、編輯後核准。
對已核准的版本再次核准是無作用，對已是草稿的版本再次退回也是無作用（業務規則 6）。
## 計算
物料表**不會產生每件總成本**——物料的成本構成在[成本表](/zh-Hant/modules/cost-sheet)上累計，
而成本表的布料與輔料明細就是從物料表複製過來，並在那裡套用每條明細的成本。
物料表對下游消費者的貢獻：
* **對成本表**，在**從物料表複製**時：每一條合格的物料表明細會種入一條成本明細——成本表會擷取該物料表明細的說明、
物料編號、部位、供應商、單位、每件用量與單位成本到成本明細上，供應商與單位成本取自連結的布料或輔料主檔，
若主檔不可用則改用物料表明細的核准時擷取副本。自此刻起，這條成本明細就是該物料在此成本表上的真實來源。詳見
[成本表——變更的影響](/zh-Hant/modules/cost-sheet#變更的影響)。
* **對採購單生成**：已核准的物料表為各供應商種入一張草稿
[採購單](/zh-Hant/reference/glossary#po-purchase-order)。
每條採購單明細承載該物料表明細的物料、解析後的供應商、該訂單對此明細所需的數量，以及核准時自連結的布料或輔料主檔擷取的單價。
沒有連結到主檔的物料表明細沒有價格來源，因此採購單明細上不會有擷取到的單價；無法解析到供應商的明細會被略過並回報為已跳過。
* **對就緒引擎與生產管理預檢**：狀態（是否**已核准**）即為閘門；兩者皆不讀取明細上的數值。
## 變更的影響
* **在草稿版本上編輯明細。** 變更會被儲存。在版本被核准前，擷取副本維持為空。
* **在已核准版本上編輯明細。** 變更會儲存到明細上，但擷取副本不會被重新擷取。版本仍是該已核准版本——
若要對即時主檔重新擷取副本，請退回再重新核准，或另開新版本。
* **刪除明細。** 該明細及其圖片與配色項目會從版本中移除。
* **變更明細所指向的布料或輔料主檔。** 物料表頁籤上顯示的即時供應商會立刻自新主檔重新讀取；擷取副本不會變動。
* **核准版本。** 每條明細寫入即時主檔的識別副本（詳見業務規則 5）。所有以**已核准**為閘門的下游消費者皆解鎖。
當這是版本的首次核准且版本綁定到某張訂單時，該訂單階段會從 **PO 已收**推進到**採購**。
* **把版本退回為草稿。** `核准者`與`核准時間`會清除；擷取副本仍留在明細上；已產生的下游影響仍保留。
版本重新可編輯。
* **在草稿成本表上執行從物料表複製。** 每一條尚未連結到成本明細的布料或輔料物料表明細會種入一條新的成本明細，
擷取該物料表明細的說明、物料編號、部位、供應商、單位、每件用量與單位成本。從那一刻起，這條成本明細就是該物料
在此成本表上的真實來源。再次執行複製是安全的：已連結到某筆物料表明細的明細會被保留不動。詳見
[成本表](/zh-Hant/modules/cost-sheet#變更的影響)。
* **從已核准的物料表生成草稿採購單。** 物料表為各供應商種入一張或多張草稿採購單。
每條採購單明細承載該物料表明細的物料、解析後的供應商、該訂單對此明細所需的數量，以及核准時自連結主檔擷取的單價。
沒有連結到主檔的物料表明細上不會有擷取到的單價；無法解析到供應商的明細會被略過並回報為已跳過。
此訂單先前已開立給同一供應商的採購單不會被重新生成。
* **開新版本。** 一個新的**草稿**版本會在款式上開啟並成為目前版本；原本的目前版本不再是目前，但仍可讀取。
* **把不同版本標記為目前。** 下游消費者會重新讀取新目前版本的狀態。當版本綁定到某張訂單時，該訂單的綁定會同步推進。
## 最佳實務
* **每條明細都連結一個布料或輔料主檔。** 自由文字明細在您組稿時可用，但沒有連結到主檔的明細無法解析到供應商，
會從草稿採購單生成中被略過。請在核准前挑好主檔。
* **`每件用量`要審慎設定。** 成本表會把它複製為每件用量，所以隨手填的占位值會一路跟到計價環節。
* **只在這條明細確實向不同於主檔預設供應商的對象採購時，才使用明細層級的`供應商`覆寫。** 否則就讓主檔的供應商
發揮作用——少一個可變動的環節。
* **物料清單完備時才核准。** 平台不會擋下不完整物料表的核准；核准只是擷取明細副本並開啟下游閘門。請只擷取您
準備好為其背書的清單。
* **物料變更請另開新版本，而非編輯舊版本。** 平台允許在已核准的版本上編輯，但不會在編輯時重新擷取明細副本。
另開新版本能保持稽核軌跡清楚。
* **在版本上一次性把明細排好順序。** 您設定的順序就是成本表、物料表頁籤與下游消費者所顯示的順序。
## 相關頁面
* [開發款式](/zh-Hant/modules/develop-a-style)
* [建立物料表](/zh-Hant/modules/build-the-bom)
* [成本表](/zh-Hant/modules/cost-sheet)
* [建立成本表](/zh-Hant/modules/build-the-cost-sheet)
* [物料表、成本表與文件版本](/zh-Hant/concepts/bom-cost-sheet-artifact-versions)
* [款式](/zh-Hant/modules/styles)
* [輔料樣品送樣](/zh-Hant/modules/trim-submissions)