使用商品文件批量创建和更新商品
您可以通过准备商品文件并将其导入 SHOPLINE,批量创建新商品或更新现有商品。根据您的需求,可以从以下 CSV 文件着手:
- 创建新商品:下载【商品模板】,填写商品信息,然后将完成的文件导入 SHOPLINE。
- 更新现有商品:导出现有商品,在导出的文件中更新信息,然后将文件重新导入 SHOPLINE。
| 注意: SHOPLINE 提供的商品模板和导出的商品数据均为 CSV 格式。导入商品时,您可以上传 CSV 或 XLSX 格式的文件。 |
本指南将说明如何获取合适的商品文件、准备商品和规格数据、了解可用字段、将商品导入 SHOPLINE,以及排查常见的导入问题。
准备批量创建或更新商品
在准备商品文件之前,请先收集要导入的商品信息,例如:
- 商品名称和描述
- 规格,例如尺码、颜色或口味
- 售价和成本
- SKU 编码和条形码
- 库存信息
- 商品图片
- 物流信息
填写商品价格时:
- 如果您的店铺显示不含税价格,请填写不含税价格。
- 如果您的店铺显示含税价格,请填写含税价格。
获取用于批量创建或更新的商品文件
您应从哪个文件开始,取决于您是要创建新商品还是更新现有商品。
下载用于新建商品的商品模板
如需批量创建商品,请下载商品模板:
- 在 SHOPLINE 管理后台,进入【商品】。
-
点击右上角的【导入】,然后选择【本地导入】。
-
在【导入商品】窗口中,点击【商品模板】。
- 打开下载的 CSV 文件,填写商品信息。
| 注意: 如果您在下载或打开商品模板时遇到问题,请尝试使用 Chrome 浏览器。 |
导出现有商品以进行批量更新
如需批量更新现有商品,请先导出其当前的商品数据。使用导出的文件有助于保留 SHOPLINE 用于在导入时匹配现有商品的标识符。
- 在 SHOPLINE 管理后台,进入【商品】。
-
点击【导出】。
-
在【导出范围】下,选择要导出的商品:
- 【全部商品】:导出店铺中的所有商品。
- 【选中的商品】:仅导出您在商品列表中选中的商品。
- 【全部筛选结果】:导出所有符合您在商品列表中所应用筛选条件的商品。
- 在【导出到邮箱】中,填写用于接收导出文件的邮箱地址。
- (可选)如需包含商品元字段,请勾选【商品元字段】,然后最多选择 20 个元字段。
- 点击【导出】。
- 从收到的邮件中下载 CSV 文件,并根据需要更新商品信息。
|
注意:
|
准备用于导入的商品文件
下载商品模板或导出现有商品后,请在电子表格应用程序中打开该文件,填写或更新商品数据。
准备商品文件时,请遵循以下要求:
- 请勿修改第一行中的字段名称或其顺序。更改或调整表头顺序可能导致 SHOPLINE 无法识别该文件,从而造成导入失败。
- 请保留文件中的所有列,即使您无需填写该列的值,另有说明的情况除外。
- 请填写所有必填字段,并遵循《了解商品文件字段》中针对每个字段说明的要求。
- 对于含有规格的商品,请为每个规格组合使用单独的一行。
- 更新现有商品时,请确保正确填写 Handle 和与规格相关的字段,以避免意外创建新商品或更改现有的规格结构。
- SHOPLINE 支持导入 CSV 和 XLSX 格式的文件,文件大小上限为 40 MB。
- 使用 CSV 文件时,部分电子表格软件可能会在打开或保存文件时更改文件格式或编码。如果您的 CSV 文件出现乱码或无法识别的字符,《解决 CSV 文件中的乱码问题》。
- 请确保每个单元格中的内容不超过您所用电子表格应用程序支持的上限,以避免内容被截断或出现格式问题:
- Microsoft Excel 和 WPS:每个单元格 32,767 个字符
- Apple Numbers:每个单元格 1,000,000 个字符
了解商品文件字段
商品模板和导出的商品文件使用相同的基本字段结构。请参考下表了解每个字段的作用以及如何填写其值。
|
注意:
|
商品识别字段
| 字段 | 说明 | 要求 | |
| Product id(仅导出) | 系统为商品生成的唯一 ID |
|
|
| Variant id(仅导出) | 系统生成的唯一 ID,用于在更新时识别现有规格 |
|
|
| Handle(选填) | 用于在导入时匹配商品的唯一商品标识符 |
|
|
| Title(必填) | 商品名称 |
|
基本商品信息字段
| 字段 | 说明 | 要求 | |
| Subtitle(选填) | 商品副标题或宣传语 |
|
|
| Product description html(选填) | 商品详情描述 |
|
|
| SPU(选填) | 商家自定义的内部商品标识符 |
|
|
| Vendor(选填) | 商品品牌或制造商 |
|
|
| Tags(选填) | 用于对商品进行分类,并支持搜索与筛选的标签 |
|
|
| Collections(选填) | 商品所属分类的 handle |
|
商品图片字段
| 字段 | 说明 | 要求 | |
| Master image(选填) | 商品图片 URL |
|
|
| Image Alt Text(选填) | 商品图片的替代文本,用于无障碍访问和 SEO |
|
SEO 和商品可用性字段
| 字段 | 说明 | 要求 | |
| SEO title(选填) | 商品页面的 SEO 标题,将显示在搜索结果中 |
|
|
| SEO description(选填) | 商品页面的 Meta 描述,将显示在搜索结果中 |
|
|
| Published(选填) | 商品是否发布到【线上商店】销售渠道 |
|
|
| Status(选填) | 商品在所有销售渠道中的可用状态 |
|
|
| Unlisted(选填) | 商品是否可通过店铺前台的商品列表、搜索、推荐及搜索引擎被发现 |
|
|
| Standardized Product Type(选填) | 标准商品分类(基于 Google 商品类别),用于税费计算等用途 |
|
|
| Custom Product Type(选填) | 商家自定义的商品分类 |
|
|
| Created time(选填) | 商品创建时间,主要用于迁移历史商品数据的场景 |
|
规格字段
| 字段 | 说明 | 要求 | |
| SKU(选填) | 商家自定义的商品或规格标识符 |
|
|
| Option1 name(选填) | 第一个规格属性的名称,例如 Color(颜色) |
|
|
| Option1 value(选填;当 Option1 name 有值时为必填) | 第一个规格属性的值,例如 Red(红色) |
|
|
| Option2–Option5 name(选填) | 第二至第五个规格属性的名称 |
|
|
| Option2–Option5 value(选填;当对应的 option name 有值时为必填) | 第二至第五个规格属性的值 |
|
|
| Option1 value image(选填) | 分配给第一个规格属性值的图片 URL |
|
|
| Option2–Option5 value image(选填) | 分配给对应规格属性值的图片 URL |
|
|
| Image(选填) | 分配给特定 SKU 的图片 URL |
|
|
| SKU Image Alt Text(选填) | SKU 图片的替代文本 |
|
| 警告: 更新现有商品时,除非您确实需要更改其规格结构,否则请勿清空现有的规格属性名称或属性值。【忽略空白字段】不适用于这些字段。 |
价格、库存、税费和物流字段
| 字段 | 说明 | 要求 |
| SKU price(选填) | SKU 的售价 |
|
| SKU compare at price(选填) | SKU 的原价或对比价 |
|
| SKU weight(选填) | SKU 的重量 |
|
| SKU weight unit(选填) | SKU 重量所使用的单位 |
|
| SKU Inventory Tracker(选填) | 是否启用库存跟踪 |
|
| SKU Inventory Policy(选填) | 该 SKU 缺货时,顾客是否仍可继续购买 |
|
| SKU Inventory Quantity(选填) | SKU 的库存数量 |
|
| Cost per item(选填) | 单件成本 |
|
| Barcode(ISBN、UPC、GTIN 等)(选填) | 用于识别该 SKU 的条形码 |
|
| SKU tax policy(选填) | 该 SKU 是否需要缴税 |
|
| SKU shipping policy(选填) | 该 SKU 是否需要物流配送 |
|
| HS code(选填) | 用于海关申报的协调制度(HS)编码 |
|
| Shipping origin(选填) | 表示该 SKU 发货地的国家/地区代码 |
|
| 注意: 如果您的店铺使用多个库存地点,SKU Inventory Quantity 字段将无法通过商品导入生效。请使用【批量更新库存】功能来更新各地点的库存数量(详情请参阅《通过 CSV 文件更新库存》)。 |
其他商品字段
| 字段 | 说明 | 要求 | |
| Path(选填) | 商品页面的自定义相对 URL 路径 |
|
|
| Gift card(选填) | 该商品是否为礼品卡 |
|
|
| Included / market(仅导出) | 商品是否发布到特定市场 |
|
|
| Price / market(仅导出) | SKU 在特定市场的售价。 |
|
|
| Metafield Description(仅导出) | 商品元字段的值 |
|
在商品文件中添加不含规格的商品
对于不含规格的商品,请将其信息填写在单独一行中。
-
在 Title 中填写商品名称。
注意: 请使用清晰、具体的商品名称,以便于识别和管理商品。例如,不要使用 "T恤" 这样的名称,而应使用更具描述性的名称,例如 "SHOPLINE 周年纪念 T 恤"。 - (可选)填写 Handle,或将其留空,由 SHOPLINE 自动生成。
- (可选)为该商品填写 SKU。
- 在 SKU price 中填写售价。若留空,价格默认为 0。
- 填写其他您希望为该商品配置的字段。
- 如需添加其他商品,请在下一行填写其信息。
在商品文件中添加含有规格的商品
对于含有规格的商品,请使用单独的行来定义每个规格组合。
例如,假设一件 T 恤有两个规格属性:Color(颜色)和 Size(尺码)。
- 在 Option1 name 中填写 Color。
- 在 Option1 value 中填写对应的颜色,例如 Red。
- 在 Option2 name 中填写 Size。
- 在 Option2 value 中填写对应的尺码,例如 S。
每个可用的组合都应单独占用一行,因为每个组合都代表一个规格。
例如:
| Title | Option1 name | Option1 value | Option2 name | Option2 value | SKU |
| SHOPLINE T-shirt | Color | Red | Size | S | TSHIRT-RED-S |
| Red | M | TSHIRT-RED-M | |||
| Yellow | S | TSHIRT-YELLOW-S | |||
| Yellow | M | TSHIRT-YELLOW-M |
对于商品级别的字段(例如 Title、Vendor 和 Tags),请仅在该商品的第一行填写值,支持留空的后续规格行可以留空。
对于 SKU 级别的字段(例如 SKU、SKU price 和 SKU Inventory Policy),请为每个规格行分别填写相应的值。
对于每个包含规格且需要导入的商品,请重复上述流程。
将商品导入 SHOPLINE
准备好商品文件后,请将其上传至 SHOPLINE,以批量创建或更新商品:
- 在 SHOPLINE 管理后台,进入【商品】。
-
点击右上角的【导入】,然后选择【本地导入】。
- 在【导入商品】窗口中,通过以下任一方式上传您的 CSV 或 XLSX 文件:
- 点击上传区域,从您的设备中选择文件。
- 将文件拖拽到上传区域中。
-
在【导入设置】下,根据您希望 SHOPLINE 处理文件的方式配置以下选项:
-
【覆盖相同handle商品(表格无handle列将会新增商品)】:若勾选,文件中与现有商品匹配的 Handle 将覆盖该商品;若未勾选,重复的 Handle 会自动添加数字后缀,并作为新商品导入。无论是否勾选,没有 Handle 的商品都将被创建为新商品。
- 【忽略空白字段(未勾选时,空字段将覆盖原有数据)】:启用此选项可防止文件中的空字段覆盖现有的商品数据。若未启用,空字段可能会清除现有值。
- 【仅更新商品元字段信息(仅支持更新已有商品,handle 不匹配时无法导入)】:如果您只想更新现有商品的元字段,请启用此选项。Handle 与现有商品不匹配的行将不会被导入。
- 【不更新库存数量】:如果您不希望文件中的库存数量更新现有库存,请启用此选项。
-
【覆盖相同handle商品(表格无handle列将会新增商品)】:若勾选,文件中与现有商品匹配的 Handle 将覆盖该商品;若未勾选,重复的 Handle 会自动添加数字后缀,并作为新商品导入。无论是否勾选,没有 Handle 的商品都将被创建为新商品。
- 点击【上传并导入】。
|
注意:
|
导入后检查商品
导入完成后,请进入【商品】查看已创建或更新的商品。
建议您打开受影响的商品,检查以下重要信息:
- 商品信息
- 规格和 SKU
- 价格和成本
- 库存设置
- 商品图片
- 商品状态和线上商店可用性
- 税费和物流设置
如果您正在更新现有商品,请检查预期字段是否已成功更新,以及现有的商品或规格信息是否被意外覆盖。
排查商品导入问题
如果您的商品文件无法导入,或部分商品信息未按预期导入,请检查以下几点:
- 文件格式:请确认您导入的是 CSV 或 XLSX 文件,且文件大小未超过 40 MB。
- 乱码或无法识别的字符: 如果 CSV 文件在电子表格软件中打开或编辑后出现乱码或无法识别的字符,请参考《解决 CSV 文件中的乱码问题》。
- 表头:请勿修改第一行中的字段名称或其顺序。
- 必填字段:请确认所有必填字段均已填写有效值。
- 字段格式:请检查各字段的值是否符合本指南中所述的格式、长度和数据类型要求。
- Handle:更新商品时,请确认文件中的 Handle 与您要更新的现有商品完全匹配。
- 规格结构:请确认规格属性名称、属性值及规格组合均填写正确。
- 图片:请确认图片 URL 和文件格式符合相应要求。
- 空白字段:如果您正在更新商品,请检查是否已启用【忽略空白字段】,以及受影响的字段是否具有特殊的空白字段处理规则。
- 库存:如果您的店铺使用多个库存地点,请使用【批量更新库存】功能更新库存数量,而非通过商品导入。
- 请求参数错误: 如果您使用 Microsoft Excel 编辑商品文件后,在导入时遇到请求参数错误,请参考《排查商品导入时的"请求参数错误"》了解排查方法。
如果您的 CSV 文件出现乱码或格式错误,请尝试使用其他电子表格或 CSV 编辑工具重新打开并保存文件,然后再次导入。