Требования к размещению файла
Доступность и расположение фасетного фида
Максимальная частота обновления: 1 раз в 24 часа.
Формат файла: CSV.
Название и путь к файлу:
https://site.ru/…/anyquery/filter.csv
Доступ к файлу должен быть публичным (без авторизации), сервер возвращает статус
200 OK.
Формат и структура CSV
Описание столбцов фасетного фида
Столбцы фида
| Столбец | Обязательность | Описание |
|---|---|---|
| header | обязателен | Первая строка CSV, содержит названия столбцов. |
| categoryId | обязателен | Идентификатор категории, к которой принадлежит атрибут; должен совпадать с категорией в глобальном XML‑фиде. |
| attribute | обязателен | Название атрибута, который передаётся в глобальном XML‑фиде; определяет название фильтра на фронте. |
| type | обязателен | Параметр, определяющий вид фильтра на фронте. |
| unit | обязателен при type=SLIDER | Единицы измерения; обязателен при type=SLIDER. |
| order | необязателен | Порядок отображения фильтров в выдаче. |
Типы фильтров (type)
Доступные виды отображения фильтров на фронте
☑️
DISTINCT
Список значений в виде чек-боксов; при большом количестве значений появляется область прокрутки.
✅
BOOLEAN
Фильтр из одного чекбокса для значений «да» или «нет».
Важно для типа SLIDER
Для корректного отображения фильтра типа SLIDER все значения соответствующих параметров в глобальном YML‑фиде должны быть приведены к единому формату.
✅ Верно — единый формат и единицы
<param name=«Длина»>590 unit="мм"</param> <param name=«Высота»>1250 unit="мм"</param> <param name=«Глубина»>650 unit="мм"</param>
❌ Неверно — смешаны формат и единицы
<param name=«Длина»>590 мм</param> <param name=«Высота»>1250 unit="см"</param> <param name=«Глубина»>650 unit="мм"</param>
Порядок отображения
Управление порядком фильтров в выдаче
order — порядок фильтров в выдаче. Параметр необязателен; при его отсутствии фильтр принимает порядковое значение строки в файле для соответствующей категории.
Примеры фидов
Корректный и некорректный варианты
Пример хорошего фида
csv
categoryId;attribute;type 400101;Высота;DISTINCT 400101;Ширина;DISTINCT 400101;Длинна;DISTINCT
Пример плохого фида
Фид не встанет, потому что есть столбец
order — но он пустой. Нужно либо заполнить, либо удалить его из первой строки.
csv
categoryId;attribute;type;order ← столбец объявлен, но значения не переданы 400101;Высота;DISTINCT 400101;Ширина;DISTINCT 400101;Длинна;DISTINCT
Важное замечание
Условие отображения фильтров на фронте
Фильтры на фронте отображаются только при полном совпадении и наличии соответствующих атрибутов в глобальном XML‑фиде и фасетном CSV‑фиде.
Если атрибут присутствует в фасетном фиде, но отсутствует в глобальном YML‑фиде, он не будет отображаться.