Localized Promotions

Configure localized promotions per country through the SFCC Business Manager.

Localized Promotions

Applies uplift, duty, tax, and FX to the default price book value to derive localized prices.

The localized promotions functionality relies on the eswRetailerLocalizedPromotions job and a base XML file: base_promotions.xml. Before exporting the XML file, ensure that the base currency is selected in the base promotions.

Example Scenario

If the base promotion is created in USD, the system can automatically generate:

  • A promotion in EUR for shoppers selecting Eurozone countries
  • A promotion in GBP for shoppers selecting the United Kingdom
  • A promotion in SEK for Sweden

When a shopper selects a specific country or currency at the storefront, the corresponding localized promotion is applied to the qualified products.

Generating Localized Promotions

To generate localized promotions based on your base promotion configuration, follow the steps below:

Export the Base Promotion

  • Navigate to Merchant Tools → Online Marketing → Import & Export
  • Select the promotion for which you want to generate localized versions and click Next >>

Define the Export File

  • In the Export file field, enter base_promotions
  • Click Export to generate the base_promotions.xml file.

Upload to IMPEX Directory

  • Download the generated base_promotions.xml file.
  • Upload the file to the following path in the IMPEX directory /RefArch (or the appropriate Site ID)

Example path: Impex/src/ESW/promotions/RefArch/base_promotions.xml

Configure Localized Promotions Preference

  • Navigate to Site Preferences → Custom Preferences → ESW Pricing Configuration
  • Configure the ESW Localized Promotions preference, which stores the base promotion configuration required for localization

Execute the Localization Job

  • Import the eswRetailerLocalizedPromotions job from salesforce-plugin\link_eshopworld\sitesdata
  • After import, locate the job under Administration → Jobs → eswInternationalPromotions
  • Ensure the XML filename base_promotions is correctly referenced in the job script and stored in the appropriate promotions folder.

Required file path: Impex/src/ESW/promotions/RefArch/base_promotions.xml

Verify the Output

  • Once the job has executed successfully, go to Business Manager → Online Marketing → Promotions
  • Confirm that the localized promotions have been created.

Example:
If Buy5for50 is the base promotion, you should see localized versions such as Buy5for50_EUR, Buy5for50_GBP, etc.


Field Base Promotion Localized Promotion
Promotion ID Buy5for50 Buy5for50_EUR
Currency USD EUR
Threshold Amount 100 USD 83.59 EUR
Discount 15 USD 12.54 EUR
Promotional Price Books
Enhance the localized experience for the shopper by converting front-end prices into localized prices.
Localized Front-End Prices
Configure localized promotions per country through the SFCC Business Manager.