📋 Структура данных

В этом разделе описана полная структура данных, используемая во всех файлах выгрузки Selectyre.

🧠 Метаданные (`metainfo`)

Раздел с общей информацией о выгрузке, присутствует во всех файлах.

Поле	Тип	Описание
`utc_update_time`	string	Время последнего обновления (UTC, ISO 8601)
`client_name`	string	Название клиента
`license_expire`	string	Срок действия лицензии

🛞 Поля шин

Описание всех полей, используемых для характеристик шин.

Поле	Тип	Описание
`code`	string	Уникальный код шины
`p_full_name`	string	Полное наименование
`p_brand`	string	Бренд
`p_model`	string	Модель
`p_width`	string	Ширина профиля в мм
`p_height`	string	Профиль (высота в % от ширины)
`p_diameter`	string	Диаметр в дюймах
`p_load_index`	string	Индекс нагрузки
`p_speed_index`	string	Индекс скорости
`p_season`	string	Сезонность (например, "Зимняя", "Летняя")
`p_category`	string	Категория (например, "Легковые")
`p_xl`	boolean	Усиленная шина (Extra Load)
`p_protection`	string \| null	Защита обода
`p_mud_terrain`	boolean	Грязевая шина
`p_all_terrain`	boolean	Вседорожная
`p_cargo`	boolean	Грузовая
`p_thorn`	boolean	С шипами
`p_can_thorn`	boolean	Возможна ошиповка
`p_omologation`	string \| null	Омологация
`p_side`	string \| null	Надпись на боковине
`p_runflat`	boolean	RunFlat шина
`p_axis`	string \| null	Ось установки
`p_layering`	string \| null	Слойность
`p_appointment`	string \| null	Назначение
`p_photo`	string	Ссылка на фото
`p_photo_last_modified`	string	Дата последнего обновления фото
`p_info_last_modified`	string	Дата последнего обновления информации
`p_shipping_weight`	string	Вес при отгрузке, кг
`p_shipping_volume`	string	Объем при отгрузке, м³
`p_shipping_length`	string	Длина упаковки, см
`p_shipping_width`	string	Ширина упаковки, см
`p_shipping_height`	string	Высота упаковки, см

🔘 Поля дисков

Описание всех полей, используемых для характеристик колесных дисков.

Поле	Тип	Описание
`code`	string	Уникальный код диска
`p_full_name`	string	Полное наименование
`p_brand`	string	Производитель
`p_model`	string	Модель
`p_category`	string	Категория (например, "Легковые")
`p_color`	string	Код цвета
`p_human_readable_color`	string	Человекочитаемый цвет
`p_width`	string	Ширина, дюймы
`p_diameter`	string	Диаметр, дюймы
`p_bolts_count`	int	Количество отверстий
`p_bolts_space`	string	Расстояние между болтами, мм
`p_pcd`	string	Сверловка (например, `5x105`)
`p_et`	string	Вылет (ET), мм
`p_dia`	string	Диаметр центрального отверстия (DIA), мм
`p_type`	string	Тип диска (например, "Литой")
`p_photo`	string	Ссылка на фото
`p_photo_last_modified`	string	Последнее обновление фото
`p_info_last_modified`	string	Последнее обновление информации
`p_shipping_weight`	string	Вес упаковки, кг
`p_shipping_volume`	string	Объем упаковки, м³
`p_shipping_length`	string	Длина упаковки, см
`p_shipping_width`	string	Ширина упаковки, см
`p_shipping_height`	string	Высота упаковки, см

📊 Поля остатков и цен

Описание полей, используемых в файлах с информацией о наличии и ценах товаров.

Поле	Тип	Описание
`code`	string	Уникальный код товара (соответствует коду из ассортимента)
`stock_name`	string	Идентификатор склада
`stock_name_ru`	string	Название склада (на русском)
`wholesale_price`	string	Оптовая цена
`quantity`	integer	Количество на складе
`recommended_retail_price`	string \| null	Рекомендованная розничная цена
`minimal_internet_price`	string \| null	Минимальная интернет-цена
`provider_key`	string	Код поставщика
`cae`	string	Код производителя
`year`	string \| null	Год производства
`sale`	boolean	Распродажа (true/false)
`price`	string	Цена
`delivery_time`	integer	Время доставки (в днях)

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

Параметр code у товара может иногда меняться. При этом товар со старым кодом исчезнет из выгрузки. Это происходит из-за периодической актуализации информации в базе данных с полным удалением товаров и перезагрузкой обновленных данных от поставщиков.

Ссылки из параметра p_photo возвращают изображение с наложенным логотипом клиента. Для того чтобы они работали, нужно предоставить логотип администратору сервиса в формате JPEG или PNG. Если логотип не предоставлен, ссылки будут возвращать ошибку 404.

Указание года и наличие пометки уцененного товара - не связанные напрямую параметры. Поставщик может не помечать устаревшие товары как уцененные, или не указывать год выпуска как причину уценки.

Особенности полей

Поля типа string | null могут содержать пустые значения
Булевы поля в CSV представляются как True/False, в JSON как true/false
Даты представлены в формате ISO 8601 с временной зоной UTC
Цены всегда указаны в рублях
Размеры упаковки указаны в сантиметрах, вес в килограммах, объем в кубических метрах