PrestaShop购物车折扣重计算：实现优惠券仅适用于非促销商品

以下方案兼容PrestaShop 1.6、1.7、8.x版本，核心逻辑是拆分购物车/订单内促销、非促销商品的折扣计算基数，保留混合结算能力的同时，限制百分比折扣仅作用于非促销商品。

需要修改/重写的文件及修改位置 #

所有修改建议通过PrestaShop原生的override机制实现，不要直接修改核心源码，避免后续版本升级覆盖代码。

• classes/Cart.php（核心，购物车侧折扣计算）
  • 修改位置：找到类内计算卡券（Cart Rule）折扣额的核心方法，1.7及以上版本为getCartRules()，1.6版本为getDiscounts()，原逻辑中计算百分比折扣的抵扣基数默认取整单符合规则的商品总额，需要替换为自定义方法返回的非促销商品总额。
  • 新增函数：在类内新增私有方法_getNonPromoDiscountBase($id_cart_rule)，方法逻辑：遍历当前购物车所有商品，先校验商品是否符合当前折扣券的适用范围（指定商品、指定分类、用户组权限等），再过滤掉处于促销状态的商品（包含标记为on_sale的商品、配置了特定促销价的商品），最终返回可用于计算百分比折扣的非促销商品含税/不含税总额（和原逻辑的计税规则保持一致）。
• classes/Order.php（核心，订单侧折扣持久化）
  • 修改位置：找到类内的addCartRule()方法，该方法负责订单生成时将购物车折扣写入订单明细、计算订单最终实付金额，原逻辑中百分比折扣的计算基数需要和购物车侧做同步修改，避免下单前后金额不一致。
  • 新增函数：在类内新增私有方法_getNonPromoOrderDiscountBase($id_cart_rule)，逻辑和购物车侧的自定义方法保持一致，遍历订单明细商品而非购物车商品，过滤促销品后返回折扣计算基数，保证订单生成后后续的金额计算（退款、对账、发票生成）都符合规则。
• controllers/front/CartController.php（必要，前端金额展示同步）
  • 修改位置：找到getAjaxCartSummary()方法，该方法负责前台购物车页、结账页异步加载金额汇总数据，将方法内返回的折扣总额字段替换为修改后的getCartRules()返回的折扣值，避免前端显示折扣和实际结算金额不符。
• controllers/admin/AdminOrdersController.php（可选，后台管理侧金额同步）
  • 修改位置：找到getOrderDetail()方法中计算订单折扣明细的逻辑，同步替换折扣计算基数，保证后台订单详情页、订单发票、发货单显示的折扣金额和实际结算一致，避免财务对账偏差。

关键校验规则 #

• 促销商品判断不要只依赖商品的on_sale字段，需要结合SpecificPrice类判断商品是否存在生效的促销特定价格，避免漏判未打促销标但实际设置了促销价的商品。
• 折扣金额分摊要对应到具体非促销商品上，不要把折扣额平摊到促销商品行，否则后续发起部分退款（尤其是退促销商品）时会出现退款金额计算错误。
• 多币种、多税率、多店铺场景下的金额计算要复用核心类自带的金额转换、税率计算方法，不要自行实现金额转换逻辑，避免不同场景下出现金额尾差。

测试必过场景：分别验证「仅常规商品用券」「仅促销商品用券（折扣额应为0）」「常规+促销商品混合结算用券」三类场景，核对购物车展示折扣、提交订单后实付金额、后台订单详情折扣额三个节点的数值完全一致，再验证混合订单部分退款的金额计算是否符合预期。

内容的提问来源于stack exchange，提问作者Kamil Wojnarowski