МСИнтеграции

МСБитрикс: быстрый старт

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

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

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

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

  1. Установите МСБитрикс из каталога решений МойСклад.
  2. Откройте Решения → МСБитрикс.
  3. Введите домен облачного портала, например company.bitrix24.ru.
  4. Нажмите Подключить портал и войдите в Битрикс24 под администратором.
  5. Подтвердите запрошенные права к CRM, каталогу, счетам и пользователям.
  6. Вернитесь в МойСклад и дождитесь статуса Активно.

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

Рекомендуемый порядок настройки

  1. Настройте товары и проверьте несколько сопоставлений.
  2. Выберите направление и склады для остатков.
  3. Настройте компании, контакты и соответствие реквизитов.
  4. Выберите сделки, CRM-заказы или оба источника.
  5. Укажите организацию, склад и валюту документов МойСклад.
  6. Сопоставьте стадии Битрикс24 со статусами заказов МойСклад.
  7. При необходимости включите счета, оплаты, отгрузки и возвраты.
  8. Выполните ручную проверку и только затем включите автоматический обмен.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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