Создать или обновить товар

Этот раздел документации описывает структуру данных для товара, получаемого через API. Структура данных включает основную информацию о товаре, его атрибутах, а также данные о наличии товара на складах и его цене.

Параметры запроса

Параметр	Формат	Обязательное	Описание
page	Целое число	Необязательное	Номер страницы, если данные разбиты на несколько страниц.
limit	Целое число	Необязательное	Количество элементов на странице.
last_updated_date	Дата	Необязательное	Фильтрация данных по дате последнего обновления. Если параметр last_updated_date не указан или не передан в запросе, система по умолчанию вернёт все данные без фильтрации по дате.

Пример использования параметров запроса

Для получения списка с пагинацией и фильтрацией по дате последнего обновления, запрос может выглядеть следующим образом:

GET /attributes?page=2&limit=10&last_updated_date=2024-12-01

Этот запрос вернёт вторую страницу данных, с 10 элементами, обновлёнными после 1 декабря 2024 года.

Пример ответа

[
    {
        "id": "Djh2f-u2n7d-2Nk82-sM2u7",
        "product_card_id":"U7nKD8wYd",
        "product_group_id":"LD1h4sJ72",
        "name_ru": "Мужские кроссовки Skechers GO walk Max Walker - Titus 216581",
        "name_uz": "Erkaklar krossovkalari Skechers GO walk Max Walker - Titus 216581",
        "description_ru": "Наслаждайтесь максимальным комфортом и спортивным стилем в Skechers GO WALK Max Walker- Titus. Эта конструкция для ходьбы со шнуровкой на банджи имеет спортивный верх из сетки со стелькой Skechers Goga Mat с воздушным охлаждением, легкой амортизацией ULTRA GO и межподошвой Skechers Max Cushioning — и все это на подошве Goodyear Performance Outsole.",
        "description_uz": "Skechers GO WALK Max Walker-Titus-da maksimal qulaylik va sport uslubidan bahramand bo'ling. Bu bungi bogʻichli yurish dizayni havo bilan sovutilgan Skechers Goga Mat oyoq toʻshagi, engil ULTRA GO amortizatori va Skechers Max Cushioning oʻrta tagligi bilan sportga oʻxshash toʻrli ustki qismni oʻz ichiga oladi — barchasi Goodyear Performance tashqi tagligi ustida.",
        "partner_sku": "216582-OLV",
        "barcode": "197627702957",
        "brand_name": "Skechers",
        "category_id": "e81d24e9-287c-42c3-815f-f4a55adc27c2",
        "weight": 100,
        "dimensions": {
            "length": 55,
            "width": 40,
            "height": 15
        },
        "attributes": [
            {
                "id": "iUy7s-Iu8wn-Khd2n-Yqn8s",
                "name": "Цвет",
                "value_id": "Ywu6-Pys6q-Ur15n-Uns71",
                "value_name": "BLACK"
            }
        ],
        "prices": [
            {
                "warehouse_id": "Uh2o-Hyes-Luw7d-uY6wn",
                "price": 1000000,
                "discount": 0
            },
            {
                "warehouse_id": "Yqjsp-quNs8-Slh21-Pshy5",
                "price": 1000000,
                "discount": 0
            }
        ],
        "updated_at": 1235674721647612,
        "is_adult": false,
        "psic": "197627702957",
        "package_code": "197627702957",
        "main_photo": "https://cdn.example.com/88b43840-a604-42bf-8d32-d5697bed1540.jpg",
        "photos": [
            "https://cdn.example.com/88b43840-a604-42bf-8d32-d5697bed1540.jpg",
            "https://cdn.example.com/88b43840-a604-42bf-8d32-d5697bed1540.jpg"
        ]
    }
]

Описание полей

Основные данные товара

Параметр	Формат	Обязательное	Описание
id	Строка	Обязательное	Уникальный идентификатор товара.
product_card_id	Строка	Обязательное	Уникальный идентификатор карточки товара.
product_group_id	Строка	Необязательное	Уникальный идентификатор группы товаров.
name_ru	Строка	Обязательное	Название товара на русском языке.
name_uz	Строка	Обязательное	Название товара на узбекском языке.
description_ru	Строка	Необязательное	Описание товара на русском языке.
description_uz	Строка	Необязательное	Описание товара на узбекском языке.
partner_sku	Строка	Обязательное	SKU (артикул) товара у партнера.
barcode	Строка	Обязательное	Штрихкод товара.
brand_name	Строка	Необязательное	Бренд товара.
category_id	Строка	Обязательное	Идентификатор категории, к которой относится товар.
weight	Число	Необязательное	Вес товара в граммах.
dimensions	Объект	Необязательное	Размеры товара.
dimensions.length	Число	Необязательное	Длина товара в миллиметрах.
dimensions.width	Число	Необязательное	Ширина товара в миллиметрах.
dimensions.height	Число	Необязательное	Высота товара в миллиметрах.
attributes	Массив объектов	Обязательное	Атрибуты товаров.
prices	Массив объектов	Обязательное	Цена товара.
is_adult	Булево	Обязательное	Указывает, является ли товар для взрослых (true - только для взрослых, false - для всех).
main_photo	Строка	Обязательное	URL основного изображения товара.
photos	Массив строк	Необязательное	Список URL изображений товара.
psic	Строка	Необязательное	Идентификатор товара по системе партнера.
package_code	Строка	Необязательное	Код упаковки товара.
updated_at	Число	Обязательное	Время последнего обновления данных товара в формате Unix timestamp.

Атрибуты товаров

Параметр	Формат	Обязательное	Описание
id	Строка	Обязательное	Идентификатор атрибута.
name	Строка	Обязательное	Название атрибута (например, "Цвет").
value_id	Строка	Обязательное	Идентификатор значения атрибута.
value_name	Строка	Обязательное	Название значения атрибута (например, "BLACK").

Информация о ценах

Параметр	Формат	Обязательное	Описание
warehouse_id	Строка	Обязательное	Идентификатор склада.
price	Число	Обязательное	Цена товара на складе.
discount	Число	Обязательное	Скидка на товар (в процентах).

Важные замечания

product_card_id: Определяет основную категорию товара (например, "Футболки", "Джинсы").
product_group_id: Создает подкатегории внутри основной категории (например, "Белая футболка", "Черная футболка").
id: Является уникальным идентификатором конкретного товара со всеми его характеристиками (например, "Белая футболка, размер M").

Создать или обновить товар

Параметры запроса​

Пример использования параметров запроса​

Пример ответа​

Описание полей​

Основные данные товара​

Атрибуты товаров​

Информация о ценах​

Важные замечания​