Demandware Provider Configuration

The Demandware provider manages the relationship between Salesforce B2C Commerce and Order Management, not including order records. It's important that you read through and understand all of the available settings to plan your configuration.

For general information on configuring a provider, see Providers.

The Demandware provider is always configured at the company level. However, some item data that is imported from B2C Commerce to Order Management is accessed in the Demandware provider at the item level.

Demandware Provider Controls

In addition to provider settings, the Demandware provider includes the following control. It's intended for use by Support for testing the integration of B2C Commerce with Order Management.

Note: Other testing controls have been moved to the B2C Commerce Integration Provider.

Demandware Provider Settings

The following table describes the functionality of each configurable setting. Hovering over the help icon () next to certain fields in the user interface opens a tool tip.

Provider setting label Data description Setting values
Category Sync Controls the synchronization of category information between B2C Commerce and Order Management. Select one:
  • Disabled: (default) Categories are not synchronized between Order Management and B2C Commerce. Changes to categories in one are not reflected in the other.
  • BF >> Demandware: Category information is mastered in Order Management. Changes to categories in Order Management are applied to B2C Commerce by scheduled tasks.
  • Demandware >> BF: Category information is mastered in B2C Commerce. Changes to categories in B2C Commerce are applied to Order Management by scheduled tasks.
Category Prefix Import Map Lets you apply a catalog prefix to the code of each category imported from B2C Commerce. It has no effect unless the Category Sync setting is Demandware >> BF. List the name of each catalog in your system along with ‘=’ and a prefix, one per line, as follows:

first_catalog_name=prefix1- second_catalog_name=prefix2-

Catalog Sync Controls the synchronization of catalog information between B2C Commerce and Order Management. Select one:
  • Disabled: (default) Catalogs are not synchronized between Order Management and B2C Commerce. Changes to catalogs in one are not reflected in the other.
  • BF >> Demandware: Catalog information is mastered in Order Management. Changes to catalogs in Order Management are applied to B2C Commerce by scheduled tasks.
  • BF >> Demandware (Seed Only): Catalog information is mastered in Order Management. Changes to catalogs in Order Management are applied to B2C Commerce by scheduled tasks.
  • BF >> Demandware >> BF: Catalog information is mastered in Order Management but can be changed in B2C Commerce. Changes to catalogs in Order Management are applied to B2C Commerce by scheduled tasks. Changes made to catalogs in B2C Commerce are imported back to Order Management by scheduled tasks.
  • Demandware >> BF: Catalog information is mastered in B2C Commerce. Changes to catalogs in B2C Commerce are applied to Order Management by scheduled tasks.
  • Demandware >> BF (Seed Only): Catalog information is mastered in B2C Commerce. Changes to catalogs in B2C Commerce are applied to Order Management by scheduled tasks.
  • Demandware >> BF (with reverse seeding): Catalog information is mastered in B2C Commerce but can be changed in Order Management. Changes to catalogs in B2C Commerce are applied to Order Management by scheduled tasks. Changes made to catalogs in Order Management are imported back to B2C Commerce by scheduled tasks.
Catalog Sync To Controls the synchronization of catalog records between Order Management and B2C Commerce. Select one:
  • Stage: Causes records to be synchronized with the B2C Commerce stage instance.
  • Production: Causes records to be synchronized with the B2C Commerce production instance.
Catalog Sync Delta Enabled Enables a task that runs more frequently than the regular catalog synchronization task. It synchronizes only any catalog records that have changed since the last full synchronization. This setting is disabled by default. Select to enable
Catalog Export Includes Controls whether certain fields are included in catalog records that are exported to B2C Commerce. It has no effect unless the Catalog Sync setting is one of the following:
  • BF >> Demandware
  • BF >> Demandware (Seed Only)
  • BF >> Demandware >> BF
Check the box next to a field to include it in the record export. Leave a box unchecked to exclude that field from the export.
Select one or more:
  • OnlineFlag
  • Display Name
  • Short Description
  • Long Description
  • Category Assignment
  • Classification Category
Catalog Export Filter Visible When enabled, only visible Item records (with the Visible setting enabled) are included in catalog data exports from Order Management to B2C Commerce. When it isn't checked, all records are included. It has no effect unless the Catalog Sync setting is one of the following:
  • BF >> Demandware
  • BF >> Demandware (Seed Only)
  • BF >> Demandware >> BF
Select to enable
Catalog Export Sync Filter Controls which records are included in the regular catalog synchronization task. Select one:
  • None (all items are included)
  • New (only new items are included)
  • New or Modified (only new and modified items are included)
Catalog Import Includes Controls whether certain fields are included in catalog records that are imported to Order Management from B2C Commerce. It has no effect unless the Catalog Sync setting is one of the following:
  • Demandware >> BF
  • Demandware >> BF (Seed Only)
  • Demandware >> BF (with reverse seeding)
  • BF >> Demandware >> BF
Check the box next to a field to include it in the record import. Leave a box unchecked to exclude that field from the import.
Select one or more:
  • Display Name
  • Short Description
  • Long Description
  • Category Assignment (path)
  • Classification Category (name)
Catalog Sync Import Product XML Check this box to import product XML when importing catalog records from B2C Commerce. If this box is left unchecked, then product XML isn't imported. The imported XML for a product can be found in the Item-level Demandware provider for the associated Item. This setting has no effect unless the Catalog Sync setting is one of the following:
  • Demandware >> BF
  • Demandware >> BF (Seed Only)
  • Demandware >> BF (with reverse seeding)
  • BF >> Demandware >> BF
Select to enable
Catalog Map Controls the creation of catalogs in B2C Commerce when exporting catalog data from Order Management.

Map each catalog Name in Order Management to a catalog name in B2C Commerce, one catalog per line, as follows:

first_OM_catalog_name=first_B2C_Commerce_catalog_name

second_OM_catalog_name=first_B2C_Commerce_catalog_name

If you don't use catalogs in Order Management, but wish to name the default catalog in B2C Commerce, make an entry like the following.

Default=B2C_Commerce_catalog_name

Customer Sync Not used. N/A
Gift Certificate Item Code To map B2C Commerce gift certificates to a gift certificate item in Order Management, enter the item code for the Order Management gift certificate Item here. If you don't, and gift certificates are imported from B2C Commerce, then Order Management creates and maps a gift certificate item with the code DW_GIFT_CERTIFICATE. Enter text
Image Sync Controls the synchronization of images between B2C Commerce and Order Management. Select one:
  • Disabled: (default) Images are not synchronized between Order Management and B2C Commerce. Changes to images in one are not reflected in the other.
  • BF >> Demandware: Images are mastered in Order Management. Changes to images in Order Management are applied to B2C Commerce by scheduled tasks.
  • Demandware >> BF: Images are mastered in B2C Commerce. Changes to images in B2C Commerce are applied to Order Management by scheduled tasks.
Image WebDAV Path The path used for storing remote images. Usually, they are not used. Enter text
Inventory Sync Controls the synchronization of inventory information between B2C Commerce and Order Management. Select one:
  • Disabled: (default) Inventory data isn't synchronized between Order Management and B2C Commerce. Changes to inventory in one are not reflected in the other.
  • BF >> Demandware: Inventory data is mastered in Order Management. Changes to inventory in Order Management are applied to B2C Commerce by scheduled tasks.
Inventory Sync Delta Enabled Enables a task that runs more frequently than the regular inventory synchronization task. It synchronizes only any inventory records that have changed since the last full synchronization. This setting is disabled by default. Select to enable
Inventory Sync Includes Controls whether certain fields are included in inventory data that is exported from Order Management to B2C Commerce. It has no effect unless the Inventory Sync setting is BF >> Demandware. Check the box next to a field to include it in the record import. Leave a box unchecked to exclude that field from the import. Select one or more:
  • Suspended
  • Vendor Quantities
Inventory Holdback Used to maintain a reserve inventory level when inventory is mastered in Order Management. If a value is entered here, that amount is subtracted from inventory levels exported to B2C Commerce (to a minimum level of 0). If a percent sign (%) is appended to the value, then the value is treated as a percentage. For example, consider an item that has an inventory of 100 units in Order Management. An inventory holdback value of 5 would cause an inventory of 95 to be exported to B2C Commerce. An inventory holdback value of 25% would cause an inventory of 75 to be exported to B2C Commerce.

You can set this value at the item level, which overrides the company-level value for that item. You cannot set it at the site level.

Enter text
Inventory Sync Fulfillment Site Feed This setting enables the export of store-level inventory data. By default, it isn't set. Select one:
  • Enabled
  • Disabled
Order Sync Controls the synchronization of order data between B2C Commerce and Order Management. Select one:
  • Disabled: (default) Order data isn't synchronized between Order Management and B2C Commerce. Changes to orders in one are not reflected in the other.
  • Demandware >> BF: Order data is mastered in B2C Commerce. Changes to orders in B2C Commerce are applied to Order Management by scheduled tasks.
Order Sync To Controls the synchronization of order records between Order Management and B2C Commerce.

This setting is always Production except in rare circumstances (usually for testing purposes).

Select one:
  • Stage: Order records are synchronized with the B2C Commerce Stage instance.
  • Production: Order records are synchronized with the B2C Commerce Production instance.
Order Import Email Behavior Controls whether Order Management sends emails for orders imported from B2C Commerce. Select one:
  • Send: Emails are sent.
  • Suppress: Emails are not sent.
Order Import Hold Behavior Controls whether Order Management clears shopping cart inventory holds (on hold) when orders are imported from B2C Commerce. Select one:
  • Clear on Import: Inventory holds are cleared when orders are imported.
  • None: Inventory holds are not cleared when orders are imported.
Catalog Import Includes Controls whether certain fields are included in catalog records that are imported to Order Management from B2C Commerce. It has no effect unless the Catalog Sync setting is one of the following:
  • Demandware >> BF
  • Demandware >> BF (Seed Only)
  • Demandware >> BF (with reverse seeding)
  • BF >> Demandware >> BF
Check the box next to a field to include it in the record import. Leave a box unchecked to exclude that field from the import.
Select to enable:
  • Source Code
Order Import Visible Behavior Provides the option to cause new orders to be set as not visible when first imported from B2C Commerce. It allows an opportunity for some pre-processing before orders become visible to customers. The default setting is Visible. The Non-Visible option is rarely used.
Note: Non-visible orders can't be made visible from within the UI.
Select one:
  • Visible: Newly imported orders are visible.
  • Non-Visible: Newly imported orders are not visible.
Handling Item Codes Maps item codes from B2C Commerce to an order handling fee in Order Management. To use it, simply enter the item codes that you wish to map, separated by the pipe character (|). Enter text
Price Book Sync Controls the synchronization of price book information between B2C Commerce and Order Management.

This setting isn't directly related to configuring Order Management to retrieve pricing and tax data from B2C Commerce via the pricing engine settings. It refers specifically to synchronizing the prices stored in Order Management with price books in B2C Commerce on a set schedule. The pricing engine settings configure Order Management to retrieve pricing and tax information from B2C Commerce on an as-needed basis.

Select one:
  • Disabled: (default) Order Management prices are not synchronized with B2C Commerce price books. Changes to prices in one are not reflected in the other.
  • BF >> Demandware: Pricing information is mastered in Order Management. Changes to pricing in Order Management are applied to B2C Commerce price books by scheduled tasks.
  • Demandware >> BF: Pricing information is mastered in B2C Commerce price books. Changes to pricing in B2C Commerce price books are applied to Order Management by scheduled tasks.
  • BF >> Demandware >> BF: Pricing information is mastered in Order Management but can be changed in B2C Commerce. Changes to pricing in Order Management are applied to B2C Commerce price books by scheduled tasks. Changes made to pricing in B2C Commerce price books are imported back to Order Management by scheduled tasks.
Price Book Sync To Controls the instance of B2C Commerce whose price books are synchronized with Order Management pricing.

This setting is not directly related to the pricing engine settings.

Select one:
  • Stage: Pricing data is synchronized with the B2C Commerce Stage instance.
  • Production: Pricing data is synchronized with the B2C Commerce Production instance.
Price Book Map Maps Order Management simple pricing to price books in B2C Commerce, one element per line. Its behavior varies depending on where your pricing is mastered:
  • Pricing Mastered in Order Management: This field maps sale prices, MSRPs, and costs in Order Management to price books in B2C Commerce using the following syntax.

    B2C_Commerce_Sale_Price_Book_ID=BasePrice
    B2C_Commerce_List_Price_Book_ID=BaseRetail
    B2C_Commerce_Cost_Price_Book_ID=BaseCost

    If no entry is made in this field, then the sales prices are exported to B2C Commerce.
  • Pricing Mastered in B2C Commerce: This field maps the wholesale prices, MSRPs, and costs in Order Management to price books in B2C Commerce using the following syntax:

    B2C_Commerce_Sale_Price_Book_ID=WholesalePrice
    B2C_Commerce_List_Price_Book_ID=RetailPrice
    B2C_Commerce_Cost_Price_Book_ID=Cost

    If no entry is made in this field, then no price books are imported.
This setting isn't directly related to the pricing engine settings.
Enter text
Site Map Maps site IDs from B2C Commerce to catalog codes in Order Management, one pair per line. When orders are imported from B2C Commerce, this map is used to assign a catalog to each order according to its site. The pricing engine endpoints can also reference this map. In that case, a shopping cart's catalog in Order Management determines the B2C Commerce site from which pricing information is retrieved. The syntax is as follows:

B2C_Commerce_Site_ID=OM_Catalog_Code

Note that the B2C Commerce site ID is retrieved from the order data file names: Orders_[siteId]_[timestamp]*.xml. If you use non-standard file names for importing order data, base this mapping on the term that replaces the site ID in your file names.

Enter text
Site Generate Catalogs Checking this box causes a site-level catalog to be generated. A site-level catalog contains only categories and item category associations. By default, it isn't checked. Select to enable
Payment Methods Map Maps payment method codes in B2C Commerce to payment method IDs in Order Management, one method per line. Create this map before running Order Management with B2C Commerce. The syntax is as follows:

B2C_Commerce_Payment_Method_Code=OM_Payment_Method_ID

Enter text
Shipping Methods Map (Legacy connector only) Maps shipping method codes in B2C Commerce to shipping method names in Order Management, one method per line. Create this map before running Order Management with B2C Commerce. The syntax is as follows:

B2C_Commerce_Shipping_Method_Code=OM_Shipping_Method_Name

Enter text
Demandware Site Map (DEPRECATED -- leave this field empty.) N/A
Pricing Engine Specifies the system to use for pricing. The default setting is BusinessFlow.

This setting isn't directly related to the price book settings. The pricing engine setting, when set to Demandware, causes Order Management to retrieve pricing and tax data from B2C Commerce on an as-needed basis. The price book settings control the scheduled synchronization of B2C Commerce price book data with pricing data stored in Order Management.

Select one:
  • BusinessFlow (Order Management)
  • Demandware
Pricing Engine Connection String (DEPRECATED -- leave this field empty.) The connection string to use to obtain an authorization token for making external pricing calls.

When Order Management is integrated with B2C Commerce, this string is provided by Support or your integrator. Don't edit it.

This setting isn't directly related to the price book settings.

Enter text
Pricing Engine Endpoints The external pricing engine API endpoints.

When Order Management is integrated with B2C Commerce, these endpoints are provided by Support or your integrator. Don't edit them.

This setting isn't directly related to the price book settings.

The following relative URLs are used when retrieving pricing from B2C Commerce:

  • Base
  • Shop (appended to Base)
  • Integration (appended to Base)
  • Default (optional -- specifies the site ID to use when no catalog has been specified)

The token (site) in these URLs is replaced with the B2C Commerce site ID corresponding to the current catalog, as defined in the Site Map field.

For example:

Base=/s/{Site}/dw/
Shop=shop/v17_3/
Integration=integration/v17_3
Default=Default_Catalog1
Suppress Tasks Used to temporarily suppress synchronization tasks. It allows a task to be stopped for a time without changing its normal configuration. Select one or more:
  • Order Sync
  • Category Sync
  • Tax Sync
  • Inventory Sync
  • Catalog Sync
  • Master Import
  • Price Sync
  • Customer Sync
  • File Transfers
Tenant DNS An address used for communication with B2C Commerce. If there are two comma-separated entries, then the first is the B2C Commerce production address, and the second is the B2C Commerce stage address. It's set up by Support or your integrator. Can have two entries, separated by a comma: production, then stage
Account Manager Connection String An address used for communication with B2C Commerce. It's set up by Support or your integrator. The format of this string is as follows:

DNS=URL;UserName=user_name;Password=password

(System) System Enabled This setting enables synchronization between Order Management and B2C Commerce. By default, it isn't set. Select to enable
(System) System Connection String The connection string for the SFTP folder for the data files being transferred between Order Management and the production instance of B2C Commerce. This string must be defined before running Order Management with B2C Commerce. It's set up by Support or your integrator. Enter text
(System) System Connection String (Stage) The connection string for the stage SFTP folder for the data files being transferred between Order Management and the stage instance of B2C Commerce. This string must be defined before running Order Management with B2C Commerce. It's set up by Support or your integrator. Enter text
(System) System Directory Map Used to override the path following the system connection string. It's set up by Support or your integrator. Enter text
(System) System File Compression Specifies the file compression type used on the data transferred between Order Management and B2C Commerce.

The default setting is GZip.

Select one:
  • None
  • GZip
  • Zip
(System) Encryption Key

Holds the private key used when communication between Order Management and B2C Commerce is encrypted. It's set up by Support or your integrator.

When the value is entered or changed, it's masked for security.

Enter text
(System) System Override Map Can be used to override the Inventory Sync setting by entering either of the following values:

Inventory_Sync=Disabled

Inventory_Sync= BF >> Demandware

Enter text
X Privacy Update: We use cookies to make interactions with our websites and services easy and meaningful, to better understand how they are used and to tailor advertising. By continuing to use this site you are giving us your consent to do this.