Выгрузка в Битрикс из 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</Количество> - задается остаток товара на складе.

к списку статей