...
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].articleproducts[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, рекомендуется вместо простого пути к разделу). Идентификаторы разделов можно получить в функции pages/export
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].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 - Социальное развитие (значения указывать через ;)
...
Коды журнала импорта товара
Код | Описание |
---|---|
Общие | |
0 | Товар добавлен/обновлён |
1 | Товар с артикулом не существует (устаревший код, более не используется) |
2 | Не найден товар соответствующий родитесльскому артикулу "parent_article" |
3 | Товар теперь является отдельной основной модификацией |
4 | Товар был перенесен в качестве модификации к другому товару |
5 | Ошибка изменения раздела |
Только для новых товаров | |
6 | Параметр Название "title" обязателен для заполнения (только для новых товаров) |
7 | Одно из обязательных полей не задано |
8 | Устаревший код. Более не используется |
9 | Товар был перенесён в другую категорию |
10 | Ошибка переноса товара в другую категорию |
11 | Переданный параметр не найден в шаблоне "Каталог" |
12 | Нет возможности сметить категорию модификации товара, т. к. у родительского товара указана другая категория. |
Ссылка на товар | |
13 | Запись с указанной ссылкой уже существует |
14 | Ошибка при создании/сохранении ссылки |
Остатки товара на складе | |
15 | Остатки товара на складе обновлены |
16 | Невозможно обновить остатки товара на складе т. к. они отключены на сайте |
17 | Ошибка целостности данных об остатках товара на складе |
18 | Склад для остатков товара не был найден |
19 | Ошибка при обновлении остатков товара на складе |
Аксессуары и подарки | |
20 | При добавлении аксессуара/подарка отсутствует аксессуар/подарок с указанным артикулом |
21 | При добавлении раздела аксессуара/подарка отсутствует раздел с указанными данными |
Галерея (для модификации, общая и Обзор 360) | |
22 | Изображение галереи было загружено |
23 | Ссылка на изображение некорректна |
24 | Ошибка при записи изображения в файл |
25 | Неизвестная ошибка при загрузке изображения |
26 | Ошибка при загрузке изображения |
27 | MIME тип загруженного изображения не соответствует допустимым: image/jpeg, image/gif, image/png |
28 | Галерея была очищена. Такой код отображается если в галереи передать параметр "removeAll":true , либо если загружать новые изображения и не указывать параметр "override" или же указать явно "override": true, что в свою очередь также очищает галерею от изображений |
Пример запроса на адрес (http://<DOMAIN>/api/catalog/import/):
...