从 POS UI 扩展 API 版本 2026-07 开始， FixedAmount 传递给 setLineItemDiscount 和 bulkSetLineItemDiscounts 来自 Cart API 的固定金额行项目折扣必须表示单位折扣。
变更原因
在 API 版本 2026-04 及更早版本中，应用可以传递整个行项目的总固定折扣，Shopify POS 会自动将其转换为单位值。在 API 版本 2026-07 中，此转换不再发生。您传递的值将直接解释为应用于行项目中每个单位的折扣。
例如，在 API 版本 2026-07 中，如果您在数量为 2 的行项目上传递'5.00'，POS 会对每个单位应用 5.00 美元的折扣，总折扣为 10.00 美元。若要对数量为 2 的行项目应用总计 5.00 美元的折扣，您应改为将'2.50'作为每单位折扣进行传递。
您需要执行的操作
此更改仅影响FixedAmount行项目折扣。百分比折扣不受影响。使用 API 版本 2026-04 或更早版本的 App 无需进行任何更改。
采用 API 版本 2026-07 的 App 必须在使用新版本之前更新其折扣计算逻辑。如果您的 App 当前将折扣计算为行项目总折扣，请在调用setLineItemDiscount或bulkSetLineItemDiscounts之前计算每单位折扣——例如，通过将总折扣除以行项目数量来实现。
如果总折扣无法被行项目数量整除，请选择一个四舍五入的单位值，以匹配您应用的预期折扣行为，并确保最终折扣与您的逻辑一致。
更多信息，请参阅 Cart API 参考。