Метод используется для получения информации о корзине покупок, созданной в результате вызова метода Создание корзины покупок, для аккаунта, к которому есть доступ у текущего пользователя.
GET {reseller_domain}/internal_api/shopping_carts/{shopping_cart_id}
В этой статье:
Авторизация
Требуется авторизация с помощью 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 пользователя. Формат: |
|
|
reseller_domain |
path |
string |
Обязательный |
Доменное имя реселлера |
|
|
shopping_cart_id |
path |
integer |
Обязательный |
ID корзины покупок, созданной в результате вызова метода Создание корзины покупок |
|
|
order_type |
query |
string |
Обязательный |
Тип заказа. Доступные значения:
|
|
Модель ответа
|
Название |
Тип данных |
Описание |
||||||
|---|---|---|---|---|---|---|---|---|
|
data |
object |
Данные ответа |
||||||
|
|
id |
string |
ID корзины покупок |
|||||
|
|
type |
string |
Тип данных |
|||||
|
|
attributes |
object |
Информация о корзине покупок |
|||||
|
|
|
created_at |
string |
Дата и время создания корзины покупок |
||||
|
|
|
provisioning_date |
string |
Дата предоставления заказа (ГГГГ-ММ-ДД) |
||||
|
|
|
total |
number |
Стоимость заказа |
||||
|
|
|
total_with_currency |
string |
Стоимость заказа с указанием валюты |
||||
|
|
|
has_discount |
bool |
Признак наличия скидки:
|
||||
|
|
|
total_discount |
number |
Сумма скидки |
||||
|
|
|
total_discount_with_currency |
string |
Сумма скидки с указанием валюты |
||||
|
|
|
promo_code |
string |
Промокод, указанный при оформлении заказа |
||||
|
|
|
trial |
bool |
Признак пробной подписки:
|
||||
|
|
|
billing_day |
integer |
Финансовый день по подписке |
||||
|
|
|
next_billing_date |
string |
Следующий финансовый день по подписке (ГГГГ-ММ-ДД) |
||||
|
|
|
items |
array of objects |
Список позиций в заказе |
||||
|
|
|
|
name |
string |
Описание позиции |
|||
|
|
|
|
quantity |
integer |
Количество заказанных единиц услуги или ресурса |
|||
|
|
|
|
discount_amount |
string |
Сумма скидки с указанием валюты |
|||
|
|
|
|
amount |
string |
Стоимость позиции с указанием валюты |
|||
|
|
|
|
top_up |
bool |
Признак пополнения баланса:
|
|||
|
|
|
|
duration |
string |
Период, на который заказывается позиция (в месяцах) |
|||
|
|
|
|
unit_price |
string |
Цена за единицу заказанной единицы услуги или ресурса с указанием валюты |
|||
|
|
|
taxes_total |
object |
Итоговые данные налогов (см.
) |
||||
|
|
|
|
total |
string |
Сумма все налогов по всем списаниям с указанием валюты реселлера |
|||
|
|
|
|
taxes |
array of objects |
Итоговые данные каждого налога |
|||
|
|
|
|
|
origin_id |
string |
ID налога в налоговом модуле |
||
|
|
|
|
|
name |
string |
Название налога |
||
|
|
|
|
|
rate |
number |
Ставка налога в процентах |
||
|
|
|
|
|
amount |
string |
Сумма налога по всем списаниям с указанием валюты реселлера |
||
|
|
|
tax_is_calculated_using |
string |
Настройка Налоги рассчитываются (см. ):
|
||||
|
|
|
payment_model |
string |
Модель оплаты подписки в заказе:
|
||||
|
|
|
work_permit_for_postpaid |
string |
Наличие у аккаунта разрешения на заказ подписок по модели Постоплата (см. ):
|
||||
|
|
|
allow_order_postpaid_subscription |
string |
Значение настройки реселлера Разрешать работу клиента по постоплате (см. ):
|
||||
|
|
|
po_number |
string |
Номер заказа в системе закупок клиента (Purchase Order, PO) (см. Обновление информации о PO в корзине покупок) |
||||
|
|
|
po_document |
object |
Информация о файле заказа из системе закупок клиента |
||||
|
|
|
|
name |
string |
Имя файла |
|||
|
|
|
|
url |
string |
Ссылка на файл |
|||
|
|
|
|
size |
integer |
Размер файла в байтах |
|||
|
|
|
next_month_amount_with_currency |
string |
Стоимость подписки на следующий месяц с указанием валюты |
||||
|
|
|
plan_data |
object |
Информация о тарифном плане |
||||
|
|
|
|
id |
integer |
ID тарифного плана |
|||
|
|
|
|
name |
string |
Название тарифного плана |
|||
|
|
|
|
sku |
string |
SKU тарифного плана |
|||
|
meta |
object |
Дополнительная информация |
||||||
|
|
server_current_time |
string |
Текущие дата и время сервера |
|||||
Пример запроса
curl --location --request GET 'https://test.activeplatform.com/internal_api/shopping_carts/20703?order_type=SalesOrder' \
--header 'Content-Type: application/vnd.api+json' \
--header 'Accept: application/vnd.api+json' \
--header 'X-Api-Locale: en' \
--header 'Authorization: Bearer AccessTokenExample'
Пример ответа
{
"data": {
"id": "20703",
"type": "shopping_cart",
"attributes": {
"created_at": "2023-11-11T18:58:15.072880+0300",
"provisioning_date": "2023-11-11",
"total": 2.73,
"total_with_currency": "2.73 USD",
"has_discount": true,
"total_discount": 0.31,
"total_discount_with_currency": "0.31 USD",
"promo_code": null,
"trial": false,
"billing_day": 1,
"next_billing_date": "2023-12-01",
"items": [
{
"name": "\"License\" for subscription \"Monthly Commitment\" from 11.11.2023 to 30.11.2023 (recurring fee)",
"quantity": 5,
"discount_amount": "0.22 USD",
"amount": "1.95 USD",
"top_up": false,
"duration": "0.667",
"unit_price": "0.65 USD"
},
{
"name": "\"Users\" for subscription \"Monthly Commitment\" from 11.11.2023 to 30.11.2023 (recurring fee)",
"quantity": 1,
"discount_amount": "0.09 USD",
"amount": "0.78 USD",
"top_up": false,
"duration": "0.667",
"unit_price": "1.30 USD"
}
],
"taxes_total": null,
"tax_is_calculated_using": "net_prices",
"payment_model": "postpay",
"work_permit_for_postpaid": "verification_not_performed",
"allow_order_postpaid_subscription": "manually",
"po_number": "00230508",
"po_document": {
"name": "PO_signed.pdf",
"url": "https://storage.test.activeplatform.com/private/uploads/shopping_cart/po_document/20703/PO_signed.pdf?expires=1699719746\u0026hash=O4J8au",
"size": 120850
},
"next_month_amount_with_currency": "4.10 USD",
"plan_data": {
"id": 23798,
"name": "Microsoft Defender For IoT",
"sku": "CFQ7TTC0MZH6:0002:P1M:Monthly"
}
}
},
"meta": {
"server_current_time": "2023-11-11T18:58:15.146688+0300"
}
}