---
title: "МойСклад: Интеграция с Битрикс24"
url: "https://despi.ru/modules/despi-moyskladcrm"
description: "Двусторонний обмен Битрикс24 (коробка) и МойСклад: сделки ↔ заказы покупателя и поставщику, контакты и компании ↔ контрагенты с реквизитами, товарные строки ↔ позиции документа."
updated: "2026-10-01"
---

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

> Двусторонний обмен Битрикс24 (коробка) и МойСклад: сделки ↔ заказы покупателя и поставщику, контакты и компании ↔ контрагенты с реквизитами, товарные строки ↔ позиции документа.

- Категория: Интеграции
- Работает с: МойСклад, Битрикс24, CRM, Интеграция
- Цена: 29 990 руб.
- Демо-период: 14 дней
- Партнёрская скидка: есть
- Установок: до 50
- HTML-версия: https://despi.ru/modules/despi-moyskladcrm
- Инструкция по установке: https://despi.ru/modules/despi-moyskladcrm#module-install
- Маркетплейс: https://marketplace.1c-bitrix.ru/solutions/despi.moyskladcrm/
- Документация: https://docs.despi.ru/despi-moyskladcrm/

## Описание

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

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

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

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

- **Сделки и заказы покупателя** МойСклад — в обе стороны.
- **Сделки и заказы поставщику** МойСклад — отдельный контур со своими настройками.
- **Контакты и компании Битрикс24 и контрагенты МойСклад** — включая юрлиц, ИП и физлиц.
- **Реквизиты клиента**: ИНН, КПП, ОГРН, юридическое название, адреса, телефон, почта, сайт.
- **Состав заказа**: товарные строки сделки и позиции документа — товар, количество, цена, скидка, ставка НДС.
- **Номенклатура**: товары, услуги, комплекты и модификации (торговые предложения) с картинками и характеристиками.
- **Стадии сделки и статусы документа**, статусы контрагента.
- **Ответственный менеджер и валюта** документа.
- **Теги (группы) контрагента** и произвольные пользовательские поля обеих систем.
- **Справочники**: сотрудники, валюты, единицы измерения, ставки НДС.

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

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

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

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

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

Всё настраивается в интерфейсе модуля, списками и таблицами соответствий, а не правкой кода:

- **Сопоставление полей.** Любое поле сделки, контакта или компании связывается с любым полем документа или контрагента МойСклад — стандартным, пользовательским или дополнительным (атрибутом). У каждой пары своё направление: в МойСклад, в Битрикс24 или в обе стороны.
- **Значения по умолчанию.** Организация, счёт, склад, канал продаж — то, что постоянно и не хранится в CRM, задаётся правилом, а не отдельным полем в Битрикс24.
- **Поля поиска связанной записи.** Связь ведётся по тому полю, которое уже сложилось в ваших данных: внешнему коду, ИНН, номеру договора.
- **Фильтры обмена.** Условия на поля решают, какие сделки уезжают в учёт и какие документы принимаются обратно.
- **Справочники соответствий.** Сотрудники, валюты, единицы измерения и ставки НДС сопоставляются явной таблицей — видно, что с чем связано и почему значение не перенеслось.
- **Создание полей CRM.** Служебные поля, которые нужны интеграции (признак типа документа, тип контрагента, статус, теги), модуль заводит сам из своих настроек — ходить в конструктор полей Битрикс24 не нужно.
- **Помощник настройки каталога.** Инфоблоки, разделы, группы товаров МойСклад и поля связи выбираются из подставленных списков, а не вводятся идентификаторами.

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

## Надёжность: очередь, проверки и разбор ошибок

Интеграция с внешним сервисом ломается предсказуемо: сервис недоступен, API ограничил частоту запросов, поле заполнено не так. Модуль рассчитан именно на это.

- **Очередь обмена.** Задачи копятся в отдельной линии на каждый профиль и обрабатываются пакетами. Повторные правки одной сделки склеиваются в одну задачу: десять изменений подряд не превращаются в десять обращений к МойСкладу. Сбой не теряется — задача повторяется с нарастающей паузой.
- **Проверка готовности настроек.** Перед каждым обменом модуль смотрит, достаточно ли настроек, чтобы запись нашлась и связалась. Недонастроенный контур обмен не запускает — вместо того чтобы плодить дубли. Состояние по обоим видам документов, трём типам контрагента и четырём справочникам видно на дашборде.
- **Защита от дублей.** Перед созданием записи модуль ищет её пару на другой стороне и обновляет найденную. Если поиск не выполнился из-за сбоя, обмен прерывается и повторяется позже: создавать запись вслепую после ошибки нельзя, это гарантированный дубль.
- **Защита от зацикливания.** Записи, которые модуль делает сам, не запускают встречный обмен: ни события CRM, ни уведомления МойСклад на них не срабатывают.
- **Страница очереди.** Видно каждую задачу: направление, документ, статус, число попыток, полный текст ошибки. Задачу можно выполнить принудительно или удалить, не дожидаясь расписания. Рядом — карточка агента: активен ли, когда следующий запуск, кнопки переустановить и прогнать проход вручную.

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

Товарная часть — самое трудоёмкое место любой интеграции, и здесь она разобрана подробно.

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

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

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

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

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

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

### Нужно ли менеджеру нажимать кнопку «выгрузить»?

Нет. Обмен запускают события CRM — создание и изменение сделки, контакта, компании. Кнопки «выгрузить» в карточке нет и не требуется. Пользователь работает как обычно и про интеграцию не думает.

### Как быстро изменения попадают в МойСклад?

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

### Что будет, если МойСклад недоступен или API ограничил частоту запросов?

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

### Создаст ли модуль дубли сделок, заказов и контрагентов?

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

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

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

### Как модуль отличает продажу от закупки?

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

### Работает ли обмен с ИП и физлицами, а не только с юрлицами?

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

### Переносятся ли реквизиты, адреса и телефоны?

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

### Нужно ли выгружать клиентскую базу заранее?

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

### Синхронизируются ли стадии сделки и статусы заказа?

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

### Переносятся ли остатки и цены товаров?

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

### Переносится ли удаление?

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

### Обмениваются ли лиды?

Нет. В обмене участвуют сделки, контакты и компании.

### Как понять, почему заказ не появился в учёте?

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

### Можно ли настроить несколько разных обменов?

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

### Что нужно настроить на стороне сервера?

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

## Требования

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

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

Честный список, чтобы не было сюрпризов при внедрении:

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

## С чего начать

1. Подключить МойСклад: токен или логин с паролем.
2. Создать служебные поля CRM прямо из настроек модуля.
3. Включить нужный контур — заказы покупателя или заказы поставщику — и задать поля поиска связанной записи.
4. Сопоставить поля обмена и, если нужно, стадии со статусами.
5. Проверить состояние настроек на дашборде: там видно, что готово, а что осталось донастроить.
6. Включить состав товаров, клиентскую базу и приём уведомлений из МойСклад, когда основной контур заработал.

## Требования

- Агент или cron: нужен
- Модуль CRM Битрикс24: да
- Модули «Торговый каталог» и «Информационные блоки» (для состава заказа): да
- Тариф МойСклад: Платный (вебхуки и дополнительные поля)
- Публичный адрес портала для вебхуков МойСклад: да

## Частые вопросы

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

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

### Как быстро изменения попадают в МойСклад?

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

### Что будет, если МойСклад недоступен или API ограничил частоту запросов?

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

### Создаст ли модуль дубли сделок, заказов и контрагентов?

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

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

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

### Как модуль отличает продажу от закупки?

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

### Работает ли обмен с ИП и физлицами, а не только с юрлицами?

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

### Переносятся ли реквизиты, адреса и телефоны?

Да. Реквизиты в Битрикс24 лежат не в самой карточке, а в связанной сущности «Реквизит», поэтому модуль находит реквизит нужного шаблона (или создаёт его) и пишет значения туда. Адреса собираются по типам, телефон, почта и сайт пишутся в множественные поля карточки.

### Нужно ли выгружать клиентскую базу заранее?

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

### Синхронизируются ли стадии сделки и статусы заказа?

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

### Нужно ли заранее выгружать каталог товаров?

Нет. Если товара во второй системе нет, модуль создаёт его сам вместе с картинками и характеристиками, а связанные сущности разворачивает каскадом. Каталог наполняется по мере появления реальных заказов.

### Переносятся ли остатки и цены товаров?

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

Для остатков и цен есть отдельный модуль — МойСклад: Синхронизация товаров.

### Переносится ли удаление?

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

### Обмениваются ли лиды?

Нет. В обмене участвуют сделки, контакты и компании.

### Как понять, почему заказ не появился в учёте?

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

### Что нужно настроить на стороне сервера?

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

### Нужен ли программист для внедрения?

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