Интеграция 1С-Битрикс с Avito: XML-фид, API и автоматизация

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

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

Наш опыт показывает, что грамотно настроенная интеграция окупается в течение первых месяцев за счёт автоматизации рутинных операций. Мы гарантируем корректную работу с категорийными полями и соблюдение всех требований 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 привязывает объявление к адресу. Адрес в фиде должен точно соответствовать одному из адресов, указанных в профиле продавца. Расхождение — причина отклонения объявления.

Как настроить XML-фид для Avito без ошибок?

При настройке фида важно предусмотреть маппинг категорий и полей для каждой товарной группы. Если ваш каталог содержит 2000 товаров, а в среднем на модерацию уходит 2 часа, ручная обработка становится невозможной. Мы автоматизируем этот процесс через кастомные таблицы соответствий.

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 часа. Частые причины отклонения: дубликаты (одинаковые фото или описание), запрещённые товары, несоответствие категории, спамное описание.

Что входит в работу по интеграции?

• Аудит текущей структуры каталога и торговых предложений в 1С-Битрикс.
• Разработка модуля генерации XML-фида с маппингом категорий и полей.
• Настройка выгрузки изображений и обработка ошибок.
• Подключение Avito API для мониторинга и автоматизации (опционально).
• Тестирование фида на тестовом аккаунте Avito, исправление замечаний.
• Документирование процесса и обучение сотрудников.
• Поддержка после запуска в течение 1 месяца.

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

Если вам нужна интеграция 1С-Битрикс с Avito под ключ, свяжитесь с нами — мы оценим ваш проект и подготовим коммерческое предложение. В работе используем сертифицированные решения и гарантируем соблюдение всех требований Avito.