Разработка приложений для маркетплейса Битрикс24

Представьте: вы разработали приложение для Битрикс24, прошли модерацию, опубликовали в маркетплейсе. Через неделю приходят жалобы — у половины клиентов не работает синхронизация, приложение выдаёт 403 на crm.deal.list. Оказывается, тариф «Базовый» не даёт прав на CRM, а вы не предусмотрели проверку. Или webhook перестал отвечать — обработчик отвязался, данные потеряны. Такие ситуации — следствие типовых ошибок, которых можно избежать на этапе архитектуры. Проблема в том, что типовые шаблоны и unchecked errors — главная причина отказов при модерации и потери клиентов. Мы за 5 лет реализовали более 50 приложений для маркетплейса Битрикс24 — от простых виджетов до multi-tenant решений. И знаем, как сделать стабильный продукт, который не подведёт клиентов. Мы специализируемся на проектировании устойчивых приложений, которые проходят модерацию с первого раза. Наш опыт позволяет избежать ловушек, связанных с тарифными ограничениями и обработкой ошибок. Стоимость разработки индивидуальна, но инвестиции окупаются за счёт экономии на поддержке и повторных доработках. Закажите консультацию — мы покажем, как снизить затраты на 20% за счёт продуманной архитектуры.

Какие типы приложений существуют?

Встраиваемые приложения (embed) работают в iframe через placement API. Точки: CRM_LEAD_DETAIL_TAB, TASKS_TASK_VIEW_TAB, CALL_LIST и десятки других. Виджеты встраиваются через BX24.placement.call() для небольших действий: кнопка в карточке, панель в чате. Приложения с собственным интерфейсом открываются в отдельной вкладке, больше свободы UX, но пользователь выходит из контекста. Боты и чат-приложения используют imbot.* и imsetting.* методы, имеют собственный обработчик.

Сравнение типов:

Как работает OAuth 2.0 в приложениях?

Авторизация строится на OAuth 2.0 с кодом авторизации. Флоу:

1. Пользователь устанавливает приложение → редирект на redirect_uri с code.
2. Приложение обменивает code на access_token и refresh_token через https://oauth.bitrix.info/oauth/token/.
3. Access_token живёт 1 час, refresh_token — 180 дней.
4. Токены хранятся в вашей БД, привязанные к member_id.

Для server-to-server используйте grant_type=client_credentials — доступно для приложений типа «Приложение». member_id критичен: все данные в БД партиционируются по нему, иначе данные одной компании попадут к другой.

REST API: работа с данными

Битрикс24 REST API — не классический REST. Методы вызываются POST на https://{portal}.bitrix24.ru/rest/{method} с form-data или JSON. Пагинация через start, лимит 50 записей. Для получения всех — цикл с next.

Популярные группы:

• crm.lead., crm.deal., crm.contact., crm.company. — CRM
• tasks.task.*, task.item.list — задачи
• disk.folder., disk.file. — файлы
• im.message.add, imbot.message.add — сообщения
• user.get, user.search — пользователи
• placement.bind — регистрация точек встраивания

Батчинг: отправляйте до 50 запросов через batch. Батчинг в 50 раз быстрее последовательных запросов.

POST /rest/batch
{
  "halt": 0,
  "cmd": {
    "get_deal": "crm.deal.get?id=123",
    "get_contact": "crm.contact.get?id=456",
    "get_company": "crm.company.get?id=789"
  }
}

Как обрабатывать webhook'и без потери данных?

Подпишитесь на события через event.bind. При наступлении события Битрикс24 делает POST на handler URL. Важные детали:

• Handler должен отвечать за 5 секунд.
• После 3 неуспешных доставок — обработчик отвязывается.
• Для тяжёлой обработки используйте очередь: примите webhook, положите в очередь, ответьте 200, обработайте асинхронно.

Доступные события: ONCRMLEADADD, ONCRMDEALUPDATE, ONTASKUPDATE, ONIMMESSAGECHAT, ONUSERADD и сотни других.

Размещение (placements)

Регистрация placement производится при установке через placement.bind. Привязывается к точке интерфейса и передаёт контекст: ID сущности, тип, права пользователя.

BX24.placement.getInterface(function(data) {
    console.log(data);
});

Подключите //api.bitrix24.com/api/v1/ и вызовите BX24.init() перед обращением к API. В iframe используйте localStorage или postMessage.

Как обойти тарифные ограничения?

REST-методы доступны не на всех тарифах. crm.* — с определённых планов, telephony.* — с телефонией, tasks.* — с модулем «Задачи». При установке проверяйте доступность через app.info и profile. Явно сообщайте пользователю, если функциональность недоступна. Не допускайте необработанных 403.

Хранение данных приложения

Битрикс24 предоставляет key-value хранилище app.option.set/get (лимит ~32KB). Для серьёзных данных нужна собственная БД. Для пользовательских настроек — user.option.set/get на стороне портала.

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

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

• Анализ требований и проектирование архитектуры
• Настройка CI/CD и развёртывание на вашем сервере
• Документация REST API и описание интеграции
• Обучение администраторов портала
• Месячная поддержка после релиза

Инфраструктура приложения

Приложение должно быть доступно по HTTPS с валидным сертификатом. Для production: отдельный домен, горизонтальное масштабирование (токены в Redis/БД), мониторинг webhook-обработчиков. Логируйте все вызовы REST API, входящие webhook'и и OAuth-обмены. Правильная архитектура экономит до 40% времени на поддержку.

Подробнее о OAuth: Wikipedia.

Свяжитесь с нами для консультации по вашему проекту. Получите предварительную оценку сроков и стоимости.

Разработка маркетплейсов на 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 минут. Получите детальный план разработки вашего маркетплейса уже сегодня.