Импорт товаров
Адрес запроса «/api/catalog/import»
Список параметров запроса
| token | Токен авторизации (обязательно) |
| products | Список импортируемых товаров |
Список доступных значений для товара
| title | Название товара или название варианта товара, если указан parent_title. Может быть указано как строка, тогда будет применено ко всем языкам, на которых представлен сайт, или как объект <key, value>, где key - двухзначный код языка (ru, uk), value - название товара. Обязательно при создании нового товара. |
| parent_title | Название товара. Может быть указано как строка, тогда будет применено ко всем языкам, на которых представлен сайт, или как объект <key, value>, где key - двухзначный код языка (ru, uk), value - название товара. Обязательно при создании нового товара. |
| description | Краткое описание товара. Может быть указано как строка, тогда будет применено ко всем языкам, на которых представлен сайт, или как объект <key, value>, где key - двухзначный код языка (ru, uk), value - описание товара. Так же данный объект можно представить как массив объектов, для создания вкладок с разным описанием. Каждый объект имеет два свойства: name - название вкладки и description - описание. Эти свойства представляют собой объект <key, value> для возможности указывать значения на разных языках. (подробнее о структуре смотрите ниже, в примере запроса). |
| unit | Единица измерения товара. Может быть указано как строка, тогда будет применено ко всем языкам, на которых представлен сайт, или как объект <key, value>, где key - двухзначный код языка (ru, uk), value - единица измерения. |
| seo_title | Meta title. Может быть указано как строка, тогда будет применено ко всем языкам, на которых представлен сайт, или как объект <key, value>, где key - двухзначный код языка (ru, uk), value - meta title. |
| seo_keywords | Meta keywords. Может быть указано как строка, тогда будет применено ко всем языкам, на которых представлен сайт, или как объект <key, value>, где key - двухзначный код языка (ru, uk), value - meta keywords. |
| seo_description | Meta description. Может быть указано как строка, тогда будет применено ко всем языкам, на которых представлен сайт, или как объект <key, value>, где key - двухзначный код языка (ru, uk), value - meta description. |
| sku | Артикул товара или артикул варианта товара, если указан parent_sku. Указывается как строка |
| parent_sku | Артикул товара. Указывается как строка (обязательно, когда нужно сгруппировать варианты товаров) |
| currency | Код валюты. Указывается как строка. Должно совпадать с тем, как указано в системе управления (обязательно, при создании нового товара) |
| barcode | Штрихкод товара или варианта товара, если указан parent_id. |
| condition | Состояние товара или варианта товара, если указан parent_id. Доступные значения: New(новый). Refurbished(заводское восстановление), Used(бывший в употреблении) |
| price | Цена товара или акционная цена товара, если указан price_old (указывается как строка, дробная часть разделяется точкой) |
| price_old | Цена товара (указывается как строка, дробная часть разделяется точкой) |
| discount | Скидка на товар в процентах (указывается как строка, дробная часть разделяется точкой) |
| availability | Доступность товара. Если в запросе указан данный параметр и display_in_showcase, значение display_in_showcase не будет учитываться. Указывается как строка. Доступные значения: Publish - доступен на сайте, ByUrl - доступен по ссылке, Unpublish - недоступен. |
| display_in_showcase | Доступность товара. Допустимые значения true, false, 1, 0 |
| presence | Наличие товара на складе. Допустимые значения true, false, 1, 0 |
| force_alias_update | Нужно ли обновлять алиас товара. Допустимые значения true, false, 1, 0 (если указано true или 1, алиас буде сгенерирован на основе названия товара) |
| id | Идентификатор товара или варианта товара, если указан parent_id. Целое число (обязательно, при обновлении товаров, если не указан sku) |
| parent_id | Идентификатор товара. Целое число (обязательно, при обновлении товаров) |
| residues | Количество на складе. Целое число |
| images | Изображения товаров. Указывается как объект значений |
| images.removeAll | Удалить все изображения перед загрузкой новых. Имеет наивысший приоритет. Допустимые значения true, false, 1, 0 |
| images.replace | Перезаписать текущее изображение. Допустимые значения true, false, 1, 0 |
| images.updateOnlyGallery | Обновить только галерею изображений. Допустимые значения true, false, 1, 0 |
| images.links | Список изображений. Указывается как массив строк |
| characteristics_mode | Метод работы с характеристиками. Указывается как строка. Доступные значения: Update - обновление существующих и добавление новых характеристик, Reset - полное удаление существующих, затем добавление новых характеристик. Если данный параметр не указан, по умолчанию используется метод Update. |
| characteristics | Характеристики товаров. Первая форма. Указываются как список значений <key, value>, где key - идентификатор типа характеристики, value - представляет объект с названием и идентификатором характеристики |
| characteristics[key].id | Идентификатор характеристики |
| characteristics[key].value | Название характеристики на всех доступных языках. Представлено как массив <key, value>, где key - двухзначный код языка, value - название. |
| characteristics | Характеристики товаров. Вторая форма. Указывается как массив объектов |
| characteristics.id | Идентификатор группы характеристики |
| characteristics.external_id | Внешний идентификатор группы характеристики |
| characteristics.value | Название группы характеристики на всех доступных языках. Представлено как массив <key, value>, где key - двухзначный код языка, value - название. |
| characteristics.values | Значение характеристик. Указывается как массив объектов |
| characteristics.values.id | Идентификатор характеристики |
| characteristics.values.external_id | Внешний идентификатор характеристики. Указывается как строка |
| characteristics.values.value | Название характеристики на всех доступных языках. Представлено как массив <key, value>, где key - двухзначный код языка, value - название. |
| parent | Категории товаров. Представляет массив объектов |
| parent.id | Идентификатор категории |
| parent.external_id | Внешний идентификатор категории. Указывается как строка |
| parent.value | Название категории на всех доступных языках. Представлено как массив <key, value>, где key - двухзначный код языка, value - название. |
| parent.parent_id | Идентификатор родительской категории (необязательно) |
| parent.parent_external_id | Внешний идентификатор родительской категории (необязательно). Указывается как строка |
| positon | Позиция варианта товара. Указывается как целое число |
| parent_position | Позиция товара. Указывается как целое число |
| brand | Производитель |
| brand.id | Идентификатор производителя |
| brand.external_id | Внешний идентификатор производителя. Указывается как строка |
| brand.value | Название производителя на всех доступных языках. Представлено как массив <key, value>, где key - двухзначный код языка, value - название. |
| modification | Модификация товара (обязательно, при создании вариантов товара) |
| modification.id | Идентификатор модификации |
| modification.external_id | Внешний идентификатор модификации (строка) |
| modification.value | Название модификации на всех доступных языках. Представлено как массив <key, value>, где key - двухзначный код языка, value - название. |
| wholesale_price | Цена для оптовых покупок (указывается как строка, дробная часть разделяется точкой) |
| wholesale_count | Количество товаров для оптовой покупки |
| wholesale_prices | Оптовые цены в зависимости от количества (массив). Если не передавать этот параметр, текущие значения будут сохранены. Чтобы очистить значения нужно передать пустой массив. |
| wholesale_prices.count | Количество приобретаемых товаров |
| wholesale_prices.price | Цена, которая применяется при достижении этого количества (указывается как строка, дробная часть разделяется точкой) |
|
stores
|
Список складов с остатками. Указывается как массив объектов |
| stores.id | Идентификатор склада (обязательно) |
| stores.external_id | Внешний идентификатор склада. Указывается как строка |
|
stores.quantity
|
Количество на складе (указывается как целое число) |
| stickers | Стикеры товаров |
| stickers.ids | Массив идентификаторов стикеров |
| stickers.external_ids | Массив внешних идентификаторов стикеров |
| stickers.remove_all | Удалить все стикеры данного товара. Допустимые значения true, false, 1, 0 |
Пример запроса
{
"token":"ji8ZJu3T14jYaYgeMRZW6dJ+ISeCnMTI3LjAuMC4x",
"products" :[
{
"title": {
"ru": "Название варианта товара на русском",
"uk": "Название варианта товара на украинском",
"en": "Название варианта товара на английском"
},
"parent_title": {
"ru": "Название товара на русском",
"uk": "Название товара на украинском",
"en": "Название товара на английском"
},
"description": {
"ru": "Описание товара на русском",
"uk": "Описание товара на украинском",
"en": "Описание товара на английском"
},
"unit": {
"ru": "Единицы измерения на русском",
"uk": "Единицы измерения на украинском",
"en": "Единицы измерения на английском"
},
"seo_title": {
"ru": "seo_title товара на русском",
"uk": "seo_title товара на украинском",
"en": "seo_title товара на английском"
},
"seo_keywords": {
"ru": "seo_keywords товара на русском",
"uk": "seo_keywords товара на украинском",
"en": "seo_keywords товара на английском"
},
"seo_description": {
"ru": "seo_description товара на русском",
"uk": "seo_description товара на украинском",
"en": "seo_description товара на английском"
},
"sku" : "product_variant_sku",
"parent_sku" : "product_sku",
"currency" : "UAH",
"price" : "123.15",
"price_old" : "152.15",
"wholesale_price" : "123.15",
"wholesale_count" : 123,
"presence" : "true",
"force_alias_update" : "1",
"residues" : 125,
"characteristics":{
"ID_4884" : [
{
"id" : 112143,
"value" : {
"ru": "1174 g",
"uk": "1174 g",
"en": "1174 g"
}
}
],
"ID_4886": [
{
"id": 118093,
"value": {
"ru": "grape",
"uk": "grape",
"en": "grape"
}
}
]
},
"modification" : {
"id" : 4121,
"value" : {
"ru": "Название модификации на русском",
"uk": "Название модификации на украинском",
"en": "Название модификации на английском"
}
}
},
{
"title": {
"ru": "Название варианта товара на русском_second",
"uk": "Название варианта товара на украинском_second",
"en": "Название варианта товара на английском_second"
},
"description": [
{
"name": {
"ru": "Вкладка 1",
"uk": "Вкладка 1",
"en": "Tab 1"
},
"description": {
"ru": "Описание 1",
"uk": "Опис 1",
"en": "Description 1"
}
},
{
"name": {
"ru": "Вкладка 2",
"uk": "Вкладка 2",
"en": "Tab 2"
},
"description": {
"ru": "Описание 2",
"uk": "Опис 2",
"en": "Description 2"
}
}
]
"parent_title": {
"ru": "Название товара на русском",
"uk": "Название товара на украинском",
"en": "Название товара на английском"
},
"sku" : "product_variant_sku_second",
"parent_sku" : "product_sku",
"currency" : "UAH",
"price" : "123.15",
"price_old" : "152.15",
"wholesale_price" : "123.15",
"wholesale_count" : 123,
"display_in_showcase" : "true",
"presence" : "true",
"force_alias_update" : "0",
"residues" : 125,
"characteristics": [
{
"external_id": "431",
"value": {
"ru": "Размер"
},
"values": [
{
"value": {
"ru": "40",
"uk": "40"
}
}
]
},
{
"external_id": "5431",
"value": {
"ru": "Сезон"
},
"values": [
{
"value": {
"ru": "Зимові",
"uk": "Зимние"
}
}
]
}
],
"parent" : [
{
"id" : 14123,
"value" : {
"ru": "Название категории на русском",
"uk": "Название категории на украинском",
"en": "Название категории на английском"
}
},
{
"id" : 14124,
"parent_id" : 14123,
"value" : {
"ru": "Название категории на русском",
"uk": "Название категории на украинском",
"en": "Название категории на английском"
}
}
]
}
]
}Пример ответа
{
"status": "OK",
"response": {
"log": [
{
"sku": "product_variant_sku",
"info": [
{
"code": 0,
"message": "Success update/add product."
},
{
"code": 2,
"message": "Product modification with product_variant_sku not exist."
}
]
},
{
"sku": "product_variant_sku_second",
"info": [
{
"code": 0,
"message": "Success update/add product."
},
{
"code": 2,
"message": "Product modification with product_variant_sku_second not exist."
},
{
"code": 9,
"message": "Create new category Название категории на русском."
}
]
}
]
}
}
58 отзывов