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

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

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

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

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

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С-Битрикс настройка единицы измерения доступна в Форме редактирования товара, на вкладке «Торговый каталог», в разделе «Параметры»:

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

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

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