Интеграции

Товары и каталог ICML

Обновлено 25 октября 2026

Сопоставление товаров

Настройки находятся в «Магазин → Плагины → RetailCRM - Полная интеграция → Товары».

Настройка	Что делает	Значения / по умолчанию
Формат ID товара	Общий идентификатор оффера в каталоге, заказах и корзинах	«ID товара + ID артикула — product_id_sku_id (рекомендуется)»; также «ID артикула — sku_id» и «Только ID товара — product_id (не рекомендуется: варианты товара сливаются в один оффер)»
Одинаковые товары → В RetailCRM разрешены одинаковые позиции	Передаёт идентификаторы строк заказа, чтобы CRM различала одинаковые офферы	Выключено; включайте в соответствии с настройкой CRM
Одинаковые товары → Объединять одинаковые товары в одну позицию	Суммирует количество одинаковых позиций с одинаковой ценой	Выключено; разные цены не объединяются
xmlId в позициях заказа	Запасной ключ поиска товара при экспорте заказа	«Не передавать (рекомендуется)» для новой установки; «Артикул SKU (историческое поведение)» — конфигурационный дефолт для установок без сохранённого значения
Включить ICML	Разрешает выдачу каталога по URL	Выключено
Неограниченные остатки	Число вместо неограниченного остатка `null`	9999; поле формы от 1 до 99999999

Повторяющиеся товары и xmlId

Если CRM разрешает одинаковые офферы отдельными строками, отметьте «В RetailCRM разрешены одинаковые позиции». Подпись соответствующей настройки CRM приведена в форме плагина: «Возможность добавлять в заказ одинаковые торговые предложения как разные позиции» в «Настройки → Системные → Заказы».

Если одинаковые позиции в CRM запрещены и теряется количество, можно включить «Объединять одинаковые товары в одну позицию». Это не решает случай товара и подарка с разными ценами: для него нужно разрешение отдельных строк на стороне CRM.

xmlId в позициях заказа и xmlId в профиле каталога — разные настройки. Первая управляет запасным поиском при отправке заказа. Вторая — значением в каталоге CRM. Дубли артикулов и xmlId могут привести к неверной привязке и склеиванию строк; отчёт разработчика описан в CLI.

Изменение формата ID

Выберите формат до начала обмена. Формат product не различает артикулы одного товара.

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

Подключение каталога

Включите «Включить ICML» и сохраните настройки.
Нажмите «Перейти к настройкам ICML» либо откройте «Магазин → Импорт/Экспорт» и выберите экспорт RetailCRM.
Настройте профиль и нажмите «Сохранить и сгенерировать».
Скопируйте адрес из поля «ICML-файл» и укажите его для загрузки каталога в RetailCRM. Используйте именно выданный URL с хешем, не составляйте адрес по номеру профиля.
Проверьте файл через «Скачать», затем наличие товаров и артикулов в CRM.

Файл выдаётся по маршруту витрины retailcrm/<хеш>.xml. Хеш соответствует конкретному профилю. При выключенном «Включить ICML» запрос возвращает 403; неизвестный хеш — 404.

Настройки профиля

Настройка	Что делает	Значения / по умолчанию
Название профиля	Имя сохранённого профиля экспорта	Произвольный текст
Витрина	Витрина для формирования товарных ссылок	Список витрин Shop-Script; без витрины форма генерации недоступна
HTTPS → Использовать HTTPS для ссылок	Протокол ссылок каталога	Флаг; у нового профиля выключен
Обновление файла	Период регенерации при обращении к URL	«Обновление только вручную», «Автоматически, не чаще раза в час», «Автоматически, не чаще раза в день», «Автоматически, не чаще раза в неделю», «При каждом запросе»; вручную
Обновлять файл, даже если нет товаров	Разрешает формирование пустого файла	Выключено
Название магазина	Название в ICML	Подставляется название магазина
Компания	Компания в ICML	Подставляется название магазина
Размер изображений	Размер передаваемых изображений	`500x0`; формат ширина × высота, 0 — пропорционально
Кол-во изображений	Максимум изображений товара	1; поле формы от 1 до 10
Выбор товаров	Ограничивает выборку стандартным селектором Shop-Script	Набор товаров определяется профилем
Фильтры → Выгружать товары с нулевым остатком	Включает нулевые остатки	Включено
Фильтры → Выгружать скрытые товары	Включает скрытые товары	Выключено
Фильтры → Выгружать скрытые категории	Включает скрытые категории	Выключено
Фильтры → Выгружать зачёркнутую цену как тип цены «oldprice»	Дополнительная цена `oldprice`	Выключено
Фильтры → Выгружать закупочную цену (purchasePrice)	Передаёт закупочную цену	Выключено
Акционная цена	Код типа цены CRM для цены плагина «Гибкие скидки» (FlexDiscount)	Пусто; при использовании создайте соответствующий тип цены в CRM
Минимальная цена	Исключает товары дешевле указанного	0 — без ограничения

«Обновление файла» с периодом не создаёт cron: регенерация запускается при запросе URL после истечения срока. Обновление по cron настраивается отдельно. Если XML отсутствует, контроллер пытается сформировать его и в ручном режиме.

Чтобы исключить отдельный товар, добавьте в дополнительные параметры товара на вкладке «Описание и SEO»:

retailcrm.ignored=1

Маппинг полей

В разделе «Маппинг полей → Основные поля» задаётся источник каждого значения.

Поле	Что передаёт	Источник по умолчанию
Название	Название оффера	Название товара (`field:name`)
Название товара	Название товара без артикула	Название товара (`field:name`)
Производитель	Бренд	Характеристика `brand`
Штрихкод	EAN/GTIN	Штрихкод SKU (`field:barcode`)
Вес	Вес товара	Не выгружать
xmlId	Внешний ID для 1С	`field:id_1c`
Артикул	Артикул SKU	`field:sku`
Ставка НДС	НДС	Налог товара (`field:tax_id`)
Маркируемый товар	Признак маркировки	Не выгружать
Описание	Описание	Не выгружать
Цвет	Цвет	Не выгружать
Размер	Размер	Не выгружать
Габариты	Габариты	Не выгружать

Источники: «— Не выгружать —», «Задать вручную...», доступные «Поля товара», «Склады» и «Характеристики». Списки зависят от магазина. Штрихкод проверяется по длине: принимаются 8, 12 или 13 цифр; генератор также пробует штатный штрихкод SKU.