Page Comparison

Функция Функція 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, рекомендуется вместо простого пути к разделу). Идентификаторы разделов можно получить в функции рекомендується замість простого шляху до розділу). Ідентифікатори розділів можна отримати у функції 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 - Социальное развитие (значения указывать Соціальний розвиток (значення вказувати через ;)

• 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")

    будут проигнорированы и

    будуть проігноровані і галерея просто

    будет

    буде очищена

...

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

• 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 - пояснение к пояснення до коду

Коды Коди журнала импорта товараімпорта товарів

...

Приклад запиту на адресу (http://<DOMAIN>/api/catalog/import/):

{
  "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"
        }
      }
    }
  ]
}

Пример ответа на запрос:Приклад відповіді на запит

{
    "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 успешно загружено"
                    }
                ]
            }
        ]
    }
}