Version notes
The version model
The extension ships in platform-bound version lines: 2.x for Shopware 6.5 (6.5.8 and later), 3.x for Shopware 6.6 and 4.x for Shopware 6.7. All three lines carry the same feature set; the Shopware Store automatically delivers the line matching your Shopware version.
This documentation covers every supported Shopware version (6.5.8+, 6.6 and 6.7), and almost everything behaves the same on all of them. A few behaviours differ on Shopware 6.5 because of how Shopware 6.5 recalculates an order after the offer is added. This page lists them so you can choose your campaign settings with confidence. If you run Shopware 6.6 or 6.7, none of this applies to you.
For most shops the safe defaults avoid every point on this page.
Stacking an offer on an order that already has a promotion
This applies only if you change a campaign's Cart promotions setting from the default "Suppress offer when a cart promotion exists" to "Stack promotion and calculate the actual add-on amount".
On Shopware 6.5, when the customer accepts and the offer is added to the order, the order's existing promotion is not re-applied to the recalculated order:
- A percentage cart promotion is not extended to the added offer product. The recorded add-on amount is the offer's own price, not the further-discounted price.
- A free-shipping promotion is not kept. Shipping returns to its normal rate on the extended order.
On Shopware 6.6 and 6.7 the promotion is re-applied, so the offer is priced after the existing discount and free shipping is preserved.
What still works on 6.5: the offer is added to the same order, the offer's own discount is applied, and the amount charged always equals the order's actual increase. There is never a charge that does not match the order total.
Recommendation: keep the default "Suppress offer when a cart promotion exists". It is the safe choice: when the order already carries a promotion, the offer is simply not shown, so no promotion is ever mispriced. Only switch a campaign to "Stack promotion and calculate the actual add-on amount" on Shopware 6.5 if you understand that an existing promotion will not be re-applied to the offer.
Re-applying the promotion on Shopware 6.5 would rebuild the order's delivery discount during the recalculation, which triggers a known Shopware 6.5 database error on some orders. Rather than risk the reliability of the order and the charge, this build keeps the conservative behaviour and documents it here.
Mixed tax-rate carts (a few cents)
This point is not specific to 6.5, but it is worth stating alongside the above.
The offer's discount is posted as a single credit line, so in a cart that mixes tax rates (for example 7% and 19%) Shopware spreads the discount's VAT relief across all rates rather than only the offered product's rate. The result is off by a few cents, and for a net (B2B) mixed-rate cart it can under-collect roughly 0.21. It is internally consistent: the amount charged always equals the order's actual increase. Single tax-rate carts are exact.
Everything else
All other functionality (the offer page, PayPal wallet and saved-card recharge, invoice and prepayment add-to-order, analytics, emails, the health check, and every default policy) behaves the same on Shopware 6.5 as on 6.6 and 6.7.
Questions: support@commercewerk.de.