来源中的信息
发生了什么
Shopify Developer Changelog 记录称，Catalog API 现在会在符合条件的商品变体上返回 list_price，用于表示商家的 compare-at 价格；原有 price 字段不变。
list_price 是 UCP Catalog Specification 2026-08-25 定义的可选字段，使用与 price 相同的 Price 对象，并以最小货币单位和货币返回；商品还可返回跨变体的 list_price_range。
变体只有在商家通过 Shopify 后台的 Catalog Mapping 分享 compare-at 价格、该价格高于买家上下文中的 price，且商家向该买家所在地区展示 compare-at 价格时，才会返回 list_price。
对于隐藏 compare-at 价格的 EEA 买家，API 不会返回该买家的 list_price；字段缺失表示在该买家和配置下没有可展示的 compare-at 价格。
经营影响
为什么重要
对面向欧洲市场的应用和购物代理而言，list_price 提供了比自行推断折扣更直接的价格参考，但它是按买家上下文返回的，不是商品的全球固定属性。
字段缺失同时可能来自商家配置、价格关系或区域展示限制，因此前端和代理需要把“没有返回”当作条件结果处理，而不是自动当作没有促销。
这项变更主要影响 Catalog API 的读取和展示逻辑；官方摘要明确表示无需商家采取强制行动，但依赖价格字段的集成仍有必要检查兼容性。
编辑观察
分析判断
价格信号从单一商品数据转向由配置、买家地区和 price 对比共同决定的条件输出，这会改变折扣识别机制；欧洲市场的应用应优先依据返回字段和买家上下文展示，而不能用固定字段存在性推断所有市场状态。当前判断仅基于单一官方变更摘要，未核验完整接口文档或更多地区行为。
对商家的直接后果不是价格本身被改写，而是不同买家可能看到不同的折扣可用性，这会影响促销标签、代理回答和价格对比组件的一致性；因此商家应把区域化结果作为展示规则的一部分，而不是要求所有买家都出现 compare-at 价格。证据未提供实际流量、转化或收入影响，不能据此推断经营结果。
下一步决策应以“是否依赖 Catalog API 生成折扣展示或代理回答”为分界：依赖该字段的欧洲集成现在检查缺失值、货币单位和变体范围，不依赖的商家可暂不改动；后续重点观察 Shopify 是否补充完整接口说明，以及 EEA 与其他欧洲买家上下文的返回差异。现有证据只确认摘要中的规则，不能扩展为所有欧洲市场都采用相同执行方式。
适用范围
对卖家的影响
使用 Shopify Catalog API、商品代理或价格对比组件的欧洲商家，可能需要确认集成是否能正确读取可选的 list_price 和 list_price_range，并处理字段缺失。
对 EEA 买家隐藏 compare-at 价格的商家，不应期待这些买家通过该 API 获得 list_price；区域化促销展示仍由商家配置和买家上下文共同决定。
不直接使用 Catalog API 的商家没有证据表明需要修改店铺定价或促销设置。
行动建议
现在应该做什么
- 1
检查 Catalog API 的价格字段兼容性
this-week如果应用或购物代理面向欧洲买家读取价格，确认解析逻辑支持可选的 list_price、list_price_range，以及最小货币单位和货币字段。
- 2
按买家上下文测试字段缺失
this-week在已启用和未启用 compare-at 展示的配置下，分别检查非 EEA 与 EEA 买家场景，确认缺失 list_price 时界面不会错误显示折扣。
- 3
跟踪 Shopify 的后续接口说明
monitor继续关注官方 Catalog API 文档，重点核对 list_price 的完整响应结构、区域规则和 list_price_range 的使用边界。
暂时不要做什么
- 不要把缺失 list_price 直接解释为商品没有折扣，也不要把 EEA 买家的区域性隐藏规则扩大到所有欧洲买家或所有市场。
- 不要因为字段新增而修改商家的 compare-at 价格、MSRP 参考价或促销配置；当前证据只支持 API 返回逻辑发生变化。
来源与依据
证据与来源
来源可能仅提供标题或摘要。请结合下方具体证据范围阅读；链接与流程校验不等于独立事实核验。内部置信值是工作流信号，不代表事实正确的概率。
- 01来源链接
The Catalog API now returns a merchant’s compare-at price as list_price on each product variant. Your app or agent can use list_price to tell when a product is marked down and by how much. The price field doesn’t change. No action is required. list_price is an optional field defined in the UCP catalog specification, version 2026-08-25. It uses the same Price object as price, with amount in minor units and a currency. Products also return list_price_range, which includes the lowest and highest list_price across their variants. A variant includes list_price when all of the following are true: The merchant shares compare-at prices through Catalog Mapping in the Shopify admin. Shopify turns this on by default for most stores and turns it off for stores that use compare-at for MSRP or another reference price. The compare-at price is higher than price for the buyer’s context. The merchant shows compare-at prices in the buyer’s region. Stores that hide them from EEA buyers don’t return list_price to those buyers. When list_price is missing, the variant has no compare-at price to show for that buyer and configuration. How you present that in your UI or in an agent’s response is up to you.
Shopify Developer Changelog · 流程状态: single-source
获取时间: 2026年10月9日 20:07 UTC
Claim is bounded to the ingested title or summary; no source body or quotation is retained.