Как выгрузить товары в CommerceML (1С)?

CommerceML 2 — стандарт обмена товарами между 1С и сайтами. Его понимают 1С-Битрикс, CS-Cart, UMI.CMS, Moguta, Beseller и другие CMS, а для WooCommerce, OpenCart и MODX есть модули. В отличие от CSV, CommerceML штатно передает дерево категорий, характеристики-справочники и торговые предложения (размеры, цвета и т.п.).

Выгрузка — два XML-файла (версия схемы 2.05, кодировка UTF-8):

import.xml — классификатор (дерево групп и свойства) и каталог товаров;
offers.xml — цены, остатки и торговые предложения.

Файлы предназначены для ручного импорта через админку сайта или модуль импорта. Обмен по протоколу 1С (когда сайт сам принимает файлы от 1С по логину и паролю) не поддерживается: если ваша CMS принимает CommerceML только так, этот формат не подойдет.

1. В списке товаров нажмите "Выгрузить"

После загрузки товаров на парсер, находясь на странице со списком товаров, нажмите кнопку "Выгрузить".

Как выгрузить товары в CommerceML - Шаг 1

2. Задайте настройки формата

В появившемся окне выберите формат "CommerceML 2 (1С)", задайте необходимые настройки и сформируйте файлы. Скачайте оба файла (или ZIP-архив с ними и распакуйте его).

3. Подготовьте фото

Стандарт CommerceML передает фото файлами, которые лежат рядом с import.xml, поэтому фото всегда выгружаются ZIP-архивом. Внутри архива фото уже есть папка import_files, а в import.xml указаны пути вида import_files/abcdef.jpg.

Распакуйте архив фото в ту же папку, где лежит import.xml, чтобы рядом с ним появилась папка import_files. Если архивов несколько, распакуйте все в одно место: файлы соберутся в одной папке import_files. Загружайте на сайт import.xml вместе с этой папкой.

4. Импортируйте файлы

Если вы не уверены в настройках своего магазина, обратитесь в поддержку своего сайта. Импорт CommerceML в разных CMS и модулях настраивается по-разному. Q-Parser не несет ответственность за настройки вашего сайта.

Сначала импортируйте import.xml (создаются группы, свойства и товары), затем offers.xml (цены, остатки и торговые предложения). Предложения ссылаются на товары из import.xml, поэтому порядок важен.

1С-Битрикс. Для товаров с вариантами нужен каталог с торговыми предложениями (инфоблок SKU). После первого импорта проверьте, в какой инфоблок попали товары и появились ли типы цен «Розничная» (и «Старая цена», если она включена).

Особенности формата

Повторный импорт. Идентификаторы товаров, групп и свойств постоянны: они вычисляются из ссылки на товар, пути категории и названия свойства. Повторный импорт обновляет уже загруженные товары, а не создает копии. Идентификаторы не зависят от сайта-донора, поэтому выгрузки с разных сайтов попадают в один каталог, а одноименные категории и свойства объединяются.

Полная выгрузка. Файлы помечены как полная выгрузка каталога. При импорте CMS может деактивировать или удалить товары, которых нет в файле (в 1С-Битрикс это задает настройка импорта для элементов, отсутствующих в файле). Если загружаете в один каталог товары с нескольких сайтов, выберите в этой настройке вариант «ничего не делать».

Категории. Вложенные категории выгружаются деревом групп, товар попадает в самую глубокую группу. Товары без категории выгружаются без группы.

Торговые предложения. Характеристики с несколькими значениями («Размер», «Цвет» и т.п.) становятся торговыми предложениями: в offers.xml предложение на каждое сочетание значений, с характеристиками предложения, ценой и остатком товара. Товар без таких характеристик выгружается одним предложением.

Цены. Цена выгружается типом цены «Розничная» в валюте товара. Чтобы выгрузить цену в другой валюте, пересчитайте ее модификаторами цены.

Остатки. Остаток выгружается в поле «Количество». Если на сайте-доноре нет остатков, количество не выгружается; товары не в наличии выгружаются с количеством 0.

Настройки формата

Тип свойств. «Строка» — значение характеристики передается текстом. «Справочник» — у свойства в классификаторе перечисляются все варианты значений, а товар ссылается на вариант. В 1С-Битрикс так создаются свойства-списки, по которым удобно фильтровать каталог. Справочником выгружаются свойства, у которых не больше 1000 разных значений и каждое значение не длиннее 255 символов, остальные — строкой.

Старая цена. По умолчанию старая цена выгружается свойством «Старая цена». Вариант «Типом цены» добавляет в offers.xml второй тип цены «Старая цена»: создайте такой тип цен в своей CMS, если она не создает его сама.

Разбить на несколько файлов и Разбить по числу товаров — на каждую часть создается своя пара файлов: import--Категория.xml и offers--Категория.xml, при разбивке по числу товаров — import.xml, import--2.xml и т.д. Каждая часть помечена как частичная выгрузка, поэтому CMS не удаляет товары, которых в ней нет. Импортируйте части по очереди, в каждой паре сначала import, затем offers.

Специальные характеристики

Часть данных CommerceML берет из характеристик с фиксированным названием. Такие характеристики не дублируются в свойствах товара. Значение выгружается как есть, без пересчета: приведите его к нужному виду заранее.

Штрихкод — характеристика «Штрихкод», выгружается в поле «Штрихкод» товара. Обычно это 8 или 13 цифр (EAN) без пробелов.

Вес — характеристика «Вес», выгружается реквизитом «Вес». 1С передает вес в килограммах, поэтому значение должно быть числом в килограммах с точкой и без единиц измерения: 0.5, а не «500 г».

Бренд выгружается свойством «Бренд».

Название должно совпадать точно: «Штрих-код» или «Вес, кг» выгрузятся обычными свойствами. Переименовать характеристику и изменить ее значение можно в редактировании товаров.

Общие настройки

Выгрузка характеристик — позволяет выгрузить свойства товаров (цвета, размеры и пр.) отдельными полями или добавить их к описанию.

Разбить на несколько файлов — позволяет разбить выгрузку на несколько файлов: по категориям или по брендам.

Разбить по числу товаров — максимум товаров в одном файле. Например, при значении 5000 первые 5000 товаров попадут в первый файл, следующие — во второй (с окончанием --2) и т.д. Работает вместе с разбивкой по категориям и брендам: лимит действует внутри каждого файла категории или бренда. Пустое значение — без ограничения.

Файловое хранилище — позволяет сделать выгрузку файлов в произвольное хранилище на FTP или S3 (подробнее)

Нашли ошибку в выгрузке в этот формат?

Если вы обнаружили ошибку в формате выгрузки CommerceML 2 (1С), пожалуйста, сообщите нам на почту или в чат на сайте. Мы постараемся исправить выгрузку как можно скорее.