Promotion engine

8 min

Promotion engine flow

Promotion engine flow Commerce Connect 10-12

Calculate promotions

The components mentioned here are available in the EPiServer.Commerce.Marketing namespace. PromotionEngine evaluates the condition of all active promotions and rewards specific orders when the conditions are fulfilled.

Here is an example of using the promotion engine to calculate promotions using the order API.

var cart = ServiceLocator.Current.GetInstance<IOrderRepository>().LoadOrCreateCart<Cart>(PrincipalInfo.CurrentPrincipal.GetContactId(), Cart.DefaultName);
    IEnumerable<RewardDescription> rewardDescriptions = ServiceLocator.Current.GetInstance<IPromotionEngine>().Run(cart);

Get promotion prices

var promotionEngine = ServiceLocator.Current.GetInstance<IPromotionEngine>();
    var currentMarket = ServiceLocator.Current.GetInstance<ICurrentMarket>();
    IEnumerable<DiscountedEntry> discountedEntries = promotionEngine.GetDiscountPrices(entryLink, currentMarket);

You can also get promotion prices for a collection of entries.

var promotionEngine = ServiceLocator.Current.GetInstance<IPromotionEngine>();
    var currentMarket = ServiceLocator.Current.GetInstance<ICurrentMarket>();
    var market = currentMarket.GetCurrentMarket();
    IEnumerable<DiscountedEntry> discountedEntries = promotionEngine.GetDiscountPrices(entryLinks, market, market.DefaultCurrency);

Evaluate entries

Evaluate a single entry.

IEnumerable<RewardDescription> rewardDescriptions = ServiceLocator.Current.GetInstance<IPromotionEngine>().Evaluate(entryLink);

Evaluate a collection of entries.

IEnumerable<RewardDescription> rewardDescriptions = ServiceLocator.Current.GetInstance<IPromotionEngine>().Evaluate(entryLinks);

Get promotions and items for campaign

IEnumerable<PromotionsItems> promotionItemsList = ServiceLocator.Current.GetInstance<IPromotionEngine>().GetPromotionItemsForCampaign(campaignLink);

Calculate promotions using workflows

You can run the promotion system with the workflow system (legacy) to calculate and remove promotions. Updated workflow activities use the EPiServer.Commerce.Marketing.IPromotionEngine to make calculations and manipulate the cart.

The promotion system is used by default in the workflows. Use one of these methods to disable it.

Update Configs\ecf.app.config.

<Application defaultApplicationName="ECApplication">
          <Features>
            <add feature="WorkflowsVNext" 
                 state="Disabled" 
                 type="Mediachase.Commerce.Core.Features.WorkflowsVNext, Mediachase.Commerce" />
          </Features>
        </Application>

Use the Servicelocator.

var featureSwitch = ServiceLocator.Current.GetInstance<IFeatureSwitch>();
        featureSwitch.Features.Add(new WorkflowsVNext());
        featureSwitch.DisableFeature(WorkflowsVNext.FeatureWorkflowsVNext);