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

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

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

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

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

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

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

2. Выбрать режим обновления товаров:

   • Однократное обновление товаров - товары которые были созданы в МС ранее и их остатки можно выгрузить одноразово кнопкой "Создать/обновить базу товаров/торговых предложений" внизу настроек вкладки модуля "Синхронизация товаров" + одновременно новые товары, которые создаются в МС, будут создаваться и обновляться на сайте моментально с помощью вебхуков.

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

3. Выбрать формат работы с товарами:

   • Добавлять товары, обновлять товары;
   • Добавлять товары, не обновлять товары;
   • Не добавлять товары, обновлять товары;
   • Не добавлять товары, не обновлять товары.

4. Выбрать формат работы с остатками:

   • Обновлять доступное количество и обновлять остаток по складам;
   • Обновлять доступное количество, не обновлять остаток по складам;
   • Не обновлять доступное количество, но обновлять остаток по складам;
   • Не обновлять доступное количество и не обновлять остаток по складам.

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

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

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

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

При обработке складов в МойСклад учитываются остатки поля "Доступно":

Поле "Доступное количество" на сайте, можно найти в настройках торгового каталога:

Все настройки для этого функционала расположены на вкладке "Остатки" раздела "Синхронизация каталога":

Формат работы с остатками

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

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

В этом поле есть несколько вариантов:

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

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

⚠️ Важно! При создании склада в 1С-Битрикс поле «Адрес склада» является обязательным. Для корректной выгрузки складов из МойСклад на сайт необходимо, чтобы у склада было заполнено поле «Адрес». Если адрес не указан, такой склад не будет создан на сайте, а в логах модуля появится сообщение об ошибке.

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

Поле «Доступное количество» во вкладке «Торговый каталог» часто играет важную роль в работе интернет-магазина и отображении товаров в публичной части сайта.

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

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

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

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

⚠️ Важно! Данное поле не ограничивает выгрузку остатков по складам. Оно влияет только на расчёт «Доступного количества»..

Асинхронный режим

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

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

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

Шаг обработки товаров при загрузке остатков

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

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

Выгрузка товаров и торговых предложений

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

• разделов каталога;
• товаров;
• модификаций (выгружаются как торговые предложения);
• комплектов.

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

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

1. Пошаговая синхронизация (цикл) Это основной процесс, длительность которого зависит от объёма каталога. В рамках цикла выполняется выгрузка:

• товаров;
• модификаций (торговых предложений);
• комплектов;
• разделов;
• остатков;
• изображений.

Данный процесс запускается либо через агенты 1С-Битрикс, либо через cron.

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

Обработка может выполняться:

• сразу при получении запроса;
• либо в отложенном режиме.

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

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

Все настройки управления функционалом модуля для синхронизации каталоганаходятся по пути «Магазин» -> «Синхронизация с МойСклад» -> «Синхронизация каталога»:

1. Включение и отключение синхронизации

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

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

2. Способ запуска пошаговой синхронизации

Данная настройка определяет механизм запуска процессов выгрузки каталога на сайт.

Доступны два варианта:

• На агентах Битрикс — для выполнения синхронизации используются стандартные агенты. Для разных сущностей (товары, торговые предложения и т.д.) запускаются отдельные агенты, обеспечивающие корректную работу пошагового обмена.
• На крон — в этом режиме методы синхронизации запускаются через cron. При этом агенты в системе могут присутствовать, но фактически не используются. Для работы данного режима необходимо дополнительно установить выполнение скрипта на крон:

* * * * * php -f [путь_до_корня_сайта]/bitrix/modules/design2u.syncms/cron.php

3. Формат работы с товарами

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

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

• только создание сущностей;
• только обновление сущностей;
• создание и обновление одновременно.

Изменение активности.

Функционал модуля позволяет управлять активностью товаров на сайте.

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

Модуль учитывает эту особенность и позволяет настроить, какие товары на сайте будут активными, а какие — нет. Это настраивается с помощью опции "Признак активности товаров на сайте":

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

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

• Не изменять активность, архивные товары не создаются на сайте — при создании нового товара в МойСклад он будет выгружен на сайт как активный. При переводе товара в архив в МойСклад его активность на сайте не изменяется. Если активность товара на сайте была изменена вручную, модуль не будет её перезаписывать.
• По архивности, архивные товары не создаются на сайте — при создании нового товара в МойСклад он будет выгружен на сайт как активный. При переводе товара в архив в МойСклад его активность на сайте автоматически изменится (товар станет неактивным). Товары, находящиеся в архиве в МойСклад, не создаются на сайте.
• По доступному количеству, если количество 0, то товар деактивируется — если у товара есть остаток в МойСклад, он будет активен на сайте. При нулевом остатке товар становится неактивным.
• По свойству типа «Флаг» — в МойСклад необходимо создать пользовательское поле типа «Флажок» (Настройки → Дополнительные поля). Если флажок установлен, товар будет активным на сайте; если нет — неактивным.

⚠️ Важно! При использовании режимов изменения активности (по архивности, по доступному количеству или по полю типа «Флаг») необходимо учитывать, что изменения активности, выполненные на сайте вручную, сохраняются, но при следующем цикле синхронизации будут перезаписаны в соответствии с настройками модуля.

⚠️ Важно! Если используется режим изменения активности по свойству типа «Флаг» (в МойСклад), следует учитывать, что при изменении только этого поля вебхук не срабатывает. В результате изменение активности товара на сайте произойдёт только после завершения очередного цикла синхронизации.

⚠️ Важно! Не следует путать активность товара с его доступностью. Активность товара — это чекбокс, который определяет, отображается ли товар в публичной части сайта. Он не связан с доступным количеством или фактическим наличием товара в каталоге.

Работа с архивными товарами

При работе с архивными товарами следует учитывать:

• Архивные товары могут обновляться из МойСклад на сайт только при включенной настройке «По архивности, архивные товары не создаются на сайте (не рекомендуется)». В остальных конфигурациях такие товары модулем игнорируются.

• Удаление лишних торговых предложений (ТП) выполняется только в направлении из МойСклад на сайт и только при включенной настройке «Удалять ТП на сайте, если таковых нет в МойСклад».

  

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

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

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

Выгрузка описания

Данная настройка позволяет включить выгрузку текста из поля "Описание" товара в МойСклад в поле «Детальное описание» или «Анонсовое описание» товара на сайте.

Пример выгрузки:

1. Описание в МойСклад

2. Детальное описание товара на сайте

Выгрузка изображений

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

Настройки, отвечающие за этот функционал, расположены в блоке «Изображения» в разделе «Синхронизация каталога» и позволяют гибко управлять выгрузкой.

Доступны следующие возможности:

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

• в анонсовую картинку товара на сайте;
• в детальную картинку товара на сайте.

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

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

Настройки разделены:

• отдельно для товаров;
• отдельно для торговых предложений.

⚠️ Важно! Модуль синхронизирует изображения в форматах jpg, png, gif

Пример выгрузки:

1. Поля на сайте:

2. Поля в МойСклад

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

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

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

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

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

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

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

В этом блоке можно отдельно настроить:

• связи для полей товаров;
• связи для полей торговых предложений.

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

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

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

Добавить пользовательские поля для товаров на стороне сайта можно в административной части, в разделе «Магазин».

Отдельно стоит отметить, что на стороне сайта можно использовать поля типа «Справочник». Такие поля позволяют привязывать к элементам каталога значения из справочников (Highload-блоков).

Модуль поддерживает передачу данных из поля типа «Строка» в МойСклад в поле типа «Справочник» на сайте. При этом сопоставление значений выполняется по полю XML_ID (внешний код).

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

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

	МС	Сайт
Тип	Строка	Любой тип
Тип	Справочник	Любой тип
Тип	Список	Любой тип

Модуль поддерживает работу со свойствами типа «Файл».

Обратите внимание: поддержка свойств типа «Файл» реализована только для простых товаров. Для торговых предложений данный функционал не предусмотрен.

⚠️ Важно!: при настройке соответствий типы полей должны совпадать — свойство типа «Файл» на сайте можно привязать только к свойству типа «Файл» в МойСклад.

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

Такие данные, как:

• наименование;
• внешний код;
• доступное количество;
• остатки по складам;
• описание товара;
• цены и НДС;
• изображения

передаются через отдельные настройки модуля и не относятся к разделу «Связи полей».

При этом в разделе «Связи полей» можно дополнительно настраивать соответствие некоторых стандартных полей, например:

• код;
• объём;
• вес;
• артикул;
• страна.

Синхронизация цен

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

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

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

• На стороне сайта можно выбирать только те типы цен, которые созданы в разделе управления типами цен. При этом использовать тип «Закупочная цена» (предустановленный в торговом каталоге) нельзя.
• На стороне МойСклад доступны только типы цен продажи и нельзя использовать минимальную и закупочную цену

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

Как добавить типы цен и валюты

Добавить новый тип цены в МойСклад можно в разделе «Товары», на странице со списком товаров, воспользовавшись кнопкой «Настройки».

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

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

⚠️ Важно! буквенный код валюты в МС обязательно должен состоять из латинских букв.

Добавить новый тип цены на сайте можно в административной части по пути: «Магазин» → «Цены» → «Типы цен». В этом разделе доступно создание новых типов цен.

⚠️ Важно! возможность добавления дополнительных типов цен доступна только начиная с редакции «Бизнес» в 1С-Битрикс.

В процессе синхронизации каталога (товаров и других сущностей) в логах может появляться ошибка «Неверная цена».

Для её устранения можно выполнить следующие действия:

1. Проверить, заполнены ли все типы цен у товаров, участвующих в синхронизации, и отсутствуют ли нулевые значения цен.
2. Включить в настройках модуля (раздел «Синхронизация каталога») опцию «Затирание свойств и цены из МойСклад на сайте пустыми значениями». Это позволит корректно обрабатывать пустые значения и избежать возникновения ошибки.

Расширенный режим работы с ценами

В административной части 1С-Битрикс предусмотрен расширенный режим работы с ценами. В этом режиме стоимость товара может зависеть от количества — задаются диапазоны и соответствующие им цены.

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

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

Выгрузка НДС

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

Все настройки, связанные с НДС, расположены в блоке «Цены» раздела «Синхронизация каталога».

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

При отмеченной опции ставка НДС будет передаваться из МойСклад:

В товар каталога на сайте:

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

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

Для этого необходимо включить опцию «Проставлять товарам галочку „НДС включен в цену“».

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

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

• Комплекты синхронизируются как с МС на сайт, так и с сайта в МС (с урезанными данными с заказами сайта).
• Синхронизация работает как и пошагово на планировщике, так и моментально с вебхуками.
• Комплект на сайте будет соответствовать комплекту в МойСклад.
• В комплекте будут передаваться все те же данные что и для товаров, то есть картинки, свойства, типы цен, описание.
• Функционала остатков как такового нет, поэтому будет передаваться только остатки товаров с комплектов.
• Комплекты как и товары связываются по внешнему коду.
• В составе комплекта будут передаваться позиции товаров/торговых предложений и их количество в комплекте.
• Процент распределения скидки и сортировка не передаются.
• Комплекты с сайта в МС будут искаться по внешнему коду вначале среди товаров, потом среди комплектов, и подвязываться к заказу, если найдутся. Если не найдутся, то с комплекты с сайта создаются в МС как простой товар с таким же внешним кодом.
• Как и у простого товара, у комплекта одна стоимость, она и будет передаваться.

Характеристики торговых предложений (SKU)

Модуль также поддерживает синхронизацию торговых предложений (SKU) на сайте.

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

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

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

На данный момент для настройки соответствия между свойствами торговых предложений и характеристиками модификаций поддерживаются следующие типы:

• в МойСклад — поля типа «Строка» и «Список»;
• на сайте — в том числе поля типа «Справочник» для торговых предложений.

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

Как добавить поля и характеристики

Добавить новую характеристику для модификации в МойСклад можно в интерфейсе редактирования товара.

На вкладке «Модификации» при создании или редактировании модификации можно выбрать существующую характеристику или создать новую непосредственно в этом разделе:

Добавить новое свойство для торгового предложения можно аналогично добавлению пользовательских свойств товаров — через интерфейс 1С-Битрикс:

Так же есть еще три дополнительных настройки при синхронизации ТП:

• Добавлять характеристики ТП в названия ТП - характеристики торговых предложений из МойСклад будут добавляться в названия торговых предложений на сайте для более удобного просмотра;
• Удалять ТП на сайте если таковых нет в МС - при выборе данной настройки торговые предложения, которых нет в МойСклад будут удаляться на сайте при обновлении товаров;
• Дублировать вес и габариты в ТП - вес и габариты главного товара будут автоматически присваиваться его торговым предложениям.

⚠️ Важно! Если товары на сайте были выгружены стандартной интеграцией (через CommerceML), внешний код SKU на сайте может содержать символ «#». Чтобы устранить эту проблему, можно воспользоваться одним из следующих способов:

• удалить товары, чтобы они были загружены заново;

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

  

Выгрузка штрихкодов

Для настройки выгрузки штрихкодов используется отдельный блок в разделе «Синхронизация каталога» — «Штрихкоды».

С помощью данного блока можно:

• настроить выгрузку штрихкодов в стандартное поля при использовании складского учёта на сайте;
• настроить передачу штрихкодов в пользовательские поля на сайте, если складской учёт не используется.

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

Для выгрузки штрихкода из МойСклад в стандартное поля «Штрихкод» на сайте (при включённом складском учёте) используется опция «Синхронизировать штрихкоды»:

Если складской учёт в 1С-Битрикс не используется, стандартные поля «Штрихкод» в товарах каталога отсутствуют. В этом случае модуль позволяет выгружать штрихкоды различных типов в пользовательские поля товаров и торговых предложений на сайте.

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

Доступны два варианта:

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

Настройка для товаров:

Настройка для торговых предложений/модификаций:

Единицы измерения

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

В 1С-Битрикс настройка единицы измерения доступна в Форме редактирования товара, на вкладке «Торговый каталог», в разделе «Параметры»:

В МойСклад это поле находится в товаре, в блоке «Общие данные»:

Настроить соответствие единиц измерения можно в административной части модуля, в блоке «Связи полей».

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

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

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

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

Запуск синхронизации разделов

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

Запуск осуществляется:

• через агенты 1С-Битрикс;
• либо через cron (с использованием отдельного скрипта).

Настройки выгрузки разделов

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

Режимы синхронизации разделов

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

Есть два основных режима:

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

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

Частичная выгрузка дерева

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

Для этого необходимо выбрать нужные разделы в настройке «Разделы в МойСклад, из которых будут загружаться товары»:

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

Возможны два варианта:

• «Не создавать корневые разделы при выгрузке» — выбранные в настройках разделы не будут созданы в корне каталога на сайте. При этом вложенные в них разделы будут созданы. Товары, расположенные непосредственно в выбранных разделах, будут выгружены в корень каталога.

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

Управление активностью разделов

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

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

С помощью настроек модуля можно:

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

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

Изменение активности синхронизируемых разделов

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

Особенности работы данной настройки:

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

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

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

В таком режиме:

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

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

Обработка разделов не участвующих в синхронизации

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

Речь идёт о разделах, которые могли быть созданы на сайте ранее, ещё до настройки синхронизации, либо были добавлены вручную и не имеют соответствующих групп в «МойСклад».

Для таких разделов предусмотрена отдельная настройка "Разделы на сайте которых нет в МойСклад":

Доступно два варианта:

1. Деактивировать — все разделы, которые отсутствуют в синхронизации и не имеют соответствующих групп в «МойСклад», будут автоматически деактивированы;
2. Не трогать — модуль не будет изменять состояние таких разделов. Они сохранят текущую активность независимо от того, были ли они активны или деактивированы ранее.

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

Множественная привязка товаров к разделам

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

Для управления этим поведением предусмотрены две настройки:

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

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

Сброс предыдущей связи в множественной привязке

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

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

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

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

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

Модуль синхронизации поддерживает выгрузку сущностей типа «Услуга» из МойСклад в каталог на сайте.

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

Настройки выгрузки услуг

Все параметры управления находятся в разделе: «Синхронизация каталога» → вкладка «Услуги».

В данном разделе можно:

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

Запуск синхронизации

Выгрузка услуг выполняется:

• по вебхукам (при изменении данных в МойСклад);
• в рамках отдельного цикла синхронизации (через агенты или cron).

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

Включение выгрузки

Опция «Выгружать услуги в каталог» позволяет включить или отключить передачу услуг из МойСклад на сайт.

Связи цен

Настройка «Связи для цен» работает аналогично настройке цен для товаров.

• в левой колонке выбирается тип цены на сайте;
• в правой — соответствующий тип цены в МойСклад.

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

Связи полей

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

Поддерживаемые типы:

• на сайте: строка, справочник, привязка к элементам;
• в МойСклад: строка, список.

Количество связей не ограничено.

Настройка разделов

В блоке «Разделы для выгрузки» можно определить, куда будут размещаться услуги:

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

Передаваемые данные

При синхронизации:

• название услуги передаётся без изменений;
• описание из МойСклад выгружается в поле «Детальное описание» на сайте.