Руководство / МСКоннект

Подключение и первый обмен

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

Обновлено 9 октября 2026 г.

Перед началом

Подготовьте аккаунт МойСклад с правом устанавливать решения, доступ администратора к порталу Битрикс24, а также несколько тестовых товаров и одну тестовую сделку. Для точного автоматического сопоставления проверьте уникальность артикулов товаров.

Установка и подключение портала

Установите МСКоннект из каталога решений МойСклад и откройте Решения / МСКоннект. Выберите один из двух способов: через приложение Битрикс24 (OAuth) или самостоятельное подключение через вебхуки. Оба способа поддерживают облачные и коробочные порталы; для коробочной версии нужен тариф Энтерпрайз.

Через приложение Битрикс24 (OAuth)

В Битрикс24 под администратором откройте Маркет, найдите МСКоннект и установите приложение. Затем откройте его из списка установленных приложений Битрикс24. Дождитесь сообщения «МСКоннект установлен в Битрикс24» или обзора обмена, если портал уже связан с МойСклад. Если окно открылось автоматически после установки, дождитесь результата в нём.
Вернитесь в МойСклад и откройте блок Подключение через приложение Битрикс24.
Введите домен того же портала: например, company.bitrix24.ru для облака или crm.company.ru для коробки.
Отметьте, что приложение установлено, и нажмите Подключить установленное приложение.
Войдите в Битрикс24 под администратором и подтвердите доступ к CRM, каталогу, счетам и пользователям.
Вернитесь в МойСклад и дождитесь статуса Активно.

Для подключения через OAuth приложение должно быть установлено в обеих системах. Кнопка подключения в МойСклад авторизует уже установленное приложение, но не устанавливает его в Битрикс24 и сама по себе не завершает установку. События и вкладки в карточках CRM настраиваются автоматически. Удаление приложения из Битрикс24 останавливает обмен этого OAuth-подключения до повторной установки и авторизации.

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

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

Самостоятельное подключение через вебхуки

Этот способ настраивается из МойСклад и работает без установки приложения в Битрикс24.

В МойСклад откройте блок Самостоятельное подключение через вебхуки.
В Битрикс24 под администратором откройте Приложения / Разработчикам / Готовые сценарии → Другое / Входящий вебхук.
Выдайте права на CRM, каталог товаров, пользователей и интернет-магазин. Коды разрешений можно скопировать из формы подключения МСКоннект.
Скопируйте полный URL вебхука в поле URL входящего вебхука в МойСклад и нажмите Подключить через вебхук. Домен определяется из URL.
После проверки нажмите Настроить обмен у подключённого портала.

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

Без исходящих событий сделки проверяются в фоне каждые 5 минут. Для автоматической передачи изменений каталога и остатков из Битрикс24 требуется настроенный приём событий. Вкладки МСКоннект в карточках CRM при подключении через вебхуки не появляются.

Если входящий вебхук пересоздан, нажмите Заменить входящий вебхук, укажите новый URL того же портала и подтвердите замену. Реквизиты проверяются до сохранения; настройки обмена и связи документов сохраняются. После замены повторно настройте исходящие события по инструкции в форме. URL вебхука и Токен приложения являются секретами — не публикуйте их.

Коробочная версия

Коробочный портал подключается на тарифе Энтерпрайз через OAuth или вебхуки. Для обоих способов нужны настроенный модуль REST, действующий HTTPS-сертификат и доступ сервера МСКоннект к REST API на домене коробки.

Для OAuth серверу коробки дополнительно нужен HTTPS-доступ к oauth.bitrix24.tech. События и вкладки CRM регистрируются приложением автоматически. Для подключения через вебхуки входящий вебхук и исходящие события настраиваются администратором по инструкции выше.

Сетевые требования описаны в документации Битрикс24.

Переход с вебхуков на OAuth

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

Товары и остатки

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

Остатки настраиваются отдельно. Для МойСклад / Битрикс24 можно выбрать фактический или доступный остаток. Доступный остаток учитывает резерв по заказам.

Компании и контакты

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

Заказы и статусы

Выберите источник заказов: сделки, CRM-заказы или оба варианта. Для каждой воронки укажите организацию и склад, затем сопоставьте стадии со статусами заказа МойСклад. Код валюты в обеих системах должен совпадать: приложение не выполняет пересчёт по курсу.

Для новых заказов из сделок можно задать минимальную дату создания сделки и разрешённые этапы воронки. Эти фильтры не зависят от сопоставления статусов. Подбор склада по наличию и разделение на несколько заказов включаются отдельно, обычное сопоставление склада с направлением сохраняется по умолчанию. Подробности приведены в руководстве по заказам и складам.

Чтобы создать Заказ покупателя, в исходной сделке или CRM-заказе должен быть выбран покупатель — компания либо контакт — и должна быть хотя бы одна товарная позиция с количеством больше нуля. Каждый товар предварительно синхронизируйте или сопоставьте с каталогом МойСклад. В настройках передачи сохраните организацию и валюту. Сопоставление стадий со статусами для самого создания заказа не обязательно. Это требования сценария передачи, а не пользовательские обязательные поля карточки Заказа покупателя в МойСклад.

На тарифах с двусторонними статусами отдельно включается направление МойСклад / Битрикс24. Изменение, которое приложение только что передало само, повторно назад не отправляется.

Отгрузки и возвраты

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

Счета и оплаты

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

Работа в Битрикс24

В карточке сделки откройте вкладку МСКоннект. Там можно подобрать товары из МойСклад, изменить количество, цену, скидку и НДС, увидеть заказ и связанные документы, а также скачать доступные печатные формы.

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

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

Подбор товаров, импорт Excel, остатки по складам и новый журнал описаны в руководстве по каталогу и работе в CRM.

Если обмен не выполняется

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