Импорт 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

{
    "custom_fields": [
        {
            "external_id": "test_field_string",
            "name": "Строковое поле",
            "entity_type": "sku",
            "required": false,
            "value_type": "unicode",
            "default_value": "Значение тестового поля sku по умолчанию"
        }
    ],
    "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,
            "custom_fields": {
                "test_field_string": "Тестовое поле"
            },
            "regional_data": [
                {
                    "external_id": "region_YnCrJj8Y1",
                    "price": "75000",
                    "old_price": "80000",
                    "currency": "RUB",
                    "custom_fields": {
                        "test_field_string": "Тестовое поле"
                    },
                    "count": 8,
                    "is_available": true,
                    "delivery": true
                }
            ]
        }
    ]
}

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>
  <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>
    <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>
      <count>8</count>
      <is_available>true</is_available>
      <delivery>true</delivery>
    </regional_data>
  </data>
</xml>

Пример ответа 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, которые были успешно импортированы