Битрикс24 ведёт продажи, сделки и коммуникации, а МойСклад — товары, отгрузки и деньги. Интеграция избавляет от двойного ввода: сделка в CRM превращается в заказ покупателя на складе, а остатки и статусы возвращаются обратно. Важно не путать Битрикс24 с коробочным 1С-Битрикс — это разные продукты с разной моделью данных.
Битрикс24 — это не сайт на 1С-Битрикс
Прежде всего разведём понятия, потому что их постоянно смешивают.
| Продукт | Что это | Модель данных |
|---|---|---|
| 1С-Битрикс (BitrixFramework) | CMS для сайта/магазина | Инфоблоки, каталог, заказы |
| Битрикс24 | CRM и корпоративный портал | Лиды, сделки, товары CRM |
Здесь речь о связке Битрикс24 (CRM) ↔ МойСклад. Обмен строится через REST API Битрикс24 (сущности crm.deal, crm.contact, crm.product) и JSON API 1.2 МойСклад.
Основные сценарии обмена
Что обычно связывают между CRM и складом:
- Сделка → заказ покупателя. Выигранная или подтверждённая сделка Битрикс24 создаёт документ в МойСклад.
- Каталог МойСклад → товары CRM. Номенклатура подтягивается в товарный каталог Битрикс24, чтобы менеджер добавлял позиции в сделку.
- Остатки МойСклад → Битрикс24. Менеджер видит наличие прямо в карточке сделки.
- Статусы отгрузки/оплаты → сделка. Стадия сделки меняется по факту отгрузки и оплаты в учёте.
- Контрагенты. Контакт/компания CRM ↔ контрагент МойСклад.
Не обязательно включать все сценарии сразу. Чаще стартуют с двух — выгрузки каталога и остатков в Битрикс24 и создания заказа покупателя из сделки, — а обратные статусы и синхронизацию контрагентов добавляют вторым этапом. Такой поэтапный запуск снижает риск и упрощает отладку каждого потока по отдельности.
Способы подключения
Есть три пути, различающихся гибкостью и стоимостью.
- Готовое приложение из Битрикс24.Маркет — коннекторы МойСклад с настройкой через интерфейс. Быстро, но с ограничениями по кастомной логике.
- Штатная интеграция в МойСклад — в разделе «Приложения» есть коннектор к Битрикс24.
- Собственное приложение на REST — когда нужны нестандартные поля сделки, своя логика статусов или сложный маппинг товаров.
Обратите внимание и на тарифные ограничения: часть возможностей REST и число доступных вызовов зависят от плана Битрикс24. На бесплатном и младших тарифах некоторые сущности и объёмы обмена ограничены, поэтому под серьёзный поток заказов тариф нужно подбирать заранее, а не упираться в лимиты после запуска.
Порядок настройки связки
Базовый маршрут внедрения:
- Создать в Битрикс24 вебхук с правами
crm, в МойСклад — токен API. - Настроить справочник товаров: решить, мастер каталога — МойСклад, и подтянуть номенклатуру в
crm.product. - Сопоставить стадии сделки Битрикс24 со статусами документа МойСклад.
- Настроить правило создания заказа покупателя (на какой стадии сделки).
- Включить обратный поток остатков и статусов.
- Прогнать тест на одной сделке от создания до отгрузки.
Каталог: где вести номенклатуру
Отдельный вопрос — где хранится «правда» о товарах. У Битрикс24 есть собственный каталог товаров CRM (crm.product), и он ограничен по сравнению с полноценным складским учётом.
- Мастером номенклатуры логично оставить МойСклад: там ведутся закупки, себестоимость и характеристики.
- В Битрикс24 подтягивается упрощённая карточка товара, чтобы менеджер собирал сделку и видел цену.
- Категории и единицы измерения сопоставляются один раз при первичной загрузке.
Сопоставление и идемпотентность
Как и в любой связке, критично хранить идентификаторы и не плодить дубли.
- ID документа МойСклад сохраняйте в пользовательском поле сделки (например,
UF_CRM_MS_DOC). - Товары сопоставляйте по артикулу/коду, а не по названию.
- Контрагентов ищите по телефону/email/ИНН перед созданием.
- Используйте
externalCodeв МойСклад, равный ID сделки, как дополнительный ключ.
batch-метод и с паузами.Обратный поток: остатки и статусы
Ценность связки для менеджера — видеть в CRM актуальные остатки и автоматические стадии.
| Событие МойСклад | Действие в Битрикс24 |
|---|---|
| Изменился остаток | Обновить наличие в карточке товара/сделки |
| Создана отгрузка | Перевести сделку на стадию «Отгружено» |
| Проведён платёж | Отметить оплату, перевести стадию |
Обратный поток реализуют вебхуками МойСклад на изменение сущностей плюс периодической сверкой — чтобы не потерять события при сбое.
Итог
Связка Битрикс24 ↔ МойСклад автоматизирует путь «сделка → заказ покупателя → отгрузка → обратные статусы» и показывает менеджеру остатки прямо в CRM. Готовые приложения подходят для типовых процессов, а нестандартные поля и логику стадий надёжнее закрывать собственным приложением на REST с хранением ID и защитой от дублей. Главное — не смешивать Битрикс24 (CRM) и 1С-Битрикс (CMS сайта): у них разные механизмы обмена.
Мы в B2Bsite настраиваем интеграцию Битрикс24 с МойСклад под ваши процессы продаж: сопоставляем стадии и справочники, реализуем двусторонний обмен и обратные статусы, закрываем идемпотентность и лимиты API.
Частые вопросы
Чем Битрикс24 отличается от 1С-Битрикс в контексте интеграции?
Битрикс24 — это CRM и портал со своим REST API и сущностями (сделки, контакты, товары CRM). 1С-Битрикс — CMS сайта с инфоблоками и заказами. Механизмы обмена у них разные, их нельзя путать.
На какой стадии сделки создавать заказ в МойСклад?
Обычно при переходе на подтверждающую стадию (например, «Счёт оплачен» или «В работе»), а не при создании сделки. Так в учёт не попадают несостоявшиеся сделки.
Как менеджеру видеть остатки в Битрикс24?
Обратным потоком из МойСклад: остатки обновляются в карточке товара CRM или выводятся в поле сделки через вебхуки и периодическую сверку.
Как избежать дублей документов?
Хранить ID документа МойСклад в пользовательском поле сделки и проверять его перед созданием, а также использовать externalCode, равный ID сделки.
Готовое приложение или своя разработка?
Для типовых процессов подходит приложение из Битрикс24.Маркет. При нестандартных полях, своей логике стадий или сложном маппинге товаров надёжнее собственное приложение на REST.
Есть ли ограничения по запросам API?
Да, у Битрикс24 REST есть лимит запросов в секунду и дневные ограничения на ряде тарифов. Массовые операции выполняют через batch-метод с паузами.
Как сопоставляются товары?
По артикулу или коду номенклатуры, а не по названию. Мастером каталога обычно выступает МойСклад, откуда товары подтягиваются в каталог Битрикс24.
Поможем с настройкой и поддержкой Интеграции и связки систем
Поможем с настройкой, доработкой и поддержкой Интеграции и связки систем.