> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tayest.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CSV 导入

> 批量上传适配表：切换模式、填写模板字段、上传并查看导入结果。

商品很多或已有厂家 / ERP 适配表时，用 CSV 批量导入。导入前必须先切到上传适配表模式。

## 操作步骤

**1. 切换模式**

**搜索设置** → 切到 **上传适配表（CSV）** → 保存。侧栏会出现 **CSV 导入**。

**2. 下载模板并填写**

打开 **CSV 导入**，下载模板，按下列字段填写。

**3. 上传并查看进度**

拖拽上传后异步解析。在下方查看成功、跳过、失败数量与错误明细。

> [!NOTE]
>
> 路径：应用后台 **CSV 导入**。可下载模板、上传文件并查看进度。

## 模板字段

列名不区分大小写。文件编码 **UTF-8**（Excel 请用带 BOM 的 UTF-8）。上限 **20MB**。

| 列 | 必填 | 说明 |
| - | - | - |
| `product_id` | 是 | 店匠商品 ID |
| `year` | 非通用件必填 | 单年 `2020`，或区间 `2016-2021`（自动展开每年一条） |
| `make` | 非通用件必填 | 品牌，需与车型库一致（大小写不限） |
| `model` | 非通用件必填 | 车型，需与车型库一致 |
| `submodel` | 否 | 子型号 |
| `is_universal` | 否 | `true` 表示通用件。通用件可不填 year / make / model |
| `notes` | 否 | 备注，如「需要额外安装支架」 |

示例：

```csv theme={null}
product_id,year,make,model,submodel,is_universal,notes
1001,2020,Honda,Civic,,false,
1001,2016-2021,Honda,Accord,,false,年份区间会展开为每一年
1002,2019,Toyota,Camry,,false,需要额外安装支架
1003,,,,,true,通用机油滤芯（不限车型）
```

## 导入结果说明

> [accordion] 重复行怎么处理？
>
> 重复行自动跳过，不算失败。

> [accordion] 失败明细看多少条？
>
> 失败时进度区最多展示 100 条错误明细。

> [accordion] 还在标签模式能上传吗？
>
> 不能。仍在标签模式时无法上传，请先切到「上传适配表」。

> [!TIP]
>
> `make` / `model` 可先到 [车型库](https://docs.tayest.com/zh/vehicle-library.md) 查一致拼写。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.