Как загрузить каталог

Каталог загружается в разделе Каталог кабинета: файлом JSON, CSV, XLSX или YML. Тот же каталог можно отдавать нам по API, если выгрузка собирается автоматически.

Файл — не единственный путь: каталог умеет приходить из YML-фида, Google Таблицы, МоегоСклада, RetailCRM, 1С или обходом вашего сайта, и тогда он обновляется сам. Сравнение всех восьми способов — в статье Откуда брать каталог. Эта статья про то, что должно быть внутри выгрузки, каким бы способом она ни пришла.

Обязательные поля

• external_id — ваш идентификатор позиции. По нему мы понимаем, что при следующей загрузке это та же карточка, а не новая.
• title — название так, как его видит человек.
• url — адрес карточки на вашем сайте.

Без external_id каждая загрузка создавала бы дубли, поэтому он обязателен.

Поля, которые сильно улучшают ответы

• description — описание словами. Главный источник смысла: из него берутся теги и характеристики.
• price и currency — цена. Без неё нельзя ответить на «до пятидесяти тысяч».
• attrs — характеристики парами «название: значение»: грузоподъёмность, объём, материал, размер.
• city, lat, lon — где находится. Дальние позиции автоматически проигрывают ближним.
• image — картинка для карточки в ответе.

Пример JSON

[
  {
    "external_id": "kran-25",
    "title": "Автокран 25 тонн, стрела 28 м",
    "description": "Монтаж оборудования, подъём материалов на высоту до 9 этажа.",
    "url": "https://example.ru/kran-25",
    "price": 2500,
    "currency": "RUB",
    "city": "Москва",
    "attrs": {"Грузоподъёмность": "25 т", "Длина стрелы": "28 м"}
  }
]

CSV

Первая строка — названия колонок, разделитель — точка с запятой или запятая, кодировка UTF-8. Характеристики в CSV передаются колонками с префиксом attr_: attr_Грузоподъёмность.

Excel: XLSX

Книгу Excel можно загрузить как есть — читаем первый лист. Шапка та же, что у CSV, и названия колонок понимаем русские: «Название», «Цена», «Описание», «Категория», «Ссылка», «Фото», «Артикул». Обязательна только колонка с названием. Старый формат .xls не читается — пересохраните как XLSX или CSV.

Что происходит после загрузки

Каждая позиция размечается: вытаскиваются теги, нормализуются характеристики, считается вектор для поиска по смыслу. На экране видно число загруженных и число проиндексированных позиций — они должны совпасть.

Позиции, которых нет в новой выгрузке, остаются на месте. Чтобы убрать снятое с продажи, загрузите полную выгрузку — режим полной замены в разделе «Каталог».