Загрузка товаров через ICML

ICML — это XML-формат, через который RetailCRM импортирует товарный каталог из интернет-магазина. Понимание структуры файла помогает настроить корректную выгрузку, избежать дублей и передать все нужные поля: категории, предложения, цены и остатки.

Что такое ICML

ICML (Intaro Catalog Markup Language) — формат выгрузки каталога, разработанный для RetailCRM на основе YML (Yandex Market Language) с расширениями. Это обычный XML-файл, который CMS формирует по постоянному адресу, а RetailCRM периодически скачивает и разбирает.

Формат описывает всё, что нужно каталогу CRM:

• дерево категорий (групп товаров);
• товары и их торговые предложения;
• цены, закупочные цены и остатки;
• характеристики, бренды, картинки и ссылки.

Для большинства CMS файл генерирует готовый модуль интеграции, поэтому вручную собирать XML обычно не требуется — но понимать структуру полезно для отладки.

Структура файла

Корень файла — элемент <yml_catalog>, внутри которого находится <shop> с двумя главными блоками: категориями и предложениями.

<yml_catalog date="2026-07-14 10:00">
  <shop>
    <name>Мой магазин</name>
    <categories>
      <category id="1">Обувь</category>
      <category id="2" parentId="1">Кроссовки</category>
    </categories>
    <offers>
      <offer id="1042" productId="57" quantity="8">
        <categoryId>2</categoryId>
        <price>5990</price>
        <purchasePrice>3200</purchasePrice>
        <name>Кроссовки Nova, 42, чёрные</name>
        <productName>Кроссовки Nova</productName>
        <vendor>Nova</vendor>
        <param name="Размер" code="size">42</param>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Категории связываются в дерево через parentId, а предложения ссылаются на категорию через categoryId.

Обязательные и важные поля

Часть полей критична для корректного импорта, остальные — желательны для полноты каталога.

Дополнительно передают picture, url, vendor, штрихкод, вес и габариты, признак активности productActivity.

Как подключить выгрузку

Подключение сводится к трём шагам.

1. На стороне CMS установить и настроить модуль выгрузки ICML — он сформирует файл по постоянному адресу.
2. В RetailCRM в настройках магазина указать URL этого файла и включить синхронизацию каталога.
3. Запустить пробную загрузку и проверить сопоставление категорий, товаров и цен.

Частые ошибки формата

Большинство проблем импорта — это дефекты самого файла, а не настроек RetailCRM.

• Неэкранированные спецсимволы (&, <) ломают XML.
• Разный productId у вариаций — размеры расходятся по разным товарам.
• Ссылки на несуществующие категории — товары попадают «в никуда».
• Пустые обязательные поля — предложение не импортируется.

Перед боевым запуском файл полезно прогнать через валидатор XML и проверить кодировку UTF-8.

Обновление и расписание

После подключения RetailCRM обходит файл по расписанию и синхронизирует изменения. Работает это по принципу сопоставления: система сравнивает предложения из файла с каталогом по артикулу и обновляет только то, что изменилось.

• Новые артикулы добавляются как новые предложения.
• Существующие обновляются по цене, остатку и характеристикам.
• Пропавшие из файла позиции можно деактивировать по настройке.

Именно поэтому стабильность артикулов так важна: весь механизм обновления держится на том, что offer id у одной и той же единицы не меняется от выгрузки к выгрузке.

Итог

ICML — это XML-формат на базе YML, через который RetailCRM импортирует каталог: категории, товары, предложения, цены и остатки. Корректный файл со стабильными артикулами, единым productId у вариаций и валидным XML обновляется автоматически и без дублей. Первую загрузку всегда стоит проверять на тестовой выборке.

Мы настраиваем генерацию ICML на стороне CMS, подключаем и отлаживаем выгрузку в RetailCRM, устраняем дубли и ошибки формата. Это типовая задача при интеграции и внедрении системы.