Changelog

Shopify Admin API 2026-07 与新的集合模型

DataEase 现在使用 Shopify Admin API 2026-07 版。大多数文件和已保存的任务仍能照常使用。本页列出了对您而言有哪些变化。

需要采取的操作:批准新权限

该应用现在会请求**库存转移(inventory transfers)**的访问权限(read_inventory_transfers、write_inventory_transfers)。Shopify 会在下次打开 DataEase 时向每个店铺显示批准提示。

  • 在您批准之前,导入所有者类型为 TRANSFER 的 metafield 定义会失败并显示行错误。其他一切照常工作。
  • 计划任务在批准待处理期间会继续运行。

详情:Metafield 定义。

集合

Shopify 用一个基于来源(sources)(包含/排除条件、手动挑选的产品、变体或子集合)构建的模型取代了智能/自定义集合。

  • 新的 Sources & conditions 列:sourceId、sourceCommand、sourceType、sourceTitle、sourceDescription、inclusionType、inclusionMatch、conditionCommand、conditionField、conditionRelation、conditionValue、conditionMatch。导入同时接受 API 值和 Matrixify 值,并能识别 Matrixify 的表头。
  • 新的导出选项“Matrixify-style headers and values”:以 Matrixify 的表头和值写入新列。
  • 经典规则列对于无法描述的集合会保持为空。导出日志会随后提示您启用 Sources & conditions 列。
  • 在已有智能集合上使用经典产品行现在会将这些产品作为手动挑选项添加,使其变为混合集合。此后,对该集合的经典规则导入会失败,报错 MIXED_SELECTIONS_AND_CONDITIONS,因此请为此类集合使用新列。
  • sortOrder:按最畅销排序的集合现在导出为 MOST_RELEVANT。不再支持 BEST_SELLING。
  • 集合类型过滤器现在标记为 Smart (with conditions) / Custom (manual only)。其数量可能显示为 ≤ N。

详情:集合。

产品和变体

  • Shopify 不再支持 taxCode(Avalara)。导入时该值会被忽略,行会显示警告。
  • 带有 collections / smartCollections 列的产品导出每次请求读取 12 个产品,带有 variantImage 列的导出读取 20 个。这些导出速度较慢,但文件内容相同。参见 Shopify 限制。
  • 如果 Shopify 因早前尝试失败而拒绝重复执行的库存更新和退款(IDEMPOTENCY_PREVIOUS_ATTEMPT_FAILED),现在会显示明确的行警告(库存)或错误(退款)。

详情:产品、订单。

客户、公司、折扣、商店

  • 客户:对于没有电子邮件地址的客户,UnsubscribeUrl 为空。导出包含客户的所有地址,不再有 250 个地址的上限。参见 Customers。
  • 公司:地点税务豁免和税务登记现在通过 Shopify 新的地点税务设置导入。参见 公司。
  • 折扣:新的导出列 discountClasses 列出折扣的每个类别。当 Include rest of world = TRUE 且未列出国家时,折扣会被导入为适用于所有国家。如果列出了国家,则只使用这些国家,且该行会显示警告。参见 折扣。
  • 商店:新的导出列 planPublicDisplayName。参见 Shop。

Metafields 和 metafield 定义

  • 现已支持所有者类型为 TRANSFER(库存转移)的 metafield 定义。
  • DataEase 不再为您自己的命名空间(例如 custom)发送管理员访问权限。对于应用命名空间,PUBLIC_READ(_WRITE) 会以 MERCHANT_READ(_WRITE) 发送。
  • 超过 2,000,000 个字符的 JSON metafield 值会显示明确的行错误。参见 Metafields。

数量和事件

  • 较大的记录数量现在显示为 10,000+,而不是 >10000。
  • Events 导出会显示提示,说明 Shopify 只保留最近 12 个月的事件。参见 Events。