---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.2
alternate:
  - https://yandex.ru/dev/kit/ru/openapi/Tovary/GetVariants.md
  - href: ru/openapi/Tovary/GetVariants.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/kit/ru/llms.txt

<div class="openapi">

# Получение списка товаров

<!-- markdownlint-disable-file -->

Возвращает список товаров с возможностью фильтрации и пагинации.

 Возможна фильтрация по:
  - идентификатору продукта;
  - статусу товара;
  - тексту названия товара, артикулу, штрихкоду и KIT ID.

## Request

<div class="openapi__requests">

<div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-get);margin-bottom: 12px">

<div class="openapi__request">

GET {.openapi__method}
```text translate=no
https://api.kit.yandex.net/v1/variants
```

</div>

</div>

</div>

### Query parameters

#|
|| **Name** | **Description** ||
||

_name_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Текст для поиска по тексту названия товара, артикулу, штрихкоду и KIT ID. Поиск регистронезависимый, частичный.

_Example:_{.json-schema-reset .json-schema-example} `iPhone`
{.table-cell}
||
||

_page_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer

Номер страницы.

_Default:_{.json-schema-reset .json-schema-value} `1`

_Min value:_{.json-schema-reset .json-schema-assertion} `1`
{.table-cell}
||
||

_per_page_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer

Количество элементов на странице.

_Default:_{.json-schema-reset .json-schema-value} `25`

_Min value:_{.json-schema-reset .json-schema-assertion} `1`

_Max value:_{.json-schema-reset .json-schema-assertion} `100`
{.table-cell}
||
||

_product_card_id_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [ProductCardID](#entity-ProductCardID)

Фильтр по идентификатору карточки товара.

Идентификатор карточки товара.

{% cut "**Examples**" %}{.json-schema-example}

``

`019b21d9-c5d9-777d-80bd-d67c664bc6d9`

{% endcut %}
{.table-cell}
||
||

_product_id_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [ProductID](#entity-ProductID)

Фильтр по идентификатору продукта.

Идентификатор продукта.

{% cut "**Examples**" %}{.json-schema-example}

``

`019b21d9-c5d9-777d-80bd-d67c664bc6d9`

{% endcut %}
{.table-cell}
||
||

_status_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [VariantStatus](#entity-VariantStatus)[]

Фильтр по статусу товара. По умолчанию возвращаются товары всех статусов, кроме `ARCHIVED`.

_Example:_{.json-schema-reset .json-schema-example} ``
{.table-cell}
||
|#{.json-schema-properties}

<div class="openapi-entity">

### ProductID {#entity-ProductID}

Идентификатор продукта.

**Type**: string&lt;uuid&gt;

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`

</div>

<div class="openapi-entity">

### ProductCardID {#entity-ProductCardID}

Идентификатор карточки товара.

**Type**: string&lt;uuid&gt;

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`

</div>

<div class="openapi-entity">

### VariantStatus {#entity-VariantStatus}

Статус товара:
- `PUBLISHED` — опубликован, доступен для покупки.
- `HIDDEN` — скрыт, не отображается в каталоге.
- `ARCHIVED` — архивирован, недоступен.

**Type**: string

_Enum:_{.json-schema-reset .json-schema-value} `PUBLISHED`, `HIDDEN`, `ARCHIVED`

</div>

## Responses

<div class="openapi__response__code__200">

## 200 OK

Список товаров.

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "variants": [
    {
      "id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
      "kit_id": 0,
      "sku": "SKU-12345",
      "barcode": "1234567890123",
      "slug": "iphone-15-pro-black",
      "name": "iPhone 15 Pro Черный",
      "description": "Флагманский смартфон с титановым корпусом",
      "brand": "Apple",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-16T14:20:00Z",
      "status": "PUBLISHED",
      "product_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
      "product_card_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
      "characteristics": [
        {
          "characteristic_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
          "value": "Черный",
          "values": [
            "Желтый",
            "Красный"
          ]
        }
      ],
      "stocks": [
        {
          "warehouse_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
          "quantity": 10,
          "reserved": 2
        }
      ],
      "media": [
        {
          "type": "IMAGE",
          "display_sequence": 1,
          "image_id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
          "video_id": "vplvusemmooxmhpwiqli"
        }
      ],
      "pricing": {
        "price": "1000",
        "manual_discount_price": "900",
        "promotion_price": "850",
        "final_price": "850"
      },
      "sort_weight": 100,
      "cargo_boxes": [
        {
          "length": 20,
          "width": 15,
          "height": 10,
          "weight": 500,
          "display_sequence": 1
        }
      ],
      "seo_title": "iPhone 15 Pro Черный - купить в интернет-магазине",
      "seo_h1": "iPhone 15 Pro Черный",
      "seo_description": "Купить iPhone 15 Pro Черный по выгодной цене",
      "vat": 20,
      "requires_marking": false
    }
  ],
  "total_count": 100
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_total_count_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer

Общее количество товаров.
{.table-cell}
||
||

_variants_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [Variant](#entity-Variant)[]

Список товаров.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
    "kit_id": 0,
    "sku": "SKU-12345",
    "barcode": "1234567890123",
    "slug": "iphone-15-pro-black",
    "name": "iPhone 15 Pro Черный",
    "description": "Флагманский смартфон с титановым корпусом",
    "brand": "Apple",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-16T14:20:00Z",
    "status": "PUBLISHED",
    "product_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
    "product_card_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
    "characteristics": [
      {
        "characteristic_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
        "value": "Черный",
        "values": [
          "Желтый",
          "Красный"
        ]
      }
    ],
    "stocks": [
      {
        "warehouse_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
        "quantity": 10,
        "reserved": 2
      }
    ],
    "media": [
      {
        "type": "IMAGE",
        "display_sequence": 1,
        "image_id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
        "video_id": "vplvusemmooxmhpwiqli"
      }
    ],
    "pricing": {
      "price": "1000",
      "manual_discount_price": "900",
      "promotion_price": "850",
      "final_price": "850"
    },
    "sort_weight": 100,
    "cargo_boxes": [
      {
        "length": 20,
        "width": 15,
        "height": 10,
        "weight": 500,
        "display_sequence": 1
      }
    ],
    "seo_title": "iPhone 15 Pro Черный - купить в интернет-магазине",
    "seo_h1": "iPhone 15 Pro Черный",
    "seo_description": "Купить iPhone 15 Pro Черный по выгодной цене",
    "vat": 20,
    "requires_marking": false
  }
]
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### VariantID {#entity-VariantID}

Идентификатор товара.

**Type**: string&lt;uuid&gt;

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`

</div>

<div class="openapi-entity">

### CharacteristicID {#entity-CharacteristicID}

Идентификатор категории.

**Type**: string&lt;uuid&gt;

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`

</div>

<div class="openapi-entity">

### VariantCharacteristic {#entity-VariantCharacteristic}

Значение характеристики товара.

#|
|| **Name** | **Description** ||
||

_characteristic_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [CharacteristicID](#entity-CharacteristicID)

Идентификатор категории.

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`
{.table-cell}
||
||

_value_{.json-schema-reset .json-schema-property .json-schema-required .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact}
{.table-cell}|
**Type**: string

Значение характеристики.

_Example:_{.json-schema-reset .json-schema-example} `Черный`
{.table-cell}
||
||

_values_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string[]

Значения характеристик.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  "Желтый",
  "Красный"
]
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "characteristic_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
  "value": "Черный",
  "values": [
    "Желтый",
    "Красный"
  ]
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### WarehouseID {#entity-WarehouseID}

Идентификатор склада.

**Type**: string&lt;uuid&gt;

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`

</div>

<div class="openapi-entity">

### VariantStock {#entity-VariantStock}

Остатки товара на складе.

#|
|| **Name** | **Description** ||
||

_quantity_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer

Количество на складе.
{.table-cell}
||
||

_reserved_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer

Зарезервированное количество.
{.table-cell}
||
||

_warehouse_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [WarehouseID](#entity-WarehouseID)

Идентификатор склада.

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "warehouse_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
  "quantity": 10,
  "reserved": 2
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### FileType {#entity-FileType}

Тип файла.

**Type**: string

_Enum:_{.json-schema-reset .json-schema-value} `IMAGE`, `VIDEO`, `OTHER`

</div>

<div class="openapi-entity">

### FileID {#entity-FileID}

Идентификатор файла.

**Type**: string&lt;uuid&gt;

_Example:_{.json-schema-reset .json-schema-example} `019b30d4-3e28-7a98-ae46-cb66932d1936`

</div>

<div class="openapi-entity">

### VariantMedia {#entity-VariantMedia}

Медиафайлы товара (изображения и видео).

#|
|| **Name** | **Description** ||
||

_display_sequence_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer

Порядок отображения.
{.table-cell}
||
||

_type_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [FileType](#entity-FileType)

Тип файла.

_Enum:_{.json-schema-reset .json-schema-value} `IMAGE`, `VIDEO`, `OTHER`
{.table-cell}
||
||

_image_id_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [FileID](#entity-FileID)

Идентификатор файла.

_Example:_{.json-schema-reset .json-schema-example} `019b30d4-3e28-7a98-ae46-cb66932d1936`
{.table-cell}
||
||

_video_id_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Идентификатор видео (для `type: VIDEO`). Видео нужно предварительно загрузить
через `POST /v1/videos` или `POST /v1/videos/from_url`.


Максимум одно видео на товар. В `media` требуется минимум одно изображение:
при отсутствии элемента `type: IMAGE` запрос завершится с ошибкой.

Привязанное видео может быть в любом статусе, но покупателям оно доступно
для просмотра только после перехода в статус `READY`.

_Example:_{.json-schema-reset .json-schema-example} `vplvusemmooxmhpwiqli`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "type": "IMAGE",
  "display_sequence": 1,
  "image_id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
  "video_id": "vplvusemmooxmhpwiqli"
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### VariantPricing {#entity-VariantPricing}

Цена товара.

#|
|| **Name** | **Description** ||
||

_final_price_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string&lt;decimal&gt;

Итоговая цена.

_Example:_{.json-schema-reset .json-schema-example} `850`
{.table-cell}
||
||

_manual_discount_price_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string&lt;decimal&gt;

Цена со скидкой (установлена вручную).

_Example:_{.json-schema-reset .json-schema-example} `900`
{.table-cell}
||
||

_price_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string&lt;decimal&gt;

Цена до скидки. Базовая цена товара от которой считается цена со скидкой.

_Example:_{.json-schema-reset .json-schema-example} `1000`
{.table-cell}
||
||

_promotion_price_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string&lt;decimal&gt;

Цена по акции.

_Example:_{.json-schema-reset .json-schema-example} `850`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "price": "1000",
  "manual_discount_price": "900",
  "promotion_price": "850",
  "final_price": "850"
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### VariantCargoBox {#entity-VariantCargoBox}

#|
|| **Name** | **Description** ||
||

_display_sequence_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer

Порядок отображения.
{.table-cell}
||
||

_height_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer

Высота (см).

_Min value:_{.json-schema-reset .json-schema-assertion} `0`
{.table-cell}
||
||

_length_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer

Длина (см).

_Min value:_{.json-schema-reset .json-schema-assertion} `0`
{.table-cell}
||
||

_weight_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer

Вес (г).

_Min value:_{.json-schema-reset .json-schema-assertion} `0`
{.table-cell}
||
||

_width_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer

Ширина (см).

_Min value:_{.json-schema-reset .json-schema-assertion} `0`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "length": 20,
  "width": 15,
  "height": 10,
  "weight": 500,
  "display_sequence": 1
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### Variant {#entity-Variant}

#|
|| **Name** | **Description** ||
||

_barcode_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Штрих-код.

_Example:_{.json-schema-reset .json-schema-example} `1234567890123`
{.table-cell}
||
||

_brand_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Бренд товара.

_Example:_{.json-schema-reset .json-schema-example} `Apple`
{.table-cell}
||
||

_cargo_boxes_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [VariantCargoBox](#entity-VariantCargoBox)[]

Вес и габариты с упаковкой.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "length": 20,
    "width": 15,
    "height": 10,
    "weight": 500,
    "display_sequence": 1
  }
]
```

{% endcut %}
{.table-cell}
||
||

_characteristics_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [VariantCharacteristic](#entity-VariantCharacteristic)[]

Характеристики товара.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "characteristic_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
    "value": "Черный",
    "values": [
      "Желтый",
      "Красный"
    ]
  }
]
```

{% endcut %}
{.table-cell}
||
||

_created_at_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string&lt;date-time&gt;

Дата создания.

_Example:_{.json-schema-reset .json-schema-example} `2024-01-15T10:30:00Z`
{.table-cell}
||
||

_description_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Описание товара.

_Example:_{.json-schema-reset .json-schema-example} `Флагманский смартфон с титановым корпусом`
{.table-cell}
||
||

_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [VariantID](#entity-VariantID)

Идентификатор товара.

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`
{.table-cell}
||
||

_kit_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer

Уникальный идентификатор товара в системе, отображаемый в B2B кабинете.
{.table-cell}
||
||

_media_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [VariantMedia](#entity-VariantMedia)[]

Изображения и видео.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "type": "IMAGE",
    "display_sequence": 1,
    "image_id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
    "video_id": "vplvusemmooxmhpwiqli"
  }
]
```

{% endcut %}
{.table-cell}
||
||

_name_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Название товара.

_Example:_{.json-schema-reset .json-schema-example} `iPhone 15 Pro Черный`
{.table-cell}
||
||

_pricing_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [VariantPricing](#entity-VariantPricing)

Цена товара.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "price": "1000",
  "manual_discount_price": "900",
  "promotion_price": "850",
  "final_price": "850"
}
```

{% endcut %}
{.table-cell}
||
||

_product_card_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [ProductCardID](#entity-ProductCardID)

Идентификатор карточки товара.

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`
{.table-cell}
||
||

_product_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [ProductID](#entity-ProductID)

Идентификатор продукта.

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`
{.table-cell}
||
||

_requires_marking_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: boolean

Признак обязательной маркировки товара в системе «Честный знак». Если параметр не передан, используется значение по умолчанию `false`. `true` — товар подлежит обязательной маркировке, `false` — не подлежит.
{.table-cell}
||
||

_seo_description_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Описание страницы в поиске (Description).

_Example:_{.json-schema-reset .json-schema-example} `Купить iPhone 15 Pro Черный по выгодной цене`
{.table-cell}
||
||

_seo_h1_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Заголовок на странице товара (H1).

_Example:_{.json-schema-reset .json-schema-example} `iPhone 15 Pro Черный`
{.table-cell}
||
||

_seo_title_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Заголовок страницы в поиске (Title).

_Example:_{.json-schema-reset .json-schema-example} `iPhone 15 Pro Черный - купить в интернет-магазине`
{.table-cell}
||
||

_sku_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Артикул товара.

_Example:_{.json-schema-reset .json-schema-example} `SKU-12345`
{.table-cell}
||
||

_slug_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

URL-идентификатор товара.

_Example:_{.json-schema-reset .json-schema-example} `iphone-15-pro-black`
{.table-cell}
||
||

_sort_weight_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer

Приоритет в каталоге.

_Min value:_{.json-schema-reset .json-schema-assertion} `1`

_Max value:_{.json-schema-reset .json-schema-assertion} `1000`
{.table-cell}
||
||

_status_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [VariantStatus](#entity-VariantStatus)

Статус товара:
- `PUBLISHED` — опубликован, доступен для покупки.
- `HIDDEN` — скрыт, не отображается в каталоге.
- `ARCHIVED` — архивирован, недоступен.

_Enum:_{.json-schema-reset .json-schema-value} `PUBLISHED`, `HIDDEN`, `ARCHIVED`
{.table-cell}
||
||

_stocks_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [VariantStock](#entity-VariantStock)[]

Остатки на складах.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "warehouse_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
    "quantity": 10,
    "reserved": 2
  }
]
```

{% endcut %}
{.table-cell}
||
||

_updated_at_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string&lt;date-time&gt;

Дата последнего обновления.

_Example:_{.json-schema-reset .json-schema-example} `2024-01-16T14:20:00Z`
{.table-cell}
||
||

_vat_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer

НДС в процентах. Специальное значение -1 означает, что товар не облагается НДС.
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
  "kit_id": 0,
  "sku": "SKU-12345",
  "barcode": "1234567890123",
  "slug": "iphone-15-pro-black",
  "name": "iPhone 15 Pro Черный",
  "description": "Флагманский смартфон с титановым корпусом",
  "brand": "Apple",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-16T14:20:00Z",
  "status": "PUBLISHED",
  "product_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
  "product_card_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
  "characteristics": [
    {
      "characteristic_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
      "value": "Черный",
      "values": [
        "Желтый",
        "Красный"
      ]
    }
  ],
  "stocks": [
    {
      "warehouse_id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
      "quantity": 10,
      "reserved": 2
    }
  ],
  "media": [
    {
      "type": "IMAGE",
      "display_sequence": 1,
      "image_id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
      "video_id": "vplvusemmooxmhpwiqli"
    }
  ],
  "pricing": {
    "price": "1000",
    "manual_discount_price": "900",
    "promotion_price": "850",
    "final_price": "850"
  },
  "sort_weight": 100,
  "cargo_boxes": [
    {
      "length": 20,
      "width": 15,
      "height": 10,
      "weight": 500,
      "display_sequence": 1
    }
  ],
  "seo_title": "iPhone 15 Pro Черный - купить в интернет-магазине",
  "seo_h1": "iPhone 15 Pro Черный",
  "seo_description": "Купить iPhone 15 Pro Черный по выгодной цене",
  "vat": 20,
  "requires_marking": false
}
```

{% endcut %}

</div>

</div>

<div class="openapi__response__code__400">

## 400 Bad Request

Некорректный запрос.

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `VALIDATION_ERROR`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `Invalid input`
{.table-cell}
||
||

_trace_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный идентификатор запроса для отладки.

_Example:_{.json-schema-reset .json-schema-example} `00000000000000000000000000000000`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__401">

## 401 Unauthorized

Не авторизован.

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `VALIDATION_ERROR`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `Invalid input`
{.table-cell}
||
||

_trace_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный идентификатор запроса для отладки.

_Example:_{.json-schema-reset .json-schema-example} `00000000000000000000000000000000`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__500">

## 500 Internal Server Error

Внутренняя ошибка сервера.

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `VALIDATION_ERROR`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `Invalid input`
{.table-cell}
||
||

_trace_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный идентификатор запроса для отладки.

_Example:_{.json-schema-reset .json-schema-example} `00000000000000000000000000000000`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

</div>

[*Deprecated]: No longer supported, please use an alternative and newer version.