NCE Migration Tool - Alongside the "Auto-Migration" Feature
This page describes the purpose and function of the legacy to New Commerce Experience (NCE) migration tool in accordance with the ‘Auto-Migration’ feature, which is used to migrate and transform existing Microsoft (legacy) subscriptions to their respective Microsoft NCE subscriptions under the Microsoft Partner Center.
What is the NCE Migration Tool?
The Migration Tool is a feature introduced in the 3.28.59 Release which allows the migration of active and synchronized Microsoft legacy subscriptions to the New Commerce Experience (NCE) respective subscription. Therefore, with this tool, you can migrate existing Microsoft subscriptions and transform them into New Commerce Experience subscriptions, automatically from within your Storefront. The tool's scope is per customer, meaning that the results appear per Microsoft Tenant. As a result, a reseller, for example, can choose to migrate one or more of the eligible legacy Microsoft subscriptions of a given end customer (Microsoft Tenant) asynchronously.
By accessing the tool via the Storefront or BSS and choosing certain parameters (depending on who accesses the tool), the legacy subscriptions that are available for migration are retrieved and displayed. The migration can begin by choosing one or more of the displayed eligible legacy subscriptions.
Accessing the NCE Migration Tool
The tool can be accessed from both the BSS platform (1) and the Storefront (2).
To access the NCE Migration Tool in BSS, the user has to navigate to BSS Setup > Administration > System Options > Applications Setup, then locate the Microsoft Cloud Services service manager to click on the Settings button. From there, the BSS user can click on the instance for which they wish to run the NCE Migration Tool and simply click on the Go to NCE Migrator button.
To access the NCE Migration Tool in Storefront, the user has to Log In to the Storefront, and from the profile icon, they must select the My Account option.
On the My Account page that opens up, they can locate the section Microsoft Cloud Services at the end. Next to the Microsoft instance, you can witness the Migrate to NCE button.
Therefore, if more than one Microsoft instance is available, you can choose from which instance you wish to begin the migration by clicking the respective button.
Once the “Migrate to NCE“ button is clicked, the Storefront user is redirected to the migration tool's page.
Configuring the NCE Migration Tool Step 1
After opening the NCE migration tool from the corresponding instance, Storefront users land on the first tab of the migration process called Current State. Here, they are presented with certain options depending on their user type, be that distributors, resellers, or direct customers.
Distributors View
When a distributor accesses the NCE migration tool, the following three elements are visible.
Instance: This field is locked since it only displays the chosen Microsoft instance for the migration that the Migrate to NCE button was previously clicked.
Select Reseller: This drop-down menu provides the distributors with the option to either pick one of their resellers or select the No Reseller option in order to pick one of their direct customers from the Select Customer drop-down menu.
Select Customer: This drop-down menu provides the distributors with the options to:
Pick one of their resellers (in the event that the same reseller has been selected on the Select Reseller drop-down menu) if they wish to migrate an NCE subscription that the reseller is using for personal usage.
Pick one of the reseller’s end customers (in the event that a reseller has been selected on the Select Reseller drop-down menu)
Pick a direct customer (in the event that the No Reseller option was selected from the Select Reseller drop-down menu).
Resellers View
When a reseller accesses the NCE migration tool, the following two elements are visible.
Select Customer: This drop-down menu allows the resellers to pick one of their end customers.
These aforementioned options (Select Reseller & Select Customer) concerning the Distributors, as well as the Resellers View, are required by our tool to prepare the existing and eligible subscriptions before the migration.
Direct Customers View
When a direct customer accesses the NCE migration tool, no elements are visible since the direct customer’s subscriptions are automatically displayed and checked for eligibility upon entering this page.
A direct customer, after the tool's first configuration, can refresh the page findings by clicking on the Refresh button.
Migration Eligibility Process STEP 2
After the distributor or the reseller defines the above steps and clicks on the Check Eligibility button, the actual check process between our BSS and the Microsoft Partner Center is initiated, and the results appear inside the following table. The same check process happens automatically for the direct customer without needing to select something or click on the Check Eligibility button.
The columns of that table are split into two distinct categories.
The first nine (9) columns are the data that stem from the existing (traditional/legacy) Microsoft Cloud Services subscriptions, whereas the remaining four (4) columns contain mostly configurable options and informative data that derive from the respective Microsoft NCE subscription, and become enabled once the user selects one of the checkboxes at the beginning of each row in order to continue with the migration process:
Customer Name: This field contains the name of the customer, which essentially is the BSS account name.
Subscription: This field contains the name/description of the legacy subscription.
Eligible: This field contains the status of whether the legacy subscription is eligible for migration (Yes) or not (No).
Reason for ineligibility: This field remains empty (with a dash) if a legacy subscription is eligible. Otherwise, the reason for the ineligibility appears in a friendly, informative message.
Product: This field contains the name of the product or add-on with which the legacy subscription was created with.
Billing Cycle: This field contains the billing cycle of the legacy subscription, such as Monthly, Annually, etc.
Qty: This field contains the quantity of the legacy subscription.
End date: This field contains the end date of the billing cycle of the legacy subscription.
Subscription amount: This field contains the payable amount of a legacy subscription per its billing cycle.
Billing Cycle: This field becomes editable when the checkbox at the beginning of the row gets clicked. For more information, continue to the following (Configuration…) section of the page.
Billing Frequency: This field becomes editable when the checkbox at the beginning of the row gets clicked. For more information, please continue to the following (Configuration…) section of the page.
Qty: This informational field displays the number of licenses of the legacy subscription that are migrated to an NCE subscription. For more information, please continue to the following (Configuration…) section of the page.
End date: This field currently contains the informative value Start new, meaning that the end date will not follow the renewal date of the legacy subscription. For more information, please continue to the following (Configuration…) section of the page.
Configuring NCE Subscription Preferences Before the Migration STEP 3
Once the user sees all the results and decides to begin the migration process, there are some options to consider concerning the transformation of a legacy Microsoft subscription to an NCE subscription. Upon clicking on one or more of the checkboxes of the eligible legacy subscriptions for migration, the Storefront user is able to choose the Billing Cycle and, in certain cases, the Billing Frequency of the NCE subscription that is about to be created from the legacy one, as displayed below.
Billing Cycle: This field becomes editable when the checkbox at the beginning of the row gets clicked and contains the new billing cycle of the subscription that is migrated to an NCE subscription. Its available options are either 1 Year or 1 Month, depending on the predefined (by Microsoft) availability for each particular NCE subscription.
Billing Frequency: This field becomes editable only when:
The following five Billing Frequency/Plan rules are all met:
The Billing Frequency checkbox option is enabled inside its Microsoft Service Manager (instance) settings.
The BSS organization for Tenant Resellers & Country Tenants must have enabled the Billing Plans option under the Shortcuts menu of the Parent organization.
The Bill To Account, of the order, has the Billing Frequency option enabled inside the Account settings.
The NCE product, towards which the migration happens, has its Billing Frequency option enabled.
The NCE product, towards which the migration happens, offers a Billing Plan.
And, the checkbox at the beginning of the row gets clicked.
When editable, the Billing Frequency field will contain the preferred configuration of the billing frequency of the subscription that will be migrated to an NCE subscription. Suppose, for example, in the previous field (Billing Cycle), the selected option was 1 Year. In that case, the Billing Frequency offers two options: Annually, meaning to be billed for the whole cost of the year upfront, or Monthly, meaning to be billed by splitting the overall cost into equal monthly terms. These Annually and/or Monthly options become available according to the predefined (by Microsoft) availability for each particular NCE subscription. Consequently, any applicable and available billing frequency options are locked to the specific billing cycle chosen by the user.
Qty: This informational field displays the number of licenses of the legacy subscription that are migrated to an NCE subscription. This means that the same number of licenses that the legacy subscription had are the ones that are migrated to the new NCE subscription.
End date: This field currently contains only the informative value Start new. This value means that the end date will not follow the renewal date of the legacy subscription. In later releases, the field will become editable, and the second option, named Current, will be the option where the end date will follow the renewal date of the legacy subscription.
Initiating the Migration Process STEP 4
Once the Start migration button is clicked, after one or more legacy Microsoft subscriptions have been chosen for migration and their respective NCE subscription pre-options have been configured, the Storefront user is met with a verification pop-up window that needs confirmation for the migration process to actually begin.
By clicking on the Migrate button, you acknowledge the continuation of the migration process, and after this point, another pop-up window is displayed where the migration process prepares the legacy Microsoft subscription.
In this migration phase, the web browser pop-up window displaying this part of the migration progress must not close.
Then, the migration process of the selected subscription(s) will start automatically, not via the NCE Migration Tool but rather via the Auto-Migration feature. The NCE Migrator Tool will initiate the manual addition of the selected subscription(s) on the Microsoft Partner Center side so that the Auto-Migration feature can then migrate them automatically over to our platform.
Migration Flow
Since the NCE Migration Tool is aligned with the Auto-Migration feature once the 'Auto-Migration' webhook responsible for the automatic migration from Microsoft is registered and enabled in your organization, during the initiation of the migration process, the flow of the NCE Migration Tool changes since it is now being handled by the Auto-Migration feature. The Auto-Migration feature handles the migration requests from the NCE Migration Tool by adding them to its migration queue, meaning that the migration requests do not have priority over the other auto-migration requests that may already exist inside the queue of the Auto-Migration feature of our platform. However, the migration flow is the following:
The NCE Migration Tool dispatches a migration request to Microsoft for the selected legacy subscription(s).
Once the Microsoft-led migration is completed inside the Microsoft Partner Center, the Auto-Migration feature of our platform receives the completed migration from the Microsoft side and adds it to the queue in order to automatically migrate it to our platform.
The first step of the Auto-Migration process is to receive from Microsoft the data of the completed migration of the selected legacy subscription(s)
The second step of the Auto-Migration process is to verify the received data and initiate the actual migration.
The third step of the Auto-Migration process is to cancel the legacy subscription in our platform.
The fourth step of the Auto-Migration process is to create the NCE subscription on our platform.
After the migration is complete.
Once the fourth step is completed, then the NCE Subscription is connected to the NCE subscription ID received from the Microsoft Partner Center. On the NCE subscription, we keep the NCE Migration ID and Legacy External Subscription ID
The new NCE subscription will be billed using the pricing calculation rules we apply to all NCE subscriptions.
For the canceled legacy subscription, a credit invoice is calculated and generated for the remaining period. Information about the migration is kept on the subscription details page.
Once the new NCE subscription has been created in the BSS platform, the NCE Migration Tool will not change its migration status since the whole process is controlled be the Auto-Migration feature. Therefore, when the BSS and Storefront users proceed to monitor the migration process inside the Results tab of the Tool, they will face the following informative message under the Status column.
For more information regarding the migration flow of the “Auto-Migration” feature of our platform, please check the Auto-Migration Process in interworks.cloud Platform page.
Migration for Tenant Reseller Organizations
The Auto-Migration-based migration flow is also utilized for tenant reseller organizations if the “Auto-Migration” webhook is registered and enabled on their parent organizations. Otherwise, the NCE Migration Tool-based migration flow is utilized, as analyzed on the https://interworkscloud.atlassian.net/wiki/spaces/ICPD/pages/676823041/NCE+Migration+Tool+for+Existing+Microsoft+Subscriptions#Migration-Flow page.
Invoicing of Newly Created NCE Subscription
After a successful migration, the newly created NCE subscription is invoiced based on the default NCE product price list and not on the legacy price list assigned to your customer’s account for the legacy Microsoft subscription. Consequently, during the migration process, the system only chooses the price list for which the currency and unit (billing cycle) match those of the NCE subscription.
The inner workings of the migration tool during the migration phase, where the billing data are calculated, are the following:
The tool checks whether an applicable price list contains that NCE product under the “Billing To” account. If it exists, then it applies those pricing rules to the product price. Otherwise, it applies the default NCE price list of the NCE product. If more than one NCE price list is assigned to the “Billing To” account in BSS for that NCE product, then the tool retrieves the most recent one. Also, before the pricing is defined, during the execution of the order of the NCE subscription, if there is any applicable promotion based on that product, it is applied. Once the pricing is done and the order is executed successfully, the creation of the NCE subscription is completed inside the platform.
Examples:
Annual Billing Plan: If the Annual billing plan for a migrated NCE subscription was selected, then the price of that subscription will remain constant for a year, so if the cost price from the NCE price list was, for example, 100 $ on 10/03/2022, this price will be the same for a year, until 09/03/2023.
Monthly Billing Plan: If the Monthly billing plan for a migrated NCE subscription was selected, then the price of the subscription will remain constant for a month, but it is susceptible to upcoming pricing changes, upon renewal, from Microsoft since each month the price might remain the same or fluctuate. Therefore, if the cost price from the NCE price list was, for example, 9 $ on 02/04/2022, the price may or may not change the following month.
Viewing the Legacy & NCE Subscription(s) in BSS After the Migration
After completing the migration, the BSS user can view details about the migration and related details between the legacy subscription, which is now canceled, and the newly created NCE subscription, which is now active and synced.
View of Legacy Subscription
By accessing the BSS Subscription view page of the legacy Microsoft subscription, you can witness that it is canceled after the migration. Furthermore, two informative custom fields are available: NCE Migration Status and NCE Subscription ID. The first field depicts whether the migration was completed, whereas the second field depicts the ID of the newly created NCE subscription that replaced the legacy one.
View of NCE Subscriptions
By accessing the BSS Subscription view page of the newly created Microsoft NCE subscription, you can witness the subscription being active and synced after the migration. Furthermore, two informative custom fields are available: NCE Migration ID and Legacy External Subscription ID. The first field depicts the migration ID with which this subscription was created (which can be searched in the NCE Migration Tool), whereas the second field depicts the ID of the legacy Microsoft subscription that this subscription replaced.
Checking the Legacy & NCE Subscription(s) in Storefront After the Migration
After completing the migration, the Storefront user can verify the successful completion of the migration process by verifying that the legacy subscription has been canceled while a newly created NCE subscription is now active and synced.
Table of Contents
- 1 What is the NCE Migration Tool?
- 2 Accessing the NCE Migration Tool
- 3 Configuring the NCE Migration Tool Step 1
- 4 Migration Eligibility Process STEP 2
- 5 Configuring NCE Subscription Preferences Before the Migration STEP 3
- 6 Initiating the Migration Process STEP 4
- 7 Invoicing of Newly Created NCE Subscription
- 8 Viewing the Legacy & NCE Subscription(s) in BSS After the Migration
- 9 Checking the Legacy & NCE Subscription(s) in Storefront After the Migration