Импорт товаров в каталог

Функция catalog/import (http://<DOMAIN>/api/catalog/import/)

Параметры:

token - ключ авторизации полученный через функцию auth
products[] - список товаров
- products[i].title.ru - значение на русском языке (опционально)
- products[i].title.ua - значение на украинском языке (опционально)
- products[i].title - указание просто значения для всех языков
- products[i].description.ru - значение на русском языке (опционально)
- products[i].description.ua - значение на украинском языке (опционально)
- products[i].description - указание просто значения для всех языков
- products[i].seo_title.ru - значение на русском языке (опционально)
- products[i].seo_title.ua - значение на украинском языке (опционально)
- products[i].seo_title - указание просто значения для всех языков
- products[i].seo_keywords.ru - значение на русском языке (опционально)
- products[i].seo_keywords.ua - значение на украинском языке (опционально)
- products[i].seo_keywords - указание просто значения для всех языков
- products[i].seo_description.ru - значение на русском языке (опционально)
- products[i].seo_description.ua - значение на украинском языке (опционально)
- products[i].seo_description - указание просто значения для всех языков
- products[i].marketplace_description - описание для маркетплейсов
- products[i].parent_article - артикул родительского товара. Необходим для создания/объединения модификаций. В случае если товар является родительским - поле не обязательно (либо указать значением артикула товара). Если обновлять существующий товар, но не указывать это поле, то в качестве значения будет взято текущий родительский артикул из БД Если же товар новый, а значение не указано, то родительский артикул будет взят из поля products[i].article
- products[i].article - артикул товара (обязательный параметр)
- products[i].article_for_display - артикул модели (опционально). Если заполнено, будет отображаться на сайте вместо артикула
- products[i].title - название товара (обязательный параметр в случае добавления нового товара)
- products[i].mod_title - название модификации товара (опционально)
  - products[i].mod_title.ru - значение на русском языке (опционально)
  - products[i].mod_title.ua - значение на украинском языке (опционально)
  - products[i].mod_title - указание просто значения для всех языков
- products[i].display_in_showcase - отображать товар (true|false|1|0)
- products[i].presence - наличие товара. Внимание: статусы наличия можно передавать только при отключенной функциии Учёт остатков на складах. Доступные значения:
  - в наличии
  - нет в наличии
  - ожидается
  - Также любые другие статусы наличия добавленные на Вашем сайте
- products[i].price - стоимость товара
- products[i].price_old - старая стоимость товара
- products[i].discount - относительная скидка на товар
- products[i].short_description — короткое описание
- products[i].color — цвет
- products[i].gtin — штрихкод (GTIN (EAN, UPC, ISBN))
- products[i].mpn — код производителя товара (MPN)
- products[i].popularity — популярность
- products[i].guarantee_shop — тип гарантии
- products[i].guarantee_length — гарантийный срок, мес.
- products[i].countdown_end_time — дата и время окончания акции
- products[i].countdown_description — текст акции
- products[i].currency - валюта товара. Доступные значения (по умолчанию):
  - UAH
  - USD
  - EUR
  - Обратите внимание, что название валюты может отличаться на Вашем сайте, если Вы её переименовали. Перед импортом валюты обязательно проверьте название валюты в админ. панели сайта
- products[i].parent - путь / к / разделу (Развивающие игрушки / Игрушки для малышей) (обязательный параметр при добавлении новых товаров)
- products[i].parent.id - идентификатор раздела каталога (используется вместо products[i].parent, рекомендуется вместо простого пути к разделу). Идентификаторы разделов можно получить в функции Экспорт категорий
- products[i].alt_parent - массив дополнительных разделов. Каждый элемент указывается также как и поле products[i].parent
  - products[i].alt_parent[n] - путь / к / разделу (Развивающие игрушки / Игрушки для малышей)
  - products[i].alt_parent[n].id - идентификатор раздела каталога (используется вместо products[i].alt_parent[n])
  - выше указанные варианты дополнительных разделов можно комбинировать
- products[i].forceAliasUpdate - необходимость в перегенерации ссылки на товар (логическое значение)
- products[i].slug - алиас товара. Работает только для нового товара, или если параметр forceAliasUpdate == true. Алиас будет проставлен в ссылку товара и преобразован согласно правилам формировании ссылок товаров
- products[i].brand - название бренда
- products[i].description - описание товара
- products[i].adult - только для взрослых (Google Merchant Center)
- products[i].uktzed - код УКТ ЗЕД
- products[i].condition - состояние товара (например, “Новый”, “б/у”, “Восстановленный”)
- products[i].condition.id - идентификатор состояния товара (используется вместо products[i].condition)
- products[i].icons - Иконки (["Распродажа", "Новинка", "Хит"]). Также другие параметры с типом "мультивыбор" либо "выбор из списка" с пометкой "мульти" можно передавать в таком же формате
- products[i].seo_title - СЕО заголовок для товара
- products[i].seo_keywords - СЕО ключевые слова для товара
- products[i].seo_description - СЕО описание для товара
- products[i].h1_title.ru - h1 заголовок для товара (русскоязычная версия)
- products[i].h1_title.ua - h1 заголовок для товара (украиноязычная версия)
- products[i].export_to_marketplace - включение выгрузки на маркеплейсы. Названия маркетплейсов указывать через точку с запятой: "marketplace 1;marketplace2;..."
- products[i].characteristics[] - характеристики товара (опционально)
  - products[i].characteristics.material - Материал
  - products[i].characteristics.weight - Вес
  - products[i].characteristics.consist - Состав
  - products[i].characteristics.country - Страна
  - products[i].characteristics.gender - Пол
  - products[i].characteristics.age - Возраст
  - products[i].characteristics.physics - Физическое развитие (значения указывать через ;)
  - products[i].characteristics.brain - Умственное развитие (значения указывать через ;)
  - products[i].characteristics.social - Социальное развитие (значения указывать через ;)

<aside> ℹ️ Новые параметры начиная с версии 3.15.15

</aside>

products[i].accessories - аксессуары для товара (массив). Перезаписывают существующие аксессуары
products[i].gifts - подарки для товара (массив). Сработает только если на сайте включены подарки. Перезаписывают существующие подарки
products[i].residues - остатки товара на складах. Работает только если на сайте включён учёт остатков на складах
products[i].images - изображения модификации товара
products[i].gallery_common - общая галерея для всех модификаций
products[i].gallery_360 - Обзор 360

<aside> ✅ Новые параметры начиная с версии 4.0

</aside>

Для проектов с оптовым функционалом (пример запроса)

products[i].price_levels - цены разного типа

Для всех проектов

products[i].multiplicity — кратность (шаг добавления в корзину). Целое число.
products[i].minimal_order — минимальный заказ. Целое число, должно быть кратно полю “Кратность”.
products[i].installments_payment — количество платежей для "Оплата частями ПриватБанка". Допустимые значения:
products[i].monobank_installments_payment — количество платежей для "Покупка частями от monobank". Допустимые значения:
products[i].unit_of_measurement — единицы измерения.
products[i].wholesale_prices[] — оптовые цены за количество единиц в заказе.