Імпорт товарів в каталог

Функція 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 - зображення з тими ж або новими посиланнями будуть додані до товару без перезапису раніше імпортованих.

  • products[i].images.removeAll - видалити всі зображення. Якщо в параметрі вказати значення 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, то інші параметри ("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, то інші параметри ("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'][n].code - статус оновлення запису (див. таблицю кодів нижче)

  • response.log[i]['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 успешно загружено"
                    }
                ]
            }
        ]
    }
}