产品

产品是您销售的商品。每个产品可以有许多变体（尺寸、颜色、包装尺寸）和许多额外数据，如价格、库存、媒体、SEO 和 metafield。
使用 DataEase，您可以批量导出，在 Excel / Google Sheets 中更新，然后在几分钟内导入到 Shopify。

(官方 Shopify 手册 → 产品 • 变体)

---

目录

1. 导出
2. 导入
3. 字段列表
4. 过滤器列表

---

1. 导出

1. 在 DataEase 中点击 新建导出。
2. 选择 CSV（适合长描述）或 Excel。
3. 选择 产品。
4. 如果需要，使用过滤器（按标签、供应商、状态等）。
5. 选择您想要的列（或 所有字段）。
6. 运行任务并下载文件。

需要图片？查看完整操作指南 → export-data

导出速度。 为了保持在 Shopify 的查询成本限制之内，DataEase 每页读取 33 个产品。当导出包含 variantImage 列时，每页为 20 个产品；包含 collections / smartCollections 列时，每页为 12 个产品。带有集合列的大型导出耗时更长，但文件内容相同。参见 Shopify 限制。

---

2. 导入

1. 打开导出文件或复制演示表。

2. 编辑行或添加新行。使用 command 列：

   Command	功能
   CREATE	创建新产品/变体/媒体行
   UPDATE	仅更改已填充的单元格
   MERGE	在产品内添加或替换行
   DELETE	删除产品（或变体/媒体行）
   IGNORE	跳过此行

3. 关键规则

   • 产品通过 id 匹配，如果没有 id 则使用 handle。
   • 变体通过 variantId 匹配；如果为空，DataEase 会查找 sku，然后是 barcode，然后是选项组合。
   • 媒体行需要 media URL 和 mediaCommand。
   • SEO 字段不能为空。
   • 库存列以 location: 开头（使用 +10 / -5 进行调整）。
   • 如果本次导入中同一次库存更新的早前尝试失败，Shopify 会拒绝重复执行（IDEMPOTENCY_PREVIOUS_ATTEMPT_FAILED）。受影响的变体行会显示警告，说明数量设置/调整未被应用——请检查行数据并重新运行导入。
   • 限制：Shopify 在商店超过 50,000 后允许您每天创建 1,000 个新产品/变体。

4. 保存文件。

5. 在 DataEase 中选择 新建导入，上传文件，映射列并运行。

完整导入指南: import-data

---

3. 字段列表

以下是 DataEase 可以为产品、变体和媒体显示的每一列。
标记为“导入字段”的字段可以发送回 Shopify。如果没有标记，则为仅导出。

图例
• 导入字段 – 可以发送回 Shopify。
• 无标记 – 仅导出（只读）。

3.1 通用辅助列

• row — 原始导出中的行号。仅导出
• topRow — 产品标题行为 TRUE，变体或媒体行为 FALSE。仅导出
• lineType — 行类型：Product、ProductMedia、Variant。仅导出

3.2 产品字段

• id — 产品 ID。更新的主键。导入字段
• command — 此产品行的操作。导入字段
• title — 向客户显示的产品名称。导入字段
• handle — URL handle（唯一，最多 256 个字符）。导入字段
• descriptionHtml — 富文本（HTML）描述。导入字段
• Description — 纯文本描述。仅导出
• vendor — 品牌/供应商。如果为空，默认为商店名称。导入字段
• status — ACTIVE、DRAFT 或 ARCHIVED。导入字段
• productType — 自定义产品类型文本。导入字段
• tags — 逗号分隔的标签（覆盖现有标签）。导入字段
• tagsCommand — 标签助手（ADD、REMOVE、REPLACE）。导入字段
• productCategory — 完整分类名称。导入字段
• ProductCategoryId — 分类 ID。导入字段
• productMetafields — 动态 metafield 列（参见 /metafields）。导入字段
• collections — 包含此产品的手动集合（该产品在集合中是被手动挑选的）。导入字段
• smartCollections — 通过条件、子集合、变体或应用来源包含此产品的集合。仅导出
• seoTitle — SEO 标题标签。导入字段
• seoDescription — SEO 元描述。导入字段
• CreatedAt — 产品创建时间。仅导出
• UpdatedAt — 上次修改时间。仅导出
• PublishedAt — 首次发布时间。仅导出
• TotalInventory — 所有变体的总库存。仅导出
• OnlineStoreUrl — 产品的在线商店 URL。仅导出
• media — 媒体 URL（每个媒体行一个，或用 ; 分隔如果分组）。导入字段
• mediaCommand — 媒体行操作。导入字段
• mediaAlt — 媒体的替代文本。导入字段
• mediaPosition — 媒体排序顺序（1-n）。导入字段
• mediaStatus — READY、PROCESSING、FAILED、UPLOADED。仅导出
• Options — 动态选项列（选项 1 名称/值等）。导入字段
• isGiftCard — true 将产品变为礼品卡。导入字段
• giftCardTemplateSuffix — 礼品卡模板文件后缀。导入字段
• templateSuffix — 产品页面的备用 Liquid 模板。导入字段
• MaxVariantPrice — 最高变体价格。仅导出
• MaxVariantPriceCurrency — 最高价格的货币。仅导出
• MinVariantPrice — 最低变体价格。仅导出
• MinVariantPriceCurrency — 最低价格的货币。仅导出
• FeaturedMedia — 特色媒体的 ID。导入字段
• variantGenerateFromOptions — true 从选项集自动创建变体。导入字段（仅导入）
• publicationScope — [IsPublished] 和 [PublishedAt] 每个销售渠道/市场。导入字段

3.3 变体字段

• variantId — 变体 ID（更新的键）。导入字段
• itemCommand — 此变体的操作。导入字段
• sku — 库存单位。导入字段
• barcode — UPC / EAN / 条码值。导入字段
• variantUpdatedAt — 变体上次更新时间。仅导出
• variantCreatedAt — 变体创建时间。仅导出
• displayName — 产品标题 + 变体标题。仅导出
• inventoryQuantity — 总现有库存。导入字段
• sellableOnlineQuantity — 在线商店可售库存。导入字段
• availableForSale — true 如果可购买。导入字段
• variantImage — 变体的特色图片 URL。导入字段
• position — 变体顺序（1-n）。导入字段
• price — 销售价（商店货币）。导入字段
• compareAtPrice — 比较价格。导入字段
• taxable — 收税？（true/false）。导入字段
• taxCode — 税码（基于美国，Avalara AvaTax）。Shopify 不再支持 Avalara 税码：该列仍可接受，但导入时该值会被忽略，并显示警告 “Tax code ignored”。变体的税码不会更改。
• inventoryPolicy — 缺货时 CONTINUE 或 DENY。导入字段
• variantMetafields — 动态变体 metafield。导入字段
• weight — 重量数值。导入字段
• weightUnit — GRAMS、KILOGRAMS、OUNCES、POUNDS。导入字段
• requiresShipping — true 如果需要实物运输。导入字段
• requiresComponents — true 如果变体仅为父捆绑包。导入字段
• cost — 单位成本（需要权限）。导入字段
• countryCodeOfOrigin — 原产国的 ISO-2 代码。导入字段
• harmonizedSystemCode — HS（关税）代码（6-13 位）。导入字段
• provinceCodeOfOrigin — 省的 ISO-2 代码（如果需要）。导入字段
• tracked — 跟踪库存？（true/false）。导入字段
• quantities — location: Location Name 动态列 – 设置或调整库存。导入字段
• fixedPrices — price / Market、compare at price / Market 动态列。导入字段

3.4 媒体状态枚举（仅导出）

• mediaStatus — READY、PROCESSING、FAILED 或 UPLOADED。

3.5 产品状态枚举（导入）

• status — ACTIVE、DRAFT 或 ARCHIVED 决定产品可见性。

---

4. 过滤器列表

您可以在导出产品之前使用的每个过滤器：

• Barcode — 按变体条码过滤。
• Bundles — 仅显示捆绑产品（true / false）。
• CategoryId — Shopify 分类类别 ID。
• CollectionId — 属于特定集合的产品。
• CombinedListingRoles — 按组合列表角色过滤。
• CreatedAt — 创建日期范围。
• DeliveryProfileId — 链接到交付配置文件的产品。
• ErrorFeedback — 带有 Shopify 错误消息的产品。
• GiftCard — 仅礼品卡产品。
• Handle — Handle 包含/等于文本。
• HasOnlyComposites — 变体全部为捆绑包的产品。
• HasOnlyDefaultVariant — 只有一个默认变体的产品。
• HasVariantWithComponents — 包含至少一个变体捆绑包的产品。
• Id — 精确的产品 ID 列表。
• InventoryTotal — 库存水平大于/小于某个数字。
• IsPriceReduced — 至少有一个变体 price < compareAtPrice 的产品。
• OutOfStockSomewhere — 在任何位置缺货的产品。
• Price — 变体价格范围。
• ProductConfigurationOwner — 所有者应用或渠道 ID。
• ProductPublicationStatus — PUBLISHED、UNPUBLISHED 等。
• ProductType — 自定义产品类型过滤器。
• PublicationIds — 发布到特定渠道的产品。
• PublishableStatus — 准备好/未准备好发布。
• PublishedAt — 首次发布日期范围。
• PublishedStatus — PUBLISHED 或 UNPUBLISHED。
• Sku — 变体 SKU 匹配。
• Status — 产品状态（ACTIVE、DRAFT、ARCHIVED）。
• Tag — 包含标签。
• Title — 标题包含/等于文本。
• UpdatedAt — 上次更新日期范围。
• VariantId — 按变体 ID 搜索。
• VariantTitle — 变体标题包含文本。
• Vendor — 供应商等于文本。

---

需要更多帮助吗？我们的支持团队会在 24 小时内回复。

其他字段

DataEase 支持此实体的更多列：

• productOptions — 产品可用的选项，如尺寸或颜色。导入字段