Получение списка Списаний конечных клиентов Реселлера

Метод Get a List of the Reseller end-customers Charges используется для получения списка Списаний конечных клиентов для текущего Реселлера или любого из его нижестоящих Реселлеров.

Доступ к текущему Реселлеру, относительно которого формируется список нижестоящих Реселлеров, определяется по токену Сотрудника, указанному в заголовке запроса.

GET {base_url}/api/v3/resellers/{reseller_id}/charges

Аргументы

Название

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

Тип данных

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

Описание

X-Api-TokenheaderstringОбязательныйAPI токен Сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике)
Content-TypeheaderstringОбязательныйПредназначен для идентификации формата и способа представления сущности
AcceptheaderstringОбязательныйПредназначен для информирования сервера о типах данных, которые поддерживаются клиентом (браузером)
reseller_idpathintegerОбязательныйID Реселлера. Возможно указать ID текущего Реселлера или ID любого из его нижестоящих Реселлеров (см. Просмотр информации о реселлере)
page[size]queryintegerОпциональныйПараметр постраничной навигации. Количество элементов на странице ответа (50 по умолчанию)
page[number]queryintegerОпциональныйПараметр постраничной навигации. Номер страницы ответа
filter[close_date]querydateОпциональный

Предназначен для фильтрации Списаний по дате закрытия в формате ГГГГ-ММ-ДД. Для указания диапазона дат используются следующие фильтры:

  • filter[close_date][gt] — дата закрытия более, чем указанная дата.
  • filter[close_date][lt] — дата закрытия менее, чем указанная дата.

filter[subscription_id]

query

integer

Опциональный

Фильтрация списка по ID Подписки

filter[status]

query

string

Опциональный

Фильтрация списка по статусу Списания (список статусов см. в Атрибуты списаний)

filter[created_at]

query

string

Опциональный

Предназначен для фильтрации Списаний по дате и времени создания в формате RFC 3339 (например, 2017-10-04T15:12:01.558009%2B03:00). Для указания диапазона используются следующие фильтры:
  • filter[created_at][gt] — дата и время более, чем указанные.
  • filter[created_at][lt] — дата и время менее, чем указанные.
filter[updated_at]

query

string

Опциональный

Предназначен для фильтрации Списаний по дате дате и времени последнего обновления в формате RFC 3339 (например, 2017-10-04T15:12:01.558009%2B03:00). Для указания диапазона используются следующие фильтры:
  • filter[updated_at][gt] — дата и время более, чем указанные.
  • filter[updated_at][lt] — дата и время менее, чем указанные.
filter[plan_class_ids]

query

string

Опциональный

Предназначен для фильтрации Списаний по ID Правила предоставления (см. Просмотр списка правил предоставления). Поддерживается указание списка из нескольких ID Правил предоставления, разделенных запятыми
includequerystringОпциональный

Предназначен для включения в ответ дополнительной информации о связанных объектах. Для получения информации о нескольких объектах значения параметра должны перечисляться через запятую. Поддерживаются следующие объекты:

ОбъектЗначение параметра

Реселлер

reseller
Клиентaccount
Подпискаsubscription

Тарифный план

plan

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

Название

Тип данных

Описание

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


id

integerID Списания

typestringТип данных

attributesobjectИнформация о Списании


created_atdateДата и время создания Списания


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


subscription_idintegerID Подписки


subscription_resource_idintegerID Ресурса в клиентской Подписке


quantityintegerКоличество заказанных единиц Услуги или Ресурса


operate_from

dateДата начала периода, оплаченного Списанием


durationfloatПериод Списания, измеряемый в месяцах. Например, период 1 день = 0.033, 2 года = 24


descriptionstringПодробное описание Списания


unit_pricefloatСтоимость единицы Ресурса или Услуги у выбранного Реселлера в валюте Тарифного плана


amountfloatОбщая сумма Списания (с учетом Скидки) в валюте выбранного Реселлера


statusstringСтатус Списания (список статусов см. в Атрибуты списаний)


typestring

Тип Списания (см. также Атрибуты списаний):

  • Charge::Setup — Списание за установку Подписки.
  • Charge::Recurring — Списание за абонентскую плату Подписки.
  • Charge::RecurringResource — Списание за абонентскую плату ресурса Подписки.
  • Charge::Renewal — Списание за продление Подписки.
  • Charge::RenewalResource — Списание за продление Ресурса.
  • Charge::ExternalResource — Списание за использование внешнего Ресурса.
  • Charge::SetupResource — Списание за установку Ресурсов Подписки.
  • Charge::Transfer — Списание за перенос Домена.


net_costfloatСебестоимость Списания для выбранного Реселлера в валюте Тарифного плана. Величина рассчитывается только для делегированных Тарифных планов и формируется исходя из цены вышестоящего Реселлера


taxes_amountfloatСумма налогов для данного Списания в валюте выбранного Реселлера


subscription_resource_namestringИмя Ресурса в Подписке, которая была заказана Клиентом


plan_resource_idintegerID Ресурса в Тарифном плане, который был заказан Клиентом


resource_idintegerID Ресурса в Шаблоне услуги


order_idintegerID Заказа, по которому произведено Списание


operate_todateДата окончания периода, оплаченного Списанием


close_datedate

Дата, когда Cписание должно быть закрыто



billing_datedateДата начала Финансового периода, к которому относится Списание


application_template_keystringКлюч Шаблона услуги, на основе которого создано приложение для Подписки (см. Просмотр и обновление информации о коннекторе)


additional_params

array of objects

Дополнительные параметры Списания для Услуг на основе следующих модулей:

  • MicrosoftCspProducts Plugin:
НазваниеТип данныхОписание
tenant_idstringID тенанта в Microsoft Partner Center
tenant_namestringИмя тенанта (домен) в Microsoft Partner Center
subscription_idstringID подписки на стороне Microsoft (внешний ID)
order_idstringID заказа на стороне Microsoft
alternate_idstringАльтернативный ID заказа на стороне Microsoft
product_idstringID продукта на стороне Microsoft, к которому относится ресурс, связанный со Списанием (пример см. в Получение списка ресурсов для коннектора Microsoft Software Subscriptions)
sku_idstringSKU ресурса на стороне Microsoft, связанного со Списанием (пример см. в Получение списка ресурсов для коннектора Microsoft Software Subscriptions)
effective_costfloatСебестоимость Списания для Реселлера с учетом скидки PEC от Microsoft. Только для Подписок на Услугу Microsoft Azure Plan (см. Формирование записей о потребленных ресурсах для подписки на услугу Microsoft Azure Plan)
  • Manual Provisioning Plugin (Ручной Провижининг):
НазваниеТип данныхОписание
tenant_namestringОсновное имя Клиента, заказавшего Подписку (см. Получение информации о Клиенте Реселлера по ID)
tenant_idstringID Клиента, заказавшего Подписку
order_idstringID Заказа на покупку, связанного с Подпиской
subscription_idstringID Подписки
offer_idstringSKU Тарифного плана, на основе которого создана Подписка (см. Получение информации о Тарифном плане Реселлера)
  • Office365:
НазваниеТип данныхОписание
tenant_namestringИмя тенанта (домен) в Microsoft Partner Center
tenant_idstringИдентификатор тенанта в Microsoft Partner Center
order_idstringНомер заказа на стороне Microsoft
subscription_idstringID подписки на стороне Microsoft
offer_idstringУникальный идентификатор (SKU) плана или дополнения в Microsoft Partner Center
  • Vendor Service Plugin (VSP):
НазваниеТип данныхОписание
external_idstringApplication External ID (внешний ID)
plan_skustringPlan SKU
subscription_attributesobjectДополнительные атрибуты Подписки, созданные в Vendor Portal, кроме атрибута, содержащего пароль
resource_keystringApplication Resource Key

В остальных случаях возвращается пустой массив



discountfloatРазмер Скидки для данного Списания в валюте выбранного Реселлера


original_amountstringРазмер Списания в валюте Тарифного плана


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


currency_ratestringКурс, по которому сформировано Списание


currency_unitintegerНоминал валюты, который использовался при расчете величины Cписания

relationshipsarrayПеречень объектов, связанных со Списанием


taxesarrayИнформация о налогах



dataarray

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

НазваниеТип данныхОписание
idintegerID объекта
typestringТип данных


resellerarrayИнформация о Реселлере



dataarray

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

НазваниеТип данныхОписание
idintegerID объекта
typestringТип данных


accountarrayИнформация о Клиенте



dataarray

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

НазваниеТип данныхОписание
idintegerID объекта
typestringТип данных


subscriptionarrayИнформация о Подписке



dataarray

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

НазваниеТип данныхОписание
idintegerID объекта
typestringТип данных


planarrayИнформация о Тарифном плане



dataarray

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

НазваниеТип данныхОписание
idintegerID объекта
typestringТип данных


discountarrayИнформация о Скидке



dataarray

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

НазваниеТип данныхОписание
idintegerID объекта
typestringТип данных
includedarray

Дополнительная информация о связанных объектах, указанных в запросе:

НазваниеТип данныхОписание
idintegerID объекта
typestringТип данных
attributesarrayАтрибуты (см. ниже)

Атрибуты:

НазваниеТип данныхОписание
idintegerID Подписки
typestringТип данных
attributesarrayИнформация о Подписке

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

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

auto_renewalbool

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

  • false — автоматическое продление отключено.
  • true — автоматическое продление включено.

billing_fromdateДата начала генерации Списаний по Подписке

expiration_datedateДата истечения срока действия Подписки

namestringНазвание Подписки

renew_point_daysintegerКоличество дней до истечения Подписки, когда Клиент получает счет на продление

start_datedateДата активации Подписки

statusstring

Статус Подписки (список статусов см. в Просмотр списка подписок)


payment_modelstring

Модель оплаты Подписки. Возможные значения:

  • prepay – Предоплата.
  • postpay – Постоплата.

payment_model_parametersobjectПараметры модели оплаты Подписки


credit_limitfloatВеличина кредитного лимита, заданная на уровне Правила обслуживания или переопределенная на уровне Клиента или Подписки. Возвращается только для payment_model = postpay


current_debtfloatВеличина текущей задолженности по Подписке. Возвращается только для payment_model = postpay
linksarrayСсылки на страницы для навигации по элементам ответа с учетом заданных параметров постраничной навигации

selfstringСсылка на текущую страницу

firststringСсылка на первую страницу

prevstringСсылка на предыдущую страницу

nextstringСсылка на следующую страницу

laststringСсылка на последнюю страницу
metaarrayДополнительная информация о Списании

currencystringКод валюты Реселлера

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

GET /api/v3/resellers/1/charges?page[size]=2&page[number]=70&filter[close_date][gte]=2019-10-01&filter[close_date][lte]=2019-10-31&filter[status]=closed&filter[plan_class_ids]=1,5&include=reseller,account,subscription,plan
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json

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

{
    "data": [
        {
            "id": "73083",
            "type": "charges",
            "attributes": {
                "created_at": "2019-08-21T11:50:21.263342+0300",
                "updated_at": "2019-11-16T01:18:26.253966+0300",
                "subscription_id": 3005638,
                "subscription_resource_id": 30146,
                "quantity": 1,
                "operate_from": "2019-09-01",
                "duration": 0.667,
                "description": "Upgrade resource (recurring fee) \"res3\" for Subscription #3005638 \"Auto provisioning with resources\"",
                "unit_price": "2.0",
                "amount": "1.27",
                "status": "closed",
                "type": "Charge::Recurring",
                "net_cost": null,
                "taxes_amount": 0,
                "subscription_resource_name": "res3",
                "plan_resource_id": 2158,
                "resource_id": 10,
                "order_id": 8025,
                "operate_to": "2019-09-20",
                "close_date": "2019-09-30",
				"billing_date": "2019-09-01",
				"application_template_key": "",
                "additional_params": [],
                "discount": "0.06",
                "original_amount": "1.27",
                "original_amount_currency": "BYN",
                "currency_rate": "1.0",
                "currency_unit": 1
            },
            "relationships": {
                "taxes": {
                    "data": []
                },
                "reseller": {
                    "data": {
                        "id": "1",
                        "type": "resellers"
                    }
                },
                "account": {
                    "data": {
                        "id": "494",
                        "type": "accounts"
                    }
                },
                "subscription": {
                    "data": {
                        "id": "3005638",
                        "type": "subscriptions"
                    }
                },
                "plan": {
                    "data": {
                        "id": "5",
                        "type": "plans"
                    }
                },
                "plan_resource": {
                    "data": null
                },
                "discount": {
                    "data": {
                        "id": "89",
                        "type": "discounts"
                    }
                }
            }
        },
        {
            "id": "73109",
            "type": "charges",
            "attributes": {
                "created_at": "2019-08-22T15:59:54.376771+0300",
                "updated_at": "2019-10-12T01:15:30.459665+0300",
                "subscription_id": 3005649,
                "subscription_resource_id": null,
                "quantity": 1,
                "operate_from": "2019-09-01",
                "duration": 1,
                "description": "Switch resource (recurring fee) #3005649 \"Auto provisioning with resources\"",
                "unit_price": "1.0",
                "amount": "1.0",
                "status": "closed",
                "type": "Charge::Recurring",
                "net_cost": null,
                "taxes_amount": 0,
                "subscription_resource_name": null,
                "plan_resource_id": null,
                "resource_id": null,
                "order_id": 8036,
                "operate_to": "2019-09-30",
                "close_date": "2019-09-30",
				"billing_date": "2019-09-01",
				"application_template_key": "",
                "additional_params": [],
                "discount": "0.00",
                "original_amount": "1.0",
                "original_amount_currency": "BYN",
                "currency_rate": "1.0",
                "currency_unit": 1
            },
            "relationships": {
                "taxes": {
                    "data": []
                },
                "reseller": {
                    "data": {
                        "id": "1",
                        "type": "resellers"
                    }
                },
                "account": {
                    "data": {
                        "id": "503",
                        "type": "accounts"
                    }
                },
                "subscription": {
                    "data": {
                        "id": "3005649",
                        "type": "subscriptions"
                    }
                },
                "plan": {
                    "data": {
                        "id": "5",
                        "type": "plans"
                    }
                },
                "plan_resource": {
                    "data": null
                },
                "discount": {
                    "data": null
                }
            }
        }
    ],
    "included": [
        {
            "id": "1",
            "type": "resellers",
            "attributes": {...
            }
        },
        {
            "id": "494",
            "type": "accounts",
            "attributes": {...
            },
            "relationships": {...
            }
        },
        {
            "id": "3005638",
            "type": "subscriptions",
            "attributes": {
                "created_at": "2019-08-21T11:50:21.083490+0300",
                "updated_at": "2019-11-16T01:18:26.153891+0300",
                "auto_renewal": false,
                "billing_from": "2019-08-21",
                "expiration_date": "2019-09-21",
                "name": "Auto provisioning with resources",
                "renew_point_days": 1,
                "start_date": "2019-08-21",
                "status": "deleted",
                "payment_model": "postpay",
                "payment_model_parameters": {
                    "credit_limit": 100,
                    "current_debt": 0
                }
            }
        },
        {
            "id": "5",
            "type": "plans",
            "attributes": {...
            }
        },
        {
            "id": "503",
            "type": "accounts",
            "attributes": {...
            },
            "relationships": {...
            }
        },
        {
            "id": "3005649",
            "type": "subscriptions",
            "attributes": {
                "created_at": "2019-08-22T15:59:54.138703+0300",
                "updated_at": "2019-09-20T10:47:07.896382+0300",
                "auto_renewal": false,
                "billing_from": "2019-08-22",
                "expiration_date": "2019-12-22",
                "name": "Auto provisioning with resources",
                "renew_point_days": 1,
                "start_date": "2019-08-22",
                "status": "waiting_for_manual_approve",
                "payment_model": "postpay",
                "payment_model_parameters": {
                    "credit_limit": 0,
                    "current_debt": 0
                }
            }
        }
    ],
    "links": {
        "self": "https://test.activeplatform.com/api/v3/resellers/1/charges?filter%5Bclose_date%5D%5Bgte%5D=2019-10-01&filter%5Bclose_date%5D%5Blte%5D=2019-10-31&filter%5Bplan_class_ids%5D=1%2C5&filter%5Bstatus%5D=closed&include=reseller%2Caccount%2Csubscription%2Cplan&page%5Bnumber%5D=70&page%5Bsize%5D=2",
        "first": "https://test.activeplatform.com/api/v3/resellers/1/charges?filter%5Bclose_date%5D%5Bgte%5D=2019-10-01&filter%5Bclose_date%5D%5Blte%5D=2019-10-31&filter%5Bplan_class_ids%5D=1%2C5&filter%5Bstatus%5D=closed&include=reseller%2Caccount%2Csubscription%2Cplan&page%5Bnumber%5D=1&page%5Bsize%5D=2",
        "prev": "https://test.activeplatform.com/api/v3/resellers/1/charges?filter%5Bclose_date%5D%5Bgte%5D=2019-10-01&filter%5Bclose_date%5D%5Blte%5D=2019-10-31&filter%5Bplan_class_ids%5D=1%2C5&filter%5Bstatus%5D=closed&include=reseller%2Caccount%2Csubscription%2Cplan&page%5Bnumber%5D=69&page%5Bsize%5D=2",
        "next": "https://test.activeplatform.com/api/v3/resellers/1/charges?filter%5Bclose_date%5D%5Bgte%5D=2019-10-01&filter%5Bclose_date%5D%5Blte%5D=2019-10-31&filter%5Bplan_class_ids%5D=1%2C5&filter%5Bstatus%5D=closed&include=reseller%2Caccount%2Csubscription%2Cplan&page%5Bnumber%5D=71&page%5Bsize%5D=2",
        "last": "https://test.activeplatform.com/api/v3/resellers/1/charges?filter%5Bclose_date%5D%5Bgte%5D=2019-10-01&filter%5Bclose_date%5D%5Blte%5D=2019-10-31&filter%5Bplan_class_ids%5D=1%2C5&filter%5Bstatus%5D=closed&include=reseller%2Caccount%2Csubscription%2Cplan&page%5Bnumber%5D=79&page%5Bsize%5D=2"
    },
    "meta": {
        "currency": "BYN"
    }
}