Import SKUs and categories

Description

Imports 2 types of entities at the same time: SKUs and categories.

Request URL

Method: POST

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

Request parameters

Parameter	Type	Example	Required	Description
token	string	"abcdefghijklmnqrstuvwxyz"	Yes	API token Make sure that market roles are available for the token.
custom_fields	array of objects	[    {       "external_id": "1234",       "name": "1234",       "entity_type": "sku",       "required": false,       "value_type": "unicode",       "default_value": "data"    } ]	No	Creating custom fields for the following entities: product SKU order order item Learn more
categories	array of objects	[    {       "external_id": "1234",       "name": "Camera & Photo",       "parent_external_id": "123"    } ]	No	Creating categories and subcategories Learn more
data	array of objects	[    {       "name": "iPhone",       "external_id": "123456"    } ]	Yes	SKU data Learn more

Request example

JSON

{
    "token": "abcdefghijklmnqrstuvwxyz",
    "custom_fields": [
        {
          "external_id": "test_field_string",
          "name": "Custom field for SKU",
          "entity_type": "sku",
          "required": false,
          "value_type": "unicode",
          "default_value": "Default value of the SKU custom field"
        }
      ],
      "categories": [
        {
          "external_id": "test_category_2",
          "name": "Electronics"
        }
      ],
    "data": [
      {
        "name": "Apple iPhone 13 256GB",
        "external_id": "sku_test_1",
        "price": "1000",
        "old_price": "1100",
        "currency": "USD",
        "description":"SKU description",
        "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": "Test field value",
        },
        "regional_data": [
          {
            "external_id": "region_YnCrJj8Y1", 
            "price": "75000",
            "old_price": "80000",  
            "currency": "RUB",
            "custom_fields": {
                "test_field_string": "Test field value for this region",
            },
            "count": 8,
            "is_available": true,
            "delivery": true
          }
        ]
      }
    ]
  }

XML

<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
  <custom_fields>
    <external_id>test_field_string</external_id>
    <name>Custom field for SKU</name>
    <entity_type>sku</entity_type>
    <required>false</required>
    <value_type>unicode</value_type>
    <default_value>Default value of the SKU custom field</default_value>
  </custom_fields>
  <categories>
    <external_id>test_category_2</external_id>
    <name>Electronics</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</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 value</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 value for this region</test_field_string>
      </custom_fields>
      <count>8</count>
      <is_available>true</is_available>
      <delivery>true</delivery>
    </regional_data>
  </data>
</xml>

Response example

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>

Response parameters

Parameter	Type	Description
error	int	Error code
error_text	string	Error text
result	array	IDs of SKUs that were successfully imported