shop.product.getInfo
Возвращает информацию о товаре.
Параметры
-
id
GET
ID товара.
-
access_token
GET
Токен авторизации, полученный при подключении к API.
-
format
GET
Необязательно
Устанавливает формат ответа. Возможные значения:
json
(по умолчанию),xml
.
Массив с информацией о товаре
- id int ID товара.
- name string Наименование.
- summary string Краткое описание.
- meta_title string Значение элемента TITLE страницы товара.
- meta_keywords string Значение метатега keywords.
- meta_description string Значение метатега description.
- description string Полное описание.
- contact_id int ID контакта пользователя, добавившего товар.
- create_datetime datetime Дата и время создания товара.
- edit_datetime datetime Дата и время последнего обновления товара.
- status int Обозначение статуса товара: -1 (снят с публикации), 0 (скрыт), 1 (опубликован).
- type_id int ID типа товара.
- image_id int ID основного изображения.
- video_url string Ссылка на видеоролик.
- sku_id int ID основной модификации.
- url int Редактируемая часть URL страницы товара на витрине.
- rating float Рейтинг товара по результатам его оценки покупателями.
- price float Цена в формате
decimal(15,4)
. - compare_price float Зачёркнутая цена в формате
decimal(15,4)
. - currency string Обозначение валюты товара в формате ISO 4217.
- min_price float Минимальная цена модификации в формате
decimal(15,4)
. - max_price float Максимальная цена модификации в формате
decimal(15,4)
. - tax_id int ID выбранного налогового правила или 0, если правило не выбрано.
- count float|null Общее количество на складе всех модификаций. Значение
null
означает, что для некоторых модификаций товара указано бесконечное количество на складе. - count_denominator int Доступная точность указания складских остатков товара. Возможные значения: 1 (целые штуки), 10 (точность до десятых), 100 (точность до сотых), 1000 (точность до тысячных).
- order_multiplicity_factor float Шаг (кратность) добавления в корзину в формате
decimal(15,3)
. - stock_unit_id int ID выбранной складской единицы измерения количества.
- base_unit_id int ID выбранной базовой единицы измерения количества.
- stock_base_ratio float Соотношение между складской и базовой единицами измерения количества.
- order_count_min float Минимальное количество товара в заказе в формате
decimal(15,3)
. - order_count_step float Значение изменения количества кнопками «+/-» в формате
decimal(15,3)
. - cross_selling int Режим отображения сопутствующих товаров: 0 (выключено), 1 (включено показывать в соответствии с настройками типа товаров), 2 (включено показывать выбранные вручную рекомендуемые товары).
- upselling int Режим отображения схожих и альтернативных товаров: 0 (выключено), 1 (включено показывать в соответствии с настройками типа товаров), 2 (включено показывать выбранные вручную рекомендуемые товары).
- rating_count int Количество отзывов о товаре.
- total_sales float Общая сумма продаж товара, выраженная в основной валюте магазина, в формате
decimal(15,4)
. - category_id int ID основной категории.
- badge string Обозначение одной из стандартных наклеек либо HTML собственной наклейки для изображений.
- sku_type int Тип выбора модификаций товара на витрине: 0 (по наименованиям артикулов), 1 (по значениям характеристик).
- sku_count int Количество модификаций.
- image_url string URL эскиза основного изображения товара с размером '750x0', если у товара есть изображения.
- skus array Массив информации о модификациях товара. Подмассив каждой модификации содержит значения со следующими ключами:
- skus[]['id'] int ID модификации.
- skus[]['sku'] int Код артикула.
- skus[]['sort'] int Значение сортировки.
- skus[]['name'] string Наименование артикула.
- skus[]['image_id'] int ID изображения, выбранного в свойствах модификации.
- skus[]['price'] float Цена в формате
decimal(15,4)
. - skus[]['purchase_price'] float Закупочная цена в формате
decimal(15,4)
. - skus[]['compare_price'] float Зачёркнутая цена в формате
decimal(15,4)
. - skus[]['count'] float|null Общее количество на складе в формате
decimal(15,3)
илиnull
, если количество модификации на всех складах бесконечное. - skus[]['available'] int Флаг (0 или 1), означающий доступность модификации для заказа.
- skus[]['stock_base_ratio'] float Соотношение между складской и базовой единицами измерения количества.
- skus[]['order_count_min'] float Минимальное количество модификации в заказе в формате
decimal(15,3)
. - skus[]['order_count_step'] float Значение изменения количества кнопками «+/-» в формате
decimal(15,3)
. - skus[]['status'] int Видимость модификации на витрине.
- skus[]['file_name'] string Имя прикреплённого файла.
- skus[]['file_size'] int Размер прикреплённого файла в байтах.
- skus[]['file_description'] string Описание прикреплённого файла.
- skus[][''stocks']['] array Массив с информацией об остатках на отдельных складах со следующими ключами:
- skus[]['stocks'][]['id'] int ID склада.
- skus[]['stocks'][]['count'] float|null Количество модификации на складе в формате в формате
decimal(15,3)
илиnull
, если количество бесконечное.
- categories array Массив с информацией о категориях товара со следующими ключами:
- categories[]['id'] int ID категории.
- categories[]['depth'] int Уровень вложенности категории в дереве категорий начиная с 0.
- categories[]['parent_id'] int ID родительской категории или 0, если у категории нет родительской.
- categories[]['name'] string Наименование категории.
- categories[]['meta_title'] string Значение тега <TITLE>.
- categories[]['meta_keywords'] string Значение метатега keywords.
- categories[]['meta_description'] string Значение метатега description.
- categories[]['type'] int Обозначение типа категории: 0 — статическая, 1 — динамическая.
- categories[]['url'] string Редактируемая часть URL категории на витрине магазина.
- categories[]['full_url'] string Относительный URL категории с учётом URL родительских категорий.
- categories[]['count'] int Количество товаров, для которых данная статическая категория является основной. Не используется для динамических категорий.
- categories[]['description'] string Описание категории.
- categories[]['conditions'] string Описание условий для формирования списка товаров в динамической категории. Не используется для статических категорий.
- categories[]['create_datetime'] datetime Дата и время создания категории.
- categories[]['edit_datetime'] datetime Дата и время последнего редактирования категории.
- categories[]['filter'] string Информация о настройках фильтра товаров в категории в виде идентификаторов полей фильтра, разделённых запятой. Идентификаторами полей могут числовые ID характеристик товаров и строка 'price' для обозначения фильтра по цене. Порядок сортировки идентификаторов в этой строке соответствует порядку сортировки полей фильтра.
- categories[]['sort_products'] string Правило сортировки товаров в категории по умолчанию.
- categories[]['include_sub_categories'] int Флаг, обозначающий, должны ли в категории отображаться товары из её подкатегорий: 0 — не должны, 1 — должны.
- categories[]['status'] int Статус видимости категории: 0 — скрытая, 1 — видимая.
- images array Массив с информацией об изображениях товара со следующими ключами:
- images[]['id'] int ID изображения.
- images[]['upload_datetime'] datetime Дата и время загрузки в свойства товара.
- images[]['sort'] int Значение сортировки начиная с 0.
- images[]['width'] int Ширина в пикселях.
- images[]['height'] int Высота в пикселях.
- images[]['size'] int Размер файла в байтах.
- images[]['original_filename'] string Оригинальное имя загруженного файла.
- images[]['ext'] string Расширение имени файла.
- images[]['url_thumb'] string URL эскиза изображения с размером '200x0'.
- features array Массив с информацией о характеристиках товара со следующими ключами:
- features['...'] mixed Значение характеристики.