Перейти к основному содержимому

Импорт продуктов, SKU и категорий

Описание

Позволяет импортировать 3 типа сущностей одновременно: продукты, SKU и категории.

URL-адрес

Метод: POST

https://example.com/api/v1.1/market/products/import

Параметры запроса

ПараметрТипПримерОбязательныйОписание
tokenstring"abcdefghijklmnqrstuvwxyz"ДаAPI токен.
Убедитесь, что для токена доступны роли, позволяющие работать с маркетом.
custom_fieldsarray of objects
[ 
   {
      "external_id": "1234",
      "name": "product_custom_field",
      "entity_type": "product",
      "required": false,
      "value_type": "unicode",
      "default_value": "data"
   }
]
НетСоздание дополнительных полей для следующих сущностей:
  • продукт
  • SKU
  • заказ
  • позиция заказа
Подробнее
categoriesarray of objects
[
   {
      "external_id": "1234",
      "name": "Camera & Photo",
      "parent_external_id": "123"
   }
]
НетСоздание категорий и подкатегорий

Подробнее
dataarray of objects
[
   {
      "name": "iPhone",
      "external_id": "123456"
   }
]
ДаДанные о продуктах и их SKU
Подробнее

Пример запроса JSON

{
"token": "abcdefghijklmnqrstuvwxyz",
"custom_fields": [
{
"external_id": "test_field_1",
"name": "Тестовое поле продукта",
"entity_type": "product",
"required": false,
"value_type": "unicode",
"default_value": "Значение тестового поля продукта по умолчанию"
},
{
"external_id": "test_field_2",
"name": "Тестовое поле sku",
"entity_type": "sku",
"required": false,
"value_type": "unicode",
"default_value": "Значение тестового поля sku по умолчанию"
}
],
"categories": [
{
"external_id": "test_category_1",
"name": "Тестовая категория"
}
],
"data": [
{
"name": "Apple iPhone 13",
"external_id": "iphone_test_1",
"price": "900",
"old_price": "950",
"currency": "USD",
"tags": ["phone", "Apple"],
"manufacturer_name": "Apple",
"description": "Описание продукта",
"url": "https://example.com",
"pictures": ["https://example.com", "https://example.com"],
"count": 20,
"expiration_time": "730",
"is_available": true,
"delivery": true,
"barcode": [5235235, 347347, 335578769],
"manufacturer_warranty": true,
"custom_fields": {
"test_field_1": "тестовое поле"
},
"regional_data": [
{
"external_id": "region_YnCrJj8Y1",
"price": "65000",
"old_price": "70000",
"currency": "RUB",
"count": 5,
"is_available": true,
"delivery": false
}
],
"categories": ["test_category_1"],
"sku": [
{
"name": "Apple iPhone 13 256GB",
"external_id": "sku_test_1",
"price": "1000",
"old_price": "1100",
"currency": "USD",
"tags": ["phone", "Apple"],
"manufacturer_name": "Apple",
"description": "Описание SKU",
"url": "https://example.com",
"count": 10,
"expiration_time": "730",
"is_available": true,
"delivery": true,
"barcode": [5235235, 347347, 335578769],
"manufacturer_warranty": true,
"custom_fields": {
"test_field_2": "тестовое поле"
},
"regional_data": [
{
"external_id": "region_Un7rdJoBT",
"price": "75000",
"old_price": "80000",
"currency": "RUB",
"count": 5,
"is_available": true,
"delivery": true
}
]
}
]
}
]
}

Пример ответа JSON

{
"error": 0,
"error_text": "",
"result": [
{
"error": 0,
"external_id": "iphone_test_1"
}
]
}

Возвращаемые параметры

ПараметрТипОписание
errorintКод ошибки
error_textstringТекст ошибки
resultarrayИдентификаторы продуктов, которые были успешно импортированы