Promotions for Microsoft 365 NCE Plans
Microsoft has introduced special promotions to boost adoption of the new commerce experience (NCE) program.
Starting from CloudBlue Commerce 21.4, users can benefit from discounts and promotional pricing offered by Microsoft for their NCE program. During checkout, CloudBlue Commerce checks with Microsoft whether the purchase is eligible for promotional discounts. If eligible, the prices are reduced in the shopping cart and a subscription is sold at a discount.
Note: When browsing a catalog, resellers see the regular prices because the system does not detect whether a particular purchase is eligible for a promotion. The information about the NCE promotion availability must be delivered to resellers by other means: through emails, banners, pop-up notifications, and various training.
Methods of Applying NCE Promotions
CloudBlue Commerce can apply an NCE promotion to a subscription by one of two methods. A BSS feature selects the method:
-
As a price reduction. This method is controlled by the
FEA_NCE_PROMOfeature. The promotion reduces the regular prices of the subscription, so the reduced price is displayed as the regular price. For details, see NCE Promotions Applied as Price Reductions. -
As a discount. This method is controlled by the
FEA_NCE_VENDOR_DISCOUNTfeature. The promotion is stored separately from the subscription prices and is applied as a discount on top of the regular price at every level of the sales chain, including the provider cost when Cost of Sale is enabled. Users see the regular price struck through and the discounted price next to it. For details, see NCE Promotions Applied as Discounts.
Both features are disabled by default. When the FEA_NCE_VENDOR_DISCOUNT feature is enabled, it supersedes the FEA_NCE_PROMO and FEA_NCE_PROMO_END_DATE features: CloudBlue Commerce ignores them for new subscriptions and for subscriptions that have moved to the discount method. Existing subscriptions that have the promotion included in their prices keep the price reduction method, and these features still apply to them, until they move. For details, see Moving Existing Subscriptions to the Discount Method.
Both methods use the same integration with the Microsoft connector. CloudBlue Commerce receives the promotion data in the nce_promo_draft ordering parameter and the nce_promo_final fulfillment parameter.
How the NCE Promotion Functionality Works
Important: This functionality only works for Microsoft 365 NCE service plans created through the Product Lifecycle Management component.
When ordering a plan through the Marketplace, the wizard collects information about a reseller to detect whether their purchase is eligible for promotional discounts.
Note: On the first step of the checkout process, resellers see the regular prices because the system does not immediately detect whether a particular purchase is eligible for a promotion.
On the final step of the checkout process, during order confirmation, the system has all the required information from Microsoft to decide whether the promotion will be applied or not. As a result, a reseller sees the reduced price on the last step. This is the real price they will pay for this purchase and subscription.
NCE Promotions Applied as Price Reductions
This method is used while the FEA_NCE_VENDOR_DISCOUNT feature is disabled. It is also used for existing subscriptions that have not moved to the discount method yet.
CloudBlue Commerce applies the promotion percentage to the catalog prices and saves the reduced prices as the regular prices of the subscription. The order and the subscription do not indicate that a promotion was applied.
Compatibility with Other BSS Marketing Functionalities
The following rules apply to this method:
-
If a reseller or customer is set up to receive an additional discount (not a promotion), this discount will be applied on top of the already reduced price, further reducing it.
-
If a reseller or customer is set up to receive a promotion (not a discount), this promotion overrides the NCE promotion and is applied on top of the regular price.
-
If a purchase is made with Special Pricing provided during checkout, this special price is applied to the sales order and to the subscription, overriding both the regular price and the NCE promotion.
Known Limitations of Price Reductions
The following limitations apply to this method:
-
Classic Rating is out of scope, only new Rating Engine is supported.
-
The NCE promotion is not applied to a subscription if a Special Pricing or Deal Pricing for any product in the sales order was specified at the same time.
-
The O365 Connector must always provide the
nce_promo_draftandnce_promo_finalparameter values. If no promotions can be applied, an empty list of promotions is expected in the parameter value. -
Any change order that changes a subscription plan or period will result in the NCE promotion to be discarded from a subscription.
-
The Tiered and Volume pricing model is not supported.
NCE Promotions Applied as Discounts
This method is used when the FEA_NCE_VENDOR_DISCOUNT feature is enabled.
For each order, CloudBlue Commerce stores the promotion received from Microsoft as a separate discount record. The regular prices of the subscription do not change. When a charge is rated, Rating Engine applies the promotion as one more discount on the charge, at every level of the sales chain. When Cost of Sale is enabled for the marketplace, the promotion is also applied to the provider cost.
In order details, the NCE promotion is listed as a separate discount, next to other discounts that apply to the same charge. In UX1, the discounted price is marked with the Global discount applied hint, the same as for other discounts configured in BSS.
Orders That Apply the Promotion
A discount record is created for each order. The following table describes where each order type takes the promotion data from.
| Order type | Source of the promotion data |
|---|---|
|
Sales order |
The |
|
Change order that increases the resource amount (upsize) |
The last known values of the |
|
Change order that switches the subscription to another plan |
The last values of the |
|
Renewal order |
The same as for a plan switch. Microsoft does not send new promotion data on renewal. |
|
Billing order |
The discount record of the last provisioned order. If that order did not create a record, the billing order applies no promotion. |
The promotion end date received from Microsoft decides whether the promotion applies to a new term. A term that starts on or after the end date does not receive the promotion.
What Users See at Checkout
The NCE promotion is displayed the same way as a discount configured in BSS: the regular price is struck through, and the discounted price is displayed next to it. Microsoft confirms the promotion only on the last page of checkout, so the discounted price appears only on that page.
The following examples show the prices that a reseller sees for 5 units.
The reseller cost is $25.00 for each unit, and the NCE promotion is 10%. Checkout displays $125.00 on the first page. On the last page, $125.00 is struck through, and $112.50 is displayed. The subscription details display the same prices.
When a discount configured in BSS also applies, the two percentages are applied one after the other. For example, the reseller cost is $15.00 for each unit, a 10% discount is configured in BSS, and the NCE promotion is 10%. Checkout displays $75.00 struck through and $67.50 from the first page, because the BSS discount is known in advance. On the last page, $75.00 is still struck through, and the price to pay is $60.75. This is $12.15 for each unit: 10% off $15.00, and then 10% off the result.
The following figure displays the last page of checkout for this example.
The following figure displays the same subscription on the subscription details page.
Interaction with Other Prices, Discounts, and Promotions
Each level of the sales chain is evaluated separately. A price or a promotion that overrides the NCE promotion on one level does not remove the NCE promotion from the other levels. The NCE promotion interacts with other pricing as follows:
-
Discounts: A discount configured in BSS and the NCE promotion both apply.
-
Promotions and special prices: A promotion, including a promotion applied by a promotion code, or a special price takes over the charge it applies to. On that charge, neither the NCE promotion nor discounts apply. The other levels still receive the NCE promotion if they have no overriding price of their own. For example, a special price for an end customer takes over the end customer charge only, and the reseller and the provider cost still receive the NCE promotion.
-
Deal prices: A deal price provided in the order payload replaces the regular price. The NCE promotion and discounts are applied on top of it. For example, the catalog price is $10.00, the deal price is $9.00, the NCE promotion is 10%, and a discount is 10%. The NCE promotion brings the price to $8.10, and the discount brings it to $7.29.
Moving Existing Subscriptions to the Discount Method
Subscriptions that were created before the FEA_NCE_VENDOR_DISCOUNT feature was enabled have the promotion included in their regular prices. To avoid a double discount, CloudBlue Commerce moves such a subscription to the discount method only when the subscription is renewed and both of the following conditions are met:
-
The subscription prices are not frozen. For details on frozen prices, see Synchronizing a Single Subscription.
-
The subscription uses subscription event history. For details, see Date Adjustments for Subscriptions in the Vendor Time Zone.
During the renewal, CloudBlue Commerce rebuilds the subscription prices without the promotion and creates a discount record. Until a subscription moves, it uses the price reduction method, and the FEA_NCE_PROMO and FEA_NCE_PROMO_END_DATE features and the NCE_APPLY_PROMO_TO_END_CUSTOMER parameter still apply to it. A subscription with frozen prices does not move.
Known Limitations of Discounts
The following limitations apply to this method:
-
Classic Rating is not supported. The subscription must be rated by Rating Engine core v2.
-
The Microsoft connector must always provide the
nce_promo_draftandnce_promo_finalparameter values. If no promotions can be applied, an empty list of promotions is expected in the parameter value. -
The
NCE_APPLY_PROMO_TO_END_CUSTOMERconfiguration parameter is ignored. The promotion always applies to end customers.
Migration Orders and Seamless Move
The payload of a migration order can contain special prices or deal prices. Seamless Move places migration orders, so the same rules apply to it. For Microsoft 365 subscriptions, Seamless Move uses deal prices.
Important: The FEA_NCE_VENDOR_DISCOUNT feature changes how deal prices in a migration order are interpreted. Before you enable the feature, change your procedures for preparing migration order payloads and Seamless Move input.
Prices in the payload are interpreted as follows:
-
Special price: A final price. It overrides both the NCE promotion and discounts. Provide the price that the customer must pay.
-
Deal price while the
FEA_NCE_VENDOR_DISCOUNTfeature is disabled: A price that already includes the NCE promotion. The promotion is not applied again. Discounts configured in BSS are applied on top of the deal price. -
Deal price when the
FEA_NCE_VENDOR_DISCOUNTfeature is enabled: A regular price before the NCE promotion. If the payload contains thence_promo_finalparameter, the promotion is applied on top of the deal price, and then discounts are applied.
The following table shows which price to provide for a subscription with a regular Microsoft price of $10.00 and a 10% NCE promotion. The target price is $9.00 with the NCE promotion only, and $8.10 when a 10% discount configured in BSS also applies.
| Target price | Special price | Deal price, feature disabled | Deal price, feature enabled |
|---|---|---|---|
|
$9.00, NCE promotion only |
$9.00 |
$9.00 |
$10.00 |
|
$8.10, NCE promotion and discount |
$8.10 |
$9.00 |
$10.00 |
When the FEA_NCE_VENDOR_DISCOUNT feature is enabled, provide the regular historical Microsoft price as the deal price, not the price that the customer actually paid. A price that already includes the promotion results in a double discount.
How to Enable the NCE Promotion Functionality
The NCE promotion functionality is configured in the BSS database. Select the method of applying NCE promotions before you start.
Important: This functionality is enabled system-wide by the support team.
Enablement
To enable this functionality, complete the following steps:
-
Enable one of the following special features in the Billing database:
-
FEA_NCE_VENDOR_DISCOUNT: to apply NCE promotions as discounts. Before you enable it, prepare your procedures as described in Migration Orders and Seamless Move. -
FEA_NCE_PROMO: to apply NCE promotions as price reductions. If you wish NCE promotions to re-apply on subscription renewal using the promotion end date obtained from Microsoft, enable this feature additionally:FEA_NCE_PROMO_END_DATE.
-
-
Store a Public Key required for the signature verification in the GlobalConf table of the BSS database. You can find this key here, or apply to the respective support team, if you cannot access this page.
INSERT INTO "GlobalConf" ("ParamName", "ParamValue") values ('NCE_PUBLIC_KEY', '-----BEGIN PUBLIC KEY----- ... -----END PUBLIC KEY-----');(Optional) If the signature verification is not required (for example, for troubleshooting purposes), you can disable it with the following parameter in GlobalConf:
INSERT INTO "GlobalConf" ("ParamName", "ParamValue") values ('NCE_SKIP_SIGNATURE_VERIFICATION', 'true'); -
Restart the BSS application. The features are read when the application starts, so a change takes effect only after the restart.
Changing Applicability of NCE Promotions to End Customers
This setting applies only to NCE promotions applied as price reductions. NCE promotions applied as discounts always apply to end customers.
By default, NCE promotions apply to resellers and end customers. You can change this behavior system-wide so that end customers do not receive this kind of promotions. Complete these steps to disable NCE promotions applicability to end customers:
- Connect to the BSS database.
-
Add the configuration parameter to the
GlobalConftable:INSERT INTO "GlobalConf" ("ParamName", "ParamValue") values ('NCE_APPLY_PROMO_TO_END_CUSTOMER', 'FALSE');
After that, new NCE promotions will no longer be applicable to end customers. However, existing subscriptions will not be affected by that change.