Creating promotions (discounts)

The plugin generates voucher codes based on Shopware promotions. For each reward type, a matching promotion must be created in Shopware in advance.

---

Basic principle

The plugin accesses an existing Shopware promotion and automatically generates an individual code from it, which it issues to the customer. The promotion defines the discount – the plugin supplies the personalized code.

Mandatory requirement for all reward types: Every linked promotion must be configured under Codes tab → Code type: Individual promotion codes. The plugin generates these codes automatically on every redemption. Without this code type, the plugin cannot generate a code.

---

Promotion for a voucher reward

A voucher reward can, for example, grant a percentage or absolute discount.

Step by step

1. Open Marketing → Promotions → Add promotion

2. Name: e.g. "Bonus – €10 voucher"

3. Active: enabled

4. Tab General:

   • Maximum redemptions per customer: 1

5. Tab Discounts:

   • Type: Fixed or percentage

   • Value: e.g. 10 (for €10)

   • Apply to: Cart total

6. Tab Codes:

   • Code type: Individual promotion codes ← required so the plugin can generate codes

7. Save

8. Enter the promotion in the plugin under Reward → Linked promotion

---

Promotion for a free-product reward

A free product is implemented via three components: a dynamic product group, a price rule and a promotion.

Step 1: Create a dynamic product group

1. Open Catalogues → Dynamic product groups → New product group

2. Name: e.g. "Reward 1"

3. Under Conditions, add the desired products or filters (e.g. "Product → Is one of → [your products]")

4. Save

Step 2: Create a price rule

1. Open Settings → Rules → Add rule

2. Name: e.g. "PRB – Product: Reward 1"

3. Priority: 1

4. Under Conditions:

   • Condition: Item in dynamic product group

   • Operator: All

   • Operator: Is one of

   • Product group: Reward 1 (the group created in step 1)

5. Save

Step 3: Create a promotion

1. Open Marketing → Promotions → Add promotion

2. Name: e.g. "Bonus – Free product: Reward 1"

3. Tab General:

   • Maximum redemptions per customer: 1

4. Tab Discounts:

   • Type: Percentage

   • Value: 100

   • Apply to: selected items with a price rule

   • Price rule: PRB – Product: Reward 1 (the rule created in step 2)

5. Tab Codes:

   • Code type: Individual promotion codes ← required so the plugin can generate codes

6. Save

7. Enter the promotion in the plugin under Reward → Linked promotion

8. Enter the product group in the plugin under Reward → Product group

---

Promotion for free shipping

1. Marketing → Promotions → Add promotion

2. Name: e.g. "Bonus – Free shipping"

3. Tab General:

   • Maximum redemptions per customer: 1

4. Tab Discounts:

   • Type: Shipping costs

   • Value: 100 (percent)

5. Tab Codes:

   • Code type: Individual promotion codes ← required so the plugin can generate codes

6. Save

7. Enter the promotion in the plugin under Reward → Linked promotion

---

Common mistakes

Problem	Cause	Solution
Code is generated but does not apply	Promotion not active or expired	Check the active toggle and validity period
100% discount applies to the entire cart	Price rule missing or misconfigured	Create a rule with a product-group condition and set it in the promotion
Code can be redeemed multiple times	"Max. redemptions per customer" not set	Set to 1
Plugin cannot generate a code	Code type not set to "Individual promotion codes"	Codes tab → set code type to "Individual promotion codes"