Імпорт товарів
Адреса запиту «/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 | Зовнішній ідентифікатор батьківської категорії (необов'язково). Вказується як рядок |
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": "за 50 грамм",
"uk": "за 50 грам",
"en": "for 50 grams"
},
"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 відгуків