Интеграция 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 успешных интеграций с классифайдами. Гарантируем стабильную работу фида и своевременную поддержку.