批量导入产品

一条条建太慢的时候，用导入：一张表格一次最多 1000 行，既能新建、也能更新已有产品。

入口在产品列表右上角的导入按钮。

一、先下载模板

进到导入页后点下载模板（如果弹出一个选择框，按需勾选后点「下载」）。拿到的 .xlsx 里：

• 第 1 行是列标题，请不要改动它 —— 上传后系统正是靠它自动对应字段的。
• 第 2 行是示例行，照着它的格式填。
• 加粗 + 浅黄色底的列是必填的，只有两列：货号和产品名称。
• 部分列（品牌、分类、标签、单位、是/否 这类）带下拉选项，可以直接选，也可以自己填编码。

⚠️ 填完记得把第 2 行的示例删掉，否则它会被当成一条真实数据导进去。

二、在表格里填写

• 一行 = 一个产品。
• 货号是这条产品的唯一标识，必填。 再次导入相同货号，会更新原来那条，而不是新建一条 —— 这正是批量改价、批量补资料的做法。
• 不需要的列可以整列删掉，不影响其它列；不删也行，上传后在映射那一步把它设成「— 不导入此列 —」即可。
• 分类是选填的，没填的产品会归到「未分类」。
• 价格列填纯数字（如 0、12.5），不要带货币符号。
• 图片可以直接嵌在单元格里（Excel / WPS 的「置于单元格中」），一行最多 9 张。注意：带图片的行会替换该产品已有的全部图片，不是追加。
• 一次最多 1000 行；超了会在下一步被拦下并提示行数过多。

三、上传

支持 .xls、.xlsx 和 .csv。把文件拖到虚线框里，或者点一下选择文件。

页面下方的可导入以下列列出了这次能导的全部列，带 * 的就是必填项 —— 不确定某个字段能不能导，看这里最快。

上传完会自动进入下一步，不用点「下一步」。

四、核对字段映射

最上面是文件前几行的预览，确认读到的内容没错位。系统会按表头自动把你的每一列对到系统字段（模板下载下来直接填的话，这一步通常全对）。这一步要做三件事：

1. 逐行核对对应关系。 对得不准的直接改；不需要导入的列选「— 不导入此列 —」。
2. 选「当记录已存在时」怎么处理 —— 也就是遇到货号已存在的行时：
   • 更新已存在（upsert） —— 默认。用表格里的值覆盖原记录。
   • 跳过已存在 —— 原记录原样不动。
   • 冲突则失败 —— 这一行直接记为失败。
3. 如果映射了价格列，会多出一个录入价口径：选税前价（不含税）或含税价，系统据此反算另一边和税额。这个选择对本次导入的所有价格列生效。

点下一步。常见的拦截提示：

• 必填字段未映射：xxx —— 货号或产品名称没对上。
• 字段被映射了多次：xxx —— 两列指向了同一个系统字段。
• 第 3、7 行的必填项「产品名称」未填写，请补齐后重新导入。 —— 表格里有空着的必填格。

五、解析引用

品牌、分类、一级/二级标签这类列，填的是名称，系统要把它对应到已有记录上。如果你映射了这类列，就会多出这一步（没有的话会自动跳过，直接开始导入）。

每个不同的值占一行（不是每条数据一行），右边是状态：

• 已解析（绿）—— 唯一匹配上了，已经自动填好，核对一下即可。
• 待确认（黄）—— 匹配到多条同名记录，需要你指定是哪一条。
• 未找到（红）—— 系统里没有这个名称。

高亮的行必须逐个处理完，「开始导入」才可点。 处理方式有两种：从下拉里选一条记录，或者 —— 仅限选填的列 —— 勾上留空，表示这些行的这个字段就空着。

六、看结果

顶部四个计数：新建 / 更新 / 跳过 / 失败。下面逐行列出行号 / 状态 / 错误，成功的行也在里面。

行号是表格里的物理行号（标题行算第 1 行，所以第一条数据是第 2 行），方便你回到原文件对着改。

导入是逐行独立的：一行出错不会影响其它行，成功的照样入库。所以失败了不用整个重来 —— 按错误提示把那几行改好，用同一份文件再导一次即可：默认的「更新已存在」会把已经成功的行原样更新，不会重复建。

想接着导下一批，点再导入一个文件。

七、只想批量换图片？

那用另一个入口：产品列表右上角的导入图片。把图片按货号或条形码命名后整批拖进去，系统自动挂到对应产品上；同一产品多张图加数字后缀（REF、REF-1、REF-2）。