0  /  22

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

Описание приложения

В данном разделе описаны общие возможности и принципы работы приложения.

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

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

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

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

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

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

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

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

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

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

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

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



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

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

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

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


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

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

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


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

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

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

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

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


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

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

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

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

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


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

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

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

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

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

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


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

Для идентификации компаний, контактов, товаров, сделок и счетов в Битрикс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 "Направление+Стадия" соответствовал уникальный статус МойСклад.

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

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

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


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

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


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

Валюты


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

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

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

Важно: поддерживаются следующие типы данных:
  • целое число
  • дробное число
  • строка
  • дата/время
  • справочник


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

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


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



Справочники



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

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

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

Сохраните, если требуется остальные настройки. На данном шаге не требуется указания поля для Битрикс24.
3. Перейдите в настройки пользовательских полей сделки (компании) Битрикс24 и создайте новое поле. В качестве типа данных укажите "Привязка к элементам инфоблоков".
4. В выпадающем списке "Тип инфоблока" выберите строку, которая не содержит наименования

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

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


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

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

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


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

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

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

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

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

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

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

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

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

Планы

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