Импорт товаров на сайт - XML файл

На данной странице описана структура содержимого XML файла, использующегося для импорта товаров на сайт на платформе komiz.io из системы бухгалтерского учета, например «1C».

Ниже приведен сокращенный пример файла имеющего описываемый формат (полный пример приведен далее).

	<?xml version="1.0" encoding="utf-8"?>
	<offers amount="1">                                           <!-- Содержит теги товаров -->
		<offer>                                                   <!-- Содержит информацию об одном товаре -->
			<title>Наименование товара</title>
			<catalogs>
				<catalog asId="cat1" title="Холодильники">
					<catalog asId="cat1.1" title="Двухкамерные"></catalog>
				</catalog>
			</catalogs>
			<brand asId="br1" title="Anesi">
				<brandSeries asId="br_series_1" title="Юбилейная серия"></brandSeries>
			</brand>
			<mods amount="7">                                     <!-- Содержит теги вариантов (модификаций) -->
				<mod article="art8_1" asId="">                    <!-- Содержит информацию об одном варианте (модификации) -->
					<size></size>
					<color>White</color>
					<weight>15</weight>
					<quantity>10</quantity>
					<dataModStatus>auto</dataModStatus>
					<price>500.00</price>
					<showKey>1</showKey>
				</mod>
				...
			</mods>
			<images amount="2">                                   <!-- Содержит теги изображений -->
				<image>http://example.com/ahrc5dm7ado.jpg</image> <!-- Поддерживается при любом значении type -->
				<image>ahrc5dm7ado.jpg</image>                    <!-- Поддерживается при любом значении type -->
				...
			</images>
		</offer>
		...
	</offers>

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

Данные в файле содержатся в кодировке UTF-8.

Ниже перечислены основные особенности структуры файла.

• Коренным тегом XML документа является offers. Он является контейнером списка товаров, каждому из которых соответствует дочерний тег offer.
• Тег offer в дочерних тегах и атрибутах содержит информацию о самом товаре, а также его вариантах (модификациях) и изображениях.
• Тег mods (который находится в теге offer) содержит информацию о вариантах (модификациях) данного товара.
• Тег images (который находится в теге offer) содержит информацию об изображениях данного товара (см. ограничения и очередь загрузки изображений).
• Информация о каждом варианте (модификации) товара заключена в тег mod являющимся дочерним для mods.
• Информация о каждом файле изображения товара заключена в тег image являющимся дочерним для images.

ОБРАТИТЕ ВНИМАНИЕ!

• Все атрибуты тегов должны обязательно присутствовать. Кроме исключительных случаев (см. описание атрибута).
• Большинство тегов могут отсутствовать. Исключением являются: коренной тег offers; тег mods с как минимум одним вложенным тегом mod. Если тегов mods и mod нет, то данный товар игнорируется. Если необязательного тега не передается, то соответствующее ему данное либо не изменяется (при существовании товара или его варианта (модификации) в базе данных сайта), либо заполняется «пустым значением» (в случае отсутствия товара или его вариантов (модификации) в базе данных сайта).
• Нужно учесть, что количество повторяемых тегов варьируется относительно количества отображаемых ими «сущностей». Например, количество тегов offer равно количеству товаров в данном файле (т.е. может быть равным нулю).

Системой допускаются все основные операции над каталогами: создание, редактирование, а также перенос одного каталога в другой. Для задания иерархии каталогов необходимо верно сформировать ее из вложенных друг в друга тегов catalog. В атрибуте asId каждого такого тега указывается идентификатор каталога в системе бухгалтерского учета. Если такой каталог будет найден, то его наименование будет изменено на то, что указано в атрибуте title. Если же не найден, то будет создан новый каталог с данным наименованием (с учетом вложенности). Также, данный каталог будет перенесен в другой каталог, если это необходимо. ПОМНИТЕ! Перенос каталога возможен, только если соблюдается ряд условий, в том числе: каталог назначения не должен содержать ни товаров, ни параметров.

Если конечный каталог товара был изменен, то будет совершен перенос данного товара в указанный каталог.

Системой допускаются все основные операции над брендом: создание, редактирование. В атрибуте asId каждого тега brand указывается идентификатор бренда в системе бухгалтерского учета. Если такой бренд будет найден, то его наименование будет изменено на то, что указано в атрибуте title. Если же не найден, то будет создан новый бренд с данным наименованием.

Сказанное выше справедливо и для серии бренда.

Указание тега brand не обязательно. Также не обязательно указание вложенного в него тега brandSeries. Но, если последний указан, то соответствующая ему серия (если и бренд и серия существуют) должна принадлежать данному бренду. Т.е. перенос серии из одного бренда в другой запрещается.

Если бренд и/или серия были изменены у товара, то будет выполнен перенос данного товара в соответствующую серию и бренд.

ОБРАТИТЕ ВНИМАНИЕ! Система поддерживает работу только с сериями верхнего уровня (у серий есть неограниченная вложенность, но оперирование с ней посредствам описываемого механизма невозможно).

Ниже приведен перечень всех XML тегов, используемых в описываемом файле, с указанием инструкций по их использованию. Теги перечислены в алфавитном порядке.

<?xml version="1.0" encoding="utf-8"?>
<offers amount="5">
    <offer>
        <title>Видеопроектор BIG VP2000</title>
        <catalogs>
            <catalog asId="proekcionnoe_oborudovanie_123123" title="Проекционное оборудование">
                <catalog asId="videoproektori_123456" title="Видеопроекторы"></catalog>
            </catalog>
        </catalogs>
        <brand asId="987654321" title="BIG">
                <brandSeries asId="58962487" title="BIG PRO"></brandSeries>
        </brand>
        <additionalField name="Описание">Данный проектор применяется для небольших помещений</additionalField>
        <useDataModsKey>1</useDataModsKey>
        <props>
                <prop title="Размер"></prop>
        </props>
        <mods amount="1">
            <mod article="35130944" asId="123456789">
                <propValues>
                    <propValue title="Средний"></propValue>
                </propValues>
                <maxDiscount>100.00</maxDiscount>
                <minAmountInOrder>1</minAmountInOrder>
                <maxAmountInOrder>0</maxAmountInOrder>
                <weight>0</weight>
                <barcode></barcode>
                <quantity>0</quantity>
                <dataModStatus>Нет в наличии</dataModStatus>
                <price>6501.00</price>
                <priceOld>0.00</priceOld>
                <showKey>0</showKey>
                <price type="Тип цен 1">5000.00</price>
                <priceOld type="Тип цен 1">0.00</priceOld>
                <price amountInOrder="10">6400.00</price>
                <price amountInOrder="50">6300.00</price>
            </mod>
        </mods>
        <params>
            <param asId="954732" title="Световой поток">
                <paramValue asId="47312874" title="800"></paramValue>
            <param>
            <param asId="3287532" title="Сфера использования">
                <paramValue asId="239854" title="Презентации"></paramValue>
                <paramValue asId="834129" title="Кинотеатры"></paramValue>
            <param>
        </params>
        <images amount="2">
                <image>http://example.com/ahrc5dm7ado.jpg</image>
                <image>http://example.com/htec8dm9jur.jpg</image>
        </images>
    </offer>
</offers>