Интеграция 1С-Битрикс с Avito

Интеграция 1С-Битрикс с Avito

Avito — не классический маркетплейс, а доска объявлений с элементами маркетплейса. Это определяет специфику интеграции: товары загружаются как объявления через XML-фид (Avito Autoload), управление — через личный кабинет или Avito API. Основная сложность — каждая категория Avito имеет собственный набор полей и правила модерации, отличающиеся от любого другого маркетплейса.

Два канала интеграции

1. Avito Autoload (XML-фид). Основной способ массовой загрузки. Продавец размещает XML-файл на своём сервере, указывает URL в настройках Avito: Профессиональные инструменты → Автозагрузка. Avito парсит фид по расписанию (раз в несколько часов).

2. Avito API (https://api.avito.ru/). REST API для управления объявлениями, статистикой, сообщениями. Авторизация — OAuth 2.0 (client_id + client_secret → access_token).

Для интеграции с 1С-Битрикс чаще всего используется комбинация: фид для загрузки каталога + API для мониторинга статусов и автоматизации.

Формат фида Avito Autoload

XML-фид Avito имеет собственную схему, несовместимую с YML:

<Ads formatVersion="3" target="Avito.ru">
  <Ad>
    <Id>уникальный_id</Id>
    <Category>Бытовая электроника</Category>
    <AdType>Товар приобретён на продажу</AdType>
    <Title>Смартфон Samsung Galaxy S24</Title>
    <Description>Текст описания</Description>
    <Price>79990</Price>
    <Images>
      <Image url="https://site.ru/photo1.jpg"/>
      <Image url="https://site.ru/photo2.jpg"/>
    </Images>
    <Address>Москва, ул. Примерная, 1</Address>
    <ContactMethod>По телефону и в сообщениях</ContactMethod>
    <!-- Поля, специфичные для категории -->
    <GoodsType>Телефоны</GoodsType>
    <Brand>Samsung</Brand>
    <Model>Galaxy S24</Model>
  </Ad>
</Ads>

Категорийные поля — главная сложность. Для категории «Бытовая электроника» нужны GoodsType, Brand, Model. Для «Одежда» — Size, Gender, ClothingType. Для «Автозапчасти» — OEMPartNumber, Brand, PartType. Полный список категорий и полей — в документации Avito Autoload.

Генерация фида из инфоблока Битрикс

Стандартного экспортного профиля для Avito в Битрикс нет. Реализация:

Кастомный PHP-скрипт — файл /local/avito_feed.php, вызываемый по cron или доступный по URL. Логика:

1. Получить элементы инфоблока через CIBlockElement::GetList() с фильтром по активности и наличию.
2. Для каждого элемента — определить категорию Avito. Маппинг хранится в отдельном свойстве элемента (PROPERTY_AVITO_CATEGORY) или в таблице соответствий раздел инфоблока → категория Avito.
3. В зависимости от категории — сформировать набор специфичных тегов.
4. Собрать XML и записать в файл.

Маппинг полей:

Проблема с <Id>. Avito идентифицирует объявление по <Id>. Если ID изменится (например, при переиндексации каталога в Битрикс) — Avito создаст новое объявление, а старое удалит. Потеряются просмотры, статистика, отзывы. Используйте артикул или внешний код (XML_ID), а не числовой ID элемента.

Проблема с <Address>. Avito привязывает объявление к адресу. Адрес в фиде должен точно соответствовать одному из адресов, указанных в профиле продавца. Расхождение — причина отклонения объявления.

Avito API: управление и автоматизация

API используется для задач, которые фид не покрывает:

• Получение статистики объявлений. GET /core/v1/items/{item_id}/stats — просмотры, звонки, сообщения. Данные можно сохранять в пользовательское свойство инфоблока для анализа эффективности.
• Управление объявлениями. PUT /core/v1/items/{item_id} — обновление полей без перезагрузки фида.
• Получение сообщений. GET /messenger/v3/accounts/{user_id}/chats — автоматизация ответов или пересылка в CRM Битрикс24.
• Активация/деактивация. Когда товар заканчивается — деактивировать объявление через API быстрее, чем ждать обновления фида.

Работа с торговыми предложениями

Avito не поддерживает варианты товара в рамках одного объявления. Каждый SKU (размер, цвет) — отдельное объявление. Для интернет-магазина с размерной сеткой это означает:

• Футболка S, M, L, XL — 4 объявления в фиде.
• Каждое с уникальным <Id> (например, ARTICLE_SIZE).
• Каждое с указанием размера в названии или описании.

При генерации фида нужно обходить инфоблок торговых предложений и создавать отдельный <Ad> для каждого предложения с ненулевым остатком. Это значительно увеличивает размер фида — для каталога в 1000 товаров с 4 размерами получается 4000 объявлений.

Лимиты и модерация

Avito ограничивает количество объявлений: бесплатный лимит зависит от категории (обычно 1–5 штук), далее — платные пакеты объявлений. Для интернет-магазинов — тариф «Для бизнеса» с увеличенными лимитами.

Модерация каждого объявления — 1–24 часа. Частые причины отклонения: дубликаты (одинаковые фото или описание), запрещённые товары, несоответствие категории, спамное описание.

Сроки интеграции