工业品高效利器：Excel 1688式矩阵导入与导出
对于拥有几十甚至上百个工程尺寸规格的制造业企业来说，在网页后台逐个点击“新增变体”录入，效率极其低下。
Appsuite 打造了专为工业外贸场景优化的 Excel 1688 式矩阵批量同步引擎。业务员在熟悉的 Excel 中批量录入单价、尺寸和库存，配合图片 .zip 压缩包，一键即可完成整组矩阵的极速上传或更新。
1. 配套测试练习包下载
Section titled “1. 配套测试练习包下载”为了让您能够零门槛跟着本教程体验真实的批量导入，我们为您准备了针对“VD型减震器”的标准测试包：
- 📥 点击下载官方示例表格：VD-Sample.xlsx
(内置预调好的 SKU 列表与数据字典) - 📦 点击下载配套图片资源包：VD-Sample-Images.zip
(包含vd-hero.jpg、vd-thread.jpg、vd-cross-section.jpg等工程实物图)
2. 导出当前商品的 Excel 模板
Section titled “2. 导出当前商品的 Excel 模板”如果您想基于现有商品（如已录入的“VD型减震器”）进行修改并导出最新表格：
- 登录 Payload CMS，打开任意一个启用了多规格的产品（如
/admin/collections/offerings/5）。 - 在商品详情页面顶部或变体矩阵管理卡片中，点击 Export SKU Matrix (.xlsx)（导出 SKU 矩阵表格）。
- 浏览器会自动下载一份 pre-formatted 的
.xlsx文件。
3. Excel 工作簿的双表结构深度解析
Section titled “3. Excel 工作簿的双表结构深度解析”打开下载的 .xlsx 文件，您会看到它由两个工作表 (Sheets) 组成：
Sheet 1: SKUs (变体明细主表)
Section titled “Sheet 1: SKUs (变体明细主表)”每一行代表一个独立的采购单品型号：
| 列号 | 标准表头名称 (Header) | 填写要求 | 填表规范与示例 |
|---|---|---|---|
| A 列 | SKU | 必填 (文本，唯一) | 厂内零件号或订货号，如 VD8*8 M3*6、VD20*15 M6*18。同一商品内严禁重复。 |
| B 列 | Price | 必填 (数字) | 该规格的基础单价（纯数字），如 0.16 或 0.45。不要手动输入 $ 或 ¥ 等货币符号。 |
| C 列 | Stock | 选填 (整数) | 现货库存数量，如 9999。若留空系统默认按现货充足处理。 |
| D 列 | Weight (kg) | 选填 (数字/公斤) | 产品单重（单位：公斤/kg），如 0.015（代表 15 克）。用于前台样品订单精准计算国际空运运费。 |
| E 列 | Image Filename / URL | 选填 (文本) | 图片文件名（如 vd-hero.jpg，需存在于上传的 ZIP 包中），或者直接粘贴外部图片网址（如 https://...）。 |
| F 列及之后 | Label [key] (动态规格列) | 依据参数要求填写 | 表头格式规范：采用 名称 [参数标识]（如 subType [subType]、dimensions [dimensions]、thread [thread]、hardness [hardness]）。方括号 [...] 内为系统核心参数字段键名。 |
Sheet 2: Dictionary (数据字典与多语言属性表)
Section titled “Sheet 2: Dictionary (数据字典与多语言属性表)”记录所有带有固定选项枚举的参数多语言标签，以及可选的图片 Alt 文本：
| 列号 | 标准表头名称 (Header) | 核心作用与填表规范 | 填写示例 |
|---|---|---|---|
| A 列 | Attribute Key | 对应 Sheet 1 中的参数标识键名（或特殊键 image-alt） | subType, dimensions, thread, hardness, image-alt |
| B 列 | Option Value / Code | 该参数在数据库中存储的底层唯一代码/值（或图片文件名） | damper, Ø8*8mm, M3*6, vd-hero.jpg |
| C 列 | Label (EN) | 在英文站点前台展示的人性化英文标签 | Rubber Damper, Ø 8×8 mm, M3 × 6 mm |
| D 列 | Label (ZH) | 在中文站点前台展示的人性化中文标签 | 橡胶减震器, 直径8×高8毫米, M3×6 螺纹 |
[!TIP] 原生下拉验证与一键映射： 从后台导出的 Excel 中，Sheet 1 动态规格列会自动绑定 Sheet 2 的数据验证下拉菜单。业务员填表时点击单元格即可直接从下拉选项中勾选，彻底杜绝人工录入错别字！同时系统在导入时会自动根据方括号
[key]进行零误差字段匹配。
4. 打包图片并执行一键导入
Section titled “4. 打包图片并执行一键导入”编辑好 Excel 并准备好产品实物图后，即可进行导入：
- 准备图片压缩包：将所有在 E 列引用的图片存入一个普通文件夹，并压缩为
.zip文件（确保 zip 根目录直接是图片文件，不要多嵌套一层子文件夹）。 - 打开导入弹窗：在 Payload CMS 商品编辑页面，点击 Import SKU Matrix（导入 SKU 矩阵）。
- 选择文件：
- 在 Excel File 处，选中填写好的
.xlsx文件； - 在 Images Archive (ZIP) 处，选中刚打包好的
.zip文件（若无需新增图片可留空）。
- 在 Excel File 处，选中填写好的
- 选择导入模式 (Import Mode)：
| 导入模式 | 运作机制与推荐场景 |
|---|---|
| 覆盖模式 (Replace) | • 清空当前商品下的所有已有规格，完全以表格内容为准重新建立。 • 适用场景：初次上架新品、大版本重构规格表。 |
| 合并增量模式 (Merge) | • 按照 SKU 编号自动比对现有商品。• 已有型号：更新单价、库存、重量和动态参数。 • 全新型号：自动追加到末尾。 • 未提及的旧型号：完整保留原样，绝不会被误删。 • 适用场景：日常季度批量调价、补充新规格尺寸。 |
- 点击 Submit Import (确认导入)：
- 系统将自动解析表格、解压并上传图片到媒体库、校验数据合法性。
- 导入完成后，弹窗将提示类似：
🎉 导入成功！共处理 10 个SKU型号，新生成 4 张图片。 - 页面将在 2 秒后自动刷新，即可在后台看到更新后的整组矩阵。
5. 图片解析的三重容错机制
Section titled “5. 图片解析的三重容错机制”Appsuite 具备工业级图片容错逻辑，按以下顺序智能寻图：
- 优先从上传的 ZIP 包中提取：解压匹配同名图片，自动存入 Payload 媒体库并与该 SKU 建立关联。
- 直接下载网络 URL：若 E 列填写的是
https://img.example.com/part.jpg，系统会自动将图片抓取下载并存入系统，杜绝外部图床失效风险。 - 重用已有媒体资产：如果该图片以前已经上传过，系统直接匹配并复用已有图片记录，绝不产生重复垃圾冗余文件。
6. 常见错误与排查指南
Section titled “6. 常见错误与排查指南”- 报错：Missing required column: SKU
- 排查：请确保 Sheet 1 的第一行表头存在且第一列为
SKU，请勿删除或重命名 A 列。
- 排查：请确保 Sheet 1 的第一行表头存在且第一列为
- 报错：Price must be a valid number
- 排查：Price 列必须是纯数字（如
0.45），请检查是否不小心输入了中文全角数字或带了字母/符号。
- 排查：Price 列必须是纯数字（如
- 图片没有显示出来？
- 排查：检查 E 列填写的图片扩展名（
.jpgvs.png）是否与 ZIP 包内的真实文件名大小写完全一致。
- 排查：检查 E 列填写的图片扩展名（
恭喜！掌握了 Excel 批量导入后，您已经可以高效管理上千款工业品规格了！接下来我们学习如何跟进处理海外采购商提交的询盘与订单：