> ## 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.

# 匯入主檔資料

> 以 CSV 檔案批次匯入客戶、廠商、布料與輔料主檔以及計量單位——同一頁上另有客戶品牌色盤的獨立匯入器。

**資料匯入**精靈讓管理員能以試算表(CSV)檔案批次載入您的
<Tooltip tip="共用參考清單——布料、輔料、顏色、單位、身體部位或分類——款式、物料表與採購單所讀取的來源。">[主檔資料](/zh-Hant/reference/glossary#master-catalog)</Tooltip>,
讓新工作區在幾小時內即可就緒，而不用逐筆手動輸入。它會在儲存前驗證每一列、
永不覆寫您已輸入的資料，並在有錯時精確告知您該修哪些列。

您會在**設定與配置**側邊欄群組中找到它，標示為**資料匯入**。此頁限管理員使用。

畫面上的參考——每個目錄承載什麼、雙語名稱欄位，以及目錄如何供給物料表、
成本表與採購單——詳見[主檔](/zh-Hant/admin/master-catalogs)。

## 可匯入的種類

精靈處理五種主檔資料。同一頁另有獨立匯入器載入**客戶品牌色盤**;
工作區的共用色清單不透過此精靈匯入(它從 主檔 → 顏色 進行編輯)。

| 實體                                                                                                         | 涵蓋內容                       |
| ---------------------------------------------------------------------------------------------------------- | -------------------------- |
| **客戶**                                                                                                     | 您銷售的買家，以及其預設條款。            |
| **<Tooltip tip="您工作區下單的外部方之權威紀錄——成衣工廠、布廠或輔料供應商。">[廠商 / 工廠](/zh-Hant/reference/glossary#vendor)</Tooltip>** | 工廠與供應商，各自類別為成衣工廠、布廠或輔料供應商。 |
| **布料主檔**                                                                                                   | 您的布料(主材)目錄。                |
| **輔料主檔**                                                                                                   | 您的輔料與配件目錄。                 |
| **計量單位**                                                                                                   | 計量單位(如碼、件)。                |

### 依相依順序匯入

有些紀錄會參照其他紀錄。精靈為此顯示「**建議設定順序**」提示:

1. **先匯客戶、廠商、單位。** 這些各自獨立；一份
   <Tooltip tip="一項布料的權威紀錄，含廠商、分類、單位與交期。">[布料主檔](/zh-Hant/reference/glossary#fabric-master)</Tooltip>
   或
   <Tooltip tip="一項輔料的權威紀錄，含廠商、分類、單位與交期。">[輔料主檔](/zh-Hant/reference/glossary#accessory-master)</Tooltip>
   可能會指名一個必須先存在的廠商。
2. **再匯布料與輔料主檔。** 它們會參照廠商、分類與單位。
3. **物料顏色在主檔之後。** 每份布料或輔料主檔各自承載自己的顏色，在主檔頁上加入。
4. **客戶品牌色盤任何時候都可以。** 頁面底部的獨立匯入器載入客戶品牌
   顏色(客戶、色號、名稱、Pantone)。

主檔列上的分類與單位欄位是例外——見下方[以參照方式產生](#以參照方式產生)。

## 準備您的資料

對每個實體，從精靈**下載範本**。範本是 CSV,已有正確的欄位標題與幾列樣本。
在這些標題下方填入您的資料——標題列請完全依樣保留。

### 對應鍵

每個實體都有一個**對應鍵**——精靈用它判斷一列是新紀錄還是既有紀錄:

| 實體      | 對應鍵          |
| ------- | ------------ |
| 客戶      | `name`       |
| 廠商 / 工廠 | `name`       |
| 布料主檔    | `article_no` |
| 輔料主檔    | `item_code`  |
| 計量單位    | `code`       |

布料與輔料主檔的比對是**標準化**的：忽略連字號、空白與大小寫，所以 `RI-026A`
與 `RI026A` 視為相同項目。其他實體以純名稱或代碼比對，忽略大小寫與前後空白。

### 逐實體欄位

以下表格列出各欄位及其是否必填。未標示為必填者皆為選填。

**客戶**——對應鍵 `name`:

| 欄位                          | 必填 | 說明                  |
| --------------------------- | -- | ------------------- |
| `code`                      | 是  | 唯一客戶代號              |
| `name`                      | 是  | 客戶或品牌名稱             |
| `country`、`address`、`notes` | 否  | 聯絡與自由文字細節           |
| `payment_terms_days`        | 否  | 淨付款天數(例如 30)        |
| `default_trade_term`        | 否  | 預設 Incoterm(例如 FOB) |
| `default_destination`       | 否  | 預設收貨目的地             |

**廠商 / 工廠**——對應鍵 `name`:

| 欄位                                             | 必填 | 說明                                                     |
| ---------------------------------------------- | -- | ------------------------------------------------------ |
| `name`                                         | 是  | 廠商或工廠名稱                                                |
| `vendor_type`                                  | 是  | `GARMENT_FACTORY`、`FABRIC_MILL` 或 `ACCESSORY_SUPPLIER` |
| `code`、`country`、`address`                     | 否  | 識別與位置                                                  |
| `contact_name`、`contact_email`、`contact_phone` | 否  | 主要聯絡人                                                  |
| `currency`、`payment_terms`                     | 否  | 商業預設                                                   |

**布料主檔**——對應鍵 `article_no`:

| 欄位                                                                                         | 必填 | 說明                   |
| ------------------------------------------------------------------------------------------ | -- | -------------------- |
| `article_no`                                                                               | 是  | 物料編號(對應鍵，標準化)        |
| `description`                                                                              | 否  | 舊版顯示描述               |
| `name_en`、`name_zh`                                                                        | 否  | 英文與中文名稱              |
| `content`、`finish`、`weave`、`weight`                                                        | 否  | 布料規格                 |
| `width_inches`、`gsm`                                                                       | 否  | 幅寬與每平方公尺重量           |
| `lead_time_days`、`moq`、`mcq`                                                               | 否  | 採購條件                 |
| `standard_cost`、`currency`                                                                 | 否  | 成本與其幣別               |
| `min_stock_qty`                                                                            | 否  | 再訂購水位                |
| `vendor`                                                                                   | 否  | 布廠名稱或代號(必須已存在)       |
| `category`、`unit`                                                                          | 否  | 若新則自動建立              |
| `quote_vendor`、`quote_price`、`quote_currency`、`quote_purchase_unit`、`quote_conversion_qty` | 否  | 選填供應商報價——所指名的廠商必須已存在 |

**輔料主檔**——對應鍵 `item_code`:

| 欄位                                                                                         | 必填 | 說明                          |
| ------------------------------------------------------------------------------------------ | -- | --------------------------- |
| `item_code`                                                                                | 是  | 項目代號(對應鍵，標準化)               |
| `item_name`                                                                                | 是  | 項目名稱                        |
| `name_en`、`name_zh`                                                                        | 否  | 英文與中文名稱                     |
| `supplier_code`                                                                            | 否  | 供應商的項目參照                    |
| `requires_color_matching`                                                                  | 否  | `true` / `false`(預設 `true`) |
| `colour`、`size_spec`                                                                       | 否  | 描述                          |
| `moq`、`lead_time_days`                                                                     | 否  | 採購條件                        |
| `min_stock_qty`                                                                            | 否  | 再訂購水位                       |
| `vendor`                                                                                   | 否  | 輔料供應商名稱或代號(必須已存在)           |
| `category`、`unit`                                                                          | 否  | 若新則自動建立                     |
| `quote_vendor`、`quote_price`、`quote_currency`、`quote_purchase_unit`、`quote_conversion_qty` | 否  | 選填供應商報價——所指名的廠商必須已存在        |

**計量單位**——對應鍵 `code`:

| 欄位            | 必填 | 說明             |
| ------------- | -- | -------------- |
| `code`        | 是  | 單位代號(例如 `YDS`) |
| `description` | 否  | 說明             |

### 檔案編碼說明

請將檔案存為 CSV。建議 UTF-8,但由中文語系 Excel(Big5 或 GBK)存出的檔案
也可接受——精靈會為您偵測編碼，所以無論哪一種，中文名稱皆可正確匯入。

## 兩種匯入模式

精靈提供兩種模式。選擇符合您當前情境的一種:

* **僅新增**——與既有紀錄相符的列會回報為錯誤。用於**初次上線**,
  工作區為空、每一列應為新紀錄時。
* **補空欄**——與既有紀錄相符的列，只填入空欄位；已有值的欄位**永不**覆寫。
  用於**充實既有紀錄**——例如為先前匯入的主檔補上交期或廠商。

刻意沒有可覆寫已有值的模式。

## 執行匯入

1. 從**設定與配置**側邊欄群組開啟**資料匯入**。
2. 從「您正在匯入什麼?」下拉選單**挑選實體**。
3. **下載範本**,以您的資料填入。
4. **選擇模式**——**僅新增**或**補空欄**。
5. **上傳**填好的檔案。
6. **預覽**——精靈會解析並驗證每一列，尚未儲存任何東西(見下方)。
7. **修正任何錯誤**並重新上傳，直到預覽乾淨。
8. **執行匯入**。精靈寫入資料，並顯示建立、充實與以參照方式產生的筆數摘要。

## 讀懂預覽

預覽在**任何儲存動作之前**驗證整份檔案。列表格上方顯示總列數、將建立的
筆數、將充實的筆數以及錯誤數。每一列顯示其列號、其狀態(**建立**、**充實**
或**錯誤**)以及訊息——哪一欄、哪裡出錯。

匯入為**全有或全無**:只要有一列有錯，就不儲存任何東西。修正檔案中被標示
的列後再上傳。這代表您絕不會落入一份匯到一半的檔案。

### 以參照方式產生

在主檔列上,`vendor`、`category` 與 `unit` 欄以名稱或代碼參照其他紀錄:

* **廠商必須已存在**——所以先匯廠商再匯主檔。主檔指名不存在的廠商會被
  回報為錯誤。
* **分類或單位若尚不存在，會自動建立**——這是「以參照方式產生」。以此方式
  建立的單位與您以單位範本匯入的相同，因此您毋須逐一手動預先建立每個分類
  與單位。結果摘要會回報產生了多少分類與單位。

## 客戶品牌色盤(獨立匯入器)

同一份資料匯入頁的底部有一張**客戶品牌色盤**卡，為一位客戶的品牌色提供
獨立匯入器——客戶、色號、色名(中英)與 Pantone。與上方實體精靈相同的
「全有或全無」預覽再執行的形狀，附有自己的範本。

客戶色盤是逐客戶的：在此匯入的顏色隸屬於一位客戶的品牌色盤，並在下游從
該客戶的紀錄中挑選。物料顏色(隸屬布料或輔料主檔的顏色)是在主檔本身的
頁面加入，不透過這兩個匯入器。

若您的工作區未顯示此卡，是管理員未開啟該功能;
[功能設定](/zh-Hant/admin/feature-settings)上有此切換。

## 匯入後

* **核對筆數。** 結果摘要會告知建立與充實了多少筆——與您預期的數量對照。
* **在相關模組中抽查幾筆紀錄**,確認資料落到您預期的位置。
* **依序繼續。** 若您從零上線，先跑客戶、廠商、單位，再跑布料與輔料
  主檔——這樣每一步的參照都已就位。

## 相關頁面

* [設定您的工作區](/zh-Hant/admin/setting-up-your-tenant)
* [主檔](/zh-Hant/admin/master-catalogs)
* [廠商](/zh-Hant/admin/vendors)
* [功能設定](/zh-Hant/admin/feature-settings)
* [v5 的更新內容](/zh-Hant/getting-started/what-changed-in-v5)
* [款式模組指南](/zh-Hant/modules/styles)
* [生產模組指南](/zh-Hant/modules/production)
* [技術包](/zh-Hant/modules/tech-packs)——先匯主檔代表技術包審核上的
  物料表列可以連結到既有物料。