Product data object

Описание

Массив объектов product используется в API запросах, связанных с импортом продуктов в маркет.

Параметр	Тип	Пример	Обязательный	Описание
name	string	"Canon EOS Digital Camera"	Да	Название продукта.
external_id	string	"12345"	Да	Дополнительный идентификатор продукта, который используется при добавлении позиции в заказе.
price	string	"490"	Нет	Актуальная цена продукта.
old_price	string	"520"	Нет	Старая цена продукта.
currency	string	"USD"	Нет	Валюта, в которой указана цена продукта. Валюты настраиваются в интерфейсе платформы: Маркет —> Настройки —> Другое. Если в запросе передать валюту, которая не задана в платформе, произойдет ошибка.
tags	array	[    "camera",    "Canon" ]	Нет	Список тегов.
manufacturer_name	string	"Canon"	Нет	Название производителя.
description	string	"Test description"	Нет	Описание продукта. Длина текста — не более 1000 символов.
url	string	"https://example.com"	Нет	URL страницы продукта на сайте магазина.
pictures	array	[    "https://example_1.com",    "https://example_2.com" ]	Нет	Список URL-ссылок на изображения продукта.
count	int	60	Нет	Количество продуктов, доступное для продажи.
expiration_time	string	"730"	Нет	Срок годности или службы (в сутках).
is_available	bool	true	Нет	Есть ли продукт в наличии у магазина.
delivery	bool	true	Нет	Возможность курьерской доставки (по всем регионам, в которые доставляет магазин).
barcode	array	[    5235235,    347347,    335578769 ]	Нет	Список штрихкодов продукта от производителя.
manufacturer_warranty	bool	true	Нет	Официальная гарантия производителя.
custom_fields	object	{    "color": "black",    "weight": 701,    "dimensions": "105*141*77" }	Нет	Дополнительные поля продукта. Подробнее.
regional_data	array	[    {       "external_id": "region_YnCrJj8Y1",       "price": "36000",       "old_price": "38500",       "currency": "RUB",       "custom_fields": {          "color": "black",          "weight": 701       },       "count": 30,       "is_available": true,       "delivery": true    } ]	Нет	Данные о продукте, которые могут различаться в зависимости от региона. external_id – это дополнительный идентификатор региона. Создать регион и получить его идентификатор можно в интерфейсе платформы: Маркет —> Настройки.
categories	array	[    "category_1",    "category_2" ]	Нет	Дополнительный идентификатор категории продукта. Подробнее.
sku	array	[    {       "name": "Canon EOS 90D Body",       "external_id": "12345678",    } ]	Нет	Данные о SKU продукта. Подробнее.

JSON

JSON

[
  {
    "name": "iPhone",
    "external_id": "123456",
    "price": "500",
    "old_price": "400",
    "currency": "USD",
    "tags": ["one", "two"],
    "manufacturer_name": "Apple",
    "description": "Test description",
    "url": "https://example.com",
    "pictures": ["https://example.com", "https://example.com"],
    "count": 60,
    "expiration_time": "730",
    "is_available": true,
    "delivery": true,
    "barcode": [5235235, 347347, 335578769],
    "manufacturer_warranty": false,
    "custom_fields": {
      "product_field_id_1": 123,
      "product_field_id_2": "data"
    },
    "regional_data": [
      {
        "external_id": "region_YnCrJj8Y1",
        "price": "864825",
        "old_price": "400",
        "currency": "USD",
        "custom_fields": {
          "product_field_id_1": 123,
          "product_field_id_2": "data"
        },
        "count": 30,
        "is_available": true,
        "delivery": true
      }
    ],
    "categories": ["category_1", "category_2"],
    "sku": [
      {
        "name": "iPhone",
        "external_id": "12345678"
      }
    ]
  }
]

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>