Version notes
This manual covers releases 2.9.1 (Shopware 6.5), 3.9.1 (Shopware 6.6) and 4.9.1 (Shopware 6.7). Cross-selling offer sources, the three preview views and the offer search time limit are available in all three lines.
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.
Shopware 6.5 handles existing cart promotions differently from 6.6 and 6.7 when an offer is added. The note on mixed tax rates applies to all three version lines.
Offers on orders with existing promotions
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 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 is not 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.
Discounts with mixed tax rates
Applies to Shopware 6.5, 6.6 and 6.7.
The offer discount is added as a separate discount line item. With mixed tax rates, such as 7% and 19%, Shopware distributes the VAT reduction across all tax rates in the order. This differs from applying the discount only to the offer product's tax rate. For orders with net prices, it can result in a lower gross add-on amount. The difference depends on the products and discount. The charge still equals the actual increase in the order total. This distribution issue does not occur with a single tax rate.
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.