Skip to main content

Documentation Index

Fetch the complete documentation index at: https://partner-integrations.voyado.com/llms.txt

Use this file to discover all available pages before exploring further.

General Settings, Cart and Order Conditions, and Discount Rules are managed within Shopware itself. You must therefore first create your promotion in Shopware before syncing it with Engage and assigning it to your customer base. Once the promotion is assigned to one or more customers, they must log into their account to access the discount. During the login process, Shopware assigns the promotion by linking the customer to a Rule using their externalId in Voyado Engage, which corresponds to their Customer ID in Shopware. If you plan to run a promotion campaign that can be reused, we strongly recommend creating the assignment directly in Shopware. If a customer creates an account in two different sales channels using the same email address, and both are connected to the same Voyado Engage environment, the promotion will only be linked to the externalId generated during the first account creation. If a personal promotion has been assigned in Shopware and redeemed through a third-party system (POS), it will remain active in Shopware.

​
Create and sync a promotion

1

Create promotion in Shopware

  1. Log into your Shopware store
  2. Navigate to Marketing > Promotions
  3. Select Add Promotion
2

Configure General Settings

  1. Promotion Name: Enter a name for the promotion
  2. Priority: Set the desired priority
  3. Valid From: Choose a start date
If you don’t set a start date, the promotion will not be synced to Engage
  1. Valid Until: Set this to unlimited
  2. Max. Total Uses: Set this to unlimited
  3. Max. Uses Per Customer: Set to 1 to minimize the risk of abuse. This extra validation assures the promotion can only be used once per customer.
  4. Activate the promotion.
  5. Select Save.
3

Add a Promotion Code

In the Promotion Codes section:
  1. Select “Fixed promotion code”
  2. Enter your promotion code
Discount codes used with Engage can only contain:
  • A-Z, a-z.
  • 0-9.
  • Underscore (_)
  • Hyphen (-).
  • Percentage sign (%)
4

Define promotion conditions

Go to the Conditions tab and configure:
  1. Pre-conditions: Define any necessary pre-requirements.
  2. Shopping Cart & Order Rules: Enter the desired conditions under Rule-based conditions.
Do NOT set any Customer rules; Engage will manage these when assigning the promotion.
5

Set Up Discounts

  • Go to the Discounts tab and:
  • Define the discount logic (e.g., percentage, fixed amount, or free shipping).
  • Click Save.
6

Sync promotion to Engage

  1. Navigate to Marketing Voyado Configuration
  2. Select on the Promotion Sync-up tab
  3. In the Sales Channel List, select the Sales Channel linked to the promotion
  4. Mark the promotions you want to sync to Engage
  5. Select Sync Promotions
7

Finalizing in Engage

The promotion will now be created in Engage as a Draft Promotion. It can then be activated and assigned manually or via the Automation tool.Once assigned in Engage, eligible customers will be able to use the promotion when they log into their account by applying the code in the discount code field.