上下文产品变体价格的新定价审计追踪

GraphQL 管理 API 在 API 版本 2026-10 的 ProductVariantContextualPricing 中新增了 auditTrail 字段。

具有 read_products 访问权限 的应用程序可以使用此字段来检查 Shopify 应用于上下文产品变体价格的已订购调整项。

现有应用无需采取任何操作。

变更内容

新的 ProductVariantContextualPricing.auditTrail 字段返回一个 PricingAuditTrail 对象，其 priceAdjustments 字段包含 Shopify 应用这些调整项的顺序。

每个 AuditTrailAdjustment 包括：

• type：Shopify 执行的操作。该字段返回 ADDITION、MULTIPLICATION 或 REPLACEMENT 的 AuditTrailAdjustmentType 值。
• value：该值由 操作使用。
• price：Shopify 应用调整后的价格。
• label：对调整内容的本地化、人类可读描述。

应用程序应将 label 视为显示文本，因为其值可能被本地化或更改，因此不应解析它或将其用作稳定标识符。

此次定价审计轨迹的首个版本支持产品变体上下文定价。它不包含订单行项目或草稿订单行项目的审计轨迹。

如果 Shopify 无法返回完整且正确的审计跟踪记录，priceAdjustments 将返回空列表而不是部分结果。

受影响对象

此变更适用于使用 GraphQL 管理 API 版本 2026-10 或更高版本并需要解释 Shopify 如何计算上下文产品变体价格的应用程序。

read_products 访问权限允许应用程序查询 ProductVariantContextualPricing.auditTrail。使用早于 2026-10 的 API 版本的应用程序无法查询该字段。

除非选择查询新字段，否则现有应用程序不受影响；此变更不会修改现有的 ProductVariantContextualPricing.price 或 ProductVariantContextualPricing.compareAtPrice 字段。

为何重要

应用可以检查生成上下文价格的计算过程。ERP 和 B2B 集成可以利用此信息来解释来自价目表、货币转换、税费和舍入的调整。

审计轨迹解释了价格计算过程，但并未指明 Shopify 选择了哪个市场、目录或价目表。

操作步骤

现有应用无需采取任何操作。

要使用定价审计轨迹：

1. 请使用 GraphQL 管理 API 版本 2026-10 或更高版本。
2. 确认应用程序具有 read_products 访问权限。
3. 在上下文定价查询中添加 auditTrail 和 priceAdjustments。
4. 使用具有上下文价格调整的产品变体测试查询。

成功的响应会按计算顺序返回适用的调整项；空的 priceAdjustments 列表表示 Shopify 未为该价格返回完整的公开审计跟踪记录。

相关文档

• ProductVariantContextualPricing GraphQL Admin API 参考
• ProductVariant.contextualPricing GraphQL Admin API 参考
• ContextualPricingContext GraphQL Admin API 参考