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

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

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

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

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

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 тдругип цены, большех сущноздавасть не позволяет тариф.

Обращаем ваше внимание, что при ошибкей) в логах "нможет появляться ошибка «Неверная цена"».

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

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

Выгрузка информации об НДС

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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