Функция Функція 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].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 - СЕО SEO заголовок для товаратовару
products[i].seo_keywords - СЕО ключевые SEO ключові слова для товаратовару
products[i].seo_description - СЕО описание SEO опис для товаратовару
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 - Социальное развитие (значения указывать Соціальний розвиток (значення вказувати через ;)
Info |
---|
Новые параметры начиная с версии Нові параметри з версії 3.15.15 |
products[i].accessories -
аксессуарыаксесуари для
товаратовару (
массивмасив).
Перезаписывают существующие аксессуарыПерезаписують наявні аксесуари
products[i].accessories[n] - артикул
товара простой строкойтовару простим рядком
products[i].accessories[n].article -
явное указание артикула товараявна вказівка артикулу товару
products[i].accessories[n].page -
путьшлях /
кдо /
разделурозділу (
Развивающие игрушкиРозвиваючі іграшки /
ИгрушкиІграшки для
малышеймалюків)
products[i].accessories[n].page.id -
идентификатор разделаідентифікатор розділу
products[i].gifts -
подаркиподарунки для
товаратовару (
массивмасив).
Сработает только если на сайте включены подарки. Перезаписывают существующие подаркиСпрацює тільки якщо на сайті ввімкнено подарунки. Перезаписують наявні подарунки
products[i].gifts[n] - артикул
товара простой строкойтовару простим рядком
products[i].gifts[n].article -
явное указание артикула товараявна вказівка артикулу товару
products[i].gifts[n].page -
путьшлях /
кдо /
разделурозділу (
Развивающие игрушкиРозвиваючі іграшки /
ИгрушкиІграшки для
малышеймалюків)
products[i].gifts[n].page.id -
идентификатор разделаідентифікатор розділу
products[i].residues -
остатки товаразалишки товару на складах.
Работает только если на сайте включён учёт остатковПрацює тільки якщо на сайті ввімкнено облік залишків на складах
products[i].residues[n].warehouse -
НазваниеНазва для
синхронизации склада (значение свойства "Название для синхронизации" в складесинхронізації складу (значення властивості "Назва для синхронізації" у складі)
products[i].residues[n].quantity -
количество товаракількість товару на
складескладі
products[i].images -
изображения модификации товаразображення модифікації товару
products[i].images.links -
ссылки на изображения товара которые необходимо загрузить (массивпосилання на зображення товару, які необхідно завантажити (масив). Фото
импортируютсяімпортуються в
том порядкетому порядку, в
котором они находятся в массивеякому вони знаходяться в масиві.
products[i].images.links[n] -
ссылкапосилання на
изображениезображення (
размер изображения не должен превышатьрозмір зображення не повинен перевищувати 5мб)
products[i].images.override -
необходимость удалить текущие изображения перед загрузкой новыхнеобхідність видалити поточні зображення перед завантаженням нових (boolean).
По умолчанию —За замовчуванням - true.
Если передатьfalse
— изображения с теми же или новыми ссылками будут добавлены к товару без перезаписи ранее импортированныхЯкщо передати false - зображення з тими ж або новими посиланнями будуть додані до товару без перезапису раніше імпортованих.
products[i].images.removeAll -
удалить все изображения. ВНИМАНИЕ! Если в параметре указать значение true то остальные параметрывидалити всі зображення. Якщо в параметрі вказати значення true, то інші параметри ("links", "override")
будут проигнорированы ибудуть проігноровані, і галерея просто
будетбуде очищена
products[i].gallery_common -
общаязагальна галерея для
всех модификацийвсіх модифікацій
products[i].gallery_common.links -
ссылки на изображения товара которые необходимо загрузить (массивпосилання на зображення товару, які необхідно завантажити (масив). Фото
импортируютсяімпортуються в
том порядкетому порядку, в
котором они находятся в массивеякому вони знаходяться в масиві.
products[i].gallery_common.links[n] -
ссылкапосилання на
изображениезображення (
размер изображения не должен превышатьрозмір зображення не повинен перевищувати 5мб)
products[i].gallery_common.override -
необходимость удалить текущие изображения перед загрузкой новыхнеобхідність видалити поточні зображення перед завантаженням нових (boolean).
По умолчаниюЗа замовчуванням - true
products[i].gallery_common.removeAll -
удалить все изображения. ВНИМАНИЕ! Если в параметре указать значение true то остальные параметрывидалити всі зображення. Якщо в параметрі вказати значення true, то інші параметри ("links", "override")
будут проигнорированы ибудуть проігноровані, і галерея просто
будетбуде очищена
products[i].gallery_360 -
ОбзорОгляд 360
products[i].gallery_360.links -
ссылки на изображения товара которые необходимо загрузить (массивпосилання на зображення товару, які необхідно завантажити (масив)
products[i].gallery_360.links[n] -
ссылкапосилання на
изображениезображення (
размер изображения не должен превышатьрозмір зображення не повинен перевищувати 5мб)
products[i].gallery_360.override -
необходимость удалить текущие изображения перед загрузкой новыхнеобхідність видалити поточні зображення перед завантаженням нових (boolean).
По умолчаниюЗа замовчуванням - true
products[i].gallery_360.removeAll -
удалить все изображения. ВНИМАНИЕ! Если в параметре указать значение true то остальные параметрывидалити всі зображення. УВАГА! Якщо в параметрі вказати значення true, то інші параметри ("links", "override")
будут проигнорированы ибудуть проігноровані і галерея просто
будетбуде очищена
Tip |
---|
...
Нові параметри з версії 4.0 |
Для проектов с оптовым функционалом (пример запросапроєктів з оптовим функціоналом (приклад запиту)
products[i].price_levels - цены разного типаціни різного типу
products[i].price_levels.level_id - число, идентификатор типа ценыідентифікатор типу ціни
products[i].price_levels.price - число, значение цены данного типазначення ціни даного типу
Для всех проектоввсіх проєктів
products[i].multiplicity — кратность (шаг добавления в корзину- кратність (крок додавання в кошик). Целое Ціле число.
products[i].minimal_order — минимальный заказ. Целое число, должно быть кратно полю “Кратность”- мінімальне замовлення. Ціле число, має бути кратним полю "Кратність".
products[i].installments_payment — количество платежей - кількість платежів для "Оплата частями ПриватБанкачастинами ПриватБанку".
Допустимые значенияДопустимі значення:"ВыклВикл" - оплата частями частинами не доступна для товаратовару
"По умолчанию" - значение берется их настроек платежной системыЗа замовчуванням" - значення береться з налаштувань платіжної системи
2-25 - допустимое количество платежейдопустима кількість платежів
products[i].monobank_installments_payment — количество платежей - кількість платежів для "Покупка частями от Купівля частинами від monobank".
Допустимые значенияДопустимі значення:"ВыклВимкнути" - оплата частями частинами не доступна для товаратовару
"По умолчанию" - значение берется их настроек платежной системыЗа замовчуванням" - значення береться з налаштувань платіжної системи
3-25 - допустимое количество платежейдопустима кількість платежів
products[i].unit_of_measurement — единицы измерения- одиниці виміру.
products[i].wholesale_prices[] — оптовые цены за количество единиц в заказе- оптові ціни за кількість одиниць у замовленні.
products[i].wholesale_prices.minimal_threshold — количество единиц- кількість одиниць
products[i].wholesale_prices.price — цена, действующая при добавлении этого кол-ва единиц в заказ- ціна, що діє під час додавання цієї кількості одиниць у замовлення
products[i].supplier_id[] — поставщик- постачальник
products[i].supplier_id.id — уникальный идентификатор поставщика- унікальний ідентифікатор постачальника
products[i].supplier_id.value — название поставщика
...
- назва постачальника
Відповідь:
status - статус выполнения функциивиконання функції
OK - все усі записи обновились успешнооновилися успішно
WARNING - при обновлении некоторых записей произошли ошибкипід час оновлення деяких записів сталися помилки
ERROR - произошла критическая ошибкасталася критична помилка
response.log - журнал выполнения функции по каждой записивиконання функції за кожним записом
response.log[i].article - артикул товаратовару
response.log[i][‘info’'info'][n].code - статус обновления записи оновлення запису (см. таблицу кодов нижедив. таблицю кодів нижче)
response.log[i][‘info’'info'][n].message - пояснение к пояснення до коду
Коды Коди журнала импорта товараімпорта товарів
Код | ОписаниеОпис |
---|---|
Общие | |
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/):
Code Block | ||
---|---|---|
| ||
{ "products": [ { "parent_article": "AAAA_TEST", "article": "AAAA_TEST", "title": { "ru": "Тестирование импорта", "ua": "Тестування імпорту" }, "description": { "ru": "Тестирование импорта", "ua": "Тестування імпорту" }, "short_description": { "ru": "Короткое описание", "ua": "Короткий опис" }, "color": "Белый", "gtin": "4581649781942", "mpn": "GO12345OOGLE", "popularity": 25, "guarantee_shop": "Магазин", "guarantee_length": 12, "countdown_end_time": "2021-12-31 23:59:59", "countdown_description": { "ru": "<p>Описание акции</p>", "ua": "<p>Опис акції</p>", "en": "<p>Description for promotion</p>" }, "parent": "iPhone / iPhone 6", "alt_parent": [ "Другие товары / Аксессуары", { "id": 98 }, "Apple / Test" ], "forceAliasUpdate": true, "slug": "aaaa-test", "display_in_showcase": true, "presence": "В наличии", "price": 100, "price_old": 150, "wholesale_prices": [ { "minimal_threshold": "4", "price": 8000 } ], "icons": [ "Распродажа", "Новинка", "Хит" ], "export_to_marketplace": "Facebook Feed;Rozetka Feed", "images": { "override": false, "links": [ "https://cdn.pixabay.com/photo/2013/07/12/12/58/tv-test-pattern-146649_960_720.png", "https://lh4.ggpht.com/wKrDLLmmxjfRG2-E-k5L5BUuHWpCOe4lWRF7oVs1Gzdn5e5yvr8fj-ORTlBF43U47yI=w300", "http://wp.patheos.com.s3.amazonaws.com/blogs/faithwalkers/files/2013/03/bigstock-Test-word-on-white-keyboard-27134336.jpg", "https://i.vimeocdn.com/portrait/58832_300x300", "http://www.testinteligencia.net/image/repository/test1.jpg", "https://i.ytimg.com/vi/yaqe1qesQ8c/maxresdefault.jpg", "http://build.horoshop.com.ua/api/catalog/export", "sdgagadsgsadgsadgsadgsagsadg" ] } }, { "parent_article": "AAAA_TEST", "article": "BBBB_TEST", "title": { "ru": "Тестирование импорта", "ua": "Тестування імпорту" }, "description": { "ru": "Тестирование импорта", "ua": "Тестування імпорту" }, "marketplace_description": { "ru": "Описание ru", "ua": "Описание ua", "en": "Описание en" }, "parent": { "id": 1036 }, "display_in_showcase": true, "price": 95, "discount": 3, "accessories": [ "2317217", "4517217", { "page": "Телефоны / Аксессуары" }, { "page": { "id": 1032 } }, { "article": "MD827" } ], "residues": [ { "warehouse": "office", "quantity": 15 } ], "gallery_common": { "override": false, "links": [ "https://cdn.pixabay.com/photo/2013/07/12/12/58/tv-test-pattern-146649_960_720.png", "https://lh4.ggpht.com/wKrDLLmmxjfRG2-E-k5L5BUuHWpCOe4lWRF7oVs1Gzdn5e5yvr8fj-ORTlBF43U47yI=w300" ] }, "characteristics": { "gender": "Мальчик ; девочка", "material": "Полиэстер", "country": { "ru": "Великобритания", "ua": "Великобританія" } "supplier_id": { "id": 4, "value": "Top" } } } ] } |
Пример ответа на запрос:Приклад відповіді на запит
Code Block | ||
---|---|---|
| ||
{ "status": "WARNING", "response": { "log": [ { "article": "AAAA_TEST", "info": [ { "code": 23, "message": "Некорректная ссылка на изображение \"sdgagadsgsadgsadgsadgsagsadg\"" }, { "code": 0, "message": "Товар обновлен" }, { "code": 13, "message": "Запись с ссылкой \/aaaa-test\/ уже существует" }, { "code": 22, "message": "Изображение https:\/\/cdn.pixabay.com\/photo\/2013\/07\/12\/12\/58\/tv-test-pattern-146649_960_720.png успешно загружено" }, { "code": 22, "message": "Изображение https:\/\/lh4.ggpht.com\/wKrDLLmmxjfRG2-E-k5L5BUuHWpCOe4lWRF7oVs1Gzdn5e5yvr8fj-ORTlBF43U47yI=w300 успешно загружено" }, { "code": 22, "message": "Изображение http:\/\/wp.patheos.com.s3.amazonaws.com\/blogs\/faithwalkers\/files\/2013\/03\/bigstock-Test-word-on-white-keyboard-27134336.jpg успешно загружено" }, { "code": 22, "message": "Изображение https:\/\/i.vimeocdn.com\/portrait\/58832_300x300 успешно загружено" }, { "code": 22, "message": "Изображение http:\/\/www.testinteligencia.net\/image\/repository\/test1.jpg успешно загружено" }, { "code": 22, "message": "Изображение https:\/\/i.ytimg.com\/vi\/yaqe1qesQ8c\/maxresdefault.jpg успешно загружено" }, { "code": 25, "message": "Произошла неизвестная ошибка при загрузке изображения. Cannot read from non-readable stream" } ] }, { "article": "BBBB_TEST", "info": [ { "code": 15, "message": "Остатки товара обновлены" }, { "code": 0, "message": "Товар добавлен" }, { "code": 22, "message": "Изображение https:\/\/cdn.pixabay.com\/photo\/2013\/07\/12\/12\/58\/tv-test-pattern-146649_960_720.png успешно загружено" }, { "code": 22, "message": "Изображение https:\/\/lh4.ggpht.com\/wKrDLLmmxjfRG2-E-k5L5BUuHWpCOe4lWRF7oVs1Gzdn5e5yvr8fj-ORTlBF43U47yI=w300 успешно загружено" } ] } ] } } |