Обмен данными между Битрикс24 и МойСклад

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

Обмен товарами.

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

Вы можете выгрузить каталог товаров из Битрикс24 в МойСклад. Выгрузка товарных групп не поддеживается.

Вы можете не выгружать весь каталог из МойСклад. Это произойдет постепенно, по мере выгрузки документов из МойСклад в Битрикс24.

Вы можете создавать новые товары в Битрикс24. Они будут загружены в МойСклад вместе с документами, созданными в Битрикс24.

Обмен компаниями.

Вы можете выгрузите всех имеющихся контрагентов МойСклад в компании Битрикс24.

Вы можете выгрузить все компании Битрикс24 в МойСклад.

Вы можете не выгружать всех контрагентов из МойСклад. Это произойдет постепенно, по мере выгрузки документов из МойСклад в Битрикс24.

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

Обмен документами.

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

Сделка Битрикс24 = Заказ покупателя МойСклад
Счет Битрикс24 = Счет МойСклад

Выгрузка сделок Битрикс24 в МойСклад.
Вы можете сохранить нумерацию заказов в МойСклад или заказы, созданные в Битрик24, могут иметь номер bx24-ID_сделки_Битрикс24. Заказы покупателя, созданные в МойСклад, переносятся в Битрикс24 как "сделка". Название сделки в этом случае формируется по формуле "Заказ покупателя " + номер заказа МойСклад.

Стоимость приложения

При установке приложения из каталога приложений МойСклад стоимость подписки составляет от 1500 руб в месяц.

С 1 июля 2024 года вводятся различные тарифы для приложения.

Возможности / Тариф	Стандарт 1500 руб/мес	Эксперт 2500 руб/мес
Синхронизация каталога товаров
Синхронизация компаний
Синхронизация контактных лиц
Синхронизация заказов покупателя и сделок
Синхронизация счетов
Создание отгрузок
Синхронизация входящих платежей
Синхронизация заказов поставщику
Синхронизация показателей клиентов
Выгрузка розницы из МойСклад в Битрикс24
Использование фильтров для выгрузки документов
Выгрузка складских документов из МойСклад в Битрикс24
Выделенный ресурс

Важная информация

При работе с приложением нельзя копировать компании, контакты, сделки, счета и заказы в Битрикс24.

При копировании в новом объекте сохраняется ссылка на идентификатор МойСклад из объекта-источника. При дальнейшей синхронизации данных это может привести к ошибкам и путанице.

При работе с документами настоятельно рекомендуем использовать не более 50 строк с товарами. При использовании 50 и более строк возможны ошибки в работе приложения. Эти ошибки связаны с особенностями архитектуры Битрикс24.

Установка приложения

Установка приложения синхронизации данных между МойСклад и Битрикс24 состоит из двух этапов.

1. Нужно уставноить приложение " Синхронизация с Битрикс24" с витрины МоегоСклада.

2. Установить бесплатного " Клиента МойСклад" с витрины Битрикс24.

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

Если Вы установили приложение после 1 марта 2024 года, переходите к настройкам МоегоСклада.

Подключение МойСклад

Данная глава устарела и оставлена в документации только для совместимости с версией приложения, которая была установлена в Битрикс24 до 1 марта 2024.

Если Вы установили приложение после 1 марта 2024 года, переходите к установке параметров по умолчанию.

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

Для подключения МоегоСклада откройте настройки МоегоСклада, перейдите в раздел "Токены", создайте токен и скопируйте его в буфер обмена.

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

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

Перейдите в настройки приложения Битрикс24 и скопируйте значение токена в соответствующее поле.

Устаревшая схема подключения.

Для подключение приложения к МойСклад требуется указать авторизационные данные сервиса МойСклад.

Важно: логин и пароль хранятся внутри Вашего Битрикс24.

Укажите данные авторизации и нажмите "Проверить".

Укажите логин и пароль пользователя МойСклад
Нажмите "Сохранить".
Если данные введены верно, можно переходить к следующему шагу.

Важно: логин и пароль не должны содержать русский букв и пробелов. В противном случае используйте в качестве логина свой e-mail..

Пользователь МойСклад

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

Можно завести отдельного пользователя и назначить ему административные права. Мы рекомендуем такой вариант т.к. приложение разрабатывалось с учетом административного доступа. Зачем может потребоваться административный доступ?

Вы можете завести "ограниченную" учетную запись. В этом случае требуется настроить доступ этого пользователя к функциям экспорта\импорта данных. Остальные параметры можете установить по своему усмотрению.

Пользователь Битрикс24

Данная глава устарела и оставлена в документации только для совместимости с версией приложения, которая была установлена в Битрикс24 до 1 марта 2024.

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

МойСклад

Параметры по умолчанию

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

собственное юридическое лицо
склад
валюта

Установите нужные значения и перейдите к установке идентификаторов Битрикс24.

Встраивание в Битрикс24

Включить показатели МойСклад в карточку компании (контакта) - выводит в режиме онлайн запроса данные из МоегоСклада: финансовые показатели и список документов.

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

Цена продажи по умолчанию - позволяет указать тип продажной цены, которая будет устанавливаться при открытии закладки МойСклад в сделке Битрик24.

Связанные документы (beta)

Раздел в разработке...

События

На закладке "События" содержится список событий (вебхуков), которое приложение зарегистрировало для своей работы.
Список может отличаться по составу, это зависит от настроек приложения.

Битрикс24

Идентификаторы объектов

Для идентификации компаний, контактов, товаров, сделок и счетов в Битрикс24 с компаниями МойСклад требуется создание пользовательских полей: поля для идентификации компании, контакта, товаров, сделок и счетов.

Если Вы уже создали такие поля, вы можете просто указать их в настройках приложения. Если такие полей нет, Вы можете создать их непосредственно в приложении. Просто нажмите на иконку с плюсом (+).

После установки значений нажмите "Сохранить". Приложение перезагрузится еще раз.

Теперь можно переходить к настройкам обмена справочниками и документами.

Пользователь Битрикс24

Все действия в Битрикс24 приложение будет выполнять под правами пользователя, который установил приложение "МойСклад Клиент" в Битрикс24. Желательно это сделать владельцу аккаунта Битрикс24 или пользователю с правами администратора, который не будет уволен из Битрикс24.

Вы можете сменить одного пользователя Битрикс24 на другого. Для этого нажмите кнопку "Сменить пользователя Б24" и подключите "Клиента МойСклад" с новым пользователем Битрикс24.

События

Включить механизм offline-событий - включение этой опции делает процесс синхронизации более надежным, но делает его немного медленнее.

Товары

Важно! Разработка приложения идет с 2013 года. Складской "учет" в Битрикс24 появился в 2021 году.

Разработчики приложения настоятельно рекомендуют вести каталог товаров и услуг на стороне МоегоСклада.

Это крайне важно для корректного складского учета.

Вы можете создавать товары внутри Битрикс24, это будет корректно обрабатываться с точки зрения логики, реализованной в Битрикс24.

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

	МойСклад	Битрикс24
Простой товар	Простой товар	Простой товар
Товар с SKU	Товар с модификациями	Товар с вариациями
Комплект	Комплект	Простой товар
Услуга	Услуга	Услуга

1. Простой товар: товар, который не имеет модификаций в МоемСкладе и вариаций в Битрикс24.

При создании товара в Битрикс24 он создается с одноименной вариацией без заполненных характеристик.

Такие товары будут переносится в МойСклад как "простой товар" без модификаций.

2. Товар с SKU: товар, который имеет модификации в МоемСкладе и вариации в Битрикс24.

Важно: до 16 октября 2022 года каждая модификация из МоегоСклада переносилась в Битрикс24 отдельным товаром.

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

После выхода обновления товар с модификациями в МоемСкладе, который выглядит следующим образом

Переносится в Битрикс24 с соответствующим набором вариаций.

Вы можете визуально проконтролировать этот процесс, включив отображение "внешнего кода" в списке вариаций. Если коды имеют структуру, как на скриншоте, значит эти данные перенесены из модификаций МоегоСклада.

Приложение по синхронизации берет за основу структуру характеристик на стороне МоегоСклада. Все новые значений характеристик необходимо создавать только в МоемСкладе. Это продиктовано спецификой складского учета.

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

В Битрикс24 все характеристики будут доступны в карточке вариации.

Изменения вариации в Битрикс24 не будет приводить к изменению модификации в МоемСкладе.

Изменения модификации в МоемСкладе будет приводить к изменению вариации в Битрикс24.

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

Важно: на момент написания данного урока АПИ Битрикс24 не поддерживает указание следующих параметров

Эти галочки нужно поставить вручную в каждой перенесенной характеристике из МоегоСклада.

3. Комплект.

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

4. Услуга.

Услуги синхронизируются с соответствующим типом данных для каждой системы.

Настройка полей

Вы можете настроить синхронизацию дополнительных полей для карточки товара.

Соответствие цен

Если Ваш Битрикс24 поддерживает несколько типов цен для товара, Вы можете настроить соответствие типов цен МойСклад и Битрикс24 для синхронизации.

Настройка синхронизации

Вы можете ограничить синхронизацию товаров, указав определенные группы в МоемСкладе.

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

Битрикс24 может не принимать картинки из МоегоСклада из-за неверного формата картинки.

Синхронизация остатков

На тарифе приложения "Эксперт" и выше доступна настройка синхронизации складских остатков.

Важно: На текущий момент приложение не работает с складским учетом Битрикс24. Остатки переносятся в Битрикс24 в пользовательские поля.

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

Общий остаток синхронизируется в стандартное поле Битрикс24 "Количество на складах". Остатки по каждому складу синхронизируются в пользовательские поля с типом "число". Синхронизация остатков поддерживается как для простых товаров, так и для товаров с модификациями. Синхронизация остатков для комплектов не поддерживается.

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

Простые товары

На закладке "Простые товары" настраиваются свойства товаров Битрикс24, в которые будут синхронизироваться остатки товаров из МоегоСклада.

Для удобства можно создать дополнительное свойство типа "дата/время" для сохранения момента актуализации остатка в Битрикс24.

Вы можете настроить синхронизацию только для определенных складов. Не обязательно создавать в Битрикс24 поля для каждого склада.

Свойства для простых товаров можно добавить в настройках CRM в разделе "Свойства товаров".

Тип поля обязательно "Число".

Модификации

На закладке "Модификации" настраиваются свойства модификаций Битрикс24, в которые будут синхронизироваться остатки товаров из МоегоСклада.
Для удобства можно создать дополнительное свойство типа "дата/время" для сохранения момента актуализации остатка в Битрикс24.

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

Выгрузка товаров

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

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

Контрагенты

Структура данных в Битрикс24 и МойСклад отличается, поэтому в приложении используются следующие правила:

юридические лица и индивидуальные предприниматели из МойСклад загружаются в Битрикс24 как "компания";
физические лица МойСклад можно загружать как "компанию", так и "контакт". Это определяется настройкой "Загружать физические лица как";
контактные лица в МоемСкладе поддерживаются не на всех тарифах и имеют несовместимую с Битрикс24 архитектуру данных. По этой причине контактные лица из МоегоСклада не выгружаются в Битрикс24.

Настройка полей

Вы можете настроить синхронизацию дополнительных полей для карточки компании.

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

Выгрузка показателей

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

Финансовые показатели клиента выгружаются при проведении отгрузки и/или оплаты в МоемСкладе.

Настройка синхронизации

Выгружать компании при записи - если отметить этот флаг, то при сохранении (добавлении \ изменении) компании в Битрикс24 или МойСклад, она автоматически будет выгружена в МойСклад или Битрикс24.
Если этот флаг не отмечен, компания будет выгружена только при выгрузке документа (сделка или счет), связанного с этой компанией.
Важно: изменение данного флага требует сохранения настроек приложения.

Загружать физические лица как - Вы можете указать в какой справочник Битрикс24 загружать физических лиц из МоегоСклада.

Фильтрация

Вы можете настроить фильтр для выгрузки компаний из Битрикс24 в МойСклад.

На момент написания данной главы поддерживаются поля только с типом данных "Да/Нет".

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

Выгрузка компаний

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

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

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

Синхронизация контактных лиц

Контактные лица в МоемСкладе поддерживаются не на всех тарифах.

Контактное лицо в МоемСкладе имеет собственный идентификатор, но не имеет самостоятельной сущности.

Контактные лица МоегоСклада выгружаются в сущность "контакт" Битрикс24 с привязкой к компании. Данный функцинал поддерживается для тарифа "Эксперт" приложения.

При использовании в документах Битрикс24 такого контакта без указания компании возникнет ошибка при передаче документа.

Изменение такого контакта в Битрикс24 не приведет к выгрузке данных из Битрикс24 в контактное лицо МоегоСклада.

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

Документы

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

В приложении используются следующие правила:

сделка Битрикс24 = заказ покупателя МойСклад;
счет Битрикс24 = счет МойСклад;
номер счета Битрикс24 = номер счета МойСклад;

Назначение кнопок и переключателей:

Битрикс24.Выгружать счета - включение этой опции подключает выгрузку новых и измененных счетов из Битрикс24 в МойСклад. Обмен запускается автоматически сразу после сохранения счета.
Битрикс24.Удалять счет Б24 при удалении счета МС - зависимый параметр от МойСклад.Выгружать счета. При включении данной опции и включенной "корзине" в МойСклад при следующем обмене будет предпринята попытка удалить соответствующий счет в Битрикс24.
Битрикс24.Выгружать сделки в заказы - включение данной опции обеспечивает выгрузку сделки Битрикс24 в МойСклад.
Битрикс24.Удалять сделку при удалении заказа - зависимый параметр от МойСклад.Выгружать заказы в сделки. При включении данной опции и включенной "корзине" в МойСклад при следующем обмене будет предпринята попытка удалить соответствующую сделку в Битрикс24.
МойСклад.Выгружать оплаты. Зависимый параметр от Битрикс24.Выгружать счета. При включенном параметре при поступлении оплаты по счету в МойСклад (входящий платеж \ ПКО) счету автоматически будет выставлен флаг оплаты и указаны данные платежного документа. Факт частичной или полной оплаты счета не анализируется.
МойСклад.Выгружать счета - включение этой опции подключает выгрузку новых и измененных счетов из МойСклад в Битрикс24. Обмен запускается запускается автоматически сразу после сохранения счета.
МойСклад.Выгружать заказы в сделки - включение этой опции подключает выгрузку новых и измененных заказов покупателя из МойСклад в Битрикс24. Обмен запускается автоматически сразу после сохранения заказа. При создании новой сделки в Битрикс24 ей присваиватеся название по правилу "Заказа покупателя № номер_заказа_МойСклад".

Дата запрета синхронизации

Если Вы хотите ограничить синхронизацию "старых" документов, установите дату, ранее которой не следует синхронизировать документы.

Заказ покупателя

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

Настройка статусов

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

Для добавления новой настройки кликните по ссылке "Добавить соответствие".

Просто выберите из выпадающих списков стадию сделки Битрикс24 статус заказа МойСклад.

Важно: соответствие стадий Битрикс24 и статусов МойСклад должно быть "один к одному".

Например, данная настройка приведет к тому, что при загрузке изменений из МойСклад на стороне Битрикс24 может произойти ошибка и сделка в Битрикс24 "выпадет" из воронки и найти ее можно будет только в общем списке. При этом ее стадия будет иметь вид "C3:NEW".

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

Или Вы можете настроить синхронизацию направлений сделок Битрикс24 с проектами МойСклад.

Важно: Если в работе Битрикс24 для смены стадий сделки используются роботы, после смены стадии нужно добавить действие "Исходящий вебхук" и задать хендлер https://ms.htmls.ru/bitrix24/moysklad/bp/.event.php?entity=deal&id={{ID}}

Фильтр по воронке

Для удобства контроля настроек или добавления новой Вы можете воспользоваться фильтром по воронке Битрикс24.

Просто кликните по нужной воронке. Будут выведены настройки только для выбранной воронки.

При добавлении новой настройки фильтр так же будет учтен.

Для отключения фильтрации выберите пункт "Все".

Синхронизация товаров

Вы можете отключить синхронизацию списка товаров в документах для определенных стадий.

Это может быть полезно, например, при указании в МоемСкладе серий товаров.

Так же это может сократить количество запросов при получении/обновлении данных, когда это точно не нужно.

Например, когда заказ уже оплачен и ни количество, ни цена не могут быть изменены.

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

Важно!
Если сделка переводится в статус, для которого предусмотрено снятие товаров с резерва или поставновка товаров в резерв, синхронизация продуктов должна быть включена.
В примере на этом скрине резервирование товаров в МоемСкладе не произойдет!
Снятие с резерва пройдет корректно.

Настройка полей

Приложение поддерживает синхронизацию системных полей без дополнительных настроек.

Если Ваш тариф приложения поддерживает настройку дополнительных полей, Вы можете настроить для них соответствие.

Важно! Типы полей в обеих системах должны совпадать.

Пример использования

В МойСклад в заказе покупателя есть системное поле "Плановая дата отгрузки". Это поле присутствует в списке полей МойСклад по умолчанию. Вы можете создать пользовательское поле для сделки с типом "Дата" и установить соответствие.

Если в настройках приложения Вы выбрали опцию сохранения нумерации МойСклад, Вам может быть полезна настройка для установки соответствия системного поля ID Битрикс24 пользовательскому полю в МойСклад для идентификации сделки.
Важно: на стороне МойСклад поле должно иметь тип "Целое число"

Направление сделки = Проект

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

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

В настройках пользовательских полей "Сделка = Заказ" добавьте соответствие. Выберите в блоке Битрикс24 "Направление сделки (сис)", а в блоке МойСклад выберите "Проект (сис)".

При использовании этой настройки Вы можете для соответствия статусов на стороне МойСклад использовать одинаковые значения.

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

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

Если перед началом синхронизации направления сделок в Битрикс24 и справочник проектов в МойСклад уже содержат значения, рекомендуется привести их наименования в соответствие.

Если справочник проектов МойСклад пуст, необходимые проекты будут созданы автоматически при переносе заказов.

Фильтрация

Фильтрация доступна на тарифах приложения "Эксперт" и выше.
До введения тарифов приложения в продажу данный функционал доступен всем пользователям для ознакомления.

Вы можете настроить выгрузку заказов покупателя из МоегоСклада в Битрикс24 с использованием фильтров по системным и пользовательских полям.

На момент написания данного материала доступны следующие типы полей:

типовое поле "Отдел"
пользовательские поля с типом "флажок" (да / нет)
пользовательские поля с типом "справочник".

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

Если заказ покупателя не удовлетворяет условиям выгрузки, в журнале синхронизации будет сделана соответствующая запись.

Минимальная цена

Если в МоемСкладе Вы используете минимальную цену для товара, можно настроить контроль цены при сохранении сделки.

Для контроля минимальной цены в сделке Битрикс24 включите опцию контрол минимальной цены в разделе "Настройка фильтров".

При установке в сделке цены на товар ниже минимальной, сделка не будет сохранятся и будет выходить предупреждение.

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

НДС

Для корректно настройки работы с системными полями "НДС" и "Цена включает НДС" в МоемСкладе можно воспользоваться данными настройками.

Необходимо в пользовательских полях сделки создать два поля с типом "Да/Нет". Не включайте множественный признак!

Можно задать значение по умолчанию для каждого поля.

Далее в настройках приложения в МоемСкладе добавьте соответствия для системных полей МоегоСклада и пользовательских полей Битрикс24.

Счёт

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

По умолчанию в МойСклад статусы для счетов не создаются, их нужно создать самостоятельно.

Настройка полей

Приложение поддерживает синхронизацию системных полей без дополнительных настроек.

Если Ваш тариф Битрикс24 поддерживает настройку дополнительных полей, Вы можете настроить для них соответствие.

Статус счета <=> Статус счета

Внимание: в обмене участвуют только те статусы счетов, которые будут выбраны в этом соответствии.

Установите соответствие статусов счетов между Битрикс24 и МойСклад.

Управление отгрузками в МойСклад

В приложении реализована возможность создавать отгрузки в МойСклад при переводе сделки в определенный статус.

Нужно учитывать, что приложение создает отгрузку без учета, созданных вручную в МойСклад отгрузкок. В этом случае может произойти "задвоение" отгрузки.

Проведение отгрузки в МойСклад происходит по правилам МоегоСклада: товар должен быть на складе в достаточном количестве.

Дополнительные документы

Загрузка розницы

В приложении реализована передача розничных продаж из МойСклад в Битрикс24

Создание входящих платежей

Приложение позволяет создавать документы оплаты "Входящий платеж" и "Приходный ордер" при переводе сделки или счета в определенную стадию.

Это может быть полезно компаниям, которые в своей работе используют "наложенный платеж".

Сотрудники

Вы можете установить соответствие между ответственным сотрудником Битрикс24 и владельцем МойСклад.

Не синхронизировать ответственных

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

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

Дальнейшее изменение ответственного сотрудника через приложение не будет происходить.

Валюты

Если Вы используете несколько валют, Вы можете установите соответствие для каждой валюты.

Справочники

Список дополнительных справочников, связанных с настройками полей сделок, счетов и компаний.

При настройке дополнительных полей есть возможность использовать поля с типом "справочник".

Управление элементами справочника в Битрикс24 осуществляется в специальном разделе настроек приложения.

С помощью кнопки "Удалить справочник" можно удалить справочник и все элементы в Битрикс24.

Справочники

Важно: управление элементами справочника осуществляется только на стороне МойСклад. На стороне Битрикс24 элементы доступны только для чтения. Если Вам нужно обновить элементы справочника в Битрикс24, они обновятся автоматически при следующем обмене, если будут входить в состав обмена.

Настройка соответствия для дополнительного поля типа "Справочник" проходит в несколько этапов.

1. В настройках приложения Битрикс24 в колонке "МойСклад" нужно выбрать название поля, которое имеет тип "Справочник"
2. После выбора всплывает окно с вопросом о создании аналогичного справочника в Битрикс24 и его первоначальном заполнении. Нажмите "ОК". Произойдет создание справочника и его первоначальная загрузка.

Сохраните, если требуется остальные настройки. На данном шаге не требуется указания поля для Битрикс24.

3. Перейдите в настройки пользовательских полей сделки (компании) Битрикс24 и создайте новое поле. В качестве типа данных укажите "Привязка к элементам инфоблоков".
4. В выпадающем списке "Тип инфоблока" выберите строку, которая называется "MP applications entity storage [rest_entity]"

5. В правом выпадающем списке выберите элемент, который содержит наименование справочника МойСклад. Например, "МойСклад. Организация"

6. Сохраните настройки поля.

7. Вернитесь к шагу 1. При выборе типа поля на стороне МойСклад больше не будет запроса на создание справочника. Укажите в графе Битрикс24 название только что созданного поля.

Если описание настроек Вам показалось слишком сложным, посмотрите небольшой ролик, как происходит процесс настройки полей.

Обновление элементов

Для обновления списка элементов откройте закладку "Справочники" в настройках приложения.

Нажмите кнопку "Справочники"

Откроется окно с списком доступных справочников. Нажмите кнопку с названием нужного справочника.

С помощью иконок обновления/добавления можно обновить название элемента в Битрикс24 или добавить новый элемент.

Если элемент справочника был удален в МоемСкладе, можно удалить соответствующий элемент в Битрикс24 с использованием иконки

Соответствие полей

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

Пользовательские поля

Приложение поддерживает обмен дополнительными (пользовательскими) полями для сделок\заказов, счетов и компаний\контрагентов.

Данные настройки станут доступны через 7 дней после установки приложения.

Важно: поддерживаются следующие типы данных:

целое число
дробное число
строка
дата со временем
справочник

Важно: типы данных полей в Битрикс24 и МойСклад должны совпадать, иначе могут возникнуть ошибки при синхронизации.
Например, правильной настройкой будет синхронизация полей с типом "строка". Если в одной системе тип данных будет "строка", а в другой "число", это приведет к ошибке в работе синхронизации.

МойСклад	Битрикс24
строка	строка
число целое	целое число
число дробное	число
справочник	привязка к элементам инфоблоков
флажок	да/нет
дата	дата/время

Организации, склады

Если Вы используете несколько организаций и\или складов, Вы можете настроить соответствие этих справочников.

Инструкция по настройке https://www.htmls.ru/articles/moysklad/moysklad-update-112-store-organization/

Остатки

На текущий момент синхронизация остатков не поддерживается.

Доступна возможность просмотра остатков МойСклад в сделке Битрик24 в режиме онлайн.

Просмотр остатков по модификациям не поддерживается.

Журнал синхронизации

Журнал выгрузки сделки Битрикс24 в МойСклад

Состояние синхронизации можно посмотреть в каждой сделке или счете в "Журнале синхронизации с МС"

Журнал выгрузки заказа покупателя МойСклад в Битрикс24.

В заказах покупателя МоегоСклада ссылка на журнал синхронизации находится над таблицей с товарами.

В зависимости от количества и размера установленных в МоемСкладе виджетов от приложений положение журнала может немного варьироваться.

Печатные формы МС в Б24

В приложении реализована возможность скачивания печатных форм МойСклад в Битрикс24.

Отмена изменений

Если приложение по непонятной причине отменяет изменения или вообще их не переносит, почитайте эту статью. Мы постарались там изложить основные причины такого поведения.

Обновления

Обновления функционала приложения.

Сентябрь, 2024

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

Август, 2024

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

Июль, 2024

Введена тарификация для приложения
Добавлена возможность контроля минимальной цены в сделках Битрикс24

Июнь, 2024

добавили фильтрацию по воронке в настройках стадий

Март, 2024

поиск по нескольким словам или части слов
поиск по модификациям с выводом остатков
добавлена возможность синхронизации комментария к адресу доставки МойСклад с пользовательским полем сделки типа "строка".
для заказов покупателя добавлена возможность настройки дополнительной филильтрации для выгрузки документов в Битрикс24. (подробнее)

Логин:
Пароль:
	Запомнить меня

Забыли свой пароль?