Интеграция 1С-Битрикс с маркетплейсами
Типичная ситуация: менеджер руками обновляет остатки на Ozon, параллельно Wildberries продаёт товар, которого уже нет на складе. Покупатель оформляет заказ — получает отмену. Рейтинг продавца падает, площадка режет показы. Знакомо? Решается это одним способом — программной интеграцией Битрикса с маркетплейсами через API, когда остатки, цены и заказы синхронизируются автоматически из единой админки.
Зачем подключать маркетплейсы
Маркетплейсы — готовый трафик. Миллионы покупателей с картой в руке.
- Каналы продаж — трафик, который один интернет-магазин не соберёт. Более половины онлайн-покупок проходят через площадки.
- Экономия на привлечении — площадка берёт трафик на себя. Вам остаётся ассортимент и цены.
- Единое управление — товары, остатки, заказы из всех каналов в Битриксе. Никакого ручного ввода.
- Сквозная аналитика — маржинальность по каждому каналу. Решения на цифрах, не на интуиции.
Какие маркетплейсы подключаем
Ozon — Seller API v3. Создание карточек (/v3/product/import), обновление цен (/v1/product/import/prices), остатки (/v2/products/stocks), заказы FBO/FBS (/v3/posting/fbs/list), возвраты. Настраиваем автогенерацию штрихкодов и этикеток через label/task.
Wildberries — API поставщика. Выгрузка номенклатуры с характеристиками по категориям (/content/v2/cards/upload), баркоды, синхронизация остатков на складах WB (/api/v3/stocks), обработка заказов и поставок, медиаконтент. Частая проблема — остатки расходятся между сайтом и WB, покупатель оформляет заказ на несуществующий товар. Решаем синхронизацией каждые 15 минут через агент Битрикс.
Яндекс.Маркет — Partner API. Каталог через фид или push-модель, цены, остатки, заказы DBS/FBS/FBY (/campaigns/{campaignId}/orders), интеграция с Яндекс.Доставкой.
СберМегаМаркет — Merchant API. Товары, офферы, заказы, синхронизация статусов.
Другие — AliExpress Россия, Авито, отраслевые площадки (Lamoda, Leroy Merlin).
Механизмы интеграции
Прямая интеграция через API — самый надёжный путь. Разрабатываем кастомный модуль Битрикс, который напрямую дёргает эндпоинты площадки. Полный контроль: если маркетплейс ломает обратную совместимость (а WB делает это регулярно) — обновляем модуль сами, не ждём третью сторону. Каждый запрос логируется в b_event_log, ретраи на 429/500 — автоматические.
Агрегаторы — RetailCRM, МойСклад, ApiShip. Унифицируют обмен с несколькими площадками. Быстрый старт, но чёрный ящик: когда что-то ломается, дебажить через чужой слой — удовольствие сомнительное. Подходит при ограниченном бюджете.
Фиды (YML/XML) — выгрузка каталога в формате Яндекс.Маркет (YML), Google Merchant (XML). Генерация настраивается через модуль catalog.export или кастомный обработчик на CIBlockXMLFile. Классика, работает для начального уровня интеграции.
Выгрузка товаров и синхронизация
Выгрузка — не «нажал кнопку». За ней серьёзная подготовительная работа.
-
Маппинг категорий — сопоставление разделов инфоблока Битрикс с деревом категорий площадки. У Ozon своя таксономия (
/v1/description-category/tree), у WB — своя. Обязательные атрибуты различаются. -
Маппинг свойств — свойства инфоблока (
PROPERTY_*) → характеристики маркетплейса. Конвертация единиц, форматов — автоматически через таблицу соответствий в highload-инфоблоке. - Обогащение карточек — rich-контент для Ozon, видеообзоры для WB, 360-фото. Площадки ранжируют по заполненности: между «голой» и проработанной карточкой разница в продажах двукратная.
-
Изображения — автоматическая генерация в нужных разрешениях через
CFile::ResizeImageGet().
Синхронизация — по расписанию через агенты CAgent::AddAgent():
| Данные | Частота | Направление |
|---|---|---|
| Остатки | 15-30 мин | Битрикс → Маркетплейс |
| Цены | 30-60 мин | Битрикс → Маркетплейс |
| Заказы | 5-10 мин | Маркетплейс → Битрикс |
| Статусы | Реалтайм (webhook) | Двусторонний |
| Карточки | По изменению | Битрикс → Маркетплейс |
Обработка заказов
Заказы с площадок падают в b_sale_order автоматически и обрабатываются в едином потоке.
-
Создание — заказ приходит со всеми реквизитами. Модуль парсит ответ API, создаёт заказ через
\Bitrix\Sale\Order::create(), привязывает к типу плательщика и платёжной системе маркетплейса. -
Единый поток — менеджеры работают с заказами из всех каналов в одном интерфейсе. Источник заказа виден в свойстве
ORDER_PROP. -
Синхронизация статусов — собрали, отгрузили, доставили — статус обновляется на маркетплейсе через callback. Обработчик
OnSaleStatusOrder. - Возвраты — отмена на маркетплейсе создаёт возврат в Битрикс. Остатки возвращаются на склад автоматически.
-
Передача в 1С — заказы уходят в 1С:Предприятие через штатный обмен
CommerceML. Один источник правды.
Мониторинг
Мультиканальная торговля без мониторинга — хаос с нарастающей энтропией.
- Контроль остатков — оповещения при расхождениях между Битрикс, маркетплейсом и 1С. Товар с нулевым остатком блокируется автоматически — нельзя продать то, чего нет. Проверка через cron каждые 10 минут.
-
Логирование и ретраи — каждый запрос к API логируется в
b_event_logс телом запроса и ответа. Сбой? Автоповтор с экспоненциальным backoff. Критическая ошибка? Уведомление в Telegram-бот админа. -
Ценообразование — автоматический расчёт с учётом комиссий площадки, логистики и целевой маржи. Формула в настройках модуля:
price = base_price / (1 - commission) + logistics. - Аналитика — дашборд: выручка, заказы, средний чек, возвраты, маржинальность по каждому маркетплейсу отдельно.
Подход к интеграции
- Аудит — смотрим каталог Битрикс, структуру инфоблоков, существующие обмены с 1С. Определяем готовность данных. Бывает, 80% работы — привести карточки в порядок: заполнить обязательные свойства, унифицировать единицы измерения.
- Стратегия — приоритетные площадки, модель (FBO/FBS/DBS), глубина интеграции.
- Разработка модулей — маппинг, валидация, обработка ошибок. Покрываем unit-тестами критичные сценарии: разбиение заказа, пересчёт остатков при частичной отмене.
- Тестирование — выгрузка тестовых товаров, эмуляция заказов через sandbox API площадок, пограничные случаи (нулевой остаток, товар без фото, цена ниже минимальной).
- Запуск — последовательно запускаем интеграции, мониторим первые обмены в реалтайме.
- Сопровождение — площадки регулярно обновляют API (WB — без предупреждения). Адаптируемся оперативно.
Сроки
| Задача | Сроки |
|---|---|
| Интеграция с одним маркетплейсом (базовая) | 2-4 недели |
| Интеграция с одним маркетплейсом (расширенная) | 4-6 недель |
| Мультиканальная (3+ площадки) | 6-12 недель |
| Генерация фидов (YML, XML) | 3-5 дней |
| Мониторинг и аналитика | 1-2 недели |
Конкретные сроки зависят от объёма каталога, количества площадок, сложности маппинга и состояния обмена с 1С. Детальную оценку даём после аудита.







