Promotions

Introduction

Syncing campaigns between two systems with different campaign models can be challenging, especially when expecting identical behavior in both systems. To ensure consistency and reliability, certain limitations must be applied to the types of campaigns that can be synchronized.

This guide explains how to configure promotions in Omnium for seamless use in both Omnium and Sitoo, with Omnium acting as the master system.

Sitoo uses predefined campaign types with strict rules and fixed value options, whereas Omnium supports a more flexible and open-ended campaign structure. Because of these differences, the integration uses Sitoo’s campaign types as a baseline. This documentation outlines how promotions set up in Omnium are interpreted in Sitoo, along with the mappings and limitations required to ensure compatibility.

In Omnium, a single promotion can be linked to multiple markets. Since each market corresponds to a Sitoo environment, the promotion will be exported to all relevant Sitoo environments based on the market configuration in Omnium.

Controlling Which Products a Promotion Applies To

In many cases, promotions should only apply to a specific selection of products — for example, a particular category, brand, or set of individual items. While both Omnium and Sitoo support filtering, they handle it differently, and their models don’t align perfectly. This section explains how filtering works across both systems and what’s required to enable proper syncing.

Filtering in Omnium

In Omnium, you can restrict a promotion by:

1. Product – Specific product IDs
2. Category – Including match in the products category tree
3. Brand
4. Season

Filtering in Sitoo

Sitoo has two main ways of restricting campaigns:

1. Product IDs – Simple filtering for including exact product matches.
2. Custom Attributes – Advanced filtering using predefined fields (e.g., category, brand), where each product must have a specific attribute value assigned. A custom attribute can only be a single text or number, not a list.

Valid filtering across the systems

The available filtering in the integration will be determined by the intersection of what is supported in both Omnium and Sitoo.

This means that to support season or brand-based filtering, the integration must map these values into Sitoo as product-level custom attributes.

Configuration

Important: Omnium generates prices for some promotion types. To avoid the discount to be applied twice in Sitoo, we have to ignore promotion prices when updating prices in Sitoo.

        {
            "key": "IgnorePromotionPricesInProductSync",
            "value": "true"
        }

Enabling Custom Attribute Sync from Omnium

To filter promotions in Sitoo based on brand, season or excluded products, you must enable the use of custom attributes in the product export from Omnium.

Step 1: Enable Sitoo Custom Attribute Mapping in Omnium

Update the tenantSettings in the Sitoo connector configuration to enable custom attribute export:

    {
      "key": "EnableCustomAttributes",
      "value": "true"
    }

Step 2: Define Attributes in Sitoo

The custom attributes needed for the promotion filtering has to have a specific key:

1. Navigate to Settings > Attributes in Sitoo.
2. Create a new attribute with Key equal to one of the given keys above, and type equal text.

Step 3: Ensure Products in Sitoo Have Attribute Values

After the attribute definitions are added in Sitoo, make sure all products are exported again. The attribute field has to be populated with data from Omnium.

Step 4: Setup Promotion Filtering in Omnium

Once custom attribute mapping is enabled and in place, you can create promotions in Omnium with filters on product, season or brand. These will then be translated into Sitoo’s attribute-based filtering during sync.

Promotion combination rules

In Sitoo, Order promotion types can always be combined, both with each other and with other promotion types. Therefore, Order promotions in Omnium has to have AlwaysApply = true. In both systems, order promotions will be applied after all other promotions.

Product campaigns can never be combined in Sitoo.

General Field Mapping: Omnium → Sitoo

The following table lists general promotion properties and how they are translated between Omnium and Sitoo. Some fields map directly, while others require additional context or have limited support due to differences in system behavior.

Mapping of the different promotion types

Order Amount Discounts - Cart Campaigns

These discounts apply to the entire order total, regardless of individual products.

Mapping restrictions:

OrderDiscountM

Not Supported

Category/Brand Discounts

Discounts targeting specific products based on filters

The product type promotions in Sitoo is split between two types in Omnium, Category/Brand promotions and Mix&Match/MultiBuy promotions.

Mapping for this type:

ProductDiscountM

ProductDiscountX

Multibuy and Mix&Match Discounts

Promotions based on buying multiple items with special pricing or discounts.

Product promotions involving combination of products is mapped to the type Multibuy/Mix&Match in Omnium. This type uses the same type of filtering, and prioritation. The difference is the extended functionality involving combination of products.

ProductBuyXForPriceM

ProductBuyXPayForY

ProductBuyXPayForYDiscountZRest

ProductBuyMinXDiscountY

ProductBuyXGetDiscountList

Not supported