CustomServicePlans.json File

File Structure

The CustomServicePlans.json file contains definitions of Office 365 service plans. A service plan is represented as a key/value pair: the key is the internal identifier of the service plan; the value is the definition of the service plan.

The definition of a service plan is a JSON object with the following properties:

  • RegisterByDefault – Reserved for future use.
  • Name – The name of the service plan.
  • Description – The description of the service plan.
  • PeriodType – The type of the subscription period of the service plan (D - days, M - month, Y - year).
  • Period – The duration of the subscription period of the service plan.
  • Trial – It defines if the service plan is trial (0 - not trial, 1 - trial).
  • SegmentGroup – The internal name of the group the service plan belongs to. Internal names are used in only the .json files.
  • ShowPriority – The listing priority of the service plan in your online store.
  • RecurringFee – The recurring fee of the subscription period of the service plan.
  • IncompatiblePlans – The list of service plans which are incompatible with the service plan. The list is represented as a JSON array and consists of internal identifiers of service plans.
  • IncompatibleSegmentGroups – The list of groups containing service plans which are incompatible with the service plan. The list is represented as a JSON array and consists of internal identifiers of groups.
  • UpgradeTo – The list of service plans to which the service plan can be upgraded. The list is represented as a JSON array and consists of internal identifiers of service plans.
  • SalesCategories – The list of sales categories to which the service plan belongs. The list is represented as a JSON array and consists of internal identifiers of sales categories.

  • Resources – The list of resource rates of the service plan. The list is represented as a JSON object consisting of key/value pairs. Each key/value pair defines a resource rate. The key of a pair is the identifier of the offer to which the resource rate belongs; the value of the pair is the definition of the resource rate and is represented as a JSON object with the following properties:

    • Name – The name of the resource type/resource of the resource rate.
    • Included – The number of included units of the resource rate.
    • Maximum – The maximum number of units of the resource rate.
    • RecurringFee – The recurring fee of the resource rate.

'Office 365 Business Premium' Service Plan

For instance, the Office 365 Business Premium service plan is defined in the following way (some original information was omitted for the sake of simplicity):

"BP+X": {

        "RegisterByDefault": 1,

        "Name": "Office 365 Business Premium",

        "Description": "<div class=\"bestseller\"/><span class=\"officelogo\"/><br/><div class=\"ShortDescription\"><b>All the features of Business Essentials and Business in one integrated plan</b></div><ul><li>Email with 50 GB mailbox</li>\n<li>1 TB file storage and sharing</li>\n<li>HD video conferencing</li>\n<li>Fully installed Office on PC/Mac</li>\n<li>Office apps on tablets and phones</li></ul>",

        "PeriodType": "Y",

        "Period": "1",

        "Trial": 0,

        "SegmentGroup": "E",

        "ShowPriority": "160",

        "RecurringFee": 12.5000,

        "IncompatiblePlans": ["BP-T", "BP+X"],

        "IncompatibleSegmentGroups": [],

        "UpgradeTo": [],

        "SalesCategories": ["B"],

        "Resources": {

                "031c9e47-4802-4248-838e-778fb1d2cc05": {

                        "Name": "Office 365 Business Premium",

                        "Included": 1,

                        "Maximum": 300,

                        "RecurringFee": 12.5000

                },

                "53fc25f7-6639-4f78-bb44-3c2dfec3ed40": {

                        "Name": "Office 365 Extra File Storage",

                        "Included": 0,

                        "Maximum": -1,

                        "RecurringFee": 0.2000

                },

                "a2706f86-868d-4048-989b-0c69e5c76b63": {

                        "Name": "Exchange Online Advanced Threat Protection",

                        "Included": 0,

                        "Maximum": -1,

                        "RecurringFee": 2.0000

                },

                "2828be95-46ba-4f91-b2fd-0bef192ecf60": {

                        "Name": "Exchange Online Archiving for Exchange Online",

                        "Included": 0,

                        "Maximum": -1,

                        "RecurringFee": 3.0000

                }

        }

}

The following service plan is created on the basis of the definition:

Office 365 Business Premium

  • Service Template: Office 365
  • Service Terms: Office 365
  • Billing Period: Monthly
  • Subscription Period: Not Trial/1 Year/$12.50 Recurring Fee

  • Resource Rates

    • Resource/Inc. Amount/Max Amount/Recurring Fee: Office 365 Business Premium/1/300/$12.50
    • Resource/Inc. Amount/Max Amount/Recurring Fee: Office 365 Extra File Storage (1 GB)/0/Unlimited/$0.20
    • Resource/Inc. Amount/Max Amount/Recurring Fee: Exchange Online Archiving for Exchange Online/0/Unlimited/$3
    • Resource/Inc. Amount/Max Amount/Recurring Fee: Exchange Online Advanced Threat Protection/0/Unlimited/$2
  • Upgrades: empty

The created service plan is added to the Office 365 Business sales category.

'Office 365 Business Premium Trial' Service Plan

For instance, the Office 365 Business Premium Trial service plan is defined in the following way (some original information was omitted for the sake of simplicity):

"BP-T": {

        "RegisterByDefault": 1,

        "Name": "Office 365 Business Premium Trial",

        "Description": "<div class=\"bestseller\"/><span class=\"officelogo\"/><br/><div class=\"ShortDescription\"><b>All the features of Business Essentials and Business in one integrated plan</b></div><ul><li>Email with 50 GB mailbox</li>\n<li>1 TB file storage and sharing</li>\n<li>HD video conferencing</li>\n<li>Fully installed Office on PC/Mac</li>\n<li>Office apps on tablets and phones</li></ul>",

        "PeriodType": "D",

        "Period": "30",

        "Trial": 1,

        "SegmentGroup": "E",

        "ShowPriority": 159,

        "RecurringFee": 0.0000,

        "IncompatiblePlans": ["BP-T", "BP+X"],

        "IncompatibleSegmentGroups": [],

        "UpgradeTo": ["BP+X"],

        "SalesCategories": ["B"],

        "Resources": {

                "031c9e47-4802-4248-838e-778fb1d2cc05": {

                        "Name": "Office 365 Business Premium",

                        "Included": 25,

                        "Maximum": 25,

                        "RecurringFee": 0.0000

                }

        }

}

The following service plan is created on the basis of the definition:

Office 365 Business Premium Trial

  • Service Template: Office 365
  • Service Terms: Office 365
  • Billing Period: Monthly
  • Subscription Period: Trial/30 Days/$0.00 Recurring Fee

  • Resource Rates

    • Resource/Inc. Amount/Max Amount/Recurring Fee: Office 365 Business Premium/25/25/$0.00
  • Upgrades: Office 365 Business Premium

The created service plan is added to the Office 365 Business sales category.