Інтеграція 1С-Бітрікс з Kufar (Білорусь)
Ми стикалися з ситуацією: магазин витрачає години на ручне додавання оголошень на Kufar, а конкуренти вже давно автоматизували вигрузку. У підсумку товари з'являються із запізненням, частина взагалі не публікується через помилки в описі. Беремо на себе повне налаштування інтеграції під ключ — від XML-фіду до маппінгу категорій та автооновлення.
Kufar — білоруський класифайд з відділом для інтернет-магазинів. Категорії «Електроніка», «Авто», «Одяг» та «Товари для дому» дають реальний трафік. Наша інтеграція з 1С-Бітрікс дозволяє публікувати та оновлювати оголошення автоматично, без рутини.
Чому Kufar не використовує REST API для публікації?
На відміну від Avito, Kufar не надає прямого REST API для миттєвої публікації. Вся масова загрузка йде через XML-фід — партнерський кабінет періодично опитує ваш фід (зазвичай раз на кілька годин). Це накладає обмеження: оголошення не з'являється моментально, але дає стабільність при великих обсягах.
Формат фіду — власний 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-фід з інфоблоку каталогу. Стандартний модуль експорту Бітрікс (catalog.export) для Kufar не підходить — формат занадто специфічний. Пишемо власний генератор.
Фільтрація товарів для фіду:
-
ACTIVE = Y— тільки активні -
QUANTITY > 0вb_catalog_product— тільки в наявності - Явне виключення товарних категорій, які Kufar не приймає або для яких немає сенсу
Особливість: Kufar обмежує кількість активних оголошень на бізнес-акаунт (залежить від тарифу). Якщо каталог більше ліміту — потрібна пріоритизація: вигружаємо топові товари за маржинальністю або оборотністю. Критерій вибору узгоджуємо з клієнтом.
Зображення. Kufar вимагає прямих URL до зображень. Якщо в Бітрікс використовується зміна розмірів через CFile::ResizeImageGet() з тимчасовими параметрами в URL — такі посилання нестабільні. Краще вказувати оригінальні URL з /upload/.
Описи без HTML
Kufar не приймає HTML-розмітку в описі оголошення. Поле <description> — тільки plain text. В Бітрікс описи товарів часто зберігаються в b_iblock_element в полях DETAIL_TEXT або PREVIEW_TEXT з *_TYPE = html. Потрібна обробка: strip_tags() плюс декодування HTML-сутностей (html_entity_decode()).
Параметри оголошень: маппінг властивостей
Для кожної категорії Kufar має список обов'язкових та рекомендованих параметрів. Наприклад, для смартфонів: об'єм пам'яті, діагональ екрану, тип SIM. Ці параметри беремо з властивостей інфоблоку та маппінгуємо на поля <param> фіду.
Маппінг властивостей: таблиця властивість_інфоблоку_ID → назва_параметра_Kufar. Зберігаємо в налаштуваннях модуля інтеграції або в окремому інфоблоці-довіднику. Без заповнення параметрів оголошення потрапляє в «базовий» лістинг без фільтрації — конверсія нижча.
Оновлення фіду та ротація оголошень
Kufar «опускає» старі оголошення вниз лістингу. Для підтримки видимості частину оголошень потрібно періодично «піднімати» (оновлювати). В рамках фідової інтеграції підняття емулюється зміною поля <price> або <description> — при зміні фіду оголошення вважається оновленим. Це не зловживання: ціни реально змінюються, актуалізація легітимна.
Що входить в роботу
| Етап | Результат |
|---|---|
| Аналіз каталогу | Визначаємо обсяг, ліміти Kufar, пріоритетні категорії |
| Розробка генератора фіду | Агент Бітрікс, фільтри, обробка зображень та описів |
| Маппінг категорій та параметрів | Відповідність ID Kufar та властивостей інфоблоку |
| Тестування | Публікація тестових оголошень, коригування |
| Документація та навчання | Інструкція для менеджера, регламент оновлення |
| Підтримка | 1 місяць супроводу після запуску |
Як уникнути типових помилок при інтеграції?
- Невірний
category_id— звіряйтеся з довідником Kufar. - Зображення з тимчасовими URL — використовуйте оригінальні шляхи до файлів.
- HTML в описі — обов'язково видаляйте розмітку.
- Перевищення ліміту оголошень — налаштуйте пріоритизацію.
Детальніше про ліміти Kufar
Ліміт активних оголошень залежить від тарифу бізнес-акаунта. Уточнити можна в особистому кабінеті або у менеджера майданчика. При перевищенні ліміту нові оголошення не публікуються, старі не оновлюються.Орієнтири за термінами
| Задача | Термін |
|---|---|
| Налаштування XML-фіду для Kufar | 3–7 днів |
| + маппінг параметрів для 3–5 категорій | 1–2 тижні |
| Повне налаштування з пріоритизацією та автооновленням | 2–3 тижні |
Вартість розраховується індивідуально після аналізу каталогу та тарифних обмежень акаунта Kufar. Оцінимо проект безкоштовно — просто зв'яжіться з нами, і ми підготуємо рішення під ваші завдання. Сертифіковані спеціалісти 1С-Бітрікс, досвід 10+ років, понад 100 успішних інтеграцій з класифайдами. Гарантуємо стабільну роботу фіду та своєчасну підтримку.