Інтеграція 1С-Бітрікс з Kufar (Білорусь)

Інтеграція 1С-Бітрікс з Kufar (Білорусь)

Kufar — білоруський класифайд, аналог Avito, з розділом для інтернет-магазинів. Для магазинів із товарами в категоріях «Електроніка», «Авто», «Одяг» та «Товари для дому» Kufar дає реальний трафік за оголошеннями. Інтеграція з 1С-Бітрікс дозволяє автоматично публікувати товарні оголошення та оновлювати їх без ручної роботи.

API Kufar для бізнес-акаунтів

Kufar надає XML-фід для масового завантаження оголошень через особистий кабінет партнера. Прямого REST API для публікації оголошень у реальному часі у Kufar немає, на відміну від Avito — вся робота відбувається через фід, який майданчик періодично опитує (зазвичай раз на кілька годин).

Формат фіду Kufar — власний XML-діалект. Основні поля оголошення:

<ad>
  <id>12345</id>
  <title>Смартфон Samsung Galaxy A54 8/256GB</title>
  <description>Опис товару без HTML</description>
  <price>1299</price>
  <currency>BYR</currency>
  <category_id>1113</category_id>
  <condition>new</condition>
  <images>
    <image>https://yourshop.by/img/samsung-a54-1.jpg</image>
  </images>
  <params>
    <param name="Бренд">Samsung</param>
  </params>
</ad>

Важлива деталь: Kufar використовує власні ID категорій (category_id). Список актуальних категорій доступний у документації партнера. Неправильний category_id — оголошення потрапляє не туди.

Генерація фіду в 1С-Бітрікс

Створюємо агент, який формує XML-фід із інфоблоку каталогу. Стандартний модуль експорту 1С-Бітрікс (catalog.export) для Kufar не підходить — формат занадто специфічний. Пишемо власний генератор.

Фільтрація товарів для фіду:

• ACTIVE = Y — лише активні
• QUANTITY > 0 у b_catalog_product — лише в наявності
• Явне виключення товарних категорій, які Kufar не приймає або для яких немає сенсу

Особливість: Kufar обмежує кількість активних оголошень на бізнес-акаунт (залежить від тарифу). Якщо каталог більший за ліміт — потрібна пріоритизація: вивантажуємо топові товари за маржинальністю або оборотністю. Критерій вибору узгоджуємо з клієнтом.

Зображення. Kufar вимагає прямих URL до зображень. Якщо в 1С-Бітрікс використовується зміна розмірів через CFile::ResizeImageGet() з тимчасовими параметрами в URL — такі посилання нестабільні. Краще вказувати оригінальні URL з /upload/.

Описи без HTML

Kufar не приймає HTML-розмітку в описі оголошення. Поле <description> — лише plain text. У 1С-Бітрікс описи товарів часто зберігаються в b_iblock_element у полях DETAIL_TEXT або PREVIEW_TEXT з *_TYPE = html. Потрібна обробка: strip_tags() плюс декодування HTML-сутностей (html_entity_decode()).

Параметри оголошень: маппінг властивостей

Для кожної категорії Kufar є список обов'язкових і рекомендованих параметрів. Наприклад, для смартфонів: обсяг пам'яті, діагональ екрана, тип SIM. Ці параметри беремо з властивостей інфоблоку та маппимо на поля <param> фіду.

Маппінг властивостей: таблиця властивість_інфоблоку_ID → назва_параметра_Kufar. Зберігаємо в налаштуваннях модуля інтеграції або в окремому інфоблоці-довіднику. Без заповнення параметрів оголошення потрапляє в «базовий» лістинг без фільтрації — конверсія нижча.

Оновлення фіду та ротація оголошень

Kufar «опускає» старі оголошення вниз лістингу. Для підтримання видимості частину оголошень потрібно періодично «піднімати» (оновлювати). У рамках фідової інтеграції підняття емулюється зміною поля <price> або <description> — при зміні фіду оголошення вважається оновленим. Це не зловживання: ціни реально змінюються, актуалізація є легітимною.

Орієнтири за термінами

Вартість розраховується індивідуально після аналізу каталогу та тарифних обмежень акаунту Kufar.