Корзина: товары, каталоги и модификации в обмене Битрикс24 и МойСклад
«Корзина» — это товары сделки, они же позиции заказа в МойСклад. Менеджер добавляет в сделку три товара, переводит её на нужную стадию — и в МойСклад появляется заказ покупателя с теми же тремя позициями, количеством и ценой. Чтобы так получилось, модулю нужно понять, какой товар МойСклад стоит за каждой строкой сделки. Правила этого поиска и задаются на странице Общие параметры → Корзина.

Страница «Корзина» только описывает, как искать и создавать товары. Сам обмен товарами включается на странице документа настройкой Обмен корзиной (товары документа) — на Заказе покупателя и Заказе поставщику. По умолчанию там стоит Не обменивать, и тогда документы уходят без товаров, что бы ни было настроено здесь.
Как модуль работает с товарами
Принцип — «найти или создать»:
- Модуль ищет товар во второй системе по полю, которое вы выбрали на этой странице.
- Нашёл — ставит его в документ.
- Не нашёл — создаёт товар во второй системе по образцу первой и ставит в документ уже его.
При создании переносятся название, описание, первая и вторая картинки, единица измерения (по справочнику единиц измерения) и, для модификаций, характеристики. Создаются все виды позиций: товар, услуга, модификация и комплект. Если для модификации нет родительского товара, сначала создаётся он; для комплекта — сначала его составные части.
Цены, остатки и ставки НДС в карточку товара при создании не переносятся. Цена и НДС переносятся в строке конкретного документа — НДС по справочнику ставок.
Благодаря созданию «на лету» не обязательно заранее выгружать весь каталог: товары появляются во второй системе по мере реальных заказов.
Модуль обменивает товары только в составе документов. Для массового обмена остатками, ценами, картинками и свойствами есть отдельное решение — о нём рассказывает кнопка Подробнее на баннере вверху страницы.
Каталог Битрикс24
Как модуль ищет и создаёт товары на стороне Битрикс24.
| Настройка | Что делает | По умолчанию | Когда менять |
|---|---|---|---|
| Инфоблок торгового каталога | Каталог Битрикс24, в котором модуль ищет товары и создаёт недостающие. Инфоблок торговых предложений (модификаций) модуль находит сам по выбранному каталогу | не выбран | Выбрать при первой настройке. Обычно это «Товарный каталог CRM» |
| Поле для поиска товара | По какому полю товара Битрикс24 искать совпадение: Внешний код (XML_ID) или любое строковое свойство выбранного инфоблока | не выбрано | Если внешний код уже занят другой интеграцией (1С, интернет-магазин) — выберите отдельное свойство |
| Поле для поиска модификации | То же для торговых предложений: внешний код или строковое свойство инфоблока торговых предложений | не выбрано | Аналогично полю поиска товара |
| Разделы инфоблока для новых товаров | Таблица «Тип товара → Раздел инфоблока»: в какой раздел класть товары, созданные модулем. Типы — Товар, Услуга, Комплект. Разделы — только первого уровня | пусто — новые товары создаются в корне инфоблока | Если хотите, чтобы созданные модулем товары не перемешивались с основным каталогом |
Три нижние настройки недоступны, пока не выбран инфоблок, — с подсказкой «Сначала выберите инфоблок торгового каталога».
Если выбрать другой инфоблок, поля поиска товара и модификации, разделы для новых товаров и таблица характеристик модификаций очищаются — их нужно настроить заново под новый каталог.
Пример. Каталог Битрикс24 уже наполняется из 1С, и внешний код занят кодами 1С. Заводим в инфоблоке строковое свойство «Код МойСклад» и выбираем его в Поле для поиска товара. Связка с МойСклад пойдёт через это свойство, обмен с 1С не пострадает. В Разделы инфоблока для новых товаров ставим «Товар → Новые из МойСклад», «Услуга → Услуги».
Каталог МойСклад
Как модуль ищет и создаёт ассортимент на стороне МойСклад.
| Настройка | Что делает | По умолчанию | Когда менять |
|---|---|---|---|
| Поле для поиска ассортимента | По какому полю искать позицию МойСклад (товар, модификацию, услугу, комплект): Внешний код или Идентификатор | Внешний код | См. ниже |
| Группы товаров для нового ассортимента | Таблица «Тип товара → Группа товаров»: в какую группу МойСклад класть созданные модулем позиции. Типы — Товар, Услуга, Комплект. Группы — только первого уровня | пусто — новые позиции создаются в корне | Если созданные модулем товары нужно складывать в отдельную группу |
Внешний код или Идентификатор? Значение поля поиска МойСклад сравнивается со значением поля поиска товара Битрикс24.
- Внешний код — подходит, когда внешние коды товаров в МойСклад совпадают с кодами в Битрикс24. Например, у товара в МойСклад внешний код «A-100», и у товара Битрикс24 в выбранном поле поиска тоже «A-100».
- Идентификатор — внутренний номер позиции в МойСклад. Он становится известен только после создания товара, поэтому модуль сразу после создания товара в МойСклад записывает его идентификатор в поле поиска товара Битрикс24 — так следующий обмен найдёт товар, а не создаст второй.
Меняйте поле поиска только до начала обмена или вместе с перепроверкой каталога. Если после смены поля значения в Битрикс24 не совпадут с новым полем МойСклад, модуль не найдёт уже существующие товары и начнёт создавать дубли.
Характеристики модификаций
| Настройка | Что делает | По умолчанию |
|---|---|---|
| Соответствие характеристик модификаций | Таблица «Свойство ТП Битрикс24 → Характеристика МойСклад»: какое свойство торгового предложения какой характеристике модификации соответствует (Цвет ↔ Цвет, Размер ↔ Размер) | пусто |
Таблица используется в обе стороны: и когда модуль создаёт модификацию в МойСклад по торговому предложению Битрикс24, и когда создаёт торговое предложение в Битрикс24 по модификации МойСклад. В качестве свойств подходят свойства-списки, привязки к элементам инфоблока и справочники.
Пока на вкладке Каталог Битрикс24 не выбран Инфоблок торгового каталога, таблица недоступна: список свойств берётся из инфоблока торговых предложений этого каталога.
Когда заполнять. Если вы продаёте товары с модификациями (одежда по размерам, краска по цветам) и модуль может создавать их во второй системе. Без соответствий созданная модификация не получит нужных характеристик.
Пример. У торговых предложений Битрикс24 есть свойства «Цвет» (список) и «Размер» (список), в МойСклад — характеристики «Цвет» и «Размер». Добавляем две строки: «Цвет → Цвет», «Размер → Размер». Теперь футболка «красная, M», созданная менеджером в Битрикс24, появится в МойСклад как модификация с характеристиками «Цвет: красный», «Размер: M».
Таблицы на странице
- Строка добавляется кнопкой Добавить соответствие, удаляется значком корзины справа.
- В таблицах «тип товара → раздел/группа» не больше трёх строк — по одной на Товар, Услугу и Комплект; когда все три заполнены, кнопка добавления пропадает.
- Изменения сохраняются кнопкой Сохранить на плавающей панели внизу — см. Как устроены настройки.