Інтеграція 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.