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

Модуль связывает CRM Битрикс24 и складской учёт МойСклад. Менеджер работает в привычной CRM — а в МойСклад сам появляется заказ покупателя или заказ поставщику с клиентом, товарами и ценами. Кладовщик или бухгалтер меняет документ в МойСклад — изменение возвращается в сделку.

Файлов обмена и кнопок «выгрузить» нет: обмен запускают сами изменения в CRM и уведомления (вебхуки) МойСклад.

🌐 Страница модуля на сайте: despi.ru/modules/despi-moyskladcrm

🔗 Карточка модуля в Маркетплейс 1С-Битрикс: marketplace.1c-bitrix.ru/solutions/despi.moyskladcrm

Модуль предназначен для коробочной версии Битрикс24 с модулем CRM.

Задача

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

• Данные расходятся. В сделке одна сумма, в заказе другая — и где разошлось, видно только глазами.
• Клиенты дублируются. Один и тот же покупатель заводится в МойСклад заново, потому что никто не проверил, есть ли он там.
• Проблемы всплывают поздно. О том, что заказ «не уехал», узнают, когда клиент звонит спросить про отгрузку.

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

Что делает модуль

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

Что синхронизируется

В Битрикс24	В МойСклад	Что переносится
Сделка	Заказ покупателя	Поля, стадия ↔ статус, клиент, товары, ответственный, валюта
Сделка	Заказ поставщику	То же — со своим набором настроек
Оплата сделки	Входящий платёж	Оплата ↔ платёж, «Оплачено» ↔ проведение, поля платежа. Только для заказов покупателя
Контакт или компания	Контрагент: юрлицо, ИП, физлицо	Поля, реквизиты и адреса, статус, группы (теги)
Товары каталога	Товары, услуги, комплекты, модификации	Находятся по выбранному полю; если товара нет — создаются

Кроме того:

• Справочники — ответственные (сотрудники), валюты, единицы измерения и ставки НДС сопоставляются явной таблицей «значение Битрикс24 ↔ значение МойСклад».
• Произвольные поля — любое поле сделки, контакта или компании (в том числе пользовательское) связывается с полем документа или контрагента МойСклад, включая дополнительные поля. Направление задаётся для каждой пары.
• Фильтры — условия на поля решают, какие сделки уходят в МойСклад и какие документы принимаются обратно.

Что модуль не переносит

Остатки и цены каталога, лиды и удаления. Удалённая сделка не удаляет заказ в МойСклад, удалённый в МойСклад контрагент остаётся в Битрикс24 — так сделано намеренно, чтобы обмен не уносил данные. Подробнее — в разделе Ограничения.

Как это выглядит в работе

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

1. Менеджер создаёт сделку с клиентом «ООО Ромашка» и добавляет в неё три товара. Как только сделка сохранена, модуль ставит задачу в очередь обмена и тут же выполняет её в фоне — сохранение карточки от этого не замедляется.
2. Через несколько секунд в МойСклад появляется заказ покупателя: клиент «ООО Ромашка» найден среди контрагентов (или заведён, если его ещё не было), три позиции с теми же ценами и скидками, организация и ответственный.
3. Кладовщик собирает заказ и переводит его в статус «Отгружен». МойСклад присылает уведомление — и сделка в CRM сама переезжает на стадию, которую вы сопоставили с этим статусом.
4. Бухгалтер проводит входящий платёж по заказу — в сделке появляется оплата с отметкой «Оплачено».

Если что-то пошло не так — МойСклад недоступен, не заполнено обязательное поле, — задача остаётся в очереди и повторяется, а причину видно на странице Очередь обмена и в Логах.

На Дашборде одним экраном видно, всё ли в порядке: подключён ли МойСклад, работает ли очередь, установлены ли вебхуки и события, корректно ли настроены документы, контрагенты и справочники. Подробнее — Дашборд.

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

Всё настраивается в интерфейсе модуля — переключателями, списками и таблицами соответствий. Рядом с каждой настройкой есть подсказка, а служебные поля CRM (тип документа, тип контрагента, поле для поиска) модуль создаёт сам — кнопкой Управление полем.

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

На чём держится надёжность

• Очередь вместо прямого запроса. Изменение сначала записывается как задача, потом выполняется. Сбой МойСклад не мешает работе менеджера, а неудачная задача повторяется — до трёх попыток.
• Защита от дублей. Перед созданием записи модуль ищет её пару на другой стороне по заданным вами полям поиска и обновляет найденную.
• Проверка готовности. Пока настроек не хватает, чтобы надёжно найти и связать запись, документ не обменивается — вместо того чтобы плодить дубли. Причина пишется в логи.
• Без «пинг-понга». Изменения, которые модуль сделал сам, не запускают встречный обмен.
• Только изменившееся. При повторном обмене отправляются лишь поля, которые действительно поменялись.

Подробно механика разобрана в разделе Как устроен обмен.

Кому это нужно

• Оптовой компании, у которой продажи живут в CRM, а отгрузки и остатки — в МойСклад.
• Компании с закупками: заказы поставщику оформляются из тех же сделок.
• Интегратору, которого попросили «связать Битрикс24 и МойСклад» без собственной разработки.

Карта документации

Раздел	Что внутри
Быстрый старт	Требования и установка, подключение к МойСклад, минимальная настройка и первый обмен. Начните отсюда.
Настройки	Все страницы настроек: подключение, вебхуки, корзина, справочники, сопоставление полей, заказ покупателя, заказ поставщику, оплаты, контрагенты и типы контрагентов.
Как устроен обмен	Общая схема, сущности двух систем, экспорт и импорт, очередь, как модуль находит пару и защищается от дублей, ограничения.
Интерфейс приложения	Меню и шапка, дашборд, очередь обмена, логи, журнал действий, таблицы модуля, события модуля, документация и «Задать вопрос».
Примеры использования	Готовые рецепты: сделки в заказы с товарами, статусы в обе стороны, контакты и компании в контрагенты, заказы поставщику, оплаты, сделки из разных воронок.
Вопросы и ответы	Почему сделка не ушла, откуда дубли, почему не меняется статус, не приходят вебхуки — и другие частые вопросы.

Инструкции, общие для всех модулей Despi: установка модуля и настройка агентов на cron — без работающего агента задачи при массовых изменениях копятся в очереди.