🚀
Быстрый старт
Перед быстрым стартом необходимо выяснить основные моменты при обмене товарами, ответив на несколько вопросов, т.о. у вас будет мини ТЗ на обмен товарами.
По вопросам настройки модуля пишите на почту или телеграм:

Как сейчас происходит обмен?

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

Что обмениваем?

Модуль умеет раздельно обменивать следующие сущности:
  • Остатки
  • Цены
  • Товары
  • Модификации
  • Комплекты
  • Услуги
  • Группы (разделы из МС)
Вам необходимо выписать, что вы хотите обменивать, от этого будет дальнейшая ваша работа с документацией и настройкой модуля. Ответы на вопросы ниже также зависят от первого вопроса.
Все перечисленные сущности обмениваются независимо друг от друга, поэтому вы можете использовать модуль в разных сценариях работы. К примеру, можете обменивать только остатки и цены.

Как обмениваем разделы?

Прежде чем обменивать товары, необходимо определиться с обменом разделов. Модуль поддерживает гибкие настройки по обмену разделов и общих сценариев может быть несколько:
  • Полное дублирование структуры каталога из МойСклад в Битрикс
  • Дублирование структуры каталога только при импорте новых товаров
  • Полное игнорирование структуры каталога и импорт товаров из МойСклад в отдельный раздел Битрикс
Также есть комбинации из этих сценириев, к примеру выгружать полную структуру каталога из МойСклад в отдельную папку Битрикс, но это редкие случаи. Чаще всего используются эти три сценария.
Модуль дает возможность вести разную структуру каталога в МойСклад и в Битриксе.

Как обмениваем товары (сущности)?

Этот раздел актуален для товаров \ услуг \ модификаций \ комплектов.
Модуль умеет обменивать товары в нескольких режимах:
  • Только импортировать новые товары
  • Только обновлять существующие товары
    • Обновлять товары по агенту
    • Обновлять товары по веб-хуку
  • Импортировать новые и обновлять текущие товары
В зависимости от выбора пунктов выше, необходимо определиться, что нужно обменивать при импорте новых товаров и при обновлении существующих.

Какие поля импортируем для новых товаров?

Модуль поддерживает раздельный импорт полей из МойСклад и каждое поле импортируется согласно настройкам модуля. Список полей:
  • Описание анонса \ детальное описание
  • Картинка анонса \ детальная картинка
  • Прочие картинки (все картинки, начиная со второй картинки в карточке товара МойСклад)
  • Габариты (вес, длина, ширина, высота)
  • Единица измерения
  • Код
  • Артикул
  • Штрихкод (первое его значение)
  • Страна

Какие доп. поля импортируем для новых товаров (свойства)?

В этом вопросе просто нужно выписать доп. поля, которые нужно импортировать на сайт.

Какие поля изменяем при обновлении существующих товаров?

Теперь нужно определиться, какие поля нужно менять у существующих товаров:
  • Название
  • Раздел (здесь стоит учитывать пункт "Как обмениваем разделы?")
  • Символьный код (не рекомендуется изменять его, даже при смене названия, т.к. может сбиться URL товара)
  • Анонс \ Детально
  • Картинка анонса \ детально
  • Прочие картинки
  • Габариты
  • Свойства (доп. поля)
  • Единица измерения
Все эти поля могут меняться у существующих товаров при массовой обработке товаров. Для обновления по веб-хуку можно выбрать тот же список полей.

Как обмениваем модификации?

Глобально для модификаций действуют те же параметры, что и для товаров (раздел выше), но есть несколько особенностей.

Используется ли решетка # во внешнем коде?

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

Как обмениваем характеристики модификаций?

Модуль умеет обменивать любые характеристики модификаций, поэтому нужно заранее определиться о механизме обмена ими:
  • Автоматически создать с нуля все свойства модификаций из МойСклад (этот режим работает по умолчанию)
  • Необходимо вручную связать характеристики из МойСклад, со свойствами Торговых предложений в Битрикс (здесь есть отдельные настройки)

Обмениваем ли комплекты из МойСклад как комплекты в Битрикс?

По умолчанию комплекты обмениваются по принципу "Комплект из МойСклад" переходит в "Простой товар в Битрикс".
Также модуль умеет обменивать составы комплектов из МойСклад в Битрикс, для этого нужно, чтобы вкладка "Товары" была настроена на тот же инфоблок, что и вкладка "Комплекты".
Last modified 2mo ago