通过 CSV 批量导入产品

第一步：打开导入工具

在 护照 页面点击 导入 CSV。您也可以在创建新护照时通过 批量导入 选项进入同一流程。导入需要 编辑者 或更高角色；查看者无法创建护照。

第二步：选择产品类别

导入工具会首先询问 产品类别——纺织品 / 服装 或 通用产品。一次导入处理一个类别，因为类别决定了存在哪些列。如果两类都卖，请分两次导入。

第三步：从模板开始

选定类别后，展开 “需要 CSV 模板？下载一份即可开始。” 有三个下载项可用：

1. 下载模板（必填字段）——只包含一份完整护照所需的列。必填字段以 * 标记。
2. 下载模板（全部字段）——该类别支持的每一列。
3. 下载示例（5 件产品）——一份填写好的样本，让您了解预期的格式。

在 Excel 或 Google Sheets 中打开模板，填入您的产品数据，并保存为 CSV。有几个字段使用紧凑格式：

• 材料成分——以分号分隔的 纤维:百分比 配对，例如 cotton:95;elastane:5。可选的第三个数字是该纤维的回收成分占比：cotton:95:30 表示 95% 棉，其中 30% 为回收。
• 列表字段（洗护标志、合规标准及其他多值列）——以分号分隔各值。
• 选项字段——使用存储值或其英文标签均可；两者都接受。

您无需保留模板的确切标题，因为没有手动映射这一步：导入工具会按字段标签或字段名，自动将您的列标题匹配到护照字段。匹配很宽容——大小写、首尾空格以及模板中末尾的 * 都会被忽略。无法匹配的列会被跳过，您会看到一条点名每个被跳过列的警告，这样改过的标题就不会悄无声息地失效。

这意味着您也可以从自己的系统导出：只要标题与模板的列名相符，文件就能导入。

第四步：查看校验结果

上传后，每一行都会用与编辑器相同的检查进行校验。一行需要填好模板中标记为 * 的字段才能导入（GTIN 是例外：它仅在稍后发布时才必填）。导入结果 界面会把您的文件一分为二：

• “N 件产品已就绪”——通过校验的行。
• “N 件有错误”——未通过的行，在一个表格中显示行号、产品以及问题所在（成分合计不为 100%、国家/地区无效、GTIN 格式错误等等；完整的检查项见 完整度与数据校验）。

点击 下载错误报告，把出错的行以带错误列的 CSV 形式取回，在表格中修正它们，然后再次导入该文件。现在导入有效的行、稍后导入修正后的行完全没问题；两批只是并排成为草稿而已。

准备好后，点击 导入 N 份有效护照。较大的文件会自动分成每批 500 份发送，并带有进度指示。

导入之后会发生什么

每个导入的行都会变成一份 草稿 护照：“全部以草稿形式导入。在护照列表中审核它们，再在准备好时发布。” 从这里开始适用正常的生命周期——草稿私密且数量不限，每份护照都会在其必填字段填写完整后各自发布。参见 草稿与已发布护照的区别，了解这两种状态如何运作。

成功界面还会提醒您当前相对方案的用量情况：草稿从不计入您的发布上限，因此在 Free 方案上导入 1,000 件产品也没问题；在升级之前，您最多可发布其中 5 份。发布本身（包括各方案的上限）在 发布数字产品护照 中介绍。