# Основные настройки
# 2. Авторизация в модуле
Для начала настройки модуля после его установки необходимо выполнить авторизацию.
При первом открытии страницы модуля отображается форма авторизации, в которую требуется ввести логин и пароль от МойСклад.
До выполнения авторизации доступен только раздел «Авторизация». Перейти к нему можно по пути:
«Магазин» → «Синхронизация с МойСклад»:
[](https://doc.aprix.ru/uploads/images/gallery/2026-05/rnLA3EgfGeKlMFdm-auth1.jpg)
В разделе «Авторизация» необходимо ввести учётные данные и нажать кнопку «Авторизация».
При успешной авторизации открывается основной интерфейс модуля с доступом к дальнейшим настройкам.
**Смотреть видео как настроить агенты на кроне:** [1С-Битрикс. Ставим выполнение агентов на крон (Crontab)](https://vk.com/video-228521075_456239031)
# Синхронизация заказов - свойства заказов
С помощью модуля можно реализовать передачу стандартных и дополнительных полей с данными заказа, как с сайта в МС, так и с МС на сайт.
Для этого нужно настроить опцию "Привязка полей заказов" на вкладке модуля "Синхронизация заказов" вкладк. В этой настройке можно сделать привязку свойств заказа конкретного плательщика на сайте к полям заказа в МС.
В левой колонке настройки отображаются дополнительные поля заказа, которые созданы на стороне МС. (Важно: Там отображаются все поля, даже те, которые уже привязаны, например, "Тип доставки", их нужно просто пропустить на данном этапе), в правой колонке - свойства заказа на сайте. Нужно указать нужные Вам настройки (лишние, которые не нужны оставить пустыми) и сохранить настройки модуля.
Свойства заказа в МС создаются с помощью дополнительных полей:
На сайте свойства создаются для конкретного плательщика:
Данные привязанных полей можно изменять как на стороне МС, так и на стороне сайта, синхронизация будет происходить моментально.
Важно: Для корректной передачи полей заказов из МС на сайт, нужно настроить типы полей для сопоставления их в модуле следующим образом:
| |МС | Сайт |
|:------------- |:---------------:| -------------:|
| Тип | Строка | Строка, список |
| Тип | Список | Строка, Список |
Важно: При создании свойств на сайте нужно, чтобы вне зависимости типа плательщика у свойств были заданы разные мнемонические кода, изменить нужно также кода свойств, которые уже изначально были созданы.
Рекомендуем изменить, например, поле "Email" для ФЛ код EMAIL для ЮЛ изменить на EMAIL2. Иначе модуль не сохранит настройки корректно.
# Механизмы запуска синхронизации и их настройки
Функционал модуля синхронизации охватывает различные этапы бизнес-процессов, связанных с заказами и каталогом товаров.
Для запуска процессов синхронизации (загрузки, выгрузки и передачи данных) используются различные триггеры как на стороне модуля, так и на стороне МойСклад.
В модуле используется 3 типа основных инициаторов (триггеров) запуска процессов синхронизации:
### 1. Вебхуки МойСклад
Вебхуки срабатывают при создании или изменении сущностей в МойСклад. К таким сущностям относятся элементы каталога (товары, модификации, комплекты), а также данные, связанные с заказами.
При срабатывании вебхука на сайт отправляется HTTP-запрос, который обрабатывается модулем и инициирует соответствующие процессы синхронизации.
Запрос представляет собой POST-запрос, содержащий информацию о событии: его тип и ссылку на изменённый объект. Например, при изменении наименования товара будет отправлен запрос со ссылкой на данный товар.
Модуль использует вебхуки для оперативной передачи данных при синхронизации товаров и заказов. Это позволяет не дожидаться выполнения циклической синхронизации (через cron), а поддерживать актуальность данных на сайте и в МойСклад в режиме, близком к реальному времени.
> ⚠️ **Важно** Для более подробного понимания принципов работы вебхуков в МойСклад рекомендуется обратиться к [официальной документации МойСклад](https://support.moysklad.ru/hc/ru/articles/360018621838).
Настройка вебхуков расположена на странице обязательных настроек модуля обмена с МС.
При первой установке модуля вебхуки не добавляются в МойСклад автоматически — их необходимо создать вручную.
Для этого после авторизации перейдите в раздел «Вебхуки и агенты». В данном разделе доступны несколько вкладок, две из которых предназначены для настройки вебхуков, необходимых для корректной работы модуля:
[](https://doc.aprix.ru/uploads/images/gallery/2026-05/RbRExAt71mFdp0nt-wh1.jpg)
При добавлении вебхука в МойСклад указывается URL (ссылка), на который будет отправляться запрос. Для такой ссылки обязательно должен быть указан домен.
По умолчанию домен определяется на основании общих настроек 1С-Битрикс, однако для корректной работы рекомендуется явно указать его в поле «Основной домен».
Рекомендуется заполнять это поле во всех случаях при настройке вебхуков:
[](https://doc.aprix.ru/uploads/images/gallery/2026-05/8OZXzVZ4r9EmlPBP-wh2.jpg)
#### Типы обработки вебхуков
В модуле предусмотрено два режима обработки вебхуков. Режим можно указать в отдельном выпадающем списке в разделе настроек вебхуков:
[](https://doc.aprix.ru/uploads/images/gallery/2026-05/QT15NS0ZVklgRmYO-wh3.jpg)
**1. Обработка без очереди.**
В данном режиме вебхуки обрабатываются сразу при поступлении на сайт. Это наиболее быстрый способ, при котором изменения в МойСклад практически мгновенно отражаются на сайте.
Для настройки доступны дополнительные параметры:
**"Количество одновременно обрабатываемых вебхуков":**
[](https://doc.aprix.ru/uploads/images/gallery/2026-05/V4H9duwaTqKOd69P-wh4.jpg)
**"Синхронизировать множественные вебхуки"** — используется при массовом редактировании данных в МойСклад:
[](https://doc.aprix.ru/uploads/images/gallery/2026-05/2qh0fYdgLon9z8jY-wh5.jpg)
Режим обработки вебхуков без очередей имеет ограничения:
* при высокой нагрузке и большом количестве изменений возможны ошибки обработки;
* часть вебхуков может быть пропущена и не обработана;
* использование режима с включённой обработкой множественных вебхуков (вебхук полученный после группового редактирования элементов в МойСклад) на текущий момент не рекомендуется.
**2. Обработка на очередях**
В этом режиме все входящие вебхуки сначала сохраняются в базе данных, после чего обрабатываются последовательно.
Обработка выполняется:
* через агенты 1С-Битрикс;
* либо через cron (с использованием отдельного скрипта).
Дополнительно можно настроить количество вебхуков, обрабатываемых за один запуск:
[](https://doc.aprix.ru/uploads/images/gallery/2026-05/OzXutoDK26TVbmy3-wh6.jpg)
Преимущества данного режима:
* гарантированная обработка всех вебхуков;
* отсутствие потери данных при высокой нагрузке;
* стабильная работа при большом объёме изменений.
Несмотря на то, что обработка происходит не мгновенно, данный режим является рекомендуемым для использования.
#### Как создать в МойСклад необходимые вебхуки
Для добавления всех необходимых вебхуков в МойСклад перейдите в раздел «Вебхуки и агенты», на вкладку «Основные настройки», и нажмите кнопку «Проверить/восстановить необходимые вебхуки».
После завершения процесса в блоках «Вебхуки заказов и контрагентов» и «Вебхуки товаров, оприходований и разделов» отобразится список всех добавленных вебхуков.
[](https://doc.aprix.ru/uploads/images/gallery/2026-05/7POOGkPHulWAIG63-wh7.jpg)
#### Менеджер вебхуков
При работе с вебхуками часто возникает необходимость получить информацию о том, какие вебхуки уже добавлены в МойСклад, с какими доменами они связаны и для каких сущностей настроены.
В стандартном интерфейсе МойСклад отсутствует удобный инструмент для просмотра и управления вебхуками. Поэтому в модуле синхронизации реализован отдельный раздел — «Менеджер вебхуков»:
[](https://doc.aprix.ru/uploads/images/gallery/2026-05/kwKJxLGruvAx5114-wh8.jpg)
Данный функционал позволяет:
* просматривать список всех вебхуков, зарегистрированных в МойСклад;
* видеть, для какой сущности и действия настроен вебхук;
* получать идентификатор вебхука и его URL;
* редактировать существующие вебхуки;
* удалять вебхуки, включая возможность массового удаления.
Менеджер вебхуков предоставляет удобный интерфейс для полного контроля и управления вебхуками, используемыми в интеграции.
Для загрузки списка всех вебхуков, зарегистрированных в МойСклад, используйте кнопку «Загрузить все вебхуки»:
[](https://doc.aprix.ru/uploads/images/gallery/2026-05/2TtW3gu0o39k6GSa-wh10.jpg)
Для добавления нового вебхука предусмотрена кнопка «Добавить вебхук»:
[](https://doc.aprix.ru/uploads/images/gallery/2026-05/4EMtboFwZCk69MaD-wh9.jpg)
При необходимости удаления нескольких вебхуков можно выбрать нужные записи с помощью чекбоксов — после этого появится дополнительная кнопка для их удаления.
[](https://doc.aprix.ru/uploads/images/gallery/2026-05/GKQR8Pe4OqUHhKDx-wh12.jpg)
#### Возможные проблемы с добавлением вебхуков:
##### 1. Изменения домена сайта
При смене домена сайта могут возникнуть проблемы с работой функционала, связанного с вебхуками. Это связано с тем, что информация о вебхуках, включая используемый домен, хранится на стороне МойСклад и не обновляется автоматически при изменении домена сайта.
Для корректной работы необходимо вручную обновить настройки вебхуков:
1. Перейдите в раздел «Вебхуки и агенты» и на вкладке «Основные настройки» укажите новый домен в поле «Основной домен».
2. Затем в «Менеджере вебхуков» удалите старые вебхуки, созданные для предыдущего домена.
3. После этого нажмите кнопку «Проверить/восстановить необходимые вебхуки» на вкладке «Основные настройки», чтобы создать актуальные вебхуки с новым доменом.
##### 3. Ошибка при добавлении/восстановлении вебхуков
При создании вебхуков (в частности, при использовании функции «Проверить/восстановить необходимые вебхуки») в интерфейсе модуля могут отображаться ошибки, полученные от МойСклад.
В большинстве случаев такие ошибки связаны с ограничениями на создание вебхуков, установленными в МойСклад.
Согласно документации МойСклад, комбинация параметров entityType (сущность), action (действие) и url (адрес обработчика) должна быть уникальной. При этом для одной комбинации сущности и действия допускается не более 5 вебхуков с различными URL.
Например, для сущности «Заказ покупателя» и действия «создание» можно создать не более 5 вебхуков (с разными адресами).
В связи с этим ошибка может возникать, если в вашей учётной записи МойСклад уже созданы вебхуки с такими же параметрами (например, для других сайтов или интеграций). В этом случае модуль не сможет добавить новые вебхуки, так как будет превышено допустимое количество.
Рекомендуется проверить существующие вебхуки в МойСклад и при необходимости удалить неиспользуемые или дублирующие записи. Сделать это можно через «Менеджер вебхуков», доступный в административной части модуля.
##### Удаление вебхуков
Если вам больше не требуются вебхуки, используемые в МойСклад, или необходимо временно отключить связанные с ними бизнес-процессы (в том числе процессы модуля синхронизации), вы можете удалить такие вебхуки через «Менеджер вебхуков», доступный в разделе «Вебхуки и агенты» в настройках модуля.
##### Возможные блокировки вебхуков со стороны МоегоСклада
В некоторых случаях, даже при наличии настроенных вебхуков в МойСклад, они могут не срабатывать. Это означает, что при изменении сущности (например, товара или заказа) запрос на сайт не отправляется.
Чаще всего такая ситуация связана с деактивацией вебхука.
Согласно документации МойСклад, при отправке вебхука система ожидает получить HTTP-ответ со статусом 200 или 204 в течение 1500 мс. Если корректный ответ не получен, выполняется несколько повторных попыток отправки. Если все попытки завершаются неудачно, вебхук считается неотработанным и в дальнейшем может быть деактивирован.
Деактивация вебхука означает, что он остаётся в системе МойСклад, но перестаёт срабатывать (становится неактивным).
Определить это можно в «Менеджере вебхуков» модуля:
* активные вебхуки выделены зеленым цветом;
* деактивированные вебхуки подсвечиваются красным цветом.
**Что делать при деактивации вебхук?**
Если вебхук был деактивирован, рекомендуется:
* Удалить неактивный вебхук через «Менеджер вебхуков»;
* Перейти во вкладку «Основные настройки»;
* Нажать кнопку «Проверить/восстановить необходимые вебхуки» для повторного создания вебхуков.
**Причины деактивации:**
На практике наиболее частая причина — временная недоступность сайта.
Если в момент отправки вебхука сайт не отвечал (например, из-за проблем с сервером или сетью), МойСклад не получал корректный ответ и в результате мог деактивировать вебхук.
#### 2. События в 1С-Битрикс
События возникают при создании или изменении сущностей на сайте (например, заказов). При их срабатывании запускаются процессы выгрузки данных в МойСклад.
Модуль синхронизации использует ряд событий 1С-Битрикс для запуска обмена, в том числе:
* события создания и изменения заказов;
* события обновления пользователей;
* события, связанные с добавлением отгрузок и оплат по заказам
#### 3. Циклические процессы (планировщик)
Отдельные методы синхронизации выполняются по расписанию.
для полноценной работы модуля нужно перевести выполнение агентов на cron.
Такие процессы могут запускаться:
* через агенты 1С-Битрикс;
* через cron (с использованием отдельного скрипта).
Циклический запуск используется для выполнения регулярной синхронизации и обработки накопленных данных.
Основные функции модуля работают через события (вебхуки). Но для полноценной работы модуля нужно перевести выполнение агентов на cron.
А именно крон нужно настроить обязательно для:
- одноразовой и циклической синхронизации товаров и остатков;
- синхронизации заказов на агентах (если нужно, они изначально настроены на вебхуки);
- синхронизации скидок.
Выполнение агентов можно настроить через постановку агентов на CronTab так и через выполнение агентов на крон.
Для выполнения агентов на крон нужно поставить обязательно файл
<адрес сайта>/bitrix/services/design2u.syncms/cron_aprix.php в планировщике на выполнение каждую минуту.
Второй способ:
Для постановки выполнения агентов на CronTab нужно сделать настройки следуя шагам [инструкции](https://dev.1c-bitrix.ru/learning/course/?COURSE_ID=43&LESSON_ID=2943) от Битрикс.
Видео: [1С-Битрикс. Ставим выполнение агентов на крон (CronTab)](https://vk.com/video-228521075_456239031)
# Первые шаги - обязательные настройки
> ВНИМАНИЕ. Обращаем ваше внимание на то, что при первичной регистрации нужны права администратора в МоемСкладе
[](https://doc.aprix.ru/uploads/images/gallery/2025-12/DmHJvqUIiEcyNH1j-skrinsot-18-12-2025-134455.jpg)
Перед тем как настроить обмен номенклатурой товаров, нужно сделать обязательную настройку, на вкладке "Обязательные настройки".
[](https://doc.aprix.ru/uploads/images/gallery/2025-07/t7xnXkbvF9yARis0-skrinsot-18-07-2025-103742.jpg)
- ID Инфоблока с товарами - инфоблок, в который будут синхронизироваться товары из МС.
- Выбрать отдел, организацию, склад по умолчанию, который установлен у Вас в МойСклад.
- Группы пользователя - тут нужно выбрать в какую группу пользователей на сайте попадет контрагент, который будет создаваться вместе с заказов с МойСклад.
- Привязки типов плательщиков - нужно указать какой тип плательщика на сайте будет соответствовать какому типу контрагента с МС, при создании заказа что на сайте что с МойСклад и выбрать какой из них основной.
- Настройки вебхуков рекомендуем оставить по умолчанию.
# 1. Установка модуля из1С-Битрикс: Маркетплейс
Модуль «МойСклад: Расширенная интеграция» устанавливается через маркетплейс 1С-Битрикс.
Процесс установки и активации:
##### 1. Установка из Маркетплейс.
На странице решения «МойСклад: Расширенная интеграция» необходимо приобрести купон на установку модуля, оформив и оплатив заказ, либо воспользоваться пробным периодом, нажав кнопку «Попробовать (25 дней)».
После этого укажите URL вашего сайта в соответствующем поле и нажмите кнопку «Установить»:
[](https://doc.aprix.ru/uploads/images/gallery/2026-05/kUDhzD6KpJy6ugPA-install1.jpg)
> ⚠️ **Важно!**
> * URL должен указывать на главную страницу сайта (без дополнительных путей и параметров);
> * вы должны быть авторизованы в административной части сайта на 1С-Битрикс.:
##### 2. Активация купона
Ссылка для покупки купона на решение: [http://marketplace.1c-bitrix.ru/solutions/design2u.syncms/](http://marketplace.1c-bitrix.ru/solutions/design2u.syncms/)
Если купон приобретён, перейдите в административную панель сайта и выполните его активацию:
[](https://doc.aprix.ru/uploads/images/gallery/2025-07/VcriKkaEndrPfjYG-2.jpg)
- После нажатия кнопки «Установить» откроется страница «Система обновлений сторонних решений». Убедитесь, что напротив решения установлена галочка, и нажмите «Загрузить»;
- Следуйте шагам мастера установки и примите лицензионное соглашение;
- Дождитесь завершения загрузки модуля и нажмите кнопку «Установить».
**Поздравляем Вас! Решение "МойСклад: расширенная интеграция" успешно установлено.**