Импорт SKU и категорий

Описание

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

URL-адрес

Метод: POST

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

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

Параметр	Тип	Пример	Обязательный	Описание
custom_fields	array of objects	[    {       "external_id": "1234",       "name": "1234",       "entity_type": "sku",       "required": false,       "value_type": "unicode",       "default_value": "data"    } ]	Нет	Создание дополнительных полей для следующих сущностей: продукт SKU заказ позиция заказа
categories	array of objects	[    {       "external_id": "1234",       "name": "1234",       "parent_external_id": "123"    } ]	Нет	Создание категорий и подкатегорий
data	array of objects	[    {       "name": "iPhone",       "external_id": "123456"    } ]	Да	Данные о SKU Подробнее

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

Приведены три примера разной сложности: минимальный запрос с обязательными полями, запрос с дополнительными полями и запрос с пользовательскими.

Обязательные поля

JSON

{
    "data": [
        {
            "name": "Apple iPhone 13 256GB",
            "external_id": "sku_test_1",
            "product_external_id": "iphone_test_1"
        }
    ]
}

XML

<xml>
  <data>
    <name>Apple iPhone 13 256GB</name>
    <external_id>sku_test_1</external_id>
    <product_external_id>iphone_test_1</product_external_id>
  </data>
</xml>

С дополнительными полями

JSON

{
"categories": [
    {
        "external_id": "test_category_2",
        "name": "Тестовая категория 2"
    }
],
"data": [
    {
        "name": "Apple iPhone 13 256GB",
        "external_id": "sku_test_1",
        "price": "1000",
        "old_price": "1100",
        "currency": "USD",
        "description": "Описание SKU",
        "product_external_id": "iphone_test_1",
        "categories": [
            "test_category_2"
        ],
        "tags": [
            "phone",
            "Apple"
        ],
        "manufacturer_name": "Apple",
        "url": "https://example.com",
        "pictures": [
            "https://example.com",
            "https://example.com"
        ],
        "count": 10,
        "expiration_time": "730",
        "is_available": true,
        "delivery": true,
        "barcode": [
            23346346,
            23546362,
            76834566
        ],
        "manufacturer_warranty": true,
        "regional_data": [
            {
                "external_id": "region_YnCrJj8Y1",
                "price": "75000",
                "old_price": "80000",
                "currency": "RUB",
                "count": 8,
                "is_available": true,
                "delivery": true
            }
        ]
    }
]
}

XML

<xml>
<categories>
<external_id>test_category_2</external_id>
<name>Тестовая категория 2</name>
</categories>
<data>
<name>Apple iPhone 13 256GB</name>
<external_id>sku_test_1</external_id>
<price>1000</price>
<old_price>1100</old_price>
<currency>USD</currency>
<description>Описание SKU</description>
<product_external_id>iphone_test_1</product_external_id>
<categories>test_category_2</categories>
<tags>phone</tags>
<tags>Apple</tags>
<manufacturer_name>Apple</manufacturer_name>
<url>https://example.com</url>
<pictures>https://example.com</pictures>
<pictures>https://example.com</pictures>
<count>10</count>
<expiration_time>730</expiration_time>
<is_available>true</is_available>
<delivery>true</delivery>
<barcode>23346346</barcode>
<barcode>23546362</barcode>
<barcode>76834566</barcode>
<manufacturer_warranty>true</manufacturer_warranty>
<regional_data>
    <external_id>region_YnCrJj8Y1</external_id>
    <price>75000</price>
    <old_price>80000</old_price>
    <currency>RUB</currency>
    <count>8</count>
    <is_available>true</is_available>
    <delivery>true</delivery>
</regional_data>
</data>
</xml>

С пользовательскими полями

Пример с созданием пользовательского поля (custom_fields в корне запроса) и его заполнением в SKU и региональных данных:

JSON

{
"custom_fields": [
    {
        "external_id": "test_field_string",
        "name": "Строковое поле",
        "entity_type": "sku",
        "required": false,
        "value_type": "unicode",
        "default_value": "Значение тестового поля sku по умолчанию"
    }
],
"data": [
    {
        "name": "Apple iPhone 13 256GB",
        "external_id": "sku_test_1",
        "product_external_id": "iphone_test_1",
        "price": "1000",
        "old_price": "1100",
        "currency": "USD",
        "custom_fields": {
            "test_field_string": "Тестовое поле"
        },
        "regional_data": [
            {
                "external_id": "region_YnCrJj8Y1",
                "price": "75000",
                "old_price": "80000",
                "currency": "RUB",
                "custom_fields": {
                    "test_field_string": "Тестовое поле"
                }
            }
        ]
    }
]
}

XML

<xml>
<custom_fields>
<external_id>test_field_string</external_id>
<name>Строковое поле</name>
<entity_type>sku</entity_type>
<required>false</required>
<value_type>unicode</value_type>
<default_value>Значение тестового поля sku по умолчанию</default_value>
</custom_fields>
<data>
<name>Apple iPhone 13 256GB</name>
<external_id>sku_test_1</external_id>
<product_external_id>iphone_test_1</product_external_id>
<price>1000</price>
<old_price>1100</old_price>
<currency>USD</currency>
<custom_fields>
<test_field_string>Тестовое поле</test_field_string>
</custom_fields>
<regional_data>
<external_id>region_YnCrJj8Y1</external_id>
<price>75000</price>
<old_price>80000</old_price>
<currency>RUB</currency>
<custom_fields>
    <test_field_string>Тестовое поле</test_field_string>
</custom_fields>
</regional_data>
</data>
</xml>

к сведению

custom_fields в корне запроса создаёт новые пользовательские поля (массив), а в объекте SKU — заполняет их значениями (объект в формате "external_id_поля": "значение").

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

JSON

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

XML

<xml>
    <error>0</error>
    <error_text></error_text>
    <result>
        <error>0</error>
        <external_id>sku_test_1</external_id>
    </result>
</xml>

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

Параметр	Тип	Описание
error	int	Код ошибки
error_text	string	Текст ошибки
result	array	Идентификаторы SKU, которые были успешно импортированы