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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Иконки приложения

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

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

Настройка приложения

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

По окончанию всех этапов Вы увидите такую картину.

Итак, начнем...

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

После проверки введенных данных (логин и пароль) потребуется указать значения по умолчанию:

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

Установите нужные значения и нажмите "Сохранить".

Приложение перезагрузится еще раз.

Переходим к следующему шагу.

Идентификационные данные

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

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

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

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

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

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

Важно! Разработка приложения идет с 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 с привязкой к "родительской" компании Битрикс24.

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

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

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

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

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

сделка Битрикс24 = заказ покупателя МойСклад;
номер заказа покупателя МойСклад может быть двух вариантов: 1) сохраняется нумерация МойСклад; 2) номер заказа в МойСклад формируется по правилу bx24-ID_сделки_Битрикс24;
счет Битрикс24 = счет МойСклад;
номер счета Битрикс24 = номер счета МойСклад;

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

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

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

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

Стадия сделки >-< Статус заказа

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

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

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

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

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

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

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

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

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

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

Ответственный >-< Владелец

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

Валюты

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

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

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

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

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

Сделка >-< Заказ

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

Если в настройках приложения Вы выбрали опцию сохранения нумерации МойСклад, Вам может быть полезна настройка для установки соответствия системного поля ID Битрикс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 поддерживает несколько направлений для сделок и в Вашем Битрикс24 создано хотя-бы одно дополнительное направление.

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

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

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

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

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

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

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

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

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

Журнал ошибок

Журнал ошибок больше не используется.

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

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

Планы

Планы по развитию приложения:

поддержка выгрузки групп товаров - реализовано
предварительный поиск компаний по ИНН (на случай, если уже были заведены клиенты в обе базы) - реализовано
поддержка выгрузки справочника "Проекты" - реализовано
формирование отчетов по реализации в разрезе "Проектов".
формирование платежного календаря на основании входящих и исходящих счетов.
Ваши предложения?

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

Регистрация
Забыли свой пароль?