Выгрузка в Битрикс из XML

В одном из наших проектов создание сайта на Битрикс стояла задача выгрузки товарного каталога в систему управления не из 1С, а из редкой клиентской программы учёта. Данная программа могла формировать xml-файлы любой необходимой структуры. Поэтому для выгрузки в Битрикс было решено формировать файл в формате CommerceML 2.021, который стандартными средствами Битрикса импортируется в инфоблок.

В данной статье будет рассказано подробно о структуре выгружаемого файла и его узлах. Описание является неполным, но достаточным практически для любого проекта создание интернет магазина. В частности, будут рассмотрены только свойства типа СТРОКА, ЧИСЛО и СПИСОК, а также множественные свойства.

Общая структура файла

<?xml version="1.0" encoding="windows-1251"?>
<КоммерческаяИнформация ВерсияСхемы="2.021" ДатаФормирования="2013-08-22T12:32:41">
  <Классификатор>
    <Ид>573cd49a-339f-4596-9526-dae569251cd4</Ид>
    <Свойства>… </Свойства>
    <СвойстваЭлементов>… </СвойстваЭлементов>
    <СвойстваГрупп>…</СвойстваГрупп>
    <Группы>…</Группы>
  </Классификатор>
  <ПакетПредложений>
        <Предложения>…</Предложения>
  </ПакетПредложений>
</КоммерческаяИнформация>

ДатаФормирования заполняется в формате ГГГГ-ММ-ДДТЧЧ:мм:СС,
где Г – год,
М- месяц,
Д – день,
Т – разделитель,
Ч – часы,
м – минуты,
С – секунды.

<Ид>573cd49a-339f-4596-9526-dae569251cd4</Ид> - идентификатор каталога, генерируется произвольным образом один раз и далее используется при каждой выгрузке. Можно использовать идентификатор, приведенный в данном примере.

Узел Свойства

В данном узле описываются все свойства товаров.

В начале узла перечисляются служебные свойства:

<Свойство>
  <Ид>CML2_ACTIVE</Ид>
  <Наименование>БитриксАктивность</Наименование>
  <Множественное>false</Множественное>
</Свойство>
<Свойство>
  <Ид>CML2_CODE</Ид>
  <Наименование>Символьный код</Наименование>
  <Множественное>false</Множественное>
</Свойство>
<Свойство>
  <Ид>CML2_SORT</Ид>
  <Наименование>Сортировка</Наименование>
  <Множественное>false</Множественное>
</Свойство>
<Свойство>
  <Ид>CML2_ACTIVE_FROM</Ид>
  <Наименование>Начало активности</Наименование>
  <Множественное>false</Множественное>
</Свойство>
<Свойство>
  <Ид>CML2_ACTIVE_TO</Ид>
  <Наименование>Окончание активности</Наименование>
  <Множественное>false</Множественное>
</Свойство>
<Свойство>
  <Ид>CML2_PREVIEW_TEXT</Ид>
  <Наименование>Анонс</Наименование>
  <Множественное>false</Множественное>
</Свойство>
<Свойство>
  <Ид>CML2_DETAIL_TEXT</Ид>
  <Наименование>Описание</Наименование>
  <Множественное>false</Множественное>
</Свойство>
<Свойство>
  <Ид>CML2_PREVIEW_PICTURE</Ид>
  <Наименование>Картинка анонса</Наименование>
  <Множественное>false</Множественное>
</Свойство>
<Свойство>
  <Ид>CML2_PICTURES</Ид>
  <Наименование>Картинки</Наименование>
  <Множественное>true</Множественное>
  <БитриксСортировка>500</БитриксСортировка>
  <БитриксКод>MORE_PHOTO</БитриксКод>
  <БитриксТипСвойства>F</БитриксТипСвойства>
  <БитриксСтрок>1</БитриксСтрок>
  <БитриксКолонок>30</БитриксКолонок>
  <БитриксТипСписка>L</БитриксТипСписка>
  <БитриксТипыФайлов></БитриксТипыФайлов>
  <БитриксКоличествоПолей>1</БитриксКоличествоПолей>
  <БитриксСвязанныйИнфоблок></БитриксСвязанныйИнфоблок>
  <БитриксОписаниеРазрешено>true</БитриксОписаниеРазрешено>
  <БитриксПоискРазрешен>false</БитриксПоискРазрешен>
  <БитриксФильтрРазрешен>false</БитриксФильтрРазрешен>
  <БитриксРасширениеТипа></БитриксРасширениеТипа>
  <БитриксОбязательное>false</БитриксОбязательное>
  <БитриксЗначениеПоУмолчанию></БитриксЗначениеПоУмолчанию>
  <Сериализовано>1</Сериализовано>
</Свойство>
<Свойство>
  <Ид>META_TITLE</Ид>
  <Наименование>META title</Наименование>
  <Множественное>false</Множественное>
  <БитриксСортировка>500</БитриксСортировка>
  <БитриксКод>META_TITLE</БитриксКод>
  <БитриксТипСвойства>S</БитриксТипСвойства>
  <БитриксСтрок>1</БитриксСтрок>
  <БитриксКолонок>70</БитриксКолонок>
  <БитриксТипСписка>L</БитриксТипСписка>
  <БитриксТипыФайлов></БитриксТипыФайлов>
  <БитриксКоличествоПолей>5</БитриксКоличествоПолей>
  <БитриксСвязанныйИнфоблок></БитриксСвязанныйИнфоблок>
  <БитриксОписаниеРазрешено>false</БитриксОписаниеРазрешено>
  <БитриксПоискРазрешен>false</БитриксПоискРазрешен>
  <БитриксФильтрРазрешен>false</БитриксФильтрРазрешен>
  <БитриксРасширениеТипа></БитриксРасширениеТипа>
  <БитриксОбязательное>false</БитриксОбязательное>
  <БитриксЗначениеПоУмолчанию></БитриксЗначениеПоУмолчанию>
  <Сериализовано>1</Сериализовано>
</Свойство>
<Свойство>
  <Ид>META_DESCRIPTION</Ид>
  <Наименование>META description</Наименование>
  <Множественное>false</Множественное>
  <БитриксСортировка>500</БитриксСортировка>
  <БитриксКод>META_DESCRIPTION</БитриксКод>
  <БитриксТипСвойства>S</БитриксТипСвойства>
  <БитриксСтрок>5</БитриксСтрок>
  <БитриксКолонок>70</БитриксКолонок>
  <БитриксТипСписка>L</БитриксТипСписка>
  <БитриксТипыФайлов></БитриксТипыФайлов>
  <БитриксКоличествоПолей>5</БитриксКоличествоПолей>
  <БитриксСвязанныйИнфоблок></БитриксСвязанныйИнфоблок>
  <БитриксОписаниеРазрешено>false</БитриксОписаниеРазрешено>
  <БитриксПоискРазрешен>false</БитриксПоискРазрешен>
  <БитриксФильтрРазрешен>false</БитриксФильтрРазрешен>
  <БитриксРасширениеТипа></БитриксРасширениеТипа>
  <БитриксОбязательное>false</БитриксОбязательное>
  <БитриксЗначениеПоУмолчанию></БитриксЗначениеПоУмолчанию>
  <Сериализовано>1</Сериализовано>
</Свойство>
<Свойство>
  <Ид>META_KEYWORDS</Ид>
  <Наименование>META keywords</Наименование>
  <Множественное>false</Множественное>
  <БитриксСортировка>500</БитриксСортировка>
  <БитриксКод>META_KEYWORDS</БитриксКод>
  <БитриксТипСвойства>S</БитриксТипСвойства>
  <БитриксСтрок>3</БитриксСтрок>
  <БитриксКолонок>70</БитриксКолонок>
  <БитриксТипСписка>L</БитриксТипСписка>
  <БитриксТипыФайлов></БитриксТипыФайлов>
  <БитриксКоличествоПолей>5</БитриксКоличествоПолей>
  <БитриксСвязанныйИнфоблок></БитриксСвязанныйИнфоблок>
  <БитриксОписаниеРазрешено>false</БитриксОписаниеРазрешено>
  <БитриксПоискРазрешен>false</БитриксПоискРазрешен>
  <БитриксФильтрРазрешен>false</БитриксФильтрРазрешен>
  <БитриксРасширениеТипа></БитриксРасширениеТипа>
  <БитриксОбязательное>false</БитриксОбязательное>
  <БитриксЗначениеПоУмолчанию></БитриксЗначениеПоУмолчанию>
  <Сериализовано>1</Сериализовано>
</Свойство>

CML2_ACTIVE – активность товара, служебное свойство, принимает значения true или false.

CML2_CODE – уникальный символьный код товара, используется при формировании URL товара, например в URL «http://localhost:6448/catalog/mebel-dlya-vannoy-komnaty/shkafy/zerkalo-shkaf-runo-iris-60-sinee/» символьным кодом товара является «zerkalo-shkaf-runo-iris-60-sinee».
Допустимые символы: цифры, символы латинского алфавита, дефис. Регистр любой.

CML2_SORT – числовое поле, может применяться для сортировки товаров. Например, если у товара 1 это поле имеет значение 30, а у товара 2 – значение 10, то сначала отобразится товар 2, затем товар 1.

CML2_ACTIVE_FROM, CML2_ACTIVE_TO – служебные поля, как правило не применяются для товаров в интернет-магазине.

CML2_PREVIEW_TEXT – поле для краткого описания товара

CML2_DETAIL_TEXT – поле для подробного описания товара. Более подробно будет описано в узле «ПакетПредложений».

CML2_PREVIEW_PICTURE – малая фотография товара, выводится на страницах товарных групп.

CML2_PICTURES – дополнительные фотографии товара. Основная фотография товара задаётся в описании товара, о чем будет сказано позднее.

META_TITLE, META_KEYWORDS, META_DESCRIPTION – свойства для SEO (заголовок окна браузера, ключевые слова и описание).

Все служебные свойства брать как есть и помещать в начало узла Свойства.

Далее в узле описываются пользовательские свойства.

Основные типы свойств:

• S – Строка
• N – Число
• L – Список

Свойство типа СТРОКА

<Свойство>
  <Ид>CML2_ARTICLE</Ид>
  <Наименование>Артикул</Наименование>
  <Множественное>false</Множественное>
  <БитриксСортировка>500</БитриксСортировка>
  <БитриксКод>CML2_ARTICLE</БитриксКод>
  <БитриксТипСвойства>S</БитриксТипСвойства>
  <БитриксСтрок>1</БитриксСтрок>
  <БитриксКолонок>30</БитриксКолонок>
  <БитриксТипСписка>L</БитриксТипСписка>
  <БитриксТипыФайлов></БитриксТипыФайлов>
  <БитриксКоличествоПолей>5</БитриксКоличествоПолей>
  <БитриксСвязанныйИнфоблок></БитриксСвязанныйИнфоблок>
  <БитриксОписаниеРазрешено>false</БитриксОписаниеРазрешено>
  <БитриксПоискРазрешен>true</БитриксПоискРазрешен>
    <БитриксФильтрРазрешен>false</БитриксФильтрРазрешен>
  <БитриксРасширениеТипа></БитриксРасширениеТипа>
  <БитриксОбязательное>false</БитриксОбязательное>
  <БитриксЗначениеПоУмолчанию></БитриксЗначениеПоУмолчанию>
  <Сериализовано>1</Сериализовано>
</Свойство>

<Ид>CML2_ARTICLE</Ид> - идентификатор свойства, произвольное уникальное значение.
Допустимые символы: цифры, символы латинского алфавита, нижнее подчеркивание, тире. Регистр любой.

<Наименование>Артикул</Наименование> - имя свойства, выводится на карточке товара.
Допустимые символы: любые. Регистр любой.

<Множественное>false</Множественное> - параметр определяет, что свойство может иметь несколько значений. См. в примерах свойство OFFERS.

<БитриксСортировка>500</БитриксСортировка> - порядок положения свойства в фильтре (если свойство будет отображаться в фильтре).

<БитриксКод>CML2_ARTICLE</БитриксКод> - символьный код свойства, равен значению узла <ИД></ИД>.

<БитриксТипСвойства>S</БитриксТипСвойства> - тип свойства, в данном примере это S – строка.

Все остальные узлы брать как есть.

Свойство типа Число

<Свойство>
  <Ид>SHIRINA_SHKAFA</Ид>
  <Наименование>Ширина шкафа, мм</Наименование>
  <Множественное>false</Множественное>
  <БитриксСортировка>500</БитриксСортировка>
  <БитриксКод>SHIRINA_SHKAFA</БитриксКод>
  <БитриксТипСвойства>N</БитриксТипСвойства>
  <БитриксСтрок>1</БитриксСтрок>
  <БитриксКолонок>30</БитриксКолонок>
  <БитриксТипСписка>L</БитриксТипСписка>
  <БитриксТипыФайлов></БитриксТипыФайлов>
  <БитриксКоличествоПолей>5</БитриксКоличествоПолей>
  <БитриксСвязанныйИнфоблок></БитриксСвязанныйИнфоблок>
  <БитриксОписаниеРазрешено>false</БитриксОписаниеРазрешено>
  <БитриксПоискРазрешен>true</БитриксПоискРазрешен>
  <БитриксФильтрРазрешен>false</БитриксФильтрРазрешен>
  <БитриксРасширениеТипа></БитриксРасширениеТипа>
  <БитриксОбязательное>false</БитриксОбязательное>
  <БитриксЗначениеПоУмолчанию></БитриксЗначениеПоУмолчанию>
  <Сериализовано>1</Сериализовано>
</Свойство>

<Ид>SHIRINA_SHKAFA</Ид> - идентификатор свойства, произвольное уникальное значение.
Допустимые символы: цифры, символы латинского алфавита, нижнее подчеркивание, тире. Регистр любой.

<Наименование>Ширина шкафа, мм</Наименование> - имя свойства, выводится на карточке товара.
Допустимые символы: любые. Регистр любой.

<Множественное>false</Множественное> - параметр определяет, что свойство может иметь несколько значений.

<БитриксСортировка>500</БитриксСортировка> - порядок положения свойства в фильтре (если свойство будет отображаться в фильтре).

<БитриксКод>SHIRINA_SHKAFA</БитриксКод> - символьный код свойства, равен значению узла <ИД></ИД>.

<БитриксТипСвойства>N</БитриксТипСвойства> - тип свойства, в данном примере это N – число.

Все остальные узлы брать как есть.

Свойство типа Список

<Свойство>
  <Ид> CML2_MANUFACTURER </Ид>
  <Наименование>Производитель</Наименование>
  <Множественное>false</Множественное>
  <ВариантыЗначений>
    <Вариант>
      <Ид>brand-1</Ид>
      <Значение>Inve</Значение>
      <ПоУмолчанию>false</ПоУмолчанию>
      <Сортировка>500</Сортировка>
    </Вариант>
    <Вариант>
      <Ид>brand-2</Ид>
      <Значение>Runo</Значение>
      <ПоУмолчанию>false</ПоУмолчанию>
      <Сортировка>500</Сортировка>
    </Вариант>
  </ВариантыЗначений>       <БитриксСортировка>500</БитриксСортировка>
  <БитриксКод>CML2_MANUFACTURER</БитриксКод>
  <БитриксТипСвойства>L</БитриксТипСвойства>
  <БитриксСтрок>1</БитриксСтрок>
  <БитриксКолонок>30</БитриксКолонок>
  <БитриксТипСписка>L</БитриксТипСписка>
  <БитриксТипыФайлов></БитриксТипыФайлов>
  <БитриксКоличествоПолей>5</БитриксКоличествоПолей>
  <БитриксСвязанныйИнфоблок></БитриксСвязанныйИнфоблок>
  <БитриксОписаниеРазрешено>false</БитриксОписаниеРазрешено>
  <БитриксПоискРазрешен>true</БитриксПоискРазрешен>
  <БитриксФильтрРазрешен>false</БитриксФильтрРазрешен>
  <БитриксРасширениеТипа></БитриксРасширениеТипа>
  <БитриксОбязательное>false</БитриксОбязательное>
  <БитриксЗначениеПоУмолчанию></БитриксЗначениеПоУмолчанию>
  <Сериализовано>1</Сериализовано>
</Свойство>

<Ид>CML2_MANUFACTURER</Ид> - идентификатор свойства, произвольное уникальное значение.
Допустимые символы: цифры, символы латинского алфавита, нижнее подчеркивание, тире. Регистр любой.

<Наименование>Производитель</Наименование> - имя свойства, выводится на карточке товара.
Допустимые символы: любые. Регистр любой.

<Множественное>false</Множественное> - параметр определяет, что свойство может иметь несколько значений. См. в примерах свойство OFFERS.

<БитриксКод>CML2_MANUFACTURER</БитриксКод> - символьный код свойства, равен значению узла <ИД></ИД>.

<БитриксТипСвойства>L</БитриксТипСвойства> - тип свойства, в данном примере это L – список.

<БитриксСортировка>500</БитриксСортировка> - порядок положения свойства в фильтре (если свойство будет отображаться в фильтре).

Все остальные узлы брать как есть.

Узел Варианты Значений свойства типа Список

Свойство типа СПИСОК содержит в себе заранее определенные значения в узле <ВариантыЗначений>. Каждое значение хранится в своем узле <Вариант> внутри узла <ВариантыЗначений>.

<Ид>brand-1</Ид> - идентификатор значения свойства, произвольное уникальное значение.
Допустимые символы: цифры, символы латинского алфавита, нижнее подчеркивание, тире. Регистр любой.

<Значение>Inve</Значение> - само значение. Допустимые символы: любые. Регистр любой.

<ПоУмолчанию>false</ПоУмолчанию> - признак того, что данное значение будет установлено по-умолчанию для товара, если не было указано какое-либо другое значение.

<Сортировка>500</Сортировка> - код сортировки значения внутри списка. Оставлять как есть.

Узел Свойства Элементов

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

Указывается идентификатор свойства в узле <Ид> и в узле <УмныйФильтр> прописывается true.

<СвойстваЭлементов>
  <Свойство>
    <Ид>CML2_MANUFACTURER</Ид>
    <УмныйФильтр>true</УмныйФильтр>
  </Свойство>
  <Свойство>
    <Ид>COLLECTION</Ид>
    <УмныйФильтр>true</УмныйФильтр>
  </Свойство>
  <Свойство>
    <Ид>SHIRINA_SHKAFA</Ид>
    <УмныйФильтр>true</УмныйФильтр>
  </Свойство>
</СвойстваЭлементов>

Узел СвойстваГрупп

В данном узле перечисляются свойства товарных групп. В рамках любого серьёзного проекта будут использованы как минимум 3 служебных свойства для SEO: UF_TITLE, UF_KEYWORDS, UF_DESCRIPTION, брать как есть.

<Свойство>
  <Ид>UF_TITLE</Ид>
  <Наименование>UF_TITLE</Наименование>
  <Сортировка>100</Сортировка>
  <Множественное>false</Множественное>
  <БитриксТипСвойства>string</БитриксТипСвойства>
  <БитриксОбязательное>false</БитриксОбязательное>
  <БитриксФильтрРазрешен>false</БитриксФильтрРазрешен>
  <БитриксПоказыватьВСписке>true</БитриксПоказыватьВСписке>
  <БитриксРедактироватьВСписке>true</БитриксРедактироватьВСписке>
  <БитриксПоискРазрешен>false</БитриксПоискРазрешен>
<БитриксНастройки>a:6:{s:4:"SIZE";i:70;s:4:"ROWS";i:1;s:6:"REGEXP";s:0:"";s:10:"MIN_LENGTH";i:0;s:10:"MAX_LENGTH";i:0;s:13:"DEFAULT_VALUE";s:0:"";}</БитриксНастройки>
</Свойство>
<Свойство>
  <Ид>UF_KEYWORDS</Ид>
  <Наименование>UF_KEYWORDS</Наименование>
  <Сортировка>100</Сортировка>
  <Множественное>false</Множественное>
  <БитриксТипСвойства>string</БитриксТипСвойства>
  <БитриксОбязательное>false</БитриксОбязательное>
  <БитриксФильтрРазрешен>false</БитриксФильтрРазрешен>
  <БитриксПоказыватьВСписке>true</БитриксПоказыватьВСписке>
  <БитриксРедактироватьВСписке>true</БитриксРедактироватьВСписке>
  <БитриксПоискРазрешен>false</БитриксПоискРазрешен>
  <БитриксНастройки>a:6:{s:4:"SIZE";i:70;s:4:"ROWS";i:3;s:6:"REGEXP";s:0:"";s:10:"MIN_LENGTH";i:0;s:10:"MAX_LENGTH";i:0;s:13:"DEFAULT_VALUE";s:0:"";}</БитриксНастройки>
</Свойство>
<Свойство>
  <Ид>UF_DESCRIPTION</Ид>
  <Наименование>UF_DESCRIPTION</Наименование>
  <Сортировка>100</Сортировка>
  <Множественное>false</Множественное>
  <БитриксТипСвойства>string</БитриксТипСвойства>
  <БитриксОбязательное>false</БитриксОбязательное>
  <БитриксФильтрРазрешен>false</БитриксФильтрРазрешен>
  <БитриксПоказыватьВСписке>true</БитриксПоказыватьВСписке>
  <БитриксРедактироватьВСписке>true</БитриксРедактироватьВСписке>
  <БитриксПоискРазрешен>false</БитриксПоискРазрешен>
  <БитриксНастройки>a:6:{s:4:"SIZE";i:70;s:4:"ROWS";i:5;s:6:"REGEXP";s:0:"";s:10:"MIN_LENGTH";i:0;s:10:"MAX_LENGTH";i:0;s:13:"DEFAULT_VALUE";s:0:"";}</БитриксНастройки>
</Свойство>

Узел Группы

В данном узле описывается иерархическая структура товарных групп и сами группы.

Иерархичность задается следующим образом:

<Группы>
    <Группа> - уровень 1
      … описание…
      <Группы>
        <Группа> - уровень 2
          … описание …
    <Группы>
    </Группы>
    </Группа>
        <Группа> - уровень 2
          … описание …
    <Группы>
    </Группы>
    </Группа>
        <Группа> - уровень 2
          … описание …
    <Группы>
    </Группы>
    </Группа>
      </Группы>
    </Группа>
</Группы>

Описание группы

<Группа>
  <Ид>cat-2</Ид>
  <Наименование>Шкафы</Наименование>
  <БитриксАктивность>true</БитриксАктивность>
  <БитриксСортировка>120</БитриксСортировка>
            <БитриксКод>shkafy</БитриксКод>
  <БитриксКартинка> 123_files/Inve_Madrid_70_k.jpg </БитриксКартинка>
  <БитриксКартинкаДетальная> 123_files/Inve_Madrid_r_iNVE_70.jpg </БитриксКартинкаДетальная>
    <ЗначенияСвойств></ЗначенияСвойств>
  <Группы></Группы>
</Группа>

<Ид>cat-2</Ид> - идентификатор группы, произвольное уникальное значение.
Допустимые символы: цифры, символы латинского алфавита, нижнее подчеркивание, тире. Регистр любой.

<Наименование>Шкафы</Наименование> - название группы. Произвольное значение.

<БитриксСортировка>120</БитриксСортировка> - порядок сортировки группы при выводе на сайте.

<БитриксАктивность>true</БитриксАктивность> - признак того, что группа будет отображаться на сайте.

<БитриксКод>shkafy</БитриксКод> - уникальный символьный код группы, используется при формировании URL товара и группы, например в URL «http://localhost:6448/catalog/mebel-dlya-vannoy-komnaty/shkafy/zerkalo-shkaf-runo-iris-60-sinee/» символьным кодом группы данного примера является «shkafy».
Допустимые символы: цифры, символы латинского алфавита, дефис. Регистр любой.

<БитриксКартинка>123_files/Inve_Madrid_70_k.jpg</БитриксКартинка> - малое изображение товарной группы. В данном примере файл импорта называется 123.xml, соответственно изображения должны храниться в папке 123_files, которая должна лежать в одной директории с файлом 123.xml.

<БитриксКартинкаДетальная>123_files/Inve_Madrid_r_iNVE_70.jpg</БитриксКартинкаДетальная> - большое изображение товарной группы.

В узле Значения Свойств задаются значения свойств товарных групп. Каждое свойство – в своем отдельном узле Значения Свойства.

<Ид>UF_TITLE</Ид> - идентификатор свойства, который был ранее указан в описании свойства.

<Значение>Шкафы для ванной комнаты</Значение> - значение свойства.

Узел Пакет Предложений

В начале узла идёт описание настроек информационного блока, в который будет выгружаться каталог.

<Ид>573cd49a-339f-4596-9526-dae569251cd4</Ид>
<ИдКлассификатора>573cd49a-339f-4596-9526-dae569251cd4</ИдКлассификатора>
<Наименование>Основной каталог товаров</Наименование>
<БитриксКод></БитриксКод>
<БитриксСортировка>500</БитриксСортировка>
<БитриксURLСписок></БитриксURLСписок>
<БитриксURLДеталь> #SITE_DIR#/catalog/#SECTION_CODE_PATH#/#ELEMENT_CODE#/ </БитриксURLДеталь>
<БитриксURLРаздел> #SITE_DIR#/catalog/#SECTION_CODE_PATH# /</БитриксURLРаздел>
<БитриксКартинка></БитриксКартинка>
<БитриксИндексироватьЭлементы>true</БитриксИндексироватьЭлементы>
<БитриксИндексироватьРазделы>true</БитриксИндексироватьРазделы>
<БитриксДокументооборот>false</БитриксДокументооборот>
<БитриксПодписи>
  <БитриксПодпись>
    <Ид>ELEMENT_NAME</Ид>
    <Значение>Товар</Значение>
  </БитриксПодпись>
  <БитриксПодпись>
    <Ид>ELEMENTS_NAME</Ид>
    <Значение>Товары</Значение>
  </БитриксПодпись>
  <БитриксПодпись>
    <Ид>ELEMENT_ADD</Ид>
    <Значение>Добавить товар</Значение>
  </БитриксПодпись>
  <БитриксПодпись>
    <Ид>ELEMENT_EDIT</Ид>
    <Значение>Изменить товар</Значение>
  </БитриксПодпись>
  <БитриксПодпись>
    <Ид>ELEMENT_DELETE</Ид>
    <Значение>Удалить товар</Значение>
  </БитриксПодпись>
  <БитриксПодпись>
    <Ид>SECTION_NAME</Ид>
    <Значение>Раздел</Значение>
  </БитриксПодпись>
  <БитриксПодпись>
    <Ид>SECTIONS_NAME</Ид>
    <Значение>Разделы</Значение>
  </БитриксПодпись>
  <БитриксПодпись>
    <Ид>SECTION_ADD</Ид>
    <Значение>Добавить раздел</Значение>
  </БитриксПодпись>
  <БитриксПодпись>
    <Ид>SECTION_EDIT</Ид>
    <Значение>Изменить раздел</Значение>
  </БитриксПодпись>
  <БитриксПодпись>
    <Ид>SECTION_DELETE</Ид>
    <Значение>Удалить раздел</Значение>
  </БитриксПодпись>
</БитриксПодписи>
<ТипыЦен>
  <ТипЦены>
    <Ид>BASE</Ид>
    <Наименование>Розничная</Наименование>
  </ТипЦены>
  <ТипЦены>
    <Ид>OPT</Ид>
    <Наименование>Оптовая</Наименование>
  </ТипЦены>
  <ТипЦены>
    <Ид>SMALLOPT</Ид>
    <Наименование>Мелко-оптовая</Наименование>
  </ТипЦены>
</ТипыЦен>

<Ид>573cd49a-339f-4596-9526-dae569251cd4</Ид>,

<ИдКлассификатора>573cd49a-339f-4596-9526-dae569251cd4</ИдКлассификатора> - в данных узлах указывается ИД, который был задан в самом начале узла Классификатор.

<Наименование>Основной каталог товаров</Наименование> - произвольное служебное название каталога, которое видно только в разделе администрирования сайта.

<БитриксПодписи> - в данном узле описываются подписи элементов управления в администраторской части.

<ТипыЦен> - в данном узле описываются типы цен, применяемые на сайте. Каждый тип цены помещается в свой отдельный узел Тип Цены:

• <Ид>BASE</Ид> - идентификатор цены, произвольное уникальное значение.
  Допустимые символы: цифры, символы латинского алфавита, нижнее подчеркивание, тире. Регистр любой.
• <Наименование>Розничная</Наименование> - название типа цены.

Стоит заметить, что начиная с версии Битрикс Управление Сайтом 12.0 несколько типов цен доступны только в редакции «Бизнес». Те, у кого битрикс был куплен до версии 12.0 в редакции «Малый бизнес», могут смело обновляться, поддержка нескольких типов цен не исчезнет.

После узла Типы Цен идет узел Предложения.

Узел Предложения

В данном узле описываются непосредственно сами товары. Каждый товар помещается в свой отдельный узел Предложение.

Узел Предложение

<Предложение>
  <Ид>product-3</Ид>
  <Наименование>Зеркало-шкаф Runo Ирис 60 зеленое</Наименование>
  <БитриксТеги></БитриксТеги>
  <Группы>
    <Ид>cat-2</Ид>
  </Группы>
  <Картинка>123_files/photo_4.jpg</Картинка>
  <ЗначенияСвойств>
    <ЗначенияСвойства>
      <Ид>CML2_ACTIVE</Ид>
      <Значение>true</Значение>
    </ЗначенияСвойства>
    <ЗначенияСвойства>
      <Ид>CML2_CODE</Ид>
      <Значение>zerkalo-shkaf-runo-iris-60-zelenoe</Значение>
    </ЗначенияСвойства>
    <ЗначенияСвойства>
      <Ид>CML2_SORT</Ид>
      <Значение>500</Значение>
    </ЗначенияСвойства>
    <ЗначенияСвойства>
      <Ид>CML2_ACTIVE_FROM</Ид>
      <Значение></Значение>
    </ЗначенияСвойства>
    <ЗначенияСвойства>
      <Ид>CML2_ACTIVE_TO</Ид>
      <Значение></Значение>
    </ЗначенияСвойства>
    <ЗначенияСвойства>
      <Ид>CML2_PREVIEW_TEXT</Ид>
      <Значение>22</Значение>
      <Тип>text</Тип>
    </ЗначенияСвойства>
    <ЗначенияСвойства>
      <Ид>CML2_DETAIL_TEXT</Ид>
      <Значение>33</Значение>
      <Тип>text</Тип>
    </ЗначенияСвойства>
    <ЗначенияСвойства>
      <Ид>CML2_PREVIEW_PICTURE</Ид>
      <Значение>123_files/Inve_Madrid_70_k.jpg</Значение>
    </ЗначенияСвойства>
    <ЗначенияСвойства>
      <Ид>META_TITLE</Ид>
      <Значение>Зеркало-шкаф Runo Ирис 60 зеленое купить в Москве</Значение>
    </ЗначенияСвойства>
    <ЗначенияСвойства>
      <Ид>META_KEYWORDS</Ид>
      <Значение>Зеркало-шкаф Runo Ирис 60 зеленое, купить Зеркало-шкаф Runo Ирис 60 синее</Значение>
    </ЗначенияСвойства>
    <ЗначенияСвойства>
      <Ид>META_DESCRIPTION</Ид>
      <Значение>Зеркало-шкаф Runo Ирис 60 зеленое - отличное зеркало-шкаф для ванной комнаты</Значение>
    </ЗначенияСвойства>
    <ЗначенияСвойства>
      <Ид>CML2_ARTICLE</Ид>
      <Значение>М 756</Значение>
    </ЗначенияСвойства>
    <ЗначенияСвойства>
      <Ид>COLLECTION</Ид>
      <Значение>Ирис</Значение>
    </ЗначенияСвойства>
    <ЗначенияСвойства>
      <Ид>SHIRINA_SHKAFA</Ид>
      <Значение>1500</Значение>
    </ЗначенияСвойства>
        <ЗначенияСвойства>
      <Ид>CML2_PICTURES</Ид>
      <ЗначениеСвойства>
        <Значение>123_files/inve_madrid_9.jpg</Значение>
        <Описание>ракурс 1</Описание>
      </ЗначениеСвойства>
      <ЗначениеСвойства>
        <Значение>123_files/Inve_Madrid_r_iNVE_70.jpg</Значение>
        <Описание>ракурс 2</Описание>
      </ЗначениеСвойства>
        </ЗначенияСвойства>
    <ЗначенияСвойства>
      <Ид>CML2_MANUFACTURER</Ид>
      <Значение>brand-2</Значение>
    </ЗначенияСвойства>
    <ЗначенияСвойства>
      <Ид>NALICHIE</Ид>
      <Значение>nalichie-da</Значение>
    </ЗначенияСвойства>
    <ЗначенияСвойства>
      <Ид>OFFERS</Ид>
      <Значение>product-1</Значение>
      <Значение>product-2</Значение>
    </ЗначенияСвойства>
  </ЗначенияСвойств>
  <Цены>
    <Цена>
      <ИдТипаЦены>BASE</ИдТипаЦены>
      <ЦенаЗаЕдиницу>3860.00</ЦенаЗаЕдиницу>
      <Валюта>RUB</Валюта>
      <Единица>шт</Единица>
    </Цена>
    <Цена>
      <ИдТипаЦены>SMALLOPT</ИдТипаЦены>
      <ЦенаЗаЕдиницу>3560.00</ЦенаЗаЕдиницу>
      <Валюта>RUB</Валюта>
      <Единица>шт</Единица>
    </Цена>
    <Цена>
      <ИдТипаЦены>OPT</ИдТипаЦены>
      <ЦенаЗаЕдиницу>3000.00</ЦенаЗаЕдиницу>
      <Валюта>RUB</Валюта>
      <Единица>шт</Единица>
    </Цена>
  </Цены>
  <Количество>0</Количество>
</Предложение>

<Ид>product-3</Ид> - идентификатор товара, произвольное уникальное значение.
Допустимые символы: цифры, символы латинского алфавита, нижнее подчеркивание, тире. Регистр любой.

<Наименование>Зеркало-шкаф Runo Ирис 60 зеленое</Наименование> - название товара. Произвольное значение.

<БитриксТеги></БитриксТеги> - служебный узел, как правило не используется, брать как есть, оставить пустым.

<Группы><Ид>cat-2</Ид></Группы> - привязка товара к товарной группе, в узле <Ид>cat-2</Ид> указан идентификатор ранее созданной группы – cat-2.

<Картинка>123_files/Inve_Madrid_70_k.jpg</Картинка> - основная большая фотография товара, выводится на карточке товара.

Далее в узле Значения Свойств задаются значения ранее описанных свойств товара.

<ЗначенияСвойства>
              <Ид>CML2_ACTIVE</Ид>
              <Значение>true</Значение>
 </ЗначенияСвойства> - признак того, что товар будет отображён на сайте.

<ЗначенияСвойства>
  <Ид>CML2_CODE</Ид>
  <Значение>zerkalo-shkaf-runo-iris-60-zelenoe</Значение>
</ЗначенияСвойства> - уникальный символьный код товара, используется при формировании URL товара, для данного товара URL будет «http://localhost:6448/catalog/mebel-dlya-vannoy-komnaty/shkafy/zerkalo-shkaf-runo-iris-60-zelenoe/».

<ЗначенияСвойства>
  <Ид>CML2_SORT</Ид>
  <Значение>500</Значение>
</ЗначенияСвойства> - ключ сортировки товара в каталоге, как правило не используется на сайте, так как товары сортируются либо по цене, либо по наименованию, либо по новизне. Значение можно оставить как в данном примере.

<ЗначенияСвойства>
  <Ид>CML2_ACTIVE_FROM</Ид>
  <Значение></Значение>
</ЗначенияСвойства>
<ЗначенияСвойства>
  <Ид>CML2_ACTIVE_TO</Ид>
  <Значение></Значение>
</ЗначенияСвойства> - данные узлы взять как есть.

<ЗначенияСвойства>
  <Ид>CML2_PREVIEW_TEXT</Ид>
  <Значение></Значение>
  <Тип>text</Тип>
</ЗначенияСвойства> - текст анонса товара. Как правило в интернет-магазинах не применяется, взять как есть, с пустым значениям и типом text.

<ЗначенияСвойства>
  <Ид>CML2_DETAIL_TEXT</Ид>
  <Значение><strong>Описание товара "Зеркало-шкаф Runo Ирис 60 зеленое"</strong></Значение>
  <Тип>html</Тип>
</ЗначенияСвойства> - детальное описание товара, выводится на карточке товара. Значение может быть текстовое, либо html. Соответственно в узле тип нужно указать text или html. Если для описания используется html, то все html-теги должны бы экранированы. Если для описания используется text, то при выводе значения этого свойства на карточке товара символы переноса строки будут автоматически заменены тегом <br />.

<ЗначенияСвойства>
  <Ид>CML2_PREVIEW_PICTURE</Ид>
  <Значение>123_files/Inve_Madrid_70_k.jpg</Значение>
</ЗначенияСвойства> - картинка анонса товара

<ЗначенияСвойства>
  <Ид>META_TITLE</Ид>
  <Значение>Зеркало-шкаф Runo Ирис 60 зеленое купить в Москве</Значение>
</ЗначенияСвойства> - заголовок окна браузера на карточке данного товара

<ЗначенияСвойства>
  <Ид>META_KEYWORDS</Ид>
  <Значение>Зеркало-шкаф Runo Ирис 60 зеленое, купить Зеркало-шкаф Runo Ирис 60 синее</Значение>
</ЗначенияСвойства> - мета-ключевые слова карточки товара

<ЗначенияСвойства>
  <Ид>META_DESCRIPTION</Ид>
  <Значение>Зеркало-шкаф Runo Ирис 60 зеленое - отличное зеркало-шкаф для ванной комнаты</Значение>
</ЗначенияСвойства>  - мета-описание карточки товара

<ЗначенияСвойства>
  <Ид>CML2_ARTICLE</Ид>
  <Значение>М 756</Значение>
</ЗначенияСвойства> - артикул товара

<ЗначенияСвойства>
  <Ид>COLLECTION</Ид>
  <Значение>Ирис</Значение>
</ЗначенияСвойства> - коллекция товара

 <ЗначенияСвойства>
  <Ид>SHIRINA_SHKAFA</Ид>
  <Значение>1500</Значение>
</ЗначенияСвойства>  - свойство товара «ширина шкафа»

<ЗначенияСвойства>
  <Ид>CML2_PICTURES</Ид>
  <ЗначениеСвойства>
    <Значение>123_files/inve_madrid_9.jpg</Значение>
    <Описание>ракурс 1</Описание>
  </ЗначениеСвойства>
  <ЗначениеСвойства>
    <Значение>123_files/Inve_Madrid_r_iNVE_70.jpg</Значение>
    <Описание>ракурс 2</Описание>
  </ЗначениеСвойства>
</ЗначенияСвойства> - дополнительные изображения товара, каждое изображение в своем узле ЗначениеСвойства. В узле описание можно указать текст, который будет выводится на увеличенном просмотре данного изображения, а также в атрибутах alt и title тега <img />.

<ЗначенияСвойства>
  <Ид>CML2_MANUFACTURER</Ид>
  <Значение>brand-2</Значение>
</ЗначенияСвойства> - привязка производителя к данном товару по коду производителя, который был задан в описаниях свойства CML2_MANUFACTURER.

<ЗначенияСвойства>
  <Ид>NALICHIE</Ид>
  <Значение>nalichie-da</Значение>
</ЗначенияСвойства> - признак наличия товара. В данном примере указана привязка к значению «да» свойства NALICHIE через идентификатор nalichie-da значения этого свойства, которое было описано ранее.

<ЗначенияСвойства>
  <Ид>OFFERS</Ид>
  <Значение>product-1</Значение>
  <Значение>product-2</Значение>
</ЗначенияСвойства>  - привязка к данному товару двух других товаров с идентификаторами product-1 и product-2 в качестве Модификаций товара. Свойство OFFERS в данном проекте будет считаться как «Модификации товара».

Далее после узла Значения Свойств следует узел Цены. Каждая цена в своем отдельном узле Цена.

Узел Цена

<Цена>
  <ИдТипаЦены>BASE</ИдТипаЦены>
  <ЦенаЗаЕдиницу>3860.00</ЦенаЗаЕдиницу>
  <Валюта>RUB</Валюта>
  <Единица>шт</Единица>
</Цена> - задана базовая цена в рублях за единицу товара «шт»
<Цена>
  <ИдТипаЦены>SMALLOPT</ИдТипаЦены>
  <ЦенаЗаЕдиницу>3560.00</ЦенаЗаЕдиницу>
  <Валюта>RUB</Валюта>
  <Единица>шт</Единица> - задана мелко-оптовая цена в рублях за единицу товара «шт»
</Цена>
<Цена>
  <ИдТипаЦены>OPT</ИдТипаЦены>
  <ЦенаЗаЕдиницу>3000.00</ЦенаЗаЕдиницу>
  <Валюта>RUB</Валюта>
  <Единица>шт</Единица> -  - задана оптовая цена в рублях за единицу товара «шт»
</Цена>

Завершает описание товара узел Количество.

<Количество>0</Количество> - задается остаток товара на складе.