Before you begin the retrieval of new and existing end customers of a Tenant reseller, you have to make sure that you have enabled (as the root/parent organization) the backordering functionality. Then, the Tenant reseller can have access to the tool's inherited instances of Microsoft. By inherited instances we mean the Microsoft instances of Tenant resellers which contain in them the MPNID of the Tenant reseller.

How to Retrieve End Customers of a Tenant Reseller & Initiate the Import

The retrieval of new and existing end customers of a Tenant reseller can be initiated after selecting from the field "Microsoft Cloud Services instance" the corresponding inherited instance option of the Tenant Reseller and subsequently clicking the Get Hierarchy button. Also, they can add a specific Microsoft Tenants by providing their Microsoft Tenant ID or their Primary Domain Name and then clicking the Get Hierarchy button. Then, the tool retrieves the instance's new and existing end customers, by obtaining only those subscriptions in the Microsoft Partner Center from which there is the Tenant reseller's MPN ID present and displays them on the following table list under the columns: 

Open

• Check-boxes: Are used either for distinct selection of one or more end customers or for selecting all end customers at once.
  If an import is under the Status: Completed / In Progress / Pending, there will be no checkbox for selection. In the event that a Microsoft (end customer) tenant in the Microsoft Partner Center does not have a BSS account, nor a subscription, the checkbox will be available in order to create that tenant as a BSS account into the BSS platform; even if no subscriptions are available for import.  

• Customer Name: This column displays the Microsoft Partner Center tenant's (end customer's) name. You are able to use filtering.

• Related BSS Account: During the import of one or more Microsoft tenants (end customers) from this list, BSS accounts are generated and become associated to the respective Microsoft tenants.  Therefore, a link will be created by the importer and depicted under the field Related BSS Account. The BSS account name will obtain the customer's name. The field will hold a link value only when the account was created by the importer. When the link is clicked, you will be redirected to the account's view page. As long as a Microsoft tenant is not imported, this field will be empty. It should be noted that there is no synchronization from BSS, which means that if there is a BSS account related to a tenant id,  "Related BSS Account" will be empty. There will be no filtering for this column because the entities are links. 

• Primary Domain: This column displays the primary Microsoft domain that the end customer resides. You are able to use filtering.   

• Customer Identifier: This column displays the Microsoft Partner Center account's id of the customer. You are able to use filtering.

• Country: This column has the corresponding Country of MS tenant, which is collected from the tenant's Billing Address. You are able to use filtering.

• BSS Subscriptions (Available after the import): This column will obtain a value only when the import has run and there are imported subscriptions inside our BSS. It displays the number of subscriptions the import has created inside the BSS platform. You are able to use filtering.

• Not Imported Subscriptions: This column contains the existing subscriptions of the end customer in the Microsoft Partner Center, that do not exist in our platform. You are able to use filtering. 

• Status: Check table below:

Status States:	Status States' Explanation:

Status States:	Status States' Explanation:
Open	The import is in the queue.
Open	The import is in progress and the status will be changed when the import gets completed.
Open	The MS tenant is synced successfully with our BSS.
Open	The MS tenant is synced with our BSS even if there were errors during the import.
Open	The MS tenant is not synced with our BSS. It is the initial status prior to import.

Distinguishing New & Existing End Customers

New tenants (end customers) in the table are denoted with the color white, in their row on the table. The green color denotes the existing end customers that have already executed imports successfully, whereas the red color denotes customers who have executed imports, but with errors or have discrepancies between our platform and the Microsoft Partner Center.

Open

As you can witness from the above screenshot, the 1st-row end customer, marked in blue highlight, is an existing customer with a related BSS account, and it has two synced BSS Subscriptions and seven Not Imported Subscriptions in the Microsoft Partner Center. This means that seven subscriptions are not yet imported into the BSS, and that is why the checkbox at the beginning of the row is available, although the Status column indicates that the subscriptions are Synced. The status is displaying the fact that seven out of the total of nine subscriptions are Not Imported Subscriptions since this end customer had successfully imported in the past two subscriptions into the BSS platform, while the checkbox indicates that more subscriptions can be added to BSS. Therefore, by selecting the checkbox of the first row, the import tool will try to import to BSS the remaining subscription that currently resides only inside the Microsoft Partner Center. 

Configure Import Options for End Customers of Tenant Resellers

When multiple tenants(end customers) are being imported at the same time, chances are that some of them are existing end customers with new subscriptions, and some of them are new end customers with new subscriptions. Since mass import is a very common business scenario, the tool can easily distinguish which tenants are existing and which ones are new to correctly apply the selected Import Options to them. So, the Separate Invoices and Price list options will be unlocked and editable for all end customers. After the configuration of the aforementioned options, as well as choosing the end customers (of a Tenant reseller) to be imported, you can either proceed with the import process by clicking the Start Import button or return back to the Indirect MS tenant's list of the import tool, by clicking the << Back button.

Having selected one or more end customers of the Tenant reseller to import, you select the Import Customers button. Then, a pop-up window appears containing the Import Options which consists of the Ordering Options as well as the Subscription Options that need to be configured for the chosen end customers of the Tenant reseller, who are about to be imported. 

• If a new customer along with their subscription(s) is to be imported into BSS, meaning that their external account ID is not found in our platform, they will have all the Ordering & Subscription Options available to them for configuration.

• If the subscriptions of an existing customer are to be imported onto our system, the Ordering Options are deactivated and displayed at their default values while the Subscription Options are available, since the BSS account of the customer already exists by having their preselected ordering options, and these will not change via this tool. However, since the Subscription Options are available for existing customers with a BSS account, the BSS user can define a Price List for the subscription to be imported.

1. For the import of new end customers, under the Ordering Options you select the invoicing variables for those tenants about to be imported. The system can be configured to reflect multiple invoicing scenarios.
   

   
   
   
   

   Enable Billing Plans – Select whether to create billing plans for the BSS account, which can be used to make all future purchases. Enable this flag to allow your end customers to purchase with payment plans and/or you already have subscriptions with payment plans in the MPC. Enabling this enables the checkbox Enable Prorate Billing for the account, as shown in the figure below:

   Open

   

   For more information on NCE Billing Frequency, please refer to the Billing Frequency page.

   For information on configuring the Ordering Options fields, please continue to the "Analysis of Ordering Options" page.
   
   
   

2. Under Subscription Options the user defines the following parameter:

   1. Price list: The price list that will be used for pricing the imported subscription in BSS. If no price list is selected in this field, then the pricing will be performed based on the default sale price of the products. 

After the configuration of the above-mentioned options, you can either proceed with the import process by clicking the Start Import button or exit the pop-up windows by clicking the "X" (close) button and return to the Tenant reseller's list.

Initiate the Import Process for End Customers of a Tenant Reseller

The actual import process of end customers of Tenant resellers is exactly the same as with the default import functionality of the tool that is analyzed for the Direct and Indirect CSPs.
After defining the above steps and once you have clicked the Start Import button, the actual import process begins its execution inside our platform.

Possible Errors & Error Messages Before & During Import

In case of a missing MPNID from the inherited Microsoft instance of the Tenant reseller, the following error message will appear:

In case an end customer's subscriptions do not have the Tenant reseller’s MPNID on those subscriptions, meaning that there is no association with the Tenant reseller's MPNID, then the following error occurs during the "Get Hierarchy" action:

"The Microsoft Tenant cannot be added to this list because none of their subscriptions have the Tenant Reseller’s MPNID."

In case the Tenant reseller tries to import an end customer with a subscription containing a product that the tool does not support yet due to its product type (such as Legacy) then the following error message appears:

• For Legacy: "The product with offer ID: <id> cannot be imported because we do not currently support the import of legacy subscriptions."

In case there are any subscriptions of the end customer with end-date alignment, the tool will not support them yet for Tenant resellers, meaning that if such a subscription is about to be imported, the following error message appears:

Open

"Subscriptions with end-date alignment are not supported yet for tenant reseller import." 

In case an end customer of a Tenant reseller has been imported with errors (e.g. fail on subscription import), the entry will become red-colored, although its status will be "Synced", as exemplified below.

Open

In order to correct the error(s) you can go to the "Import Results PageRetrieve End Customers of a Tenant Reseller & Initiate the Import#ImportResultsPage and from there, navigate to the end customer's import that was completed with errors in order to click the name under the column Type from which the below pop-up window appears. By clicking the black arrow (highlighted in green), you can expand and reveal the log of the import and examine the reason(s) of the error(s) in detail (highlighted in yellow), as exemplified below. 

Open

In case a product does not exist or is discontinued in the Tenant resseller's organization and they try to import a subscription with that product, the following error message appears:

Open

Rare Cases of Grandchild Tenants of a Tenant Resellers & Country Tenants

Since the backordering functionality is not supported for a "grandchild" Tenant, meaning a Tenant reseller of a Tenant reseller, the import customers tool for inherited instances is also not supported in grandchild Tenants. 
However, if the first Tenant reseller (child) is a Country Tenant, the import customers tool can support all inherited instances of the second Tenant reseller (grandchild), including those inherited from the root organization. This is because Country Tenants do not support backordering and function similarly to root organizations.

Open

For the import results, you must continue on to the "Import Results Page" page.  

Table of Contents