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.