Parameter Required to Migrate CSP Legacy Subscriptions to NCE Subscriptions

Note: Refer to CloudBlue Commerce API documentation for additional information on how to manage orders through the platform's API.

When making the request to migrate CSP legacy subscriptions to NCE, please ensure that the new order is placed for an NCE plan that is equivalent to the CSP plan to be migrated. The transaction_info_object parameter provides information of the transaction to be processed. The specific data to be provided in JSON format will depend on the transaction type. The request for the migration must contain parameters both for the base products and the add-ons.

Note: Add-ons can be now migrated independently (without migrating the base product). To do this, the add-on subscription ID must be specified in the corresponding subscription_id field. When doing this, it is also possible to migrate add-ons to the add-on specified in such field by adding the corresponding add-on subscription ID in the subscription_id fields available within the addons object.

Parameter ID Required JSON structure with the following parameters:
transaction_info_object Yes

Parameter ID

Description/Value
transaction_type NCEmigration
ms_customer_id Microsoft customer ID
csp_order_id Microsoft CSP source order ID
subscription_id Microsoft source base or add-on subscription ID
purchaseFullTerm

true/false

  • True: A new term can be started.

  • False: The subscription will be migrated co-term with the expiration date of the source CSP subscription.

addons
  • subscription_id: Add-on subscription ID. This may be an add-on to a base product or an add-on to another add-on.

  • termDuration: New term duration.

  • billingCycle: New billing cycle.

  • purchaseFullTerm: true/false.

    • True: A new term can be started.

    • False: The subscription will be migrated co-term with the expiration date of the source CSP subscription.

microsoft_domain Yes The Microsoft domain of the subscription to be migrated, including ".onmicrosoft.com". For example: mycompanyDomain.onmicrosoft.com.
transaction_id Yes The transaction id must be the same as the one used for add-ons (see below).
migration_type No This parameter is used by the migration tools and it stores a value containing the type of migration as agreed with the Vendor. This parameter is not mandatory, but it is nice to have in cases when reports are generated.

Additionally, for each add-on, additional parameters are used in order to align orders in Connect with those in Microsoft:

Parameter ID Required  
transaction_info_object Yes
Parameter ID Description/Example Value
transaction_type NCEmigrationAddon
microsoft_domain Yes The Microsoft domain of the subscription to be migrated, including ".onmicrosoft.com". For example: mycompanyDomain.onmicrosoft.com.
transaction_id Yes The transaction id for the addon must be the same as the one used for the base product.

Example of parameters to migrate a base subscription and the corresponding add-ons:

Copy
{
     {
         "key":  "transaction_info_object",
         "structured_value":
         {
            "transaction_type": "NCEmigration",
            "ms_customer_id":  "MSFT customer id",
            "csp_order_id":  "MSFT CSP source order id",
            "subscription_id":  "MSFT source Base/Add-on subscription ID",
            "purchaseFullTerm": true/false
            "addons": [
                {
                    "subscription_id":  "MSFT Add-on subscription ID",
                    "termDuration":"New TermDuration",
                    "billingCycle":"New BillingCycle",
                    "purchaseFullTerm": true/false
                },
                {
                     "subscription_id":  "MSFT Add-on subscription ID",
                     "termDuration":"New TermDuration",
                     "billingCycle":"New billingCycle",
                     "purchaseFullTerm": true/false
                }
            ]
         }
     },
     {
         "key":  "microsoft_domain",
         "value":  "mybusiness.onmicrosoft.com"
     },
     {
         "key":  "transaction_id",
         "value":  "123345"   *---------------------------the same transaction ID to be sent in addons requests*
     }
}

Example of the parameters to be used for each addon:

Copy
{
     {
         "key":  "transaction_info_object",
         "structured_value":
         {
             "transaction_type": "NCEmigrationAddon"
         }
     },
     {
         "key":  "microsoft_domain",
         "value":  "mybusiness.onmicrosoft.com"
     },
     {
         "key":  "transaction_id",
         "value":  "123345"* ------------------------the same transaction ID as the parent*
     }
}
CloudBlue, an Ingram Micro business, uses cookies to improve the usability of our site. By continuing to use this site and/or logging in you are accepting the use of these cookies. For more information, visit our Privacy Policy.