Получение информации о тарифном плане нижестоящего реселлера

Метод Get plan of downstream reseller используется для получения информации о тарифном плане нижестоящего реселлера по отношению к текущему реселлеру.

Для авторизации требуется API-токен сотрудника. API-токен можно получить через Панель управления Оператора (см. Просмотр и обновление информации о сотруднике).

По указанному в запросе API-токену определяются текущий реселлер и его нижестоящие реселлеры, доступные в рамках метода.

GET {base_url}/api/v3/resellers/{reseller_id}/child_reseller_plans/{plan_id}

Аргументы

Название

Тип параметра

Тип данных

Обязательный/ 
Опциональный

Описание

X-Api-TokenheaderstringОбязательныйAPI-токен сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике)
Content-TypeheaderstringОбязательныйТип данных, передаваемых в запросе. Необходимо указать: application/vnd.api+json
AcceptheaderstringОбязательныйПоддерживаемые типы данных в ответе. Необходимо указать: application/vnd.api+json
base_urlpathstringОбязательныйURL ActivePlatform
reseller_idpathintegerОбязательныйID реселлера. Возможно указать ID текущего реселлера или ID любого из его нижестоящих реселлеров (см. Просмотр информации о реселлере)
plan_idpathintegerОбязательный

ID тарифного плана

Модель ответа

Название

Тип данных

Описание

dataarrayДанные ответа


id

integer

ID тарифного плана


typestringТип данных

attributesobjectИнформация о тарифном плане


created_at

string

Дата и время создания тарифного плана



updated_at

string

Дата и время последнего изменения тарифного плана



statusstringСтатус тарифного плана (список статусов см. в Просмотр списка тарифных планов)


name

string

Название тарифного плана



description

string

Дополнительная информация о тарифном плане, которая отображается клиентам в Панели управления Клиента



public

bool

Признак доступности тарифного плана:

  • true — тарифный план доступен для заказа.
  • false — тарифный план недоступен для заказа.


plan_class_id

integer

ID правила предоставления (см. Управление Правилами предоставления тарифных планов)



product_id

integer

ID продукта, с которым связан тарифный план



billing_typestringТип биллинга тарифного плана


ancestrystringДля делегированных тарифных планов содержит список ID родительских тарифных планов, начиная от корневого (см. Просмотр списка делегированных тарифных планов). Для тарифных планов, созданных сотрудником выбранного реселлера, равен null


reseller_idintegerID реселлера, которому принадлежит тарифный план


plan_class

string

Название правила предоставления



product_category_id

integer

ID категории продукта, с которой связан тарифный план



product_category

string

Название категории продукта, с которой связан тарифный план



product

string

Название продукта, с которым связан тарифный план



plan_resources

array of objects

Информация о ресурсах тарифного плана




dataarrayДанные объекта




idintegerID ресурса тарифного плана




typestringТип данных




attributesobjectИнформация о ресурсах тарифного плана





created_atstringДата и время создания ресурса





updated_atstringДата и время последнего обновления ресурса





namestring

Название ресурса






measurablebool

Признак использования модели расчета стоимости за фактическое использование ресурса (недоступен, если функция не поддерживается внешними службами):

  • true — используется расчет за фактическое использование ресурса.
  • false — не используется расчет за фактическое использование ресурса.





unit_of_measurestring

Единица измерения ресурса:

  • unit — измеряемый ресурс, для которого указывается определенное количество.
  • boolean — неизмеряемый ресурс(для ресурсов, у которых не надо указывать количество), возможные значения:
    • true — ресурс включен в тарифный план.
    • false — ресурс не включен в тарифный план.





application_template_namestringНазвание услуги, которая предоставляется в рамках данного тарифного плана





includedinteger

Количество ресурса, которое включено в тарифный план по умолчанию (включенные ресурсы входят в стоимость подписки)






minimuminteger

Минимальное количество ресурса (с учетом величины included), которое доступно для заказа (см. Ресурсы тарифного плана)






limitinteger

Максимальное количество ресурса, доступное для заказа. Если ресурс безлимитный (признак unlimited_units = true), то limit = 0






setup_feefloat

Величина платежа за установку ресурса






recurring_feefloat

Величина ежемесячной абонентской платы за ресурс






overuse_feefloat

Стоимость перерасхода ресурсов






renewal_feefloat

Стоимость продления использования ресурса






unlimited_unitsbool

Признак отключения лимитов использования ресурса:

  • true — лимиты отключены.
  • false — лимиты активны.





publicbool

Возможные значения:

  • true — ресурс доступен клиентам для заказа.
  • false — ресурс недоступен клиентам для заказа.





statusstring

Статус ресурса:

  • active — активный.
  • inactive — неактивный.
  • deleted — удален.





resource_idinteger

ID ресурса в шаблоне услуги






priorityintegerПриоритет ресурса. У основного ресурса priority максимальный





net_costsobject

Значения себестоимостей указанных типов для ресурса







setup_feefloat

Величина платежа за установку ресурса







recurring_feefloat

Величина ежемесячной абонентской платы за ресурс







overuse_feefloat

Стоимость перерасхода ресурсов







renewal_feefloat

Стоимость продления использования ресурса






custom_attributesobjectИнформация о дополнительных параметрах ресурса






plan_resources.custom_attributes.['custom-attribute-key']stringЗначение дополнительного параметра ресурса


plan_periodsarray of objectsИнформация о периодах тарифного плана



data
arrayДанные объекта




idintegerID периода тарифного плана




typestringТип данных




attributesobjectИнформация о периодах тарифного плана





created_atstring

Дата и время создания периода тарифного плана






updated_atstring

Дата и время последнего обновления периода тарифного плана






duration_valueintegerДлительность периода тарифного плана





duration_typestringЕдиница измерения периода тарифного плана





setup_feefloatСтоимость установки тарифного плана для данного периода





recurring_feefloatЕжемесячная стоимость тарифного плана для данного периода





transfer_feefloatСтоимость переноса домена, если услуга включает в себя возможность использования доменов





renewal_feefloatСтоимость продления тарифного плана для данного периода





trialbool

Признак того, является ли период тарифного плана пробным:

  • true — период является пробным.
  • false — период не является пробным.





publicbool

Признак доступности периода для заказа в рамках данного тарифного плана:

  • true — период доступен для заказа.
  • false — период недоступен для заказа.





statusstring

Статус периода тарифного плана:

  • active — активный.
  • deleted — удален.





descriptionstringОписание периода тарифного плана





endlessbool

Признак того, является ли период тарифного плана бессрочным:

  • true — период является бессрочным.
  • false — период не является бессрочным. Продолжительность периода указана в duration_value и duration_type.





net_costsobject

Значения себестоимостей указанных типов для периода







setup_feefloatСтоимость установки тарифного плана для данного периода






recurring_feefloatЕжемесячная стоимость тарифного плана для данного периода






transfer_feefloatСтоимость переноса домена, если услуга включает в себя возможность использования доменов






renewal_feefloatСтоимость продления тарифного плана для данного периода


available_account_types

array of objectsИнформация о типах клиентов, для которых доступен тарифный план



id

integer

ID типа клиента



namestringИмя типа клиента



created_at

string

Дата и время создания типа клиента



updated_at

string

Дата и время последнего обновления типа клиента



reseller_idintegerID реселлера, к которому относится тип клиента



name_patternstringШаблон отображения имени клиента в платформе



primary_namestringНазвание поля с основным именем клиента. Например, для типа клиента Юридическое лицо это может быть Название компании



keystringКлюч типа клиентов



default_payment_method_idinteger

ID способа оплаты (см. Способы оплаты), который используется по умолчанию для данного типа клиентов




ancestryintegerID родительского типа клиентов



use_by_default

bool

Признак типа клиента по умолчанию:

  • true — типа клиента используется по умолчанию.
  • false — типа клиента не используется по умолчанию.


plan_currency

stringКод валюты тарифного плана


custom_attributesobjectИнформация о дополнительных параметрах тарифного плана



custom_attributes.['custom_attribute_key']stringЗначение дополнительного параметра тарифного плана

relationshipsobjectИнформация о связанных объектах


plan_categoryobjectИнформация о связанной категории тарифных планов



dataobjectИнформация о категории тарифных планов




idstringID категории тарифных планов




typestringТип данных

Пример запроса

GET /api/v3/resellers/1/child_reseller_plans/36
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json

Пример ответа

{
    "data": {
        "id": "36",
        "type": "plans",
        "attributes": {
            "created_at": "2016-10-27T16:29:29.154+03:00",
            "updated_at": "2019-01-09T12:11:51.357+03:00",
            "status": "active",
            "name": "Office 365 Enterprise E1",
            "description": "",
            "public": true,
            "plan_class_id": 18,
            "product_id": 407,
            "billing_type": "reservation",
            "ancestry": "24/28",
            "reseller_id": 7,
            "plan_class": "Default1",
            "product_category_id": 293,
            "product_category": "Default",
            "product": "Default",
            "plan_resources": {
                "data": [
                    {
                        "id": "621",
                        "type": "plan_resources",
                        "attributes": {
                            "created_at": "2016-10-27T16:29:29.224+03:00",
                            "updated_at": "2016-10-27T16:29:29.224+03:00",
                            "name": "Licenses count",
                            "measurable": false,
                            "unit_of_measure": "unit",
                            "application_template_name": "Office 365 Enterprise E1",
                            "included": 0,
                            "minimum": 1,
                            "limit": 0,
                            "setup_fee": "0.0",
                            "recurring_fee": "2.0",
                            "overuse_fee": "0.0",
                            "renewal_fee": "0.0",
                            "unlimited_units": true,
                            "public": true,
                            "status": "active",
                            "resource_id": 287,
                            "priority": 0,
                            "net_costs": {
                                "setup_fee": "0.0",
                                "recurring_fee": "1.0",
                                "overuse_fee": "0.0",
                                "renewal_fee": "0.0"
                            },
                            "custom_attributes": {
                                "item_1c_for_resellers": ""
                            }
                        }
                    },
                    {
                        "id": "629",
                        "type": "plan_resources",
                        "attributes": {
                            "created_at": "2016-10-27T16:29:29.477+03:00",
                            "updated_at": "2016-10-27T16:29:29.477+03:00",
                            "name": "Customer Lockbox",
                            "measurable": false,
                            "unit_of_measure": "unit",
                            "application_template_name": "Office 365 Enterprise E1",
                            "included": 0,
                            "minimum": 0,
                            "limit": 0,
                            "setup_fee": "0.0",
                            "recurring_fee": "3.0",
                            "overuse_fee": "0.0",
                            "renewal_fee": "0.0",
                            "unlimited_units": true,
                            "public": true,
                            "status": "active",
                            "resource_id": 302,
                            "priority": 1,
                            "net_costs": {
                                "setup_fee": "0.0",
                                "recurring_fee": "2.0",
                                "overuse_fee": "0.0",
                                "renewal_fee": "0.0"
                            },
                            "custom_attributes": {}
                        }
                    }
                ]
            },
            "plan_periods": {
                "data": [
                    {
                        "id": "179",
                        "type": "plan_periods",
                        "attributes": {
                            "created_at": "2016-10-27T16:29:29.192+03:00",
                            "updated_at": "2016-10-27T16:29:29.192+03:00",
                            "duration_value": 1,
                            "duration_type": "year",
                            "setup_fee": "0.0",
                            "recurring_fee": "0.0",
                            "transfer_fee": "0.0",
                            "renewal_fee": "0.0",
                            "trial": false,
                            "public": true,
                            "status": "active",
                            "description": "",
                            "endless": false,
                            "net_costs": {
                                "setup_fee": "0.0",
                                "recurring_fee": "0.0",
                                "transfer_fee": "0.0",
                                "renewal_fee": "0.0"
                            }
                        }
                    }
                ]
            },
            "available_account_types": [
                {
                    "id": 16,
                    "name": "Personal BLR",
                    "created_at": "2016-10-27T16:24:44.322+03:00",
                    "updated_at": "2017-08-08T15:55:36.439+03:00",
                    "reseller_id": 7,
                    "name_pattern": "%first_name %middle_name %last_name",
                    "primary_name": "",
                    "key": "personalblr",
                    "default_payment_method_id": null,
                    "ancestry": "1/68/9",
                    "use_by_default": false
                },
                {
                    "id": 17,
                    "name": "Business BLR",
                    "created_at": "2016-10-27T16:24:44.342+03:00",
                    "updated_at": "2017-05-10T19:28:56.330+03:00",
                    "reseller_id": 7,
                    "name_pattern": "%primary_name",
                    "primary_name": "Company name",
                    "key": "businessblr",
                    "default_payment_method_id": null,
                    "ancestry": "2/67/8",
                    "use_by_default": false
                }
            ],
            "plan_currency": "USD",
            "custom_attributes": {}
        },
        "relationships": {
            "plan_category": {
                "data": {
                    "id": "293",
                    "type": "plan_categories"
                }
            }
        }
    }
}