Получение списка заблокированных списаний

Метод используется для получения многостраничного списка заблокированных списаний на балансе аккаунта, к которому есть доступ у текущего пользователя. 

GET {reseller_domain}/internal_api/accounts/{account_id}/blocked_charges

В этой статье:

Авторизация

Требуется авторизация с помощью access token пользователя.

Аргументы

Название

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

Тип данных

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

Описание

Content-Type

header

string

Обязательный

Тип данных, передаваемых в запросе. Укажите application/vnd.api+json

Accept

header

string

Обязательный

Поддерживаемые типы данных в ответе. Укажите application/vnd.api+json

X-Api-Locale

header

string

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

Двухбуквенный код языка данных в ответе

Authorization 

header

string

Обязательный

Действующий access token пользователя. Формат: Bearer <access token>

reseller_domain

path

string

Обязательный

Доменное имя реселлера

account_id

path

integer

Обязательный

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

page[size]

query

integer

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

Параметр постраничной навигации. Количество элементов на странице ответа (50 по умолчанию)

page[number]

query

integer

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

Параметр постраничной навигации. Номер страницы ответа (1 по умолчанию)

sort

query

string

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

Предназначен для сортировки элементов списка по указанному параметру. Доступные значения:

  • sort=created_at — сортировка по возрастанию значений created_at.

  • sort=-created_at — сортировка по убыванию значений created_at.

include

query

string

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

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

Объект

Значение параметра

Налоги

taxes

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

Название

Тип данных

Описание

data

array of objects

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


id

string

ID списания


type

string

Тип данных


attributes

object

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



created_at

string

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



type

string

Тип списания



description

string

Описание



quantity_float

string

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



duration_float

string

Оплачиваемый период в месяцах



operate_from

string

Дата начала оплачиваемого периода



operate_to

string

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



unit_price

string

Цена за единицу услуги или ресурса с указанием валюты реселлера



discount_amount

string

Скидка с указанием валюты реселлера



amount

string

Сумма списания с налогами с указанием валюты реселлера



total

number

Сумма списания с налогами в валюте реселлера



tax_is_calculated_using

string

Настройка Налоги рассчитываются (см. ):

  • net_prices Сверх цены плана — все цены в тарифных планах указаны без налогов.

  • gross_prices Внутри цены плана — все цены в тарифных планах включают в себя налоги.



net_amount

number

Сумма списания без налогов в валюте реселлера



taxes_amount

string

Сумма налогов с указанием валюты реселлера



reseller_currency_iso_code

string

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



item_target_data

object

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




target_id

integer

ID сущности




target_type

string

Тип сущности




type

string

Тип списания




description

string

Название сущности



subscription

object

Информация о подписке, для которой сформировано списание




id

integer

ID подписки




name

string

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




billing_type

string

Тип биллинга тарифного плана, на который заказана подписка (см.


)




payment_model

string

Модель оплаты подписки:

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

  • postpay Постоплата.



original_amount

number

Сумма списания с налогами в валюте тарифного плана



unit_price_currency

string

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


relationships

object

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



taxes

object

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




data

array of objects

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

Название

Тип данных

Описание

id

string

ID объекта

type

string

Тип данных

included

array of objects

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

Название

Тип данных

Описание

id

string

ID объекта

type

string

Тип данных

attributes

object

Атрибуты (см. ниже)

  • Для налогов — о каждом налоге, использованном при создании списания:

    Название

    Тип данных

    Описание

    id

    string

    ID налога

    type

    string

    Тип данных

    attributes

    object

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


    created_at

    string

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


    updated_at

    string

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


    charge_id

    integer

    ID списания, для которого рассчитан налог


    origin_id

    integer

    ID налога в налоговом модуле


    name

    string

    Название налога


    code

    string

    Код налога


    rate

    number

    Размер налога в процентах


    amount

    number

    Сумма налога в валюте реселлера, рассчитанная для net_amount списания

links

object

Ссылки для постраничной навигации


self

string

Текущая страница


first

string

Первая страница


prev

string

Предыдущая страница (при наличии)


next

string

Следующая страница (при наличии)


last

string

Последняя страница

meta

object

Дополнительная информация


current_page

integer

Номер текущей страницы


page_count

integer

Общее число страниц


server_current_time

string

Текущие дата и время сервера

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

Bash
curl --location --request GET 'https://test.activeplatform.com/internal_api/accounts/95/blocked_charges?include=taxes' \
--header 'Content-Type: application/vnd.api+json' \
--header 'Accept: application/vnd.api+json' \
--header 'X-Api-Locale: en' \
--header 'Authorization: Bearer AccessTokenExample'

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

JSON
{
    "data": [
        {
            "id": "6926",
            "type": "charge_recurrings",
            "attributes": {
                "created_at": "2023-04-11T11:27:59.590891+0000",
                "type": "Charge::Recurring",
                "description": "Upgrade resource (recurring fee) \"Licenses\" for Subscription #1687 \"Office\" from 24.02.2023 to 28.02.2023",
                "quantity_float": "1.0",
                "duration_float": "0.179",
                "operate_from": "2023-02-24",
                "operate_to": "2023-03-01",
                "unit_price": "11.00 €",
                "discount_amount": "0.00 €",
                "amount": "2.39 €",
                "total": 2.39,
                "tax_is_calculated_using": "net_prices",
                "net_amount": 1.97,
                "taxes_amount": "0.42 €",
                "reseller_currency_iso_code": "EUR",
                "item_target_data": {
                    "target_id": 2030,
                    "target_type": "SubscriptionResource",
                    "type": "ProvisioningItem::Upgrade",
                    "description": "Licenses"
                },
                "subscription": {
                    "id": 1687,
                    "name": "Office",
                    "billing_type": "csp_monthly",
                    "payment_model": "prepay"
                },
                "original_amount": 2.39,
                "unit_price_currency": "EUR"
            },
            "relationships": {
                "taxes": {
                    "data": [
                        {
                            "id": "7770",
                            "type": "taxes"
                        },
                        {
                            "id": "7769",
                            "type": "taxes"
                        },
                        {
                            "id": "7768",
                            "type": "taxes"
                        }
                    ]
                }
            }
        }
    ],
    "included": [
        {
            "id": "7770",
            "type": "taxes",
            "attributes": {
                "charge_id": 6926,
                "origin_id": 38,
                "name": "Regional tax",
                "code": "reg",
                "rate": 8.0,
                "amount": 0.16,
                "created_at": "2023-04-11T11:27:59.603446+0000",
                "updated_at": "2023-04-11T11:27:59.603446+0000"
            }
        },
        {
            "id": "7769",
            "type": "taxes",
            "attributes": {
                "charge_id": 6926,
                "origin_id": 18,
                "name": "Local Tax",
                "code": "loc",
                "rate": 2.0,
                "amount": 0.04,
                "created_at": "2023-04-11T11:27:59.602363+0000",
                "updated_at": "2023-04-11T11:27:59.602363+0000"
            }
        },
        {
            "id": "7768",
            "type": "taxes",
            "attributes": {
                "charge_id": 6926,
                "origin_id": 20,
                "name": "VAT",
                "code": "vat",
                "rate": 11.0,
                "amount": 0.22,
                "created_at": "2023-04-11T11:27:59.600455+0000",
                "updated_at": "2023-04-11T11:27:59.600455+0000"
            }
        }
    ],
    "links": {
        "self": "https://test.activeplatform.com/internal_api/accounts/95/blocked_charges?include=taxes&page%5Bnumber%5D=1&page%5Bsize%5D=50",
        "first": "https://test.activeplatform.com/internal_api/accounts/95/blocked_charges?include=taxes&page%5Bnumber%5D=1&page%5Bsize%5D=50",
        "prev": null,
        "next": null,
        "last": "https://test.activeplatform.com/internal_api/accounts/95/blocked_charges?include=taxes&page%5Bnumber%5D=1&page%5Bsize%5D=50"
    },
    "meta": {
        "current_page": 1,
        "page_count": 1,
        "server_current_time": "2023-06-30 T12:34:56.199973+0300"
    }
}