> ## 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-Hans/reference/glossary#master-catalog)</Tooltip>,
让新工作区在数小时内即可就绪，而不用逐笔手动输入。它会在保存前验证每一行、
绝不覆盖您已输入的数据，并在有错时精确告知您该修哪些行。

您会在**设置与配置**侧边栏分组中找到它，标示为**数据导入**。此页限管理员使用。

画面上的参考——每个目录承载什么、双语名称字段，以及目录如何供给物料表、
成本表与采购单——详见[主档](/zh-Hans/admin/master-catalogs)。

## 可导入的种类

向导处理五种主数据。同一页另有独立导入器载入**客户品牌色盘**;
工作区的共用色列表不通过此向导导入(它从 主档 → 颜色 进行编辑)。

| 实体                                                                                                        | 涵盖内容                      |
| --------------------------------------------------------------------------------------------------------- | ------------------------- |
| **客户**                                                                                                    | 您销售的买家，以及其默认条款。           |
| **<Tooltip tip="您工作区下单的外部方之规范记录——成衣厂、布厂或辅料供应商。">[厂商 / 工厂](/zh-Hans/reference/glossary#vendor)</Tooltip>** | 工厂与供应商，各自类别为成衣厂、布厂或辅料供应商。 |
| **面料主档**                                                                                                  | 您的面料(主材)目录。               |
| **辅料主档**                                                                                                  | 您的辅料与配件目录。                |
| **计量单位**                                                                                                  | 计量单位(如码、件)。               |

### 依相依顺序导入

有些记录会参照其他记录。向导为此显示"**建议设置顺序**"提示:

1. **先导客户、厂商、单位。** 这些各自独立；一份
   <Tooltip tip="一项面料的规范记录，含厂商、分类、单位与交期。">[面料主档](/zh-Hans/reference/glossary#fabric-master)</Tooltip>
   或
   <Tooltip tip="一项辅料的规范记录，含厂商、分类、单位与交期。">[辅料主档](/zh-Hans/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-Hans/admin/feature-settings)上有此切换。

## 导入后

* **核对笔数。** 结果摘要会告知创建与充实了多少笔——与您预期的数量对照。
* **在相关模块中抽查几笔记录**,确认数据落到您预期的位置。
* **依序继续。** 若您从零上线，先跑客户、厂商、单位，再跑面料与辅料
  主档——这样每一步的参照都已就位。

## 相关页面

* [设置您的工作区](/zh-Hans/admin/setting-up-your-tenant)
* [主档](/zh-Hans/admin/master-catalogs)
* [厂商](/zh-Hans/admin/vendors)
* [功能设置](/zh-Hans/admin/feature-settings)
* [v5 的更新内容](/zh-Hans/getting-started/what-changed-in-v5)
* [款式模块指南](/zh-Hans/modules/styles)
* [生产模块指南](/zh-Hans/modules/production)
* [技术包](/zh-Hans/modules/tech-packs)——先导主档代表技术包审核上的
  物料表行可以连结到既有物料。