Получение списка Списаний

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

Метод Get List of Charges API v1 позволяет получить список Списаний для текущего Реселлера.

Список Cписаний может быть показан в рамках конкретной страницы. Для этого необходимо передать следующие аргументы:

номер страницы (page);
количество элементов на странице (per_page).

Список Cписаний может быть отсортирован по любому полю. Для этого необходимо передать следующие аргументы:

название поля для сортировки по нему (sorting[field]);
режим сортировки: по возрастанию или по убыванию (sorting[reversed]).

Список Списаний может быть отфильтрован по:

дате создания (filters[created_at]);
дате обновления (filters[updated_at]);
id Подписки (filters[subscription_id]);
статусу (filters[status]).

Метод {base_url}/api/vendor/v1/charges устарел. Рекомендуется использовать:

GET {base_url}/api/reseller/v1/charges.json?api_token={api_token}

Аргументы

Название	Тип параметра	Тип данных	Обязательный/ Опциональный	Описание
api_token	query	string	Обязательный	API токен Сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике). Текущий Реселлер определяется по данному токену
page	query	integer	Опциональный	Возвращается список Списаний по указанному номеру страницы

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

Название	Тип данных	Описание
id	integer	ID Cписания
subscription_id	integer	ID Подписки
subscription_resource_id	integer	ID Ресурса в Подписке
subscription_resource_name	string	Имя Ресурса в Подписке
plan_resource_id	integer	ID ресурса в Тарифном плане
resource_id	integer	ID Ресурса в Шаблоне услуги
quantity	integer	Количество заказанных единиц Услуги или Ресурса
operate_from	date	Дата начала периода, оплаченного Списанием
operate_to	date	Дата окончания периода, оплаченного Списанием
duration	float	Период Списания, измеряемый в месяцах. Например, период 1 день = 0.033, 2 года = 24
description	string	Подробная информация о Списании
unit_price	float	Стоимость одной единицы Услуги или Ресурса
amount	float	Общая сумма Списания
status	string	Текущий статус Списания (список статусов см. в Атрибуты списаний)
type	string	Тип Списания (см. также Charges attributes) Charge::Setup - Списание за установку Подписки; Charge::Recurring - Списание за абонентскую плату Подписки; Charge::RecurringResource - Списание за абонентскую плату ресурса Подписки; Charge::Renewal - Списание за продление Подписки; Charge::RenewalResource - Списание за продление Ресурса; Charge::ExternalResource - Списание за использование внешнего Ресурса; Charge::SetupResource" - Списание за установку Ресурсов Подписки; Charge::Transfer - списание за перенос Домена.
order_id	integer	ID Заказа, по которому произведено Cписание
close_date	date	Дата, когда Cписание должно быть закрыто
created_at	date	Дата и время создания Списания
updated_at	date	Дата и время последнего изменения Списания

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

GET http://reseller.activeplatform.com/api/reseller/v1/charges?api_token=qQwW123

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

[
    {
        "id": 46875,
        "subscription_id": 3004218,
        "subscription_resource_id": 28236,
        "subscription_resource_name": "Resources consumption",
        "plan_resource_id": 3499,
        "resource_id": 1580,
        "quantity": 1,
        "operate_from": "2018-04-27",
        "operate_to": "2018-04-30",
        "duration": 19.047999,
        "description": "Charge Resource (recurring fee) \"Resources consumption\" for #3004218 \"azures\"",
        "unit_price": "5.0",
        "amount": "95.24",
        "status": "closed",
        "type": "Charge::RecurringResource",
        "order_id": null,
        "close_date": "2018-04-30",
        "created_at": "2018-04-27T04:38:40.203400+0300",
        "updated_at": "2018-06-01T13:56:15.162505+0300"
    },    
    {
        "id": 49848,
        "subscription_id": 3004376,
        "subscription_resource_id": 28619,
        "subscription_resource_name": "Resources consumption",
        "plan_resource_id": 3532,
        "resource_id": 1594,
        "quantity": 1,
        "operate_from": "2018-07-20",
        "operate_to": "2018-07-31",
        "duration": 120.7593293625,
        "description": "Charge Resource (recurring fee) \"Resources consumption\" for #3004376 \"Azure For Demo\"",
        "unit_price": "4.0",
        "amount": "483.04",
        "status": "closed",
        "type": "Charge::RecurringResource",
        "order_id": null,
        "close_date": "2018-07-31",
        "created_at": "2018-07-20T15:52:08.242171+0300",
        "updated_at": "2018-12-01T07:18:03.418472+0300"
    }
]