МойСклад: Интеграция с Битрикс24

Что умеет решение

Модуль объединяет CRM Битрикс24 и систему складского учёта МойСклад в единый рабочий контур. Менеджер работает со сделками в интерфейсе CRM, а соответствующие заказы покупателя или поставщика автоматически формируются в МойСкладе с полной детализацией: клиент, номенклатура, цены, скидки и ставки НДС. Любые изменения документов в учётной системе мгновенно отражаются в карточке сделки. Обмен данными происходит без использования файлов, ручных кнопок выгрузки или переноса строк.

Процесс синхронизации модульный и гибкий: каждый контур, направление и поле настраиваются независимо. Внедрение не требует запуска всех функций сразу — можно начать с выгрузки сделок, затем подключить состав заказа, клиентскую базу, справочники и обратную синхронизацию изменений.

Поддерживаемые объекты синхронизации:

Сделки и заказы покупателя МойСклад (двусторонний обмен).

Сделки и заказы поставщику МойСклад (отдельный контур с индивидуальными настройками).

Контакты и компании Битрикс24, а также контрагенты МойСклад (включая юридические лица, ИП и физических лиц).

Реквизиты клиентов: ИНН, КПП, ОГРН, полное наименование, адреса, телефоны, электронная почта и сайты.

Интеграция синхронизирует состав заказа: товарные строки сделки и позиции документов, включая наименование товара, количество, цену, скидку и ставку НДС. Поддерживается полная номенклатура — товары, услуги, комплекты и модификации (торговые предложения) с изображениями и характеристиками. Передаются стадии сделок, статусы документов и контрагентов, а также данные об ответственном менеджере и валюте документа. Настройка включает синхронизацию тегов (групп) контрагентов и произвольных пользовательских полей обеих систем. Доступны справочники сотрудников, валют, единиц измерения и ставок НДС.

Работа модуля построена на событиях без периодического опроса. При сохранении сделки менеджером модуль мгновенно фиксирует событие и ставит задачу в очередь, обеспечивая мгновенное сохранение карточки без ожидания ответа внешнего сервиса. Очередь самостоятельно проверяет соответствие фильтрам, ищет существующую связь, создает или обновляет документ, подтягивает данные клиента и состава товаров, а также фиксирует связь между записями. Обратная синхронизация работает аналогично: при изменении документа или контрагента в МойСклад модуль получает уведомление, помещает его в очередь и обновляет карточку в Битрикс24. Отсутствие планового опроса API исключает задержки и снижает нагрузку на лимиты учетной системы.

При повторной синхронизации модуль сверяет накопленные данные с текущим состоянием и передаёт только изменённые поля. Если изменений нет, запрос на запись не формируется. Состав заказа проверяется построчно: совпадающие позиции остаются без изменений, обновляются лишь те, которые реально были скорректированы.

Настройка без программиста

Конфигурация выполняется через интерфейс модуля с помощью списков и таблиц соответствий, без необходимости редактирования кода.

Сопоставление полей. Любое поле сделки, контакта или компании в Битрикс24 можно связать с любым полем документа или контрагента в МойСклад — стандартным, пользовательским или дополнительным (атрибутом). Для каждой пары задаётся направление синхронизации: в МойСклад, в Битрикс24 или двустороннее.

Значения по умолчанию. Постоянные параметры, такие как организация, счёт, склад или канал продаж, которые не хранятся в CRM, настраиваются отдельным правилом, а не через создание полей в Битрикс24.

Поля поиска связанных записей. Связь между записями устанавливается по существующим в данных полям: внешнему коду, ИНН или номеру договора.

Фильтры обмена. Условия, заданные для полей, определяют, какие сделки передаются в учёт и какие документы принимаются обратно.

Справочники соответствий. Сотрудники, валюты, единицы измерения и ставки НДС сопоставляются через явную таблицу. Это позволяет наглядно видеть связи между данными и понимать причины, по которым значение не было перенесено.

Автоматическое создание полей CRM. Модуль самостоятельно формирует служебные поля, необходимые для интеграции (признак типа документа, тип контрагента, статус, теги), на основе своих настроек. Вмешательство в конструктор полей Битрикс24 не требуется.

Удобная настройка каталога. Инфоблоки, разделы, группы товаров МойСклад и поля связи выбираются из готовых списков, что исключает необходимость ручного ввода идентификаторов.

Изолированные настройки. Все параметры хранятся внутри профиля обмена. Разные профили имеют собственные настройки соответствия, фильтры и поля, которые не влияют друг на друга.

Надёжность: очереди, проверки и обработка ошибок. Интеграция рассчитана на предсказуемые сбои: недоступность сервиса, ограничение частоты запросов API или некорректное заполнение полей.

Очередь обмена. Задачи накапливаются в отдельной очереди для каждого профиля и обрабатываются пакетами. Повторные изменения одной сделки объединяются в одну задачу, что предотвращает создание множества запросов к МойСкладу при множественных правках. При сбое задача не теряется, а повторяется с увеличивающейся задержкой.

Проверка готовности настроек

Перед каждым обменом модуль проверяет корректность конфигурации, чтобы гарантировать успешное нахождение и связывание записей. При недостаточной настройке обмен не запускается, что предотвращает создание дубликатов. Статус синхронизации по двум типам документов, трём категориям контрагентов и четырём справочникам отображается на дашборде.

Защита от дублирования

Перед созданием новой записи система ищет её аналог на противоположной стороне и обновляет существующую. Если поиск не удался из-за сбоя, процесс обмена приостанавливается до повторной попытки. Попытка создать запись без предварительной проверки после ошибки исключена, так как это неизбежно приведёт к появлению дубля.

Защита от циклических обменов

Записи, созданные модулем, не инициируют встречный обмен. События CRM и уведомления МойСклад на такие записи не реагируют.

Управление очередью задач

В интерфейсе отображаются все задачи с указанием направления, типа документа, статуса, количества попыток и полного текста ошибки. Задачу можно выполнить принудительно или удалить без ожидания запланированного времени. Рядом доступна карточка агента: статус активности, время следующего запуска, а также кнопки для переустановки и ручного запуска процесса.

Товары и каталог

Товарная часть является наиболее сложным элементом интеграции. В данном модуле этот раздел детально проработан и описан подробно.

Поиск товаров осуществляется по выбранному полю связи: внешнему коду (XML_ID) или конкретному свойству инфоблока в Битрикс24, а в МойСклад — по внешнему коду или внутреннему идентификатору. Если XML_ID уже занят выгрузкой из 1С или интернет-магазина, модуль переключает связь на другое свойство, не нарушая существующие интеграции. После создания товара код связи записывается обратно, чтобы следующий обмен находил существующий товар, а не создавал дубликат.

Если товар отсутствует во второй системе, модуль создает его автоматически, перенося название, описание, единицу измерения, изображения и характеристики. Связанные сущности формируются иерархически: для модификации сначала создается родительский товар, для комплекта — его компоненты. Свойства торговых предложений (цвет, размер, объем) сопоставляются с характеристиками номенклатуры МойСклад, включая списки, привязки к элементам инфоблока и справочники Highload-блоков.

Благодаря этому механизму обмен заказами можно запустить без предварительной выгрузки всего каталога. Номенклатура заполняется по мере поступления реальных заказов и остается синхронизированной в обеих системах.

Вопросы и ответы

Обмен данными односторонний или двусторонний?

Интеграция двусторонняя с гибкой настройкой направлений синхронизации. Вы можете отдельно управлять потоком данных для каждого типа документов, состава товаров, ответственных лиц, валют, тегов и конкретных пар полей. Например, разрешить передачу ответственного в МойСклад без обратного получения.

Менеджеру не требуется нажимать кнопку «выгрузить». Обмен инициируется автоматически событиями CRM: созданием или изменением сделки, контакта или компании. Интерфейс карточки не содержит кнопок выгрузки, что позволяет работать в привычном режиме без внимания к техническим деталям.

Изменения передаются в МойСклад практически мгновенно. После создания задачи модуль обрабатывает её в фоновом режиме, не ожидая планового запуска агента. Стандартная обработка очереди выполняется раз в минуту. Обновления из МойСклад поступают в виде уведомлений непосредственно в момент редактирования документа.

При недоступности МойСклада или превышении лимитов частоты запросов API задача сохраняется в очереди и повторяется. Система выполняет до трёх попыток с увеличивающимися интервалами между ними. Временные сбои и ограничения лимитов обрабатываются автоматическим повтором. Если авторизация в МойСклад не проходит, очередь приостанавливается, чтобы избежать бесполезных попыток подключения.

Модуль использует механизмы сопоставления для предотвращения создания дубликатов сделок, заказов и контрагентов.

Обмен документами не начнётся, если не настроено хотя бы одно поле поиска связанной записи. Это обязательное требование системы, а не рекомендация.

Можно ли выгружать только часть сделок?

Да. Фильтр позволяет задавать условия по полям: направление, источник, стадия, дата и произвольные пользовательские поля. Доступные операторы сравнения: «равно», «не равно», «больше», «меньше», «содержит», «не содержит». Для импорта документов из МойСклад применяется отдельный набор условий, например, приём только заказов конкретного склада или организации.

Как определяется тип сделки (продажа или закупка)?

Тип определяется по правилу, которое вы задаёте: через пользовательское поле сделки и его значение. Например, если поле «Тип сделки» имеет значение «Закупка», сделка обрабатывается как заказ поставщику. Сделки без указанного признака по умолчанию считаются заказами покупателя. При импорте из МойСклад это поле заполняется автоматически.

Поддерживается ли обмен с индивидуальными предпринимателями и физическими лицами?

Модуль поддерживает три типа контрагентов в МойСкладе: юридические лица, индивидуальные предприниматели и физические лица. Для каждого типа настраивается отдельная привязка к контакту или компании в Битрикс24, выбираются переносимые поля и шаблон реквизитов. Для юрлиц передаются ИНН, КПП и юридический адрес, для физлиц — паспортные данные и контактная информация.

Реквизиты, адреса и телефоны переносятся корректно. В Битрикс24 реквизиты хранятся в отдельной связанной сущности, поэтому модуль находит подходящий шаблон или создает новый, записывая туда данные. Адреса группируются по типам, а телефон, электронная почта и сайт заполняют множественные поля карточки. Из МойСклада в Битрикс24 передаются адреса и множественные значения.

Предварительная выгрузка клиентской базы не требуется. Поскольку заказ в системе невозможен без контрагента, клиентские данные передаются автоматически вместе со сделкой. В учет попадают только те клиенты, по которым сформированы реальные заказы. Полноценный обмен всей базой клиентов настраивается отдельно при необходимости.

Синхронизация стадий сделок и статусов заказов поддерживается.

Сопоставление полей выполняется вручную через таблицу соответствий; автоматическое совпадение по названиям не предусмотрено. При работе со сделками модуль автоматически определяет воронку на основе стадии: без этого механизма Битрикс24 мог бы некорректно изменить стадию, перенеся её в другую воронку. Стадии, не имеющие соответствия, остаются без изменений.

Остатки товаров и прайс-листы не синхронизируются. Модуль передаёт документы, контакты и карточки номенклатуры. Цена и скидка передаются в составе позиции конкретного документа, то есть фиксируется фактическая стоимость заказа, а не актуальная цена из каталога.

Удаление объектов не синхронизируется. Удаление сделки в одной системе не приводит к удалению соответствующего заказа в другой, и наоборот. Это решение продиктовано безопасностью: удаление является необратимой операцией, и её автоматическое дублирование между системами несёт риски потери данных.

Лиды не участвуют в обмене. Синхронизация затрагивает только сделки, контакты и компании.

Причины отсутствия заказа в учёте можно выявить через страницу очереди задач. Там отображаются статус каждой задачи, количество попыток выполнения и полный текст ошибки. Это позволяет диагностировать проблему без анализа серверных логов и обращения в техническую поддержку. В очереди также указываются причины пропуска: срабатывание фильтра, отсутствие необходимых настроек или отсутствие изменений в данных.

Интеграция МойСклад и Битрикс24 использует планировщик агентов (cron) для обработки очереди задач и публичный веб-хук на портале для приема уведомлений от МойСклад. Файл-обработчик уведомлений модуль разворачивает автоматически через свой интерфейс и проверяет доступность адреса реальным запросом, что исключает необходимость доступа к серверу по FTP.

Для работы требуются: коробочная версия Битрикс24 с установленным модулем CRM; модули «Торговый каталог» и «Информационные блоки» для обмена составом заказов и номенклатурой; учетная запись МойСклад, подключаемая через токен доступа или логин с паролем (права определяются учетной записью, выпустившей токен); настроенный планировщик агентов Битрикс24 и публично доступный URL на портале для веб-хуков.

Ограничения функционала:

Модуль не синхронизирует остатки товаров и прайс-листы.

Не переносит удаление записей в любом направлении.

Не обменивает данные о лидах.

Не синхронизирует изменения изображений товаров после их создания.

Не разрешает конфликты редактирования: если одно и то же поле изменено с обеих сторон, приоритет имеет изменение, выполненное последним.

Модуль не определяет автоматически соответствие сотрудников, валют, единиц измерения и ставок НДС. Эти параметры сопоставляются вручную, что обеспечивает предсказуемость процесса.

Настройка начинается с подключения МойСклад через токен или логин с паролем. В интерфейсе модуля создаются служебные поля CRM. Затем активируется необходимый контур обмена — заказы покупателя или заказы поставщику — и указываются поля для поиска связанных записей. Далее выполняется сопоставление полей обмена и, при необходимости, привязка стадий к статусам.

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

General iT поможет установить модуль, настроить его и проверить работу на твоём сайте.