变体

产品变体是产品的不同版本（如尺寸 S，颜色红色，32 GB 等）。
使用 DataEase，您可以导出所有变体，修改价格、库存、条形码、metafield，然后在几分钟内将文件导入回 Shopify。

Shopify 手册 关于变体。

---

目录

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

---

1. 导出

1. 新导出 → CSV / Excel → 变体
2. 选择您需要的过滤器（见下方列表）。
3. 选择列（或选择全部）。
4. 运行并下载。
5. 如果您的描述 metafield 很大，请选择 CSV（Excel 单元格最大 32,767 个字符）。

完整导出指南：export-data。

---

2. 导入

1. 编辑导出文件或复制我们的演示表。
2. 在每个变体行使用 itemCommand（CREATE、UPDATE、MERGE、DELETE、IGNORE）。
3. 确保您至少有 variantId 或 sku 或 barcode 来匹配变体。
   如果库存数量更新因本次导入中同一请求的早前尝试失败而被拒绝（IDEMPOTENCY_PREVIOUS_ATTEMPT_FAILED），该行会显示警告，且数量不会更改——请检查该行并重新运行导入。
4. 保存为 CSV 或 XLSX → 在 DataEase 中新导入 → 上传 → 映射列 → 运行。

详细步骤：import-data。

---

3. 字段列表

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

变体列

• variantId — 变体的唯一标识符。导入字段
• itemCommand — 此变体行的操作（CREATE、UPDATE 等）。导入字段
• sku — 库存单位（SKU）。导入字段
• barcode — 条形码 / UPC / EAN。导入字段
• displayName — 自动生成的名称（产品标题 + 变体标题）。仅导出
• inventoryQuantity — 所有位置的总库存。导入字段
• sellableOnlineQuantity — 在线商店可用库存。导入字段
• availableForSale — 如果可购买则为 true。导入字段
• variantImage — 变体的特色图片 URL。导入字段
• position — 变体排序顺序（1 = 第一）。导入字段
• price — 销售价格（商店货币）。导入字段
• compareAtPrice — “对比价格”（划线）。导入字段
• taxable — 收税？（true / false）。导入字段
• taxCode — 美国税码字符串（Avalara AvaTax）。Shopify 不再支持 Avalara 税码：导入时该值会被忽略，并显示警告 “Tax code ignored”，变体的税码不会更改。导入字段
• inventoryPolicy — 缺货时 CONTINUE 或 DENY。导入字段
• variantMetafields — 动态 metafield 列，如 variant metafield custom.color。参见 metafields。导入字段
• weight — 重量数值。导入字段
• weightUnit — GRAMS、KILOGRAMS、OUNCES 或 POUNDS。导入字段
• requiresShipping — 如果是实物商品则为 true。导入字段
• requiresComponents — 如果变体只能作为捆绑包的一部分销售则为 true。导入字段
• cost — 单位成本（需要权限）。导入字段
• countryCodeOfOrigin — 原产国 ISO-2 代码。导入字段
• harmonizedSystemCode — HS（关税）代码（6-13 位数字）。导入字段
• provinceCodeOfOrigin — 原产省份 ISO-2 代码。导入字段
• tracked — 跟踪库存？（true/false）。导入字段
• Inventory quantities — 动态位置列 location: Warehouse A 等。调整库存或使用 “+5” / “-3”。导入字段
• fixedPrices — 动态市场价格列 price / Canada，compare at price / EU。导入字段
• variantCreatedAt — 变体创建时间。仅导出
• variantUpdatedAt — 上次变体更新时间。仅导出

---

4. 过滤器列表

在导出之前使用这些过滤器以限制获取的变体：

• Barcode — 变体条形码匹配文本。
• CategoryId — 产品分类 ID 等于值。
• CreatedAt — 变体创建日期范围。
• Handle — 产品 handle 包含 / 等于文本。
• Id — 产品 ID 等于列表。
• InventoryTotal — 库存水平大于 / 小于数字。
• Price — 变体价格范围。
• ProductType — 产品类型等于文本。
• Sku — SKU 匹配值。
• Status — 产品状态（ACTIVE、DRAFT、ARCHIVED）。
• Tag — 产品有标签。
• Title — 产品标题包含文本。
• UpdatedAt — 变体上次更新日期范围。
• VariantId — 变体 ID 等于列表。
• VariantTitle — 变体标题包含文本。
• Vendor — 供应商等于文本。

---

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

其他字段

DataEase 支持此实体的更多列：

• descriptionHtml — HTML 格式的产品描述。导入字段
• Description — 纯文本产品描述。导入字段
• tags — 逗号分隔的产品标签列表。导入字段
• tagsCommand — 标签的操作（ADD、REMOVE 等）。导入字段
• productCategory — 产品类别名称。导入字段
• ProductCategoryId — 产品类别的唯一标识符。导入字段
• productMetafields — 用于附加产品信息的自定义字段。导入字段
• collections — 产品所属的集合列表。导入字段
• smartCollections — 产品所属的智能集合列表。导入字段
• media — 产品的相关媒体文件。导入字段
• seoDescription — 产品的 SEO 元描述。导入字段
• seoTitle — 产品的 SEO 元标题。导入字段
• PublishedAt — 产品发布的日期和时间。导入字段
• TotalInventory — 产品可用的总库存。导入字段
• OnlineStoreUrl — 在线商店中产品的 URL。导入字段
• mediaCommand — 媒体文件的操作（ADD、REMOVE 等）。导入字段
• mediaAlt — 媒体文件的替代文本。导入字段
• mediaPosition — 产品画廊中媒体文件的位置。导入字段
• mediaStatus — 媒体文件的状态（ACTIVE、ARCHIVED 等）。导入字段
• productOptions — 产品可用的选项（例如，尺寸，颜色）。导入字段
• isGiftCard — 指示产品是否为礼品卡。导入字段
• giftCardTemplateSuffix — 礼品卡产品的模板后缀。导入字段
• templateSuffix — 产品的模板后缀。导入字段
• MaxVariantPrice — 所有变体中的最高价格。导入字段
• MaxVariantPriceCurrency — 最高变体价格的货币。导入字段
• MinVariantPrice — 所有变体中的最低价格。导入字段
• MinVariantPriceCurrency — 最低变体价格的货币。导入字段
• FeaturedMedia — 产品的主要特色媒体文件。导入字段
• variantGenerateFromOptions — 指示变体是否从选项生成。导入字段
• publicationScope — 产品发布的范围（GLOBAL、LOCAL 等）。导入字段
• options — 产品变体的选项列表。导入字段
• quantities — 每个变体的可用数量。导入字段