Экспорт товаров с сайта - XML файл

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

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

<?xml version="1.0" encoding="utf-8" ?>
<offers amount="3" sessionId="1878501665">                    <!-- Содержит теги товаров -->
    <catalogs>                                                <!-- Содержит теги всех каталогов -->
        <catalog id="11" asId="cat1" title="Холодильники">
            <catalog id="22" asId="cat1.1" title="Двухкамерные"></catalog>
        </catalog>
        ...
    </catalogs>
    <offer id="5243">                                         <!-- Содержит информацию об одном товаре -->
        <title>Наименование товара</title>
        <catalog id="22" asId="cat1.1" title="Холодильники / Двухкамерные"></catalog>
        <catalogs>
            <catalog id="11" asId="cat1" title="Холодильники">
                <catalog id="22" asId="cat1.1" title="Двухкамерные"></catalog>
            </catalog>
        </catalogs>
        <brand id="111" asId="br1" title="Amro">
                <brandSeries asId="42421" title="Юбилейная серия"></brandSeries>
        </brand>
        <time>2013-10-10 12:08:51</time>
        <time_unixtime>1381392531</time_unixtime>
        <mods amount="7">                                     <!-- Содержит теги вариантов (модификаций) -->
            <mod article="1123213" asId="">                   <!-- Содержит информацию об одном варианте (модификации) -->
                <code>5243-6225</code>
                <size>xxl</size>
                <color>red</color>
                <weight>0</weight>
                <quantity>0</quantity>
                <price>5.00</price>
                <showKey>0</showKey>
            </mod>
            ...
        </mods>
        <images amount="2">                                   <!-- Содержит теги изображений -->
            <image>http://cdn1.com/ahrc5dm7ado.jpg</image>    <!-- Если type = export_as_xml -->
            <image>ahrc5dm7ado.jpg</image>                    <!-- Если type = export_as_zip -->
            ...
        </images>
    </offer>
    ...
</offers>

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

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

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

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

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

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

<?xml version="1.0" encoding="utf-8"?>
<offers amount="5" sessionId="1450224532">
	<catalogs>
		<catalog id="11" asId="cat1" title="Холодильники">
			<catalog id="22" asId="cat1.1" title="Двухкамерные"></catalog>
		</catalog>
		<catalog id="1" asId="proekcionnoe_oborudovanie_123123" title="Проекционное оборудование">
			<catalog id="2" asId="videoproektori_123456" title="Видеопроекторы"></catalog>
		</catalog>
	</catalogs>
	<offer id="5325">
		<title>Видеопроектор BIG VP2000</title>
		<catalog id="2" asId="videoproektori_123456" title="Проекционное оборудование / Видеопроекторы"></catalog>
		<catalogs>
			<catalog id="1" asId="proekcionnoe_oborudovanie_123123" title="Проекционное оборудование">
				<catalog id="2" asId="videoproektori_123456" title="Видеопроекторы"></catalog>
			</catalog>
		</catalogs>
        <brand id="111" asId="br1" title="Amro">
                <brandSeries asId="42421" title="Юбилейная серия"></brandSeries>
        </brand>
		<additionalField name="Описание">Данный проектор применяется для небольших помещений</additionalField>
		<time>2015-01-27 14:25:38</time>
		<time_unixtime>1422357938</time_unixtime>
		<url>http://site.com/offer/video-proektor-big-vp2000-o5325/</url>
		<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>
				<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>
	</offer>
</offers>