XML файл

Для автоматической загрузки информации о товарах, которые продаются в Вашем магазине, необходимо составить XML файл (Extensible Markup Language).
XML файл должен соответствовать данному формату.

Общие замечания по формату, которые необходимо учитывать

Стандарт XML учитывает порядок следования элементов, поэтому важно соблюдать его в соответствии с примерами, приведенными ниже.

Стандарт XML не допускает использования в текстовых данных непечатаемых символов с ASCII-кодами в диапазоне значений от 0 до 31 (за исключением символов с кодами 9, 10, 13 - табуляция, перевод строки, возврат каретки). Также этот стандарт требует обязательной замены некоторых символов на эквивалентные им символьные примитивы.

Условия замены в текстовых полях:

Текстовый символ	Замена(символьный примитив)
"	"
&	&
>	>
<	&lt;
'	&apos;

Заголовок документа (XML header):

<?xml version="1.0" encoding="UTF-8" ?>

Заголовок должен начинаться с первой строки, с нулевого символа.

Элемент eplanet_catalog

- <eplanet_catalog date="2011-02-03 16:38">
   - <shop>
...
    </shop>
</eplanet_catalog>

Любой XML-документ может содержать только один корневой элемент. В качестве корневого используется элемент eplanet_catalog. Атрибут date элемента eplanet_catalog должен соответствовать дате и времени генерации XML-файла на стороне магазина. Дата должна иметь формат YYYY-MM-DD HH:mm.

Элемент shop

<shop>    
В элементе shop содержится описание всех товаров магазина. Товары магазина описываются в элементах currencies, categories, offers.

Элемент currencies

<currencies>
 <currencyid="1" code="UAH" rate="1" />
 <currencyid="2" code="USD" rate="8" />
 <currencyid="3" code="EUR" rate="10" />
 <currencyid="4" code="RUB" rate="0.25" />
 <currencyid="5" code="F" rate="12.771" />
</currencies>

Элемент currencies задает список курсов валют магазина. Каждая из валют описывается отдельным элементом currency. Параметр id элемента currency указывает код валюты, а параметр rate - курс этой валюты к валюте, взятой за единицу. Параметру rate присваивается исключительно числовое значение (если присутствует дробная часть - значение вводится через точку).

Элемент categories

<categories>
 <category id="26">Женская обувь</category>
 <category id="30" parentId="26">Балетки</category>
 <category id="29" parentId="26">Босоножки</category>
 <category id="28" parentId="26">Ботильоны</category>
 <category id="31" parentId="26">Кеды</category>
 <category id="32" parentId="26">Кроссовки</category>
 <category id="33" parentId="26">Мокасины</category>
 <category id="34" parentId="26">Полусапоги</category>
 <category id="35" parentId="26">Сапоги</category>
 <category id="36" parentId="26">Туфли</category>
 <category id="37" parentId="26">Шлепанцы</category>
 <category id="1">Мужская обувь</category>
 <category id="41" parentId="1">Босоножки</category>
 <category id="2" parentId="1">Ботинки</category>
 <category id="42" parentId="1">Бутсы</category>
 <category id="3" parentId="1">Кеды</category>
 <category id="40" parentId="1">Кроссовки</category>
 <category id="39" parentId="1">Мокасины</category>
 <category id="7" parentId="1">Полусапоги</category>
 <category id="5" parentId="1">Сапоги</category>
 <category id="4" parentId="1">Туфли</category>
 <category id="38" parentId="1">Шлепанцы</category>
 <category id="43">Обувь для девочек</category>
 <category id="57" parentId="43">Балеточки</category>
 <category id="55" parentId="43">Босоножечки</category>
 <category id="53" parentId="43">Ботиночки</category>
 <category id="51" parentId="43">Кроссовочки</category>
 <category id="49" parentId="43">Сапожечки</category>
 <category id="47" parentId="43">Туфельки</category>
 <category id="45" parentId="43">Шлепанцы</category>
 <category id="44">Обувь для мальчиков</category>
 <category id="56" parentId="44">Босоножечки</category>
 <category id="54" parentId="44">Ботиночки</category>
 <category id="52" parentId="44">Кроссовочки</category>
 <category id="58" parentId="44">Мокасинчики</category>
 <category id="50" parentId="44">Сапожечки</category>
 <category id="48" parentId="44">Туфельки</category>
 <category id="46" parentId="44">Шлепанцы</category>
  <category id="64">Дизайнерская обувь</category>
<category id="73" parentId="64">Gnatkovskih</category>
<category id="65" parentId="64">Jenny Cristal</category>
<category id="77" parentId="64">Julia Kosova</category>
<category id="76" parentId="64">MOD</category>
<category id="70" parentId="64">VolSTan</category>
<category id="75" parentId="64">Алена Щеглова</category>
<category id="68" parentId="64">Андрей Денисенко</category>
<category id="72" parentId="64">Таня Перетятко</category>
<category id="74" parentId="64">Юлия Котишева</category>
<category id="67" parentId="64">Яна Титова</category> 
  <category id="27">Другое</category>
  <category id="59" parentId="27">Губки и щетки</category>
  <category id="62" parentId="27">Краски для обуви</category>
  <category id="60" parentId="27">Крема и блески</category>
  <category id="69" parentId="27">Накладки для обуви</category>
  <category id="63" parentId="27">Стельки и шнурки</category>
  <category id="61" parentId="27">Сумки</category>

</categories>

В элементе categories содержится список категорий shoes.ua. Каждая категория описывается отдельным элементом category. Описание категории должно включать ее идентификатор (параметр id) для всех категорий и идентификатор категории более высокого уровня для подкатегорий. Идентификатор категории должен быть уникальным положительным целым числом.
Ни у одной категории параметр id не может быть равен "0".
Если элемент parentId не указан, то категория считается корневой.

Параметры:
id - идентификатор категории товаров
parentId - идентификатор предыдущей по иерархии категории товаров

Элемент offers

<offers>
<offer>...</offer>
...
</offers>

В элементе offers содержится список товарных предложений магазинов. Каждое товарное предложение описывается отдельным элементом offer.
Описание товарного предложения может быть представлено следующим способом:

<offer id="1" type="product.model" status="true" price="2500" discount="0" discount_price="0" curId="1" catId="28">
 <offer_pictures>
<offer_picture>http://yoursite.com/file/images/shoes217894.JPG</offer_picture>
<offer_picture>http://yoursite.com/file/images/shoes217895.JPG</offer_picture>
</offer_pictures>
<offer_brand>Trade Mark</offer_brand>
<offer_brandcode>217894</offer_brandcode>
<offer_name>Manchester</offer_name>
<offer_descr>
<![CDATA[Желтые туфли подарят солнечное настроение. Их можно соединить и с джинсами, и с юбкой, и с платьем. <br><br>Высота каблука - 8 см. Материал изготовления верха - натуральная замша, подкладки - натуральная кожа, подошвы - кожвалон. Страна-изготовитель - Франция. Размеры полномерные.]]>
</offer_descr>
<offer_sizes>38;39;40;41</offer_sizes>
<offer_shops>14</offer_shops>
</offer>

Пример созданного .xml файла.

Контакты службы поддержки для вопросов и предложений.