SKU data object

Description

SKU data object used in SKU import requests.

Parameter	Type	Example	Required	Description
name	string	"Canon EOS 90D Body"	Yes	SKU's name.
external_id	string	"12345678"	Yes	SKU ID that is used when adding an item to an order.
price	string	"510"	No	Current price of the SKU.
old_price	string	"600"	No	Old price of the SKU.
currency	string	"USD"	No	The currency that is used when specifying the SKU price. Currencies are configured in the platform interface: Market → Settings → Other. If the request passes a currency that is not set in the platform, an error will occur.
tags	array	[ "camera", "Canon" ]	No	List of tags.
manufacturer_name	string	"Canon"	No	Manufacturer's name.
description	string	"test description"	No	SKU description. The length of the text is no more than 1000 characters.
product_external_id	string	"12345"	Yes	The ID of the product to which the SKU is linked. Must be the same for all SKUs of the same product.
url	string	"https://example.com"	No	URL of the SKU page on the store site.
pictures	array	[ "https://example_1.com", "https://example_2.com" ]	No	List of URL links to the SKU images.
count	int	10	No	The number of SKU available for sale.
expiration_time	string	"730"	No	Shelf life or service life (in days).
is_available	bool	true	No	Whether the SKU is in stock or not.
delivery	bool	false	No	Possibility of courier delivery (for all regions to which the store delivers).
barcode	array	[ 5235235, 347347, 335578769 ]	No	List of SKU barcodes from the manufacturer.
manufacturer_warranty	bool	true	No	Manufacturer's official warranty.
custom_fields	object	{ "color": "black", "weight": 730, "dimensions": "105*139*79" }	No	Custom SKU fields. Learn more
regional_data	array	[ { "external_id": "region_YnCrJj8Y1", "price": "36000", "old_price": "38500", "currency": "RUB", "custom_fields":{ "color": "black", "weight": 701 }, "count": 10, "is_available": true, "delivery": true } ]	No	SKU data that varies by region. external_idis the region ID. You can create a region and get its ID in the platform interface: Market → Settings.
categories	array	[ "category_1", "category_2" ]	No	SKU category ID. Learn more

JSON

JSON

[
  {
    "name": "iPhone",
    "external_id": "12345",
    "price": "235",
    "old_price": "400",
    "currency": "USD",
    "description": "",
    "product_external_id": "12345678",
    "categories": ["1234", "12345"],
    "tags": ["one", "two"],
    "manufacturer_name": "Apple",
    "url": "https://example.com",
    "pictures": ["https://example.com", "https://example.com"],
    "count": 50,
    "expiration_time": "730",
    "is_available": true,
    "delivery": true,
    "barcode": [23346346, 23546362, 76834566],
    "manufacturer_warranty": true,
    "custom_fields": {
      "sku_custom_field_1": 123,
      "sku_custom_field_2": "data"
    },
    "regional_data": [
      {
        "external_id": "region_YnCrJj8Y1",
        "price": "864825",
        "old_price": "400",
        "currency": "USD",
        "custom_fields": {
          "sku_custom_field_1": 123,
          "sku_custom_field_2": "data"
        },
        "count": 30,
        "is_available": true,
        "delivery": true
      }
    ]
  }
]

XML

<xml>
  <row>
    <name>iPhone</name>
    <external_id>12345</external_id>
    <price>235</price>
    <old_price>400</old_price>
    <currency>USD</currency>
    <description></description>
    <product_external_id>12345678</product_external_id>
    <categories>1234</categories>
    <categories>12345</categories>
    <tags>one</tags>
    <tags>two</tags>
    <manufacturer_name>Apple</manufacturer_name>
    <url>https://example.com</url>
    <pictures>https://example.com</pictures>
    <pictures>https://example.com</pictures>
    <count>50</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>
      <sku_custom_field_1>123</sku_custom_field_1>
      <sku_custom_field_2>data</sku_custom_field_2>
    </custom_fields>
    <regional_data>
      <external_id>region_YnCrJj8Y1</external_id>
      <price>864825</price>
      <old_price>400</old_price>
      <currency>USD</currency>
      <custom_fields>
        <sku_custom_field_1>123</sku_custom_field_1>
        <sku_custom_field_2>data</sku_custom_field_2>
      </custom_fields>
      <count>30</count>
      <is_available>true</is_available>
      <delivery>true</delivery>
    </regional_data>
  </row>
</xml>