通过表格导入和更新商品#

下载对应类别的模板，填写商品信息，然后在商品目录上传。此流程无需编写代码或使用 API 凭证。

开始之前#

在 Dashboard 中选择正确的店铺。您需要拥有该店铺的商品目录编辑权限。如果看不到上传商品表格按钮，请检查当前店铺、商品目录写入权限，以及账户是否处于只读状态。

下载对应类别的模板#

1. 打开 Dashboard → 商品目录。
2. 点击上传商品表格，打开导入商品弹窗。
3. 在选择商品类别中选择要导入的类别。可选类别取决于店铺配置。
4. 点击下载 Excel 模板。不同类别需要分别下载模板、分别上传。

每次准备新的导入文件时，建议重新下载模板，确保列名与当前类别要求一致。下载的是空白模板，不是现有商品目录的导出文件。

填写工作簿#

工作簿中各工作表的用途如下：

每行商品都需要填写 sku、name、image_url、product_url，以及该类别要求的尺寸。请以下载模板中的必填标记和说明为准，不要翻译字段名，也不要添加未知列或重复列。

• 将 SKU 单元格设为文本格式，避免表格软件删除前导零或改变较长的标识符。每个 SKU 只填写一行；同一文件中不能出现重复值，仅大小写不同的值也视为重复。
• image_url 应填写可公开直接访问的 HTTP 或 HTTPS 图片地址，无需登录、Cookie 或自定义请求头即可打开。product_url 应填写商品详情页地址。
• 按模板说明填写尺寸和单位。如果尺寸值中和 dimension_unit 中都未指定单位，默认按 in 处理。
• status 请使用 Enums 中列出的值。留空时默认为 active，更新商品时建议明确填写。

建议保存为 .xlsx。也支持仅包含商品表头和数据的 .csv 文件，不支持旧版 .xls 文件。单个文件最多包含 50,000 行非空商品数据，大小不得超过 50 MB。

上传并查看结果#

1. 返回导入弹窗，选择与模板一致的商品类别。
2. 在填写后上传中选择已保存的文件，再点击开始导入。
3. 在最近导入中查看文件名、处理状态，以及成功和失败行数。文件提交成功表示已受理，导入仍会在后台继续处理。
4. 等待处理结束，即使任务显示已完成，也要检查是否存在失败行。返回商品目录，核对导入后的商品数据和就绪状态。

如果存在失败行，请点击下载失败行，根据错误信息修正商品数据，然后选择相同类别重新上传。下载的失败行工作簿包含失败数据及诊断列；重新上传时，系统会忽略这些诊断列。

遇到临时处理失败时，可在界面提供重试按钮时重试。同一任务的重试不会修正错误的商品数据。如果界面提示部分行需要支持人员核对，请点击联系支持，这些行不会自动重试。

更新已有商品#

使用对应类别的模板，保留商品原有的 SKU。为本次上传的每行商品填写全部必填字段，修改需要更新的值，然后重新上传。

• 同一店铺内，相同 SKU 会更新已有商品；不存在的 SKU 会创建新商品。在表格中修改 SKU 不会给原商品重命名。
• 可以只上传需要更新的商品行。文件中未出现的商品不会被删除、停用或下架。
• 表格导入不属于部分字段更新：必填字段仍需填写。不要假设可选单元格留空就会保留原值。尤其要注意，status 留空默认为 active，未指定尺寸单位时默认为 in。
• 请保留已填写的工作簿，方便今后更新。下载的模板不包含现有商品数据。

任务完成后，请在商品目录中核对相关商品。导入成功并不直接代表商品已能在店铺前台展示，还需确认商品就绪状态，并完成 SDK 上线检查清单。

通过 API 自动导入#

如果需要定期从服务端同步商品，请使用 Product Import API。该接口的请求字段、数量限制和部分更新行为有独立说明，与本表格操作流程分别介绍。