从 POS UI Extensions API 版本 2026-07 开始,购物车行项目数据中的产品捆绑组件包含折扣分配详情。
应用可以访问购物车行项目中捆绑组件的组件级折扣分配,例如:
shopify.cartLineItem.components?.[0]?.discountAllocations
相同的LineItem形状也用于Cart API的购物车状态,因此从shopify.cart.current.value.lineItems读取行项目的应用也可以在此处访问捆绑组件上的组件折扣分配。
此前,POS UI扩展通过lineItem.discountAllocations在父级行项目上暴露折扣分配,而捆绑组件仅暴露组件级别的税费信息,未暴露组件级别的折扣分配。这使得应用难以为享受折扣的产品捆绑包计算组件级别的折扣、税费、报告或合规值。
此更改为新增功能。使用 API 版本 2026-04 或更早版本的应用无需进行任何更改。
采用API版本2026-07的应用在处理享受折扣的产品捆绑包时可以使用components[].discountAllocations。当捆绑组件没有任何折扣分配时,应用应处理该属性缺失或为空的情况。
更多信息,请参阅[Cart Line Item API参考](https://shopify.dev/docs/api/pos-ui-extensions/2026-07-rc/target-apis/contextual-apis/cart-line-item-api#cartlineitemapi- propertydetail-cartlineitem)和[Cart API current 属性](https://shopify.dev/docs/api/pos-ui-extensions/2026-07-rc/target-apis/contextual-apis/cart-api#cartapi-propertydetail-curr ent)。

