Описание

Позволяет импортировать 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Идентификаторы продуктов, которые были успешно импортированы
  • No labels