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

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

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

Общее

Функционал модуля синхронизации поддерживает синхронизацию контрагентов в системе «МойСклад» и пользователей сайта на 1С-Битрикс.

Важно учитывать особенности структуры пользователей в 1С-Битрикс:

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

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

• пользователями 1С-Битрикс;
• контрагентами в МойСклад.

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

Основные параметры синхронизации пользователей и контрагентов находятся в разделе «Синхронизация заказов» → вкладка «Контрагенты»:

Для корректной синхронизации контрагентов важно указать связи по типам плательщиков и тип плательщика по умолчанию в Основных настройках модуля:

Поле для синхронизации контрагентов

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

Дополнительно можно настроить повторную проверку контрагента:

• по e-mail;
• по телефону.

В таком случае при синхронизации поиск пользователя или контрагента выполняется в несколько этапов:

1. Сначала выполняется поиск по внешнему коду.
2. Если объект не найден, модуль выполняет дополнительный поиск:
   • по e-mail;
   • либо по телефону.

Тип дополнительной проверки зависит от выбранных настроек в разделе синхронизации контрагентов:

Добавление новых пользоваталей

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

Для этого доступны дополнительные настройки.

Управление почтовыми уведомлениями

Данная настройка определяет, будет ли отправляться стандартное почтовое уведомление 1С-Битрикс при создании нового пользователя:

В зависимости от состояния настройки:

• уведомление будет отправлено;
• либо отправка письма будет отключена.

Группа для новых пользователей

Настройка расположена во вкладке «Основные настройки» и позволяет указать группу, в которую будет автоматически добавлен новый пользователь при его создании вместе с заказом:

⚠️ Важно! Необходимо внимательно выбирать группу пользователей. Если по ошибке указать административную группу, новые автоматически создаваемые пользователи могут получить административные права на сайте.

Отключение обновления контрагентов

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

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

Если такое поведение не требуется, необходимо включить настройку «Не обновлять контрагентов»:

В этом случае модуль будет:

• выполнять только поиск контрагента;
• привязывать найденного контрагента к заказу;
• не изменять существующие данные контрагента.

Связи полей для выгрузки контрагентов

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

Для этого в настройках предусмотрен отдельный блок сопоставления полей, позволяющий привязать поля контрагента в МойСклад к свойствам заказа в 1С-Битрикс:

Поддерживаются отдельные настройки для:

• физических лиц;
• юридических лиц;
• индивидуальных предпринимателей.

Это позволяет передавать различные наборы данных в зависимости от типа контрагента.

Группа контрагента

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

Для этого используется настройка «Группа, с которой будет создан новый контрагент»:

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

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

Модуль умеет осуществлять полноценную синхронизацию оплат на сайте и входящих платежей в МС. Оплаты в заказе на сайте:

Передаются в МС в виде входящих платежей и приходных ордеров:

Аналогично работает и в обратную сторону с МС на сайт. Привязка оплат на сайте и платежей МС происходит по внешнему коду (ни в МС, ни на сайте эти внешние коды нельзя увидеть в интерфейсе, но они есть “под капотом”). Сама синхронизация оплат/платежей работает на вебхуках, потому изменения происходят мгновенно.

Блок настройки оплат состоит из следующих настроек:

1. Направление обмена оплатами/входящими платежами отвечает за то, в какую сторону будет работать синхронизация оплат: a) Не синхронизировать. b) С МС на сайт. c) С сайта в МС. d) В обе стороны.

2. Свойство входящего платежа, в котором хранится способ оплаты, отвечает за то, в какое свойство входящего платежа (свойство нужно создать самому в МС, в настройках платежей) будет сохранено название платежной системы. Это свойство обязательно для заполнения, если в свойстве “Направление обмена оплатами/входящими платежами” выбрано хотя бы одно направление синхронизации.

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

4. Формат синхронизации оплат определяет на какие действия реагировать и какие делать при синхронизации. Эта настройка влияет на обе стороны синхронизации, как с МС на сайт, так и с сайта в МС.

5. Привязка оплаты к свойству в МС передает в МС в свойство заказа название типа оплаты в первой из оплат заказа.

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

Данные которые передаются:

• сумма;
• дата прихода;
• оплачено/не оплачено;
• номер документа прихода;
• способ оплаты.

Некоторые тонкости:

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

• Если в настройке “Тип синхронизации с МС на сайт” указано “только статусы заказов” или “ничего не синхронизировать”, то независимо от того, что выбрано в блоке настроек “Синхронизация оплат”, передачи оплат с МС на сайт не будет, так как по логике оплаты это часть заказа.

• Не поддерживается передача входящих платежей, если один платеж в МоемСкладе привязан к нескольким заказам.

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

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

Привязка отгрузок на сайте происходит по внешнему коду (ни в МС, ни на сайте эти внешние коды нельзя увидеть в интерфейсе, но они есть в коде). Сама синхронизация отгрузок работает на событиях и вебхуках, потому изменения происходят мгновенно.

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

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

Свойство отгрузки, в котором хранится служба доставки - отвечает за то, в какое свойство отгрузки будет сохранено название доставки. Это свойство обязательно для заполнения, если в свойстве “Направление обмена отгрузками” выбрано хотя бы одно направление синхронизации.

Свойство отгрузки, в котором хранится идентификатор отправления - отвечает за то, в какое свойство отгрузки будет сохранено трек номер.

Свойство отгрузки, в котором храниться разрешение доставки - это привязка разрешения доставки с сайта к дополнительному свойству типа "флажок" в МС.

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

Статусы отгрузок - это связки статусов отгрузок, работают так же как и связки статусов заказов, только это для отгрузок. Для привязки нужно создать (если нет) статусы отгрузок на сайте и статусы отгрузок в МС.

Передаваемые данные в отгрузке:

• Позиции товаров в отгрузке и их количество и стоимость;
• Статус отгрузки;
• Служба доставки;
• Стоимость доставки;
• Свойства "Доставка разрешена" и "Отгрузка" ( отгружено или нет);
• Идентификатор отправления;
• Комментарий менеджера.

Синхронизация этих свойств может работать как с сайта в МС так и с МС на сайт.

Основные настройки

Модуль поддерживает двустороннюю синхронизацию заказов: как с сайта в МойСклад, так и из МойСклад на сайт.

В рамках синхронизации вместе с заказами могут передаваться:

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

Запуск и отключение выгрузки заказов

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

Инициаторы синхронизации заказов:

• Вебхуки МойСклад — срабатывают при создании или изменении заказа и инициируют синхронизацию данных на сайт. Используются по умолчанию при включенной синхронизации заказов.

• События 1С-Битрикс — запускаются при создании или изменении заказа на сайте и инициируют синхронизацию данных в МойСклад. Также используются по умолчанию при включенной синхронизации заказов.

• Методы, выполняемые через агенты или cron — используются для обработки созданных и обновлённых заказов на сайте в рамках отложенной синхронизации.

Режимы запуска обработки заказов на сайте

1. Мгновенная выгрузка.

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

2. Отложенная обработка заказов

Это специальный режим, при котором все заказы, созданные или обновлённые на сайте, обрабатываются через очередь. В этом режиме события заказов не используются — как создание, так и обновление выполняются отложенно. Обработка запускается через агенты либо через cron. Дополнительно можно настроить количество сущностей, обрабатываемых за один запуск методов (один хит) через агенты или cron.

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

Ключевую роль в бизнес-процессах при работе с заказами играют статусы.

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

Для настройки соответствий используется отдельный блок настроек — «Привязки статусов заказов»:

В данной настройке автоматически отображаются:

• все доступные статусы заказов в 1С-Битрикс;
• все доступные статусы заказов в МойСклад.

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

В 1С-Битрикс это можно сделать в настройках интернет-магазина:

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

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

Выбор типа синхронизации заказов из МойСклад на сайт

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

Доступны следующие варианты:

• "Заказы, статусы заказов, контрагенты" — все выбранные сущности будут создаваться и обновляться из МойСклад на сайте;
• "Только заказы и контрагенты, кроме статусов" — на сайте будут создаваться и обновляться только заказы и контрагенты, без синхронизации статусов;
• "Только статусы заказов" — будут обновляться только статусы заказов, без создания и обновления самих заказов и контрагентов;
• "Ничего не синхронизировать" — полностью отключает синхронизацию заказов из МойСклад на сайт.

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

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

Можно выбрать один из вариантов:

• обработка создания и обновления заказов;
• только создание заказов;
• только обновление заказов.

Номер заказа в МойСклад

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

По умолчанию при создании заказа в МойСклад используется внутренняя нумерация МойСклад. В результате номер заказа в МойСклад, как правило, не совпадает с идентификатором или номером заказа в 1С-Битрикс.

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

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

Синхронизация полей

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

Связи пользовательских полей в МойСклад и свойств заказа на сайте

Настроить соответствие свойств заказа на сайте и пользовательских полей в МойСклад можно в разделе «Синхронизация заказов», на вкладке «Общие», в блоке «Привязка полей заказов».

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

В левой колонке отображаются дополнительные поля заказа, созданные на стороне МойСклад. Важно: здесь выводятся все поля, включая уже привязанные (например, «Тип доставки») — их можно пропустить на данном этапе.

В правой колонке отображаются свойства заказа на сайте.

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

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

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

На сайте свойства создаются для конкретного плательщика:

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

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

	МС	Сайт
Тип	Строка	Строка, список
Тип	Список	Строка, Список

Важно: При создании свойств на сайте нужно, чтобы вне зависимости типа плательщика у свойств были заданы разные мнемонические кода, изменить нужно также кода свойств, которые уже изначально были созданы.

Рекомендуем изменить, например, поле "Email" для ФЛ код EMAIL для ЮЛ изменить на EMAIL2. Иначе модуль не сохранит настройки корректно.

Синхронизация местоположений

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

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

Обратите внимание: выгрузка местоположения осуществляется только в одну сторону — с сайта в МойСклад, и только в пользовательское поле типа «Строка».

Выгрузка номера заказа

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

Обратите внимание: для данной настройки в МойСклад доступен только тип поля «Строка».

Выгрузка комментариев

Для синхронизации комментария покупателя к заказу необходимо включить настройку «Синхронизация комментария покупателя к заказу» в разделе «Синхронизация заказов» на вкладке «Общие».

Комментарий с сайта (поле «Комментарий покупателя к заказу») синхронизируется с полем «Комментарий» в МойСклад (расположено под списком позиций).

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

Синхронизация заказов - префикс и номера заказов в МС

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

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

Префикс в МС будет выглядеть так:

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

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

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

"С обновлением" - это работает так: если вы измените номер заказа в МС , то при пересохранении заказа на стороне сайта, номер вернется в первоначальное значение.

"Без обновления" - это работает так: если вы измените номер заказа в МС , то при пересохранении заказа на стороне сайта, номер НЕ вернется в первоначальное значение.

Обращаем Ваше внимание, что все заказы работают на событиях, и чтобы изменения вступили в силу, необходимо пересохранить заказ на стороне сайта.

Синхронизация заказов - отмена заказа

Отмена заказа на стороне Сайта

При необходимости отмены заказа в Административной части сайта действуем следующим образом:

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

После выбора "Отменить" необходимо нажать на "Применить"

Заказ отменится

При этом в МС отмененный заказ изменит шрифт на серый цвет

Внутри отмененного заказа галка "Проведено" не активна. Заказ успешно отменен.

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

Отмена заказа на стороне МоегоСклада

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

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

При включении настройки "Резервировать товары при создании заказа". У старых заказов резервы обновляться не будут. Настройка работает только при создании новых заказов.

Товары, которые есть в заказе, будут попадать в МойСклад в резерв.

Синхронизация заказов - выбор заказов, которые нужно передать на сайт

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

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

Синхронизация заказов - дата, с которой нужно начать синхронизировать заказы

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

Синхронизация заказов - принудительно добавлять товары в заказ

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

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

На вкладке “Журнал обмена” можно посмотреть информацию о прохождении синхронизации и ошибках, которые возникли.

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

При работе с заказами в 1С-Битрикс в заказе всегда присутствует информация о доставке: стоимость и название транспортной компании. Однако в Битрикс доставка не добавляется как отдельная позиция корзины.

В системе «МойСклад» структура заказа отличается: отдельной сущности доставки в заказе нет, как и стандартного поля для хранения названия или стоимости доставки. Несмотря на это, модуль синхронизации позволяет гибко передавать информацию о доставке из 1С-Битрикс в МойСклад.

Все настройки, связанные с выгрузкой доставки, находятся в разделе «Синхронизация заказов» → вкладка «Доставки»:

Выгрузка доставки в позицию заказа

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

Для этого необходимо включить настройку «Передавать доставку в заказе» на вкладке «Доставки»:

Если используются настройки по умолчанию и дополнительные параметры не заданы, модуль синхронизации:

• автоматически найдет или создаст услугу с названием «Доставка»;
• добавит эту услугу в заказ;
• укажет стоимость доставки в цене позиции.

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

Использование отдельных услуг для доставок

В некоторых случаях требуется, чтобы в заказ передавалось не общее название «Доставка», а конкретное название службы доставки или транспортной компании.

Для этого используется настройка «Использовать отдельные услуги для доставок»:

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

• службами доставки на сайте;
• услугами в МойСклад.

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

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

Передача информации о доставке в пользовательские поля заказа

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

Для этого используются две настройки:

Привязка даты доставки к свойству «МойСклад»

В данной настройке необходимо указать пользовательское поле типа «Строка» в МойСклад, в которое будет передаваться дата доставки:

Привязка доставки к свойству «МойСклад»

В этой настройке можно указать:

• пользовательское поле типа «Строка»;
• либо пользовательский справочник МойСклад.

В выбранное поле будет передаваться название доставки, используемое в заказе.

⚠️ Важно! При изменении стоимости доставки в позиции заказа данное изменение не будет синхронизировано со стоимостью доставки в 1С-Битрикс. Это связано с ограничениями платформы. При этом, если стоимость доставки изменена в отгрузке, такая цена будет успешно синхронизирована. Подробнее об отгрузках и передаче данных по доставке можно узнать тут.