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

Описание

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

URL-адрес

Метод: POST

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

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

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

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

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
            }
          ]
        }
      ]
    }
  ]
}

XML

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

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

JSON

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

XML

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

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

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