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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Свойства

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

Можно передавать на сайт только выделенные типы полей

Создать нужные поля на строне сайта:

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

Реализована передача поля типа "Справочник" на сайт из поля типа "Строка" из МоегоСклада. При этом синхронизация такого свойства будет осуществляться по полю XML_ID (это внешний код), если этого свойства нет на сайте, то нужно создать:

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

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

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

Свойство типа "Файл" реализовано только для простых товаров, для ТП не реализовано.

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

Название
Внешний код
Доступное количество
Остаток по складам
Описание товара
Цены (кроме закупочной и минимальной)
Код
Объем
Вес
Артикул
Страна
НДС
Изображение

Цены

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

Цены в МоемСкладе можно создать и отредактировать в карточке товара:

Обращаем ваше внимание, что при ошибке в логах "неверная цена" нужно:

Или проверить заполнены ли все цены для товаров (нет нулевых цен)
Или в настройках товаров установить чекбокс "Затирание свойства и цены из МС на сайте пустыми значениями"

Валюта создается в настройках:

Цены на сайте можно настроить в разделе "Цены":

Важно:

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

Если у Вас тариф Битрикс "Малый бизнес" то получиться синхронизировать только 1 тип цены, больше создавать не позволяет тариф.

НДС

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

Ставка НДС будет передаваться из МойСклад

В карточку товара на сайте

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

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

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

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

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

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

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

Важно
Если у Вас товары на сайте выгружены стандартной интеграцией, то внешний код на сайте будет передан со знаком "#". Чтобы нивелировать данную проблему достаточно:

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

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

Создать свойство торгового предложения на сайте:

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

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

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

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

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

Для настройки передачи штрихкода из МС на сайт, существует возможность выбора ПО ТИПУ или ПО РАСПОЛОЖЕНИЮ

Выбираем в настройках привязку ШТРИХКОД, и затем выбираем привязку из поля "Тип колонки на сайте"

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

Единицы измерения являются встроенными полями как в 1С-Битрикс, так и в МойСклад.

В 1С-Битрикс единицы измерения отображаются во вкладке товара в полях торгового каталога, расположенных здесь:

В МойСклад данное поле расположено в разделе «Общие данные».

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

Аналогично свойствам и ценам, для единиц измерения можно задать неограниченное количество связей.