Get a List of the Reseller's Plan order attributes

The Get a List of the Reseller's Plan order attributes method returns the list of additional attributes required for the Services provisioning by the given Plan ID of the current Reseller or any of its downstream Resellers.

Access to the current Reseller and downstream Resellers is determined by the Manager's token in the API request.

The Get a List of the Reseller's Plan order attributes method can be used for Services based on the following plugins:

VSP (Vendor service plugin).
Office365.
MicrosoftCspProducts.

 GET {base_url}/api/v3/resellers/{reseller_id}/plans/{plan_id}/order_attributes

Arguments

Name	Parameter Type	Data type	Required/Optional	Description
X-Api-Token	header	string	Required	API token of the Manager that performs the operation (see Viewing and updating manager's information)
Content-Type	header	string	Required	Indicates the media type (text/html or text/JSON) of the request that is sent to the server by the client (browser)
Accept	header	string	Required	Information about data types that the client (browser) supports
reseller_id	path	integer	Required	ID of the current Reseller or any of its downstream Resellers (see Viewing and updating reseller general information)
plan_id	path	integer	Required	ID of the Plan
account_id	query	integer	Required	ID of an Account for ordering a Subscription. May affect the list of additional attributes
plan_resource_ids[]	query	integer	Required	Coma-separated list of IDs of Resources of the specified Plan to be ordered in a Subscription (see Create a Sales Order). May affect the list of additional attributes

Response model

Name

Data type

Description

data

array of objects

Response data

order_attributes

array of objects

List of additional attributes of Services

Service	Key of the additional attribute	Additional attribute	Notes
Google Workspace (G Suite)	domain_name	The name of the customer domain for purchasing the Service
	customer_alternate_email	The alternative customer email that Google will use to contact the customer
	admin_login	The domain administrator's login
Kaspersky	approval_code	Approval Code	See Kaspersky (PAYG, Yearly). Service specifics
Services based on the Office365 plugin	is_new_domain	The "Create new Microsoft Tenant Name" option	Absent in the response if the specified Account ID is already linked to a Microsoft Tenant Name in the platform (an Account has a Subscription to any Microsoft Service)
	with_subdomain	The "With the .onmicrosoft.com subdomain" option
	customer_domain	Microsoft Tenant Name
	microsoft_customer_agreement	The "Accept Microsoft Customer Agreement" option	Absents in the response if Microsoft Customer Agreement is already accepted in the platform for the Account with the specified ID
Services based on the MicrosoftCspProducts plugin	is_new_domain	The "Create new Microsoft Tenant Name" option	Absent in the response if the specified Account ID is already linked to a Microsoft Tenant Name in the platform (an Account has a Subscription to any Microsoft Service)
	with_subdomain	The "With the .onmicrosoft.com subdomain" option
	customer_domain	Microsoft Tenant Name
	microsoft_customer_agreement	The "Accept Microsoft Customer Agreement" option	Absents in the response if none of the specified Plan Resource IDs requires acceptance of Microsoft Customer Agreement or Microsoft Customer Agreement is already accepted in the platform for the Account with the specified ID
	microsoft_azure_subscription	Customer Microsoft Azure subscription	Absents in the response if none of the specified Plan Resource IDs requires that the Account with the specified ID should have an active Subscription to the Microsoft Azure Service. See an example in Ordering a subscription to the Microsoft Software Subscriptions service via the Operator Control Panel
	reservation_scope	Reservations scope

required

bool

Indicates whether the additional attribute is required:

true — the additional attribute is required.
false — the additional attribute is optional.

values

array

The list of available values of the additional attribute

Service	Key of the additional attribute	The list of available values of the additional attribute
Google Workspace (G Suite)	The list of available values of the additional attribute is not limited. The method returns an empty array.
Services based on the Office365 plugin
Kaspersky
Services based on the MicrosoftCspProducts plugin	microsoft_azure_subscription	Array of objects — the list of IDs and names of active Subscriptions to the Microsoft Azure Service for the specified Account
Services based on the MicrosoftCspProducts plugin	reservation_scope	Array of objects — the list of available options and their displayed names: all — All subscriptions. current — Current subscription.

label

string

Name of the additional attribute

type

string

Data type of the additional attribute:

string.
select — a list.
checkbox — for example, the "Accept Microsoft Customer Agreement" option.
boolean — for example, the "Create new Microsoft Tenant Name" option.

key

string

Key of the additional attribute

priority

integer

Priority of the additional attribute

default_value

string

Default value of the additional attribute

plugin_slug

string

Plugin used for the Service of the additional attribute:

office365 — the Office365 plugin.
microsoft_csp_products — the MicrosoftCspProducts plugin.
vendor_service — VSP (Vendor service plugin).

order_attributes_info

array

Not used in the current version

Request example (Google, VSP plugin)

GET /api/v3/resellers/1/plans/1238/order_attributes?account_id=826&plan_resource_ids[]=2205
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json

Response example (Google, VSP plugin)

{
    "data": {
        "order_attributes": [
            {
                "required": true,
                "values": [],
                "label": "Domain name",
                "type": "string",
                "key": "domain_name",
                "priority": 1,
                "default_value": "",
                "plugin_slug": "vendor_service"
            },
            {
                "required": true,
                "values": [],
                "label": "Alternate email",
                "type": "string",
                "key": "customer_alternate_email",
                "priority": 2,
                "default_value": "",
                "plugin_slug": "vendor_service"
            },
            {
                "required": true,
                "values": [],
                "label": "Admin login",
                "type": "string",
                "key": "admin_login",
                "priority": 3,
                "default_value": "",
                "plugin_slug": "vendor_service"
            }
        ],
        "order_attributes_info": []
    }
}

Request example (Microsoft 365, Office365 plugin)

GET /api/v3/resellers/1/plans/1132/order_attributes&account_id=820&plan_resource_ids[]=1394
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json

Response example (Microsoft 365, Office365 plugin)

{
    "data": {
        "order_attributes": [
            {
                "label": "Create new Microsoft Tenant Name",
                "type": "boolean",
                "key": "is_new_domain",
                "values": [],
                "priority": 1,
                "default_value": "",
                "plugin_slug": "office365",
                "required": true
            },
            {
                "label": "With the .onmicrosoft.com subdomain",
                "type": "boolean",
                "key": "with_subdomain",
                "values": [],
                "priority": 1,
                "default_value": "",
                "plugin_slug": "office365",
                "required": true
            },
            {
                "label": "Microsoft Tenant Name",
                "type": "string",
                "key": "customer_domain",
                "values": [],
                "priority": 1,
                "default_value": "",
                "plugin_slug": "office365",
                "required": true
            },
            {
                "label": "Accept Microsoft Customer Agreement",
                "type": "checkbox",
                "key": "microsoft_customer_agreement",
                "values": [],
                "priority": 1,
                "default_value": "",
                "plugin_slug": "office365",
                "required": true
            }
        ],
        "order_attributes_info": []
    }
}