shop.product.add
Добавляет новый товар.
Параметры
-
name
POST
Наименование.
-
type_id
POST
ID типа товара.
-
summary
POST
Необязательно
Краткое описание.
-
description
POST
Необязательно
Полное описание.
-
meta_title
POST
Необязательно
Элемент TITLE страницы товара.
-
meta_keywords
POST
Необязательно
Содержимое атрибута META keywords.
-
meta_description
POST
Необязательно
Содержимое атрибута META description.
-
og
POST
Необязательно
Ассоциативный массив значений параметров товара для соцсетей. Примеры допустимых ключей массива: 'title', 'description', 'video', 'image_id'.
-
status
POST
Необязательно
Статус публикации: -1 (снят с публикации), 0 (скрытый), 1 (опубликован).
-
image_id
POST
Необязательно
ID основного изображения.
-
sku_id
POST
Необязательно
ID основной модификации.
-
video_url
POST
Необязательно
URL видеоролика.
-
url
POST
Необязательно
Редактируемая часть URL страницы товара на витрине.
-
currency
POST
Необязательно
3-буквенный код валюты товара.
-
tax_id
POST
Необязательно
ID налогового правила, применимого к товару.
-
cross_selling
POST
Необязательно
Режим выборки рекомендуемых товаров (cross-selling): 0 — рекомендуемые товары отключены, 1 — включен автоматический подбор рекомендуемых товаров, 2 — рекомендуемые товары выбраны вручную.
-
upselling
POST
Необязательно
Режим выборки рекомендуемых товаров (upselling): 0 — рекомендуемые товары отключены, 1 — включен автоматический подбор рекомендуемых товаров, 2 — рекомендуемые товары выбраны вручную.
-
badge
POST
Необязательно
ID одной из стандартных наклеек или HTML-код пользовательской наклейки.
-
sku_type
POST
Необязательно
Способ выбора модификаций товара на витрине: 0 — по наименованиям артикулов, 1 — по значениям характеристик. Значение по умолчанию — 0.
-
stock_base_ratio
POST
Необязательно
Отношение складской единицы измерения количества к базовой. Если не указано, используется значение из настроек типа товара.
-
order_count_step
POST
Необязательно
Значение изменения количества кнопками «+/-». Если не указано, используется значение из настроек типа товара.
-
order_count_min
POST
Необязательно
Минимальное количество для заказа. Если не указано, используется значение из настроек типа товара.
-
skus
POST
Необязательно
Массив информации о модификациях товара. Обязателен в том случае, если в параметре 'sku_type' указано значение 0. Ключи массива — ID модификаций, значения — подмассивы со значениями свойств модификаций:
- available (int) Флаг (0 или 1) доступности для заказа.
- status (int) Флаг (0 или 1) видимости на витрине.
- price (float) Цена в формате decimal(15,4).
- purchase_price (float) Закупочная цена в формате decimal(15,4).
- compare_price (float) Зачёркнутая цена в формате decimal(15,4).
- name (string) Наименование.
- stock_base_ratio (float) Соотношение складской и базовой единиц измерения количества в формате decimal(16,8).
- order_count_min (float) Минимальное количество для заказа в формате decimal(15,4).
- order_count_step (float) Значение изменения количества кнопками «+/-» в формате decimal(15,4).
- stock (array) Массив складских остатков модификации. Если в магазине не настроено ни одного склада, то массив должен содержать 1 элемент с количеством модификации в формате decimal(15,3). Если склады настроены, то ключами массива должны быть ID складов, а значениями — количество модификации на данном складе в формате decimal(15,3).
- features (array) Значения характеристик в параметрах модификации. Ключи массива — строковые идентификаторы характеристик, значения массива — значения характеристик. -
features
POST
Необязательно
Массив значений характеристик товара. Пример структуры массива удобно подсмотреть средствами разработчика в браузере при сохранении товара в панели управления магазина.
-
features_selectable
POST
Необязательно
Массив значений характеристик, из всех сочетаний которых должны автоматически сформироваться модификации товара. Ключи массива — строковые идентификаторы характеристик, значения массива — список ID значений этих характеристик. Может использоваться при передаче в параметре 'sku_type' значения '1'.
-
base_price_selectable
POST
Необязательно
Цена, которая должна примениться ко всем модификациям, автоматически сформированным из значения параметра 'features_selectable'.
-
compare_price_selectable
POST
Необязательно
Зачёркнутая цена, которая должна примениться ко всем модификациям, автоматически сформированным из значения параметра 'features_selectable'.
-
purchase_price_selectable
POST
Необязательно
Закупочная цена, которая должна примениться ко всем модификациям, автоматически сформированным из значения параметра 'features_selectable'.
-
categories
POST
Необязательно
Массив ID категорий товара. Первый ID в массиве сохранится как ID основной категории товара.
-
tags
POST
Необязательно
Список тегов, которые нужно привязать к товару, разделённые запятой в виде одной строки либо в виде массива строк.
-
params
POST
Необязательно
Дополнительные параметры товара в виде ассоциативного массива либо в виде строки вида 'name1=value1\nname2=value2\n...', в которой пары 'name=value' должны быть отделены друг от друга символом новой строки. Если в качестве значения передать null, то все дополнительные параметры товара будут удалены.
-
sets
POST
Необязательно
Массив с информацией о списках, в которые должен быть включён товар. Элементами массива могут быть либо ID списков, либо подмассивы с единственным ключом 'id', содержащим ID каждого списка. Если товар ранее содержался в каких-то списках, то он автоматически исключается из тех списков, чьи ID не указаны в этом параметре.
-
format
GET
Необязательно
Устанавливает формат ответа. Возможные значения:
json
(по умолчанию),xml
.
Коды ошибок
-
invalid_request
Неверно сформированный запрос. Дополнительная информация об ошибке передается в параметре
error_description
. -
access_denied
Доступ к указанному методу API не разрешен.
-
invalid_method
Неизвестный метод API.