---
title: 导入产品
description: 使用 Runner 的 CSV 模板启动目录导入并跟踪其处理历史。
---

当逐个输入相同的结构化目录信息效率低下时，从准备好的 CSV 导入产品。

## 为什么以及何时使用导入

当您已经在电子表格或其他系统中拥有产品数据并可以将其映射到 Runner 的 CSV 模板时，使用导入。对于小型目录或需要先了解字段时，使用手动[产品](./products)表单。

## 可用性和前提条件

- 在就绪的商店中打开**商店运营 → 产品**。
- 完成创建其实时店面目录渠道的商店发布/就绪设置；导入任务无法在没有该渠道的情况下继续。
- 填充的桌面产品列表显示**导入**。在空目录中，首先使用**添加第一个产品**；移动视图强调手动创建。
- 导入仅接受 CSV 文件。
- 使用 Runner 的当前模板。必需的列是 `handle` 和 `title`；变体行必须包括模板显示的必需 `sku` 和选项值。
- 启动导入会更改商店目录。提交文件前请查看。

## 打开导入产品

**入口路径：** **工作区 → 选择商店 → 商店运营 → 产品 → 导入**

![导入产品对话框](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgObeFKMJCcW62zHrU8smjSnqvixd1twlAf4uK)

## 主要控件

| 控件 | 使用原因 | 选中时发生的情况 |
| --- | --- | --- |
| **导入** | 打开批量导入工作流 | 打开导入产品对话框而不启动任务。 |
| **模板** | 从 Runner 的预期列开始 | 下载当前 `product-import-template.csv` 文件。 |
| **历史** | 检查早期的导入任务 | 切换到导入文件及其最新状态的列表。 |
| 上传区域 | 选择准备好的 CSV | 在本地读取文件并在内容可用时将其显示为就绪。 |
| 移除文件控件 | 更正错误的选择 | 清除选定的文件，以便您可以选择另一个。 |
| **启动导入** | 提交选定的 CSV | 启动导入任务，然后在 Runner 接受时移动到历史。 |
| **取消** | 不提交而离开 | 关闭对话框并清除选定的文件。 |
| **刷新**在历史中 | 请求最新的任务状态 | 重新加载可见的导入历史。 |
| **返回导入** | 准备另一个文件 | 从历史返回到上传视图。 |
| **关闭** | 离开历史 | 关闭对话框而不更改已提交的任务。 |

## 准备并提交 CSV

1. 选择**导入**，然后**模板**。
2. 在保留 CSV 格式的电子表格编辑器中打开下载的 CSV。
3. 保留模板标题。为产品完成 `handle` 和 `title`，加上变体显示的 `sku` 和选项值。
4. 在导出为 CSV 前查看产品句柄、标题、价格、变体和任何重复的行。
5. 返回对话框并将 CSV 选择或拖动到上传区域。
6. 等待文件显示**准备导入**。
7. 仅选择一次**启动导入**。
8. 在**历史**中，跟踪提交的文件直到达到终端状态，然后刷新产品列表并检查结果行。

## 理解历史状态

| 状态 | 含义 | 要做什么 |
| --- | --- | --- |
| **待处理** | 任务正在等待启动 | 将其保留在原位并稍后再检查；不要立即提交重复项。 |
| **处理中** | Runner 正在处理文件 | 保持对话框打开或稍后返回历史。 |
| **已完成** | Runner 完成了将文件交给目录导入器 | 产品处理可以在此状态后继续。刷新产品并检查名称、变体、价格、状态和库存。 |
| **失败** | Runner 无法完成导入任务 | 当前历史卡记录失败状态但不记录详细原因。在提交新文件前检查前提条件和源 CSV。 |
| **已取消** | 任务未继续 | 确认是否创建了任何产品，然后决定接下来提交什么。 |

历史还可以显示文件大小、总行数和事务 ID（当 Runner 拥有这些值时）。这些详细信息标识任务；它们不能替代检查产品记录。

## 限制和故障排除

- **启动导入已禁用：** 选择 `.csv` 文件并等待 Runner 完成读取非空内容。
- **无效的文件类型：** 将电子表格导出为 CSV；重命名另一个文件格式不会转换它。
- **文件读取错误：** 重新导出 CSV，确认它在您的设备上正常打开，然后再次选择它。
- **导入失败：** 确认商店发布/就绪设置创建了实时店面目录渠道，然后使用提供的模板、恢复必需的列并检查变体 `sku` 和选项值。
- **任务看起来卡住了：** 打开历史并选择**刷新**。待处理和处理中不是完成的证明。
- **出现意外的产品行：** 不要盲目重复相同的导入。比较 CSV 句柄与产品列表并有意更正记录。

## 相关指南

- [产品](./products)
- [库存和变体](./inventory-and-variants)
- [入职和常规设置](./onboarding-and-general-settings)
- [商店运营概览](./)