Page Comparison

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

ПараметрыParametersParameters:

• token - ключ авторизации полученный через функцию authauthorization key obtained via the auth function

• products[] - список товаровproduct list

  • products[i].title.ru - значение на русском языке (опциональноen - value in English (optional)

  • products[i].title.ua - значение на украинском языке (опциональноro - value in Romanian (optional)

  • products[i].title - указание просто значения для всех языковcommon value for all languages

  • products[i].description.ru - значение на русском языке (опциональноen - value in English (optional)

  • products[i].description.ua - значение на украинском языке (опциональноro - value in Romanian (optional)

  • products[i].description - указание просто значения для всех языковcommon value for all languages

  • products[i].seo_title.ru - значение на русском языке (опциональноen - value in English (optional)

  • products[i].seo_title.ua - значение на украинском языке (опциональноro - value in Romanian (optional)

  • products[i].seo_title - указание просто значения для всех языковcommon value for all languages

  • products[i].seo_keywords.ru - значение на русском языке (опциональноen - value in English (optional)

  • products[i].seo_keywords.ua - значение на украинском языке (опциональноro - value in Romanian (optional)

  • products[i].seo_keywords - указание просто значения для всех языковcommon value for all languages

  • products[i].seo_description.ru - значение на русском языке (опциональноen - value in English (optional)

  • products[i].seo_description.ua - значение на украинском языке (опциональноro - value in Romanian (optional)

  • products[i].seo_description - указание просто значения для всех языковcommon value for all languages

  • products[i].marketplace_description - описание для маркетплейсовdescription for marketplaces

  • products[i].parent_article - артикул родительского товара. Необходим для создания/объединения модификаций. В случае если товар является родительским - поле не обязательно (либо указать значением артикула товара).
    Если обновлять существующий товар, но не указывать это поле, то в качестве значения будет взято текущий родительский артикул из БД
    Если же товар новый, а значение не указано, то родительский артикул будет взят из поля article of the parent product. Necessary for creating/merging variants. If the product is a parent, thid field is not necessary (or specify the value of the product article).
    If you update an existing item but do not specify this field, the current parent article from the database will be taken as the value
    If the product is new and no value is specified, the parent article will be taken from the products[i].article field
    

  • products[i].article - артикул товара (обязательный параметрproduct article (mandatory parameter)
    

  • products[i].article_for_display - артикул модели model article (опциональноoptional). Если заполнено, будет отображаться на сайте вместо артикулаIf filled in, it will be displayed on the site instead of the product article

  • products[i].title - название товара (обязательный параметр в случае добавления нового товараproduct name (mandatory parameter in case of adding a new product)

  • products[i].mod_title - название модификации товара (опциональноproduct variant name (optional)

    • products[i].mod_title.ru - значение на русском языке (опциональноen - value in English (optional)

    • products[i].mod_title.ua - значение на украинском языке (опциональноro - value in Romanian (optional)

    • products[i].mod_title - указание просто значения для всех языковcommon value for all languages

  • products[i].display_in_showcase - отображать товар display product (true|false|1|0)

  • Также любые другие статусы наличия добавленные на Вашем сайте

    products[i].presence - наличие товараproduct availability. Внимание: статусы наличия можно передавать только при отключенной функциии Учёт остатков на складах.
    Доступные значения:

  • в наличии

  • нет в наличии

  • ожидается

  Attention: availability statuses can be transferred only if the Stock Accounting function is disabled.
  Available values:

  • in stock

  • out of stock

  • coming soon

  • Also any other availability statuses added to your site

  • products[i].price - стоимость товараproduct price

  • products[i].price_old - старая стоимость товараproduct old price

  • products[i].discount - относительная скидка на товарrelative discount on the product

  • products[i].short_description — короткое описаниеshort description

  • products[i].color — цветcolor

  • products[i].gtin — штрихкод barcode (GTIN (EAN, UPC, ISBN))

  • products[i].mpn — код производителя товара manufacturer part number (MPN)

  • products[i].popularity — популярностьpopularity

  • products[i].guarantee_shop — тип гарантииwarranty type

  • products[i].guarantee_length — гарантийный срокwarranty period, месmonths.

  • products[i].countdown_end_time — дата и время окончания акцииpromotion end date and time

  • products[i].countdown_description — текст акцииpromotion text

  • products[i].currency - валюта товара. Доступные значения (по умолчаниюcurrency of the product. Available values (by default):

    • UAH

    • USD

    • EUR

    • Обратите внимание, что название валюты может отличаться на Вашем сайте, если Вы её переименовали. Перед импортом валюты
      обязательно проверьте название валюты в админ. панели сайта

    • PLN

    • RON

    • MDL

    • Note that the currency name may be different on your site, if you have renamed it. Before importing the currency you must check the currency name in the site admin panel

  • products[i].parent - путь path / к to / разделу section (Развивающие игрушки / Игрушки для малышей) (обязательный параметр при доблении новых товаровEducational toys / Toys for babies) (mandatory parameter when adding new products)

  • products[i].parent.id - идентификатор раздела каталога (используется вместо catalog section identifier (used instead of products[i].parent, рекомендуется вместо простого пути к разделу). Идентификаторы разделов можно получить в функции recommended instead of just the section path). Section identifiers can be obtained with the pages/export function
    

  • products[i].alt_parent - массив дополнительных разделов. Каждый элемент указывается также как и поле array of additional sections. Each element is specified in the same way as the products[i].parent field

    • products[i].alt_parent[n] - путь path / к to / разделу section (Развивающие игрушки / Игрушки для малышейEducational toys / Toys for babies)

    • products[i].alt_parent[n].id - идентификатор раздела каталога (используется вместо catalog section identifier (used instead of products[i].alt_parent[n])

    • выше указанные варианты дополнительных разделов можно комбинироватьthe above options for additional sections can be combined

  • products[i].forceAliasUpdate - необходимость в перегенерации ссылки на товар (логическое значениеneed to regenerate the product reference (boolean value, true/false)

  • products[i].slug - алиас товара. Работает только для нового товара, или если параметр product alias. Works only for new item, or if the parameter forceAliasUpdate == true. Алиас будет проставлен в ссылку товара и преобразован согласно правилам формировании ссылок товаровThe alias will be inserted into the product link and converted according to the rules of forming product links
    

  • products[i].brand - название брендаbrand name

  • products[i].description - описание товараproduct description

  • products[i].adult - только для взрослых for adults only (Google Merchant Center)

  • products[i].condition - состояние товара (например, “Новый”, “б/у”, “Восстановленный”product condition (e.g. "New", "Used", "Refurbished")

  • products[i].condition.id - идентификатор состояния товара (используется вместо product condition ID (used instead of products[i].condition)

  • products[i].icons - Иконки Icons (["РаспродажаSale", "НовинкаNew", "ХитBestseller"]). Также другие параметры с типом "мультивыбор" либо "выбор из списка" с пометкой "мульти" можно передавать в таком же форматеAlso other parameters with the "Multiselect" type or "Selection from list" with the mark "multi" can be passed in the same format
    

  • products[i].seo_title - СЕО заголовок для товараSEO title for product

  • products[i].seo_keywords - СЕО ключевые слова для товараSEO keywords for product

  • products[i].seo_description - СЕО описание для товараSEO description for product

  • products[i].h1_title.ru en - h1 заголовок для товара (русскоязычная версияheader for the product (English version)

  • products[i].h1_title.ua ro - h1 заголовок для товара (украиноязычная версияheader for the product (Romanian version)

  • products[i].export_to_marketplace - включение выгрузки на маркеплейсы. Названия маркетплейсов указывать через точку с запятойenable uploading to marketplaces. Specify names of marketplaces with semicolon: "marketplace 1;marketplace2;...".

  • products[i].characteristics[] - характеристики товара product attributes (опциональноoptional)

    • products[i].characteristics.material - МатериалMaterial

    • products[i].characteristics.weight - ВесWeight

    • products[i].characteristics.consist - СоставComposition

    • products[i].characteristics.country - СтранаCountry

    • products[i].characteristics.gender - ПолGender

    • products[i].characteristics.age - ВозрастAge

    • products[i].characteristics.physics - Физическое развитие (значения указывать через Physical development (enter values with ;)

    • products[i].characteristics.brain - Умственное развитие (значения указывать через Mental development (specify values with ;)

    • products[i].characteristics.social - Социальное развитие (значения указывать через Social development (enter values with ;)
      

• • products[i].accessories - аксессуары для товара (массив). Перезаписывают существующие аксессуарыproduct accessories (array). Overwrites existing accessories
    

    • products[i].accessories[n] - артикул товара простой строкойproduct article (string)

    • products[i].accessories[n].article - явное указание артикула товараdirect indication of the product article

    • products[i].accessories[n].page - путь path / к to / разделу section (Развивающие игрушки / Игрушки для малышейEducational toys / Toys for babies)

    • products[i].accessories[n].page.id - идентификатор разделаsection ID

  • products[i].gifts - подарки для товара (массив). Сработает только если на сайте включены подарки. Перезаписывают существующие подаркиgifts for the product (array). Will only work if the site has gifts enabled. Overwrites existing gifts
    

    • products[i].gifts[n] - артикул товара простой строкойproduct article (string)

    • products[i].gifts[n].article - явное указание артикула товара

    • products[i].gifts[n].page - путь path / к to / разделу section (Развивающие игрушки / Игрушки для малышейEducational toys / Toys for babies)

    • products[i].gifts[n].page.id - идентификатор разделаsection ID

  • products[i].residues - остатки товара на складах. Работает только если на сайте включён учёт остатков на складахproduct stock in warehouses. Works only if the site has stock accounting enabled

    • products[i].residues[n].warehouse - Название для синхронизации склада (значение свойства "Название для синхронизации" в складеName for warehouse synchronization (value of the property "Name for synchronization" in the warehouse)

    • products[i].residues[n].quantity - количество товара на складеproduct stock in the warehouse

  • products[i].images - изображения модификации товараproduct variant images

    • products[i].images.links - ссылки на изображения товара которые необходимо загрузить (массив). Фото импортируются в том порядке, в котором они находятся в массивеlinks to the product images to be loaded (array). Photos are imported in the order in which they are in the array.

      • products[i].images.links[n] - ссылка на изображение (размер изображения не должен превышать 5мбlink to the image (image size should not exceed 5MB)

    • products[i].images.override - необходимость удалить текущие изображения перед загрузкой новых need to delete current images before loading new ones (boolean). По умолчанию — Default is true. Если передать false — изображения с теми же или новыми ссылками будут добавлены к товару без перезаписи ранее импортированных.products[i].images.removeAll - удалить все изображения. ВНИМАНИЕ! Если в параметре указать значение true то остальные параметры If false is passed, images with the same or new links will be added to the product without overwriting the previously imported ones.

    • products[i].images.removeAll - remove all images. WARNING! If you specify true in the parameter, the other parameters ("links", "override") будут проигнорированы и галерея просто будет очищенаwill be ignored and the gallery will simply be cleaned up.
      

  • products[i].gallery_common - общая галерея для всех модификацийcommon gallery for all variants

    • products[i].gallery_common.links - ссылки на изображения товара которые необходимо загрузить (массив). Фото импортируются в том порядке, в котором они находятся в массивеlinks to the product images to be loaded (array). Photos are imported in the order in which they are in the array.

      • products[i].gallery_common.links[n] - ссылка на изображение (размер изображения не должен превышать 5мбlink to the image (image size should not exceed 5MB)

    • products[i].gallery_common.override - необходимость удалить текущие изображения перед загрузкой новых need to delete current images before loading new ones (boolean). По умолчанию - Default is true.

    • products[i].gallery_common.removeAll - удалить все изображения. ВНИМАНИЕ! Если в параметре указать значение true то остальные параметры remove all images. WARNING! If you specify true in the parameter, the other parameters ("links", "override") будут проигнорированы и галерея просто будет очищенаwill be ignored and the gallery will simply be cleaned up.
      

  • products[i].gallery_360 - Обзор 360-degree view
    

    • products[i].gallery_360.links - ссылки на изображения товара которые необходимо загрузить (массив)links to the product images to be loaded (array). Photos are imported in the order in which they are in the array.

      • products[i].gallery_360.links[n] - ссылка на изображение (размер изображения не должен превышать 5мбlink to the image (image size should not exceed 5MB)

    • products[i].gallery_360.override - необходимость удалить текущие изображения перед загрузкой новых need to delete current images before loading new ones (boolean). По умолчанию - Default is true.

    • products[i].gallery_360.removeAll - удалить все изображения. ВНИМАНИЕ! Если в параметре указать значение true то остальные параметры remove all images. WARNING! If you specify true in the parameter, the other parameters ("links", "override") будут проигнорированы и галерея просто будет очищена

...

• • • will be ignored and the gallery will simply be cleaned up.

Для проектов с оптовым функционалом (пример запросаFor projects with wholesale functionality (example query)

• products[i].price_levels - цены разного типаprices of different types

  • products[i].price_levels.level_id - число, идентификатор типа ценыnumber, price type identifier

  • products[i].price_levels.price - число, значение цены данного типа

...

• • number, price value of this type

For all projects

• products[i].multiplicity — кратность  (шаг добавления в корзину). Целое числоmultiplicity  (step of adding to cart). Integer number.

• products[i].minimal_order — минимальный заказ. Целое число, должно быть кратно полю “Кратность”minimum order. Integer, must be a multiple of the "Multiplicity" field.

• products[i].installments_payment — количество платежей для "Оплата частями ПриватБанкаnumber of payments for "Payment by installments by PrivatBank".
  Допустимые значенияAvailable values:

  • "Выкл" - оплата частями не доступна для товара"По умолчанию" - значение берется их настроек платежной системыOff" - payment by installments is not available for the product

  • "Default" - the value is taken from the payment system settings

  • 2-25 - допустимое количество платежейallowable number of payments

• products[i].monobank_installments_payment — количество платежей для "Покупка частями от number of payments for "Purchase by installments from monobank".
  Допустимые значенияAvailable values:

  • "Выкл" - оплата частями не доступна для товара"По умолчанию" - значение берется их настроек платежной системыOff" - payment by installments is not available for the product

  • "Default" - the value is taken from the payment system settings

  • 3-25 - допустимое количество платежейallowable number of payments

• products[i].unit_of_measurement — единицы измеренияmeasurement units.

• products[i].wholesale_prices[] — оптовые цены за количество единиц в заказеwholesale prices for the number of units in an order.

  • products[i].wholesale_prices.minimal_threshold — количество единицnumber of units

  • products[i].wholesale_prices.price — цена, действующая при добавлении этого кол-ва единиц в заказthe price valid when adding this number of units to an order

• products[i].supplier_id[] — поставщикsupplier

  • products[i].supplier_id.id — уникальный идентификатор поставщикаunique supplier ID

  • products[i].supplier_id.value — название поставщикаsupplier name

ОтветResponseResponse:

• status - статус выполнения функцииfunction execution status

• • OK - все записи обновились успешноall records updated successfully

  • WARNING - при обновлении некоторых записей произошли ошибкиerrors occurred when updating some records

  • ERROR - произошла критическая ошибкаcritical error has occurred

• response.log - журнал выполнения функции по каждой записиfunction execution log for each record

• • response.log[i].article - артикул товараproduct article

  • response.log[i][‘info’][n].code - статус обновления записи (см. таблицу кодов нижеrecord update status (see the code table below)

  • response.log[i][‘info’][n].message - пояснение к коду

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

...

Код

...

Описание

...

Общие

...

0

...

Товар добавлен/обновлён

...

1

...

Товар с артикулом не существует (устаревший код, более не используется)

...

2

...

• • code explanation

Product import log codes

...

Example of a query for the address (http://<DOMAIN>/api/catalog/import/):

{
  "products": [
    {
      "parent_article": "AAAA_TEST",
      "article": "AAAA_TEST",
      "title": {
        "ruen": "ТестированиеImport импортаtest",
        "uaro": "ТестуванняTest de імпортуimport"
      },
      "description": {
        "ruen": "ТестированиеImport импортаtest",
        "uaro": "ТестуванняTest de імпортуimport"
      },
      "short_description": {
        "ruen": "КороткоеShort описаниеdescription",
        "uaro": "КороткийScurtă описdescriere"
      },
      "color": "БелыйWhite",
      "gtin": "4581649781942",
      "mpn": "GO12345OOGLE",
      "popularity": 25,
      "guarantee_shop": "МагазинShop",
      "guarantee_length": 12,
      "countdown_end_time": "2021-12-31 23:59:59",
      "countdown_description": {
        "ru": "<p>Описание акции</p>",
        "uaen": "<p>Опис<p>Description for акції<promotion</p>",
        "enro": "<p>Description<p>Descriere forpentru promotion<promovare</p>",
      },
      "parent": "iPhone / iPhone 6",
      "alt_parent": [
        "ДругиеOther товарыproducts / АксессуарыAccessories",
        {
          "id": 98
        },
        "Apple / Test"
      ],
      "forceAliasUpdate": true,
      "slug": "aaaa-test",
      "display_in_showcase": true,
      "presence": "ВIn наличииstock",
      "price": 100,
      "price_old": 150,
      "wholesale_prices": [
        {
          "minimal_threshold": "4",
          "price": 8000
        }
      ],
      "icons": [
        "РаспродажаSale",
        "НовинкаNew",
        "ХитBestseller"
      ],
      "export_to_marketplace": "Facebook Feed;RozetkaGoogle Feed for Merchant Center",
      "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": {
        "ruen": "ТестированиеImport импортаtest",
        "uaro": "ТестуванняTest de імпортуimport"
      },
      "description": {
        "ruen": "ТестированиеImport импортаtest",
        "uaro": "ТестуванняTest de імпортуimport"
      },
      "marketplace_description": {
        "ruen": "ОписаниеDescription ruen",
        "uaro": "ОписаниеDescriere uaro",
        "en": "Описание en"   
      },
      "parent": {
        "id": 1036
      },
      "display_in_showcase": true,
      "price": 95,
      "discount": 3,
      "accessories": [
        "2317217",
        "4517217",
        {
          "page": "ТелефоныPhones / АксессуарыAccessories"
        },
        {
          "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": "МальчикBoy ; девочкаGirl",
        "material": "ПолиэстерPolyester",
        "country": {
          "ruen": "ВеликобританияUnited Kingdom",
          "uaro": "ВеликобританіяMarea Britanie"
        }
      "supplier_id": {
        "id": 4,
        "value": "Top"
        }
      }
    }
  ]
}

Пример ответа на запросExample of a response to a request:

{
    "status": "WARNING",
    "response": {
        "log": [
            {
                "article": "AAAA_TEST",
                "info": [
                    {
                        "code": 23,
                        "message": "НекорректнаяIncorrect link ссылкаto наthe изображениеimage \"sdgagadsgsadgsadgsadgsagsadg\""
                    },
                    {
                        "code": 0,
                        "message": "ТоварProduct обновленupdated"
                    },
                    {
                        "code": 13,
                        "message": "Запись с ссылкойAn entry with the link \/aaaa-test\/ ужеalready существуетexists"
                    },
                    {
                        "code": 22,
                        "message": "ИзображениеThe image https:\/\/cdn.pixabay.com\/photo\/2013\/07\/12\/12\/58\/tv-test-pattern-146649_960_720.png успешноhas been загруженоuploaded"
                    },
                    {
                        "code": 22,
                        "message": "ИзображениеThe image https:\/\/lh4.ggpht.com\/wKrDLLmmxjfRG2-E-k5L5BUuHWpCOe4lWRF7oVs1Gzdn5e5yvr8fj-ORTlBF43U47yI=w300 успешноhas been загруженоuploaded"
                    },
                    {
                        "code": 22,
                        "message": "ИзображениеThe image http:\/\/wp.patheos.com.s3.amazonaws.com\/blogs\/faithwalkers\/files\/2013\/03\/bigstock-Test-word-on-white-keyboard-27134336.jpg успешноhas been загруженоuploaded"
                    },
                    {
                        "code": 22,
                        "message": "ИзображениеThe image https:\/\/i.vimeocdn.com\/portrait\/58832_300x300 успешноhas been загруженоuploaded"
                    },
                    {
                        "code": 22,
                        "message": "ИзображениеThe image http:\/\/www.testinteligencia.net\/image\/repository\/test1.jpg успешноhas been загруженоuploaded"
                    },
                    {
                        "code": 22,
                        "message": "ИзображениеThe image https:\/\/i.ytimg.com\/vi\/yaqe1qesQ8c\/maxresdefault.jpg has успешноbeen загруженоuploaded"
                    },
                    {
                        "code": 25,
                        "message": "ПроизошлаUnknown неизвестнаяerror ошибкаwhen приloading загрузкеan изображенияimage. Cannot read from non-readable stream"
                    }
                ]
            },
            {
                "article": "BBBB_TEST",
                "info": [
                    {
                        "code": 15,
                        "message": "ОстаткиStock товараbalances обновленыupdated"
                    },
                    {
                        "code": 0,
                        "message": "ТоварProduct добавленadded"
                    },
                    {
                        "code": 22,
                        "message": "ИзображениеThe image https:\/\/cdn.pixabay.com\/photo\/2013\/07\/12\/12\/58\/tv-test-pattern-146649_960_720.png успешноhas been загруженоuploaded"
                    },
                    {
                        "code": 22,
                        "message": "ИзображениеThe image https:\/\/lh4.ggpht.com\/wKrDLLmmxjfRG2-E-k5L5BUuHWpCOe4lWRF7oVs1Gzdn5e5yvr8fj-ORTlBF43U47yI=w300 has успешноbeen загруженоuploaded"
                    }
                ]
            }
        ]
    }
}