МСБитрикс: быстрый старт
Как подключить Битрикс24 к МойСклад и безопасно запустить первый обмен.
Перед началом
Подготовьте аккаунт МойСклад с правом устанавливать решения, доступ администратора к порталу Битрикс24, а также несколько тестовых товаров и одну тестовую сделку. Для точного автоматического сопоставления проверьте уникальность артикулов товаров.
Установка и подключение портала
- Установите МСБитрикс из каталога решений МойСклад.
- Откройте Решения → МСБитрикс.
- Введите домен облачного портала, например
company.bitrix24.ru. - Нажмите Подключить портал и войдите в Битрикс24 под администратором.
- Подтвердите запрошенные права к CRM, каталогу, счетам и пользователям.
- Вернитесь в МойСклад и дождитесь статуса Активно.
Коробочный портал подключается на тарифе Энтерпрайз через входящий вебхук. URL вебхука является секретом: не публикуйте его и не передавайте третьим лицам.
Рекомендуемый порядок настройки
- Настройте товары и проверьте несколько сопоставлений.
- Выберите направление и склады для остатков.
- Настройте компании, контакты и соответствие реквизитов.
- Выберите сделки, CRM-заказы или оба источника.
- Укажите организацию, склад и валюту документов МойСклад.
- Сопоставьте стадии Битрикс24 со статусами заказов МойСклад.
- При необходимости включите счета, оплаты, отгрузки и возвраты.
- Выполните ручную проверку и только затем включите автоматический обмен.
Товары и остатки
Для каталога выберите направление, участвующие группы, типы номенклатуры, цену, валюту, передачу описаний и изображений. Сначала сопоставьте существующие товары по артикулу или вручную. Уже связанная позиция обновляется и не создаётся повторно.
Остатки настраиваются отдельно. Для МойСклад → Битрикс24 можно выбрать фактический или доступный остаток. Доступный остаток учитывает резерв по заказам.
Компании и контакты
Выберите направления передачи компаний, контактов, реквизитов и контактных лиц. Сопоставьте шаблоны реквизитов Битрикс24 с юридическими лицами, ИП и физическими лицами МойСклад. При необходимости свяжите ответственных пользователей и сотрудников двух систем.
Заказы и статусы
Выберите источник заказов: сделки, CRM-заказы или оба варианта. Для каждой воронки укажите организацию и склад, затем сопоставьте стадии со статусами заказа МойСклад. Код валюты в обеих системах должен совпадать: приложение не выполняет пересчёт по курсу.
На тарифах с двусторонними статусами отдельно включается направление МойСклад → Битрикс24. Изменение, которое приложение только что передало само, повторно назад не отправляется.
Отгрузки и возвраты
Если включены складские документы, выберите склад списания и действие для каждой стадии: создать отгрузку-черновик, провести оставшееся количество либо оформить возврат. Проведённая отгрузка меняет складской остаток, поэтому автоматическое проведение нужно отдельно подтвердить в настройках.
Счета и оплаты
Сопоставьте организации и статусы счетов для каждого направления. Передача оплат включается только после сохранения настроек счетов. Уже перенесённая проведённая оплата повторно не создаётся; изменение или удаление финансового документа требует ручной сверки.
Работа в Битрикс24
В карточке сделки откройте вкладку МСБитрикс. Там можно подобрать товары из МойСклад, изменить количество, цену, скидку и НДС, увидеть заказ и связанные документы, а также скачать доступные печатные формы.
После изменения состава сделки внутри решения нажмите Обновить, чтобы передать актуальные позиции в уже связанный заказ МойСклад. Напоминание исчезнет после успешного обновления.
Если обмен не выполняется
- Откройте историю обмена и прочитайте сообщение операции.
- Проверьте активность подключения, подписку и подтверждённые права приложения.
- Убедитесь, что товар имеет точное сопоставление, а обязательные поля заполнены.
- Для складских документов проверьте выбранный склад и подтверждение проведения.
- Если проблема сохраняется, создайте тикет кнопкой сообщения внутри приложения. Поддержка увидит, что обращение пришло из МСБитрикс.