Разработка модуля интеграции с маркетплейсами 1С-Битрикс

Разработка модуля интеграции с маркетплейсами для 1С-Битрикс начинается с задачи: синхронизировать каталог на 50 000 товаров с Ozon и Wildberries. Кажется, что это несколько строк кода, но на практике — десятки edge-кейсов: маркетплейс меняет API без предупреждения, товары отклоняются из-за несоответствия атрибутов, остатки расходятся из-за гонки состояний между складами. Потеря заказов, штрафы за расхождение остатков, ручная сверка каждое утро — вот цена ошибки.

Средний проект включает 3-5 маркетплейсов, 50 000+ товаров и 1000+ заказов в сутки. Без системы очередей и грамотного маппинга атрибутов интеграция развалится под нагрузкой. Мы построили модуль, который выдерживает пиковые нагрузки и не теряет данные. Опыт работы с 1С-Битрикс — более 10 лет, выполнено свыше 50 интеграций с маркетплейсами.

Как разработать модуль интеграции с маркетплейсами для 1С-Битрикс?

Стандартный модуль интеграции для 1С-Битрикс работает в рамках системы модулей (/bitrix/modules/). Он регистрируется через RegisterModule(), добавляет агентов через CAgent::AddAgent() и вешает обработчики на события инфоблоков (OnAfterIBlockElementAdd, OnAfterIBlockElementUpdate, OnAfterIBlockElementDelete). Документация 1С-Битрикс по созданию модулей рекомендует именно этот подход.

Минимальный набор функций: выгрузка товаров (маппинг полей инфоблока на схему маркетплейса, загрузка изображений, передача характеристик), синхронизация остатков (обновление CATALOG_QUANTITY), получение заказов (создание заказов в b_sale_order) и обработка статусов (двусторонняя синхронизация).

Почему очередь обязательна? — разработка модуля интеграции

Прямой вызов API маркетплейса из обработчика события — антипаттерн. Ozon допускает не более 10 RPS, WB — 1 запрос/секунду на /api/v3/orders. Если товаров 5000+, массовое редактирование в админке создаст шквал запросов и вернёт 429.

Правильная схема:

• Событие Битрикс → запись задачи в очередь (HL-блок или отдельная таблица)
• Агент каждые N минут → читает очередь пачками → вызывает API маркетплейса
• Результат → лог + обновление статуса задачи в очереди

Очередь — это единственный способ гарантировать, что вы не превысите лимиты API. В одном из проектов с каталогом в 200 000 товаров стандартный подход (прямые запросы из обработчиков) приводил к 429-м ошибкам каждые 5 минут. После внедрения очереди на HL-блоке нагрузка на API маркетплейса снизилась в 3 раза, а время синхронизации — с 4 часов до 20 минут.

Маппинг атрибутов — самое трудоёмкое место

У каждого маркетплейса своя система категорий и обязательных атрибутов. Для Ozon нужно получить список атрибутов через /v3/category/attribute, для WB — /content/v2/object/charcs/{subjectId}. В модуле реализуется административный интерфейс, где задаются:

• Соответствие категорий (разделы инфоблока ↔ ID категории маркетплейса)
• Маппинг свойств (UF_* или PROPERTY_* ↔ attribute_id)
• Маппинг складов (CATALOG_STORE ↔ warehouse_id)
• Правила трансформации значений (например, числовые характеристики WB передаются как строки)

Сертифицированные специалисты 1С-Битрикс с многолетним опытом настраивают маппинг так, чтобы ни один товар не был отклонён из-за неверного формата.

Торговые предложения и вариативные товары

WB и Ozon по-разному работают с вариативностью. WB использует массив размеров sizes[], Ozon — color_image. В Битрикс ТП хранятся в дочернем инфоблоке. При выгрузке получаем все ТП через CCatalogSKU::GetOffersList() и собираем структуру под формат маркетплейса. При обновлении остатков обновляем каждый SKU отдельно.

Получение и обработка заказов

Заказы приходят через polling (агент) или webhook. При создании заказа в Битрикс:

• Покупатель создаётся как анонимный или привязывается по email.
• Способ доставки и оплаты должны быть заведены в системе (b_sale_delivery_service, b_sale_pay_system).
• Артикул маркетплейса должен совпадать с CATALOG_ARTICLE или XML_ID элемента инфоблока.
• Внешний ID заказа сохраняется в b_sale_order_props для обратной синхронизации.

Обработка ошибок и мониторинг

Модуль без логирования — чёрный ящик. Минимальный лог пишется в b_event_log. Для production — собственная таблица с полями: уровень, маркетплейс, действие, HTTP-код, тело ответа (truncate до 4KB). Отдельный агент раз в час повторяет задачи с ATTEMPTS < 3, алертит неудачные через CEvent::Send() или Telegram.

Что входит в работу?

При заказе разработки модуля интеграции вы получаете:

• Архитектурная документация с описанием всех сущностей и потоков данных.
• Настройка модуля в боевой среде (доступы, конфигурация, тестовый запуск).
• Обучение администраторов (2 часа, возможен удалённый формат).
• Гарантийная поддержка 2 месяца (исправление ошибок, консультации).
• Исходный код модуля, переданный вам в собственность.

Почему наш модуль надёжнее стандартных решений?

Используем очередь как единственную точку входа для всех API-вызовов. Это гарантирует соблюдение rate limits, повтор при временных ошибках и полный лог. Модуль не сломается при скачке нагрузки — проверено на каталогах с 500 000 товаров. Все интеграции выполняются на лицензионном ПО, с соблюдением стандартов безопасности.

Этапы разработки модуля интеграции

1. Аудит текущей системы и требований.
2. Проектирование архитектуры модуля с учётом нагрузки.
3. Разработка адаптеров для каждого маркетплейса.
4. Реализация UI маппинга атрибутов и категорий.
5. Настройка очередей и агентов.
6. Интеграционное тестирование в sandbox (где доступен).
7. Документация по эксплуатации и обучение администраторов.
8. Гарантийная поддержка 2 месяца.

Сроки разработки

Сроки указаны для разработки с нуля. При использовании готового ядра очереди и переиспользовании адаптеров — сокращение на 25–30%.

Тестирование и приёмка

Каждый адаптер должен иметь unit-тесты для маппинга и интеграционные тесты с sandbox-окружением (Ozon и Яндекс Маркет предоставляют sandbox, WB — тестирование через бой с тестовыми артикулами). Перед релизом проверяем сценарии: массовое обновление цен (500+ позиций), приход 50+ заказов одновременно, обнуление остатков.

Свяжитесь с нами для предварительной оценки вашего проекта — это бесплатно. Мы проанализируем архитектуру и предложим оптимальное решение.

Получите консультацию по архитектуре интеграции — обсудим детали и сроки.

Разработка маркетплейсов на 1С-Битрикс: как преодолеть ограничения стандартной архитектуры

Таблица b_sale_order и связанные с ней b_sale_basket не рассчитаны на мультивендорность из коробки. В Битриксе нет штатного модуля «маркетплейс» — каждый раз это кастомная разработка поверх модуля sale. Стандартный модуль sale не умеет разделять заказ по разным поставщикам: если в корзине товары от трёх продавцов, Битрикс создаст один заказ с единым номером, статусом и общей суммой. Невозможно отправить каждый субзаказ в отдельный личный кабинет, рассчитать комиссию для каждого продавца или разрешить им частичную отгрузку. Нам приходится переопределять всю логику: от корзины до статусной модели. Дополнительно стандартный поиск (Sphinx) и кэширование не оптимизированы под мультивендорный каталог — при 100 000 товаров от 500 поставщиков фильтры по поставщику приводят к падению производительности (запросы с WHERE по IBLOCK_ELEMENT_PROPERTY становятся медленнее в 5–10 раз). Мы пишем отдельный модуль, который расширяет стандартную корзину: добавляет привязку товара к поставщику через свойство заказа, разбивает один заказ на субзаказы по продавцам и маршрутизирует каждый отдельно.

Почему стандартные решения не подходят для мультивендорных площадок?

Модели маркетплейсов

Классический маркетплейс — оператор не держит склад. Вся товарная логика лежит на продавцах, площадка занимается трафиком и платёжным шлюзом. Технически это отдельный инфоблок поставщиков со связью через UF_VENDOR_ID в highload-инфоблоке каталога.

Гибридная модель — оператор продаёт наравне с внешними поставщиками. Главная боль: ранжирование в каталоге. Если поставщики видят, что карточки площадки всегда выше — уходят. Мы решаем это отдельным компонентом сортировки, где позиция определяется рейтингом, скоростью отгрузки и ценой, без привилегий для «своих».

Маркетплейс услуг — заявки, тендеры, эскроу. Тут вместо b_sale_basket работает кастомная сущность заявки с воркфлоу через бизнес-процессы Битрикс.

B2B-маркетплейс — договоры, акты сверки, кредитные линии, EDI. Авторизация по ИНН, мультиценовые группы через b_catalog_group, лимиты отгрузки.

Какие технические проблемы решает разработка маркетплейсов на 1С-Битрикс?

Модели монетизации

Что включает кабинет продавца?

Кабинет — сердце маркетплейса. Неудобный кабинет = пустая площадка. Стандартного решения нет, пишем с нуля на компонентах Битрикс.

• Управление каталогом — CRUD товаров через кастомный компонент, массовая загрузка CSV/XML через CIBlockXMLFile. Вручную вбивать 10 000 SKU никто не станет, поэтому импорт — первое, что делаем.
• Обработка заказов — субзаказы падают в кабинет через ajax-polling или websocket. Подтверждение, печать накладных через CSalePdf, обновление статуса с обратной синхронизацией в основной заказ.
• Финансовая аналитика — дашборд на highload-инфоблоке агрегированных данных. Выручка, комиссии, выплаты — детализация по товарам и периодам. Продавец видит, что продаётся, а что просто занимает витрину.
• Настройки доставки — собственные тарифы продавца, привязка к sale.delivery.handler.
• Коммуникация — встроенный чат без раскрытия контактов. Реализуем через модуль im или кастомную таблицу сообщений.
• Акции — скидки, промокоды через b_sale_discount с фильтром по vendor_id.

Модерация и контроль качества

Одна партия контрафакта убивает репутацию площадки. Поэтому модерация — обязательный слой.

• Модерация товаров — статус ACTIVE='N' до прохождения проверки. Автомодерация отсекает очевидное (запрещённые слова, отсутствие фото), ручная разбирает спорное. Обработчик OnBeforeIBlockElementUpdate не даёт обойти.
• Верификация продавцов — проверка ИНН через API ФНС, загрузка сканов документов. Статусы: новый → проверенный → премиум. Каждый уровень открывает лимиты по количеству товаров и комиссиям.
• Рейтинговая система — не просто звёзды. Алгоритм учитывает скорость отправки (AVG(ship_date - order_date)), процент возвратов, качество ответов на вопросы.
• Антифрод — детектим накрутку рейтингов по паттернам (один IP, одинаковые тексты, аномальная частота). Дублирование аккаунтов ловим по ИНН и банковским реквизитам.
• Типичная ошибка: хранение данных о поставщиках в обычном инфоблоке — при 1000+ продавцов запросы становятся тормозными. Используйте highload-инфоблоки.

Как устроена система выплат продавцам?

Финансовый модуль — то, ради чего продавцы приходят на площадку.

• Расчёт комиссии — обработчик на смену статуса заказа. Комиссия зависит от категории, статуса продавца, текущих условий. Хранится в отдельной таблице vendor_transactions.
• Периодические выплаты — cron-задача формирует реестр: еженедельно, дважды в месяц или ежемесячно. Минимальная сумма выплаты, холдирование до подтверждения получения.
• Акты и отчётность — генерация PDF актов через PhpOffice\PhpSpreadsheet, автоматическая нумерация, скачивание в один клик.
• Холдирование — деньги удерживаются до получения товара. Снижает споры и возвраты.
• Выплаты через банковские API — ЮKassa, CloudPayments, прямые банковские API. Продавец получает деньги без звонков и напоминаний.
• Важно: разделение заказов на уровне обработчика OnSaleOrderSaved приводит к расхождению статусов. Разделяйте на этапе корзины.
• Ручная фискализация каждого субзаказа нарушает 54‑ФЗ. Используйте единый чек с признаком «агент». На одном из проектов автоматизация фискализации сократила издержки на 400 000 руб. ежемесячно. На другом проекте оптимизация поиска через Elasticsearch сократила время загрузки каталога на 80% (с 3 секунд до 0.6 секунды).

Как мы строим архитектуру маркетплейса

1. Определение бизнес-модели — выбираем тип маркетплейса и схему монетизации.
2. Проектирование БД — highload-инфоблоки для каталогов свыше 50 000 SKU, отдельные таблицы для субзаказов (orders_split) и транзакций.
3. Разработка ядра — создаём модуль marketplace.vendor, реализуем привязку товаров к поставщикам, механизм разделения заказов, агенты для расчёта комиссий.
4. Интеграция платёжного шлюза и 54-ФЗ — настраиваем фискализацию через АТОЛ Онлайн или CloudPayments.
5. Тестирование на нагрузку — используем k6 или ab для проверки 5000 заказов в сутки.

Типичные ошибки при разработке маркетплейсов на Битрикс

• Хранение поставщиков в обычном инфоблоке — приводит к тормозам при >1000 записей. Используйте highload-инфоблоки.
• Разделение заказов после сохранения — нарушает статусную модель. Разделяйте на этапе корзины.
• Ручная фискализация каждого субзаказа — нарушает 54-ФЗ. Фискализируйте единым чеком с признаком агента.
• Игнорирование кэширования тегированного для каталога — при мультивендорности кэш сбрасывается целиком. Настраивайте теги по vendor_id.

Технологический стек

• 1С-Битрикс «Бизнес» или «Энтерпрайз» — модуль sale + catalog как фундамент. Мультивендорная обвязка — кастомные модули.
• Highload-инфоблоки — каталоги свыше 100 000 SKU. Обычные инфоблоки при таких объёмах падают на фильтрации: CIBlockElement::GetList с десятком свойств генерирует JOIN-ы на десятки таблиц b_iblock_element_prop_sNN. Highload решает это плоской структурой.
• Elasticsearch — полнотекстовый поиск. Elasticsearch обрабатывает запросы в 10 раз быстрее штатного модуля поиска (Sphinx). Пользователь пишет «кроссовки найки» — находит «Nike кроссовки».
• Очереди — импорт каталогов, расчёт выплат, генерация отчётов. Агенты Битрикс (CAgent) для лёгких задач, отдельная очередь через RabbitMQ или supervisor + кастомный CLI для тяжёлых.

Мы гарантируем, что разработанный модуль выдержит нагрузку до 5000 заказов в сутки на стандартном VPS. Сертифицированные специалисты 1С-Битрикс (опыт более 10 лет, 50+ реализованных проектов) выполняют аудит архитектуры до старта разработки. При масштабе 2000 продавцов среднее время модерации — 15 минут, а 95% заказов обрабатываются автоматически.

Отраслевые маркетплейсы

Каждая ниша — свои грабли:

• Стройматериалы — расчёт доставки крупногабарита. Паллеты, тоннаж, подъём на этаж. Обычный калькулятор доставки не справляется, пишем кастомный sale.delivery.handler.
• Продукты питания — сроки годности в свойствах инфоблока, температурный режим, слоты доставки «день в день». Ошибка в логистике = списание.
• Автозапчасти — подбор по VIN через laximo API, кросс-номера, оригиналы и аналоги. Отдельная headache — разные сроки поставки у разных продавцов на одну деталь.
• Одежда — размерные сетки (EU/US/RU), высокий процент возвратов. Логика обработки возвратов с перераспределением комиссии — отдельный пласт.
• Промоборудование — B2B с тендерами, запросами КП. Карточка товара с 50+ параметрами в табличном виде.

Сроки и этапы

Пытаться запустить всё сразу — надёжный способ не запустить ничего.

MVP за 3-4 месяца. Полнофункциональная платформа — 6-12 месяцев итеративной разработки.

Что входит в работу

• Документация: архитектурная схема, описание API, инструкции для продавцов.
• Доступы: репозиторий с кодом, тестовый стенд, админка.
• Обучение: две сессии для администраторов и менеджеров.
• Поддержка: 1 месяц бесплатного сопровождения после запуска, далее по SLA.
• Гарантия на разработанные модули — 12 месяцев.

Свяжитесь с нами для оценки вашего проекта — рассчитаем сроки и стоимость индивидуально. Закажите консультацию, и мы покажем на реальном кейсе, как решаем проблему мультивендорности за 30 минут. Получите детальный план разработки вашего маркетплейса уже сегодня.