Интеграция 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-фид из инфоблока каталога. Стандартный модуль экспорта Битрикс (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.