ssossossosso
Documentation Home »User Guide »Pricing »Configuring Price Management
current version

Configuring Price Management

OroCommerce groups price configuration options into the following categories:

Global Currency Configuration

Global currency configuration helps you:

  • Add and remove currencies from the allowed currencies list.
  • Set the base currency.
  • Specify the conversion rate to and from the base currency.
  • Define the order used when the currencies are displayed to the front store and management console users.
  • Toggle between the currency display formats (currency code, e.g. USD, and currency symbol, e.g. $).

Note

The website level configuration has higher priority and overrides these configuration settings.

To change the default global currency settings:

  1. Navigate to System > Configuration in the main menu.
  2. Select System Configuration > General Setup > Currency in the menu to the left.

Note

For faster navigation between the configuration menu sections, use Quick Search.

The Currency Settings page opens. It contains the following information:

  • Base — A flag that marks the base currency that is used by default to display totals, budgets, and amounts.

  • Currency Name — International name of the currency that follows ISO 4217 standard (e.g. US dollar).

  • Currency Code — International currency code that follows ISO 4217 standard (e.g. USD).

  • Currency Symbol — Graphical symbol that is used to denote a currency (e.g. $).

  • Rate From — The conversion rate from the selected currency to the base currency. Used to calculate transaction amounts (e.g. opportunity budget) in the base currency if they were entered in other currencies. Maximum precision is 10 digits.

  • Rate To — The conversion rate from the base currency to the selected currency. Used to calculate new exchange rates when the base currency is changed. Maximum precision is 10 digits.

  • Display Format — A toggle between the ISO code and symbol representation of the currency.

    The order subtotal when the display format is set to Currency Code:

    The order subtotal when the display format is set to Currency Symbol:

  1. To customize the Display Format:

    1. Clear the Use Default check box next to the option.
    2. Select the new option value (either Currency Code or Currency Symbol).
  2. To change the base currency, click the Base option in the corresponding row.

    Before:

    After:

    Important

    Changing base currency requires manual update of the money values (budgets, totals, revenues, etc.). You will be prompted to confirm the change.

  3. To modify the currency exchange rate to and from the base currency, edit the Rate To and Rate From values in the corresponding row.

  4. To add a currency to the allowed currencies list:

    1. Select the currency from the Allowed Currencies list and click Add next to it.

      The currency is appended to the top of the list.

    1. Fill in the exchange rate to and from the base currency.
  5. To delete a currency from the allowed currencies list, click the Delete Currency icon at the end of the corresponding row.

    Note

    Deleting base currency is restricted. To unblock delete action for the currency that is set as base, switch to a different base currency.

  6. To change the currency sort order, click and hold the Sort icon, and drag the currency up or down the list.

  7. To roll back any changes to the currency settings, click Revert on the top right.

  1. Click Save Settings.

Currency Configuration per Website

Currency configuration a the particular website helps you:

  • Enable all or some currencies from the allowed currencies list to be used in OroCommerce front store and management console for this website.
  • Select the currency that is shown by default in the OroCommerce front store and management console for this website.

Note

The website level configuration has higher priority and overrides these configuration settings.

To change the default currency settings for the website:

  1. Navigate to System > Websites in the main menu.
  2. For the necessary website, click the More Options menu at the end of the row, and then click the Configure icon to start editing the configuration.
  3. Select Commerce > Catalog > Pricing in the menu to the left.

Note

For faster navigation between the configuration menu sections, use Quick Search.

The following page opens:

  • Enabled Currencies — The subset of allowed currencies that is available for the customer user by default on this website.

  • Default Currency — The currency used by default to show prices in the front store on this website.

  1. To customize any of these options:

    1. Clear the Use System check box next to the option.
    2. Select the new option.
  2. Click Save.

Global Pricing Configuration

Global pricing configuration helps you:

  • Set price precision and price rounding strategy.
  • Configure default price lists, their priority and merge strategy to get the necessary resulting combination of prices that are shown on the websites and for the customers whenever their price list settings fall back to the system default.
  • Specify an offset in hours that helps launch combined price list recalculation before price change is activated.
  • Enable all or some currencies from the allowed currencies list to be used in OroCommerce front store and management console.
  • Select the currency that is shown by default in the OroCommerce front store and management console.

Note

The website level configuration has higher priority and overrides these configuration settings. Customer group configuration overrides configuration on the website level. Custom configuration on the customer level has the highest priority.

To change the default global pricing settings:

  1. Navigate to System > Configuration in the main menu.
  2. Select Commerce > Catalog > Pricing in the menu to the left.

Note

For faster navigation between the configuration menu sections, use Quick Search.

The Pricing page opens. It contains the following information:

  • Pricing Precision — The number of digits that are allowed in the fractional part of the price (e.g. precision of 4 enables your sales manager use prices like $10.0001).

  • Pricing Rounding Type — The rounding type that is used when calculated product price has more digits in the fractional part than allowed by the Pricing Precision value. Please use one of the following options:

    • Ceil — Rounds to the nearest integer that is not less than the price with the fractional part (e.g. 23.5 is rounded to 24; 23.3 is rounded to 24; 23.7 is rounded to 24)
    • Floor — Rounds to the nearest integer that does not exceed the price with the fractional part (e.g. 23.5 is rounded to 23; 23.3 is rounded to 23; 23.7 is rounded to 23)
    • Half Down — Uses ceil rounding for the prices with fractional part that is bigger than 0.5 and uses floor rounding for the prices with a fractional part that is that lower than or equal to 0.5 (e.g. 23.5 is rounded to 23; 23.3 is rounded to 23; 23.7 is rounded to 24)
    • Half Up — Uses ceil rounding for the prices with fractional part that is bigger than or equal to 0.5 and uses floor rounding for the prices with a fractional part that is that lower than 0.5 (e.g. 23.5 is rounded to 24; 23.3 is rounded to 23; 23.7 is rounded to 24)
    • Half Even — Uses ceil rounding for the prices with fractional part that is bigger than 0.5, uses floor rounding for the prices with a fractional part that is that lower than 0.5, and rounds the price to the nearest even integer when the price fraction is exactly 0.5 (e.g. 23.5 is rounded to 24; 23.3 is rounded to 23; 23.7 is rounded to 24)
  • Price Lists — A set of default price lists that may be used for price calculation. Website, customer group, and customer may have their own set of price lists that overrides the default configuration.

    When the Minimal Price is selected as the pricing strategy, OroCommerce looks up the minimal price for various tiers of amount and the product units:

    When the Merge by priority is selected as the pricing strategy, the OroCommerce considers the price list priority and Merge Allowed flags to look up all the available price per units and per tiers of amount:

    Note

    Price lists with higher priority are on top.

  • Offset Of Processing CPL Prices — A time frame (in hours) before the scheduled price change when the price list recalculation and reindex should happen to prepare the future actual prices in the OroCommerce front store.

  • Pricing Strategy — The strategy that is used for a price lookup.

    OroCommerce may search for the most close match of the product price in the selected units and currency for the requested product quantity in one of the following ways:

    • Using Minimal Price strategy — From the default or customized set of price lists, OroCommerce collects all products prices that match product units, currency, and the requested product quantity, and selects the minimal price per tier and per unit as the one to show to the customer user:

    • Using Merge by priority strategy — OroCommerce walks through the default or customized set of price lists starting with the price list of the top priority and moving along to those with the lower priority.

      When the product price is initially found in the price list with the Merge Allowed option enabled, the price and the price list priority is collected for further evaluation and merge. Prices for other units and for other tiers of product quantity may be collected form the same price list and from other price lists with the Merge Allowed option enabled. The tier/unit prices with the highest priority are shown to the customer user.

      When the product price is initially found in the price list with the Merge Allowed option disabled, OroCommerce collects the product prices for all units and for all tiers of product quantity from this price list only. Other price lists are not taken into account, as price merge is not allowed. The units and tiers of quantity where the price is missing are hidden from the customer user.

  • Enabled Currencies — The subset of allowed currencies that is available for the customer user by default.

    Note

    The website level configuration has higher priority and overrides the global configuration settings.

  • Default Currency — The currency that is used by default to show prices in the front store.

    Note

    The website level configuration has higher priority and overrides the global configuration settings.

  1. To customize the option configuration:

    1. Clear the Use Default check box next to the option.
    2. Select or type in the new option value.
  2. To add a price list to the default price lists:

    1. Click + Add Price List and select the price list in the newly added line. After you start typing the price list name, the list of suggestions that match your entry appears. Press Enter or click the suggested value to add the price list.

      Note

      The price list is appended to the bottom of the list and, initially, has lower priority then existing price lists. Adjust the price list priority if necessary and specify whether the merge is allowed (the later is shown only for the Merge by priority price selection strategy).

  3. To control the way prices are merged into the combined price list, select or clear the Merge Allowed option for the price lists.

    When merge is allowed, the prices for the tiers and units that are missing in the higher priority price list may be covered by the prices from the lower priority price lists that should support price merge too.

  4. To delete a price list from the default price lists, click the Deactivate at the end of the corresponding row.

  5. To change the price list priority, click and hold the Sort icon, and drag the price list up or down the list.

  6. To roll back any changes to the currency settings, click Revert on the top right.

  1. Click Save Settings.

Price List Configuration

In the website, customer group, and customer details, the Price Lists section contains a set of price lists used for price calculation on a website, for a customer group, or for a customer. Price list configuration may fall back to the system default price list configuration or to the default price list configuration for the website, customer group, and customer.

Price Lists Fallback Options

Configuration Level Fallback Configuration Options
System Configuration
Website
  • System Configuration (config)
  • Current website only
Customer Group
  • Website
  • Current customer group only
Customer
  • Customer Group
  • Current customer only

Price Selection Strategy

Depending on the price selection strategy that is selected globally in the system configuration, every price list might or might not have the Merge Allowed option.

When the Minimal Price is selected as the pricing strategy, OroCommerce looks up the minimal price for various tiers of amount and the product units, and the Merge Allowed option is ignored and hidden:

When the Merge by priority is selected as the pricing strategy, the OroCommerce considers the price list priority and Merge Allowed flags to look up all the available price per units and tiers of amount:

Note

Price lists with higher priority are on top.

Default

See Price Lists option description in the Global Pricing Configuration topic.

Per Website

To change the default price list settings for the website:

  1. Navigate to System > Websites in the main menu.
  2. Click the More Options menu to the right of the necessary website and click the Edit icon to start editing the website details.

Note

For faster navigation between the configuration menu sections, use Quick Search.

  1. In the Price Lists section:

    1. Select one of the following values for the Fallback option for the users who are visiting this website:
    1. To add a price list, click + Add Price List and select the price list in the newly added line. After you start typing the price list name, the list of suggestions appears. Press Enter or click the suggested value to add the price list.

      Note

      The price list is appended to the bottom of the list and, initially, has a lower priority than the existing price lists. Adjust the price list priority if necessary and specify whether the merge is allowed (the later is shown only for the Merge by priority price selection strategy).

    2. To control the way prices are merged into the combined price list, select or clear the Merge Allowed option for the price lists.

      When merge is allowed, the prices for the tiers and units that are missing in the higher priority price list may be covered by the prices from the lower priority price lists that support the price merge.

    3. To delete a price list from the default price lists, click the Deactivate icon at the end of the corresponding row.

    4. To change the price list priority, click and hold the Sort icon, and drag the price list up or down the list.

  2. Click Save.

Per Customer Group

To change the price list settings for the customer group:

  1. Navigate to Customers > Customer Group in the main menu.

  2. Click the More Options menu to the right of the necessary customer group and then click the Edit icon to start editing the group details.

  3. In the Price Lists section, do the following to configure price lists that are used for price calculation when the customer users who belong to this customer group access the particular website (for example, Default):

    Tip

    Switch between the websites using tabs.

    1. Select one of the following valus for the Fallback option:
    1. To add a price list, click + Add Price List and select the price list in the newly added line. After you start typing the price list name, the list of suggestions appears. Press Enter or click the suggested value to add the price list.

      Note

      The price list is appended to the bottom of the list and, initially, has a lower priority than the existing price lists. Adjust the price list priority if necessary and specify whether the merge is allowed (the later is shown only for the Merge by priority price selection strategy).

    2. To control the way prices are merged into the combined price list, select or clear the Merge Allowed option for the price lists.

      When merge is allowed, the prices for the tiers and units that are missing in the higher priority price list may be covered by the prices from the lower priority price lists that support the price merge.

    3. To delete a price list from the default price lists, click the Deactivate icon at the end of the corresponding row.

    4. To change the price list priority, click and hold the Sort icon, and drag the price list up or down the list.

  4. Click Save.

Per Customer

To change the price list settings for the customer:

  1. Navigate to Customers > Customer in the main menu.

  2. Click the More Options menu to the right of the necessary customer and then click the Edit icon to start editing customer details.

  3. In the Price Lists section, do the following to configure price lists that are used for price calculation when the customer users access the particular website (for example, Default):

    Tip

    Switch between the websites using tabs.

    1. Select one of the following values for the Fallback option:
      • Customer Group — OroCommerce uses Price Lists from the customer group configuration to calculate the prices shown in the front store.
      • Current customer only — For price calculation, OroCommerce uses the configurations (per website) in the current customer group.
    1. To add a price list, click + Add Price List and select the price list in the newly added line. After you start typing the price list name, the list of suggestions appears. Press Enter or click the suggested value to add the price list.

      Note

      The price list is appended to the bottom of the list and, initially, has a lower priority than the existing price lists. Adjust the price list priority if necessary and specify whether the merge is allowed (the later is shown only for the Merge by priority price selection strategy).

    2. To control the way prices are merged into the combined price list, select or clear the Merge Allowed option for the price lists.

      When merge is allowed, the prices for the tiers and units that are missing in the higher priority price list may be covered by the prices from the lower priority price lists that support the price merge.

    3. To delete a price list from the default price lists, click the Deactivate icon at the end of the corresponding row.

    4. To change the price list priority, click and hold the Sort icon, and drag the price list up or down the list.

  4. Click Save.

Browse maintained versions:
current1.4