Для подключения к системе необходимо подготовить файл экспорта в формате XML.
Структура файла экспорта:
<?xml version=”1.0” encoding=”windows-1251”?>
<price date=”…”>
<name>…</name>
<url>…</url>
<currency code=”…”/>
<region>…</region>
<catalog>
<category id=”…”>…</category>
<category id=”…” parentId=”…”>…</category>
</catalog>
<items>
<item id=”…”>
<name>…</name>
<url>…</url>
<price>…</price>
<categoryId>…</categoryId>
<vendor>…</vendor>
<image>…</image>
<description>…</description>
</item>
<item id=”…”>
<name>…</name>
<url>…</url>
<price>…</price>
<categoryId>…</categoryId>
<vendor>…</vendor>
<image>…</image>
<description>…</description>
</item>
</items>
</price>
Краткое описание тегов:
Атрибут date тега <price> предназначен для обозначения даты обновления файла экспорта. Допустимый формат даты: YYYY-MM-DD HH-MM.
Например, date="2007-03-21 11:17"
Тег <name> должен содержать название магазина. Например, <name>Shop</name>.
Тег <currency> определяет валюту прайса. Его атрибут code может принимать одно из трех возможных значений: UAH, USD, EUR. Для задания курса валюты можно использовать атрибут rate, значение которого - курс указанной валюты. Если валюта прайса - евро или доллар, и при этом не указан атрибут rate, то цена будет переведена в гривны по курсу НБУ.
Примеры:
<currency code="USD" rate="5.1" /> - валюта прайса - доллар США, курс 5.1.
<currency code="EUR" /> - валюта прайса - Евро, курс НБУ.
Тег <region> используется для обозначения региона доставки. Допустимые значения: Допустимые значения: "Украина", "Винница", "Днепропетровск", "Донецк", "Житомир", "Закарпатье", "Запорожье", "Ивано-Франковск", "Киев", "Кировоград", "Крым", "Луганск", "Луцк", "Львов", "Николаев", "Одесса", "Полтава", "Ровно", "Сумы", "Тернополь", "Харьков", "Херсон", "Хмельницкий", "Черкассы", "Чернигов", "Черновцы", "Россия".
Например,
<region>Киев</region>
<region>Одесса</region> - регионы доставки: Киев, Одесса.
Тег <catalog> содержит описание дерева категорий файла экспорта.
Тег <category> содержит название описываемой категории дерева категорий. Его атрибут id содержит уникальный номер категории, целое число от 1 до 2147483647. Внимание! Необходимо, чтобы id категории был постоянным и не изменялся от экспорта к экспорту.
Атрибут parentID содержит id родительской категории, целое число от 1 до 2147483647. Если атрибут parentID не указан, либо равен нулю – родительской категорией для описываемой считается корневая.
Максимальная допустимая вложенность категорий – шесть уровней. Желательная - менее четырёх.
Пример:
<catalog>
<category id="1">Мобильная связь</category>
<category id="2" parentID="1">Мобильные телефоны</category>
</catalog>
Тег <items> содержит все описания товаров в файле экспорта.
Тег <item> содержит описание отдельного товара. Атрибут id содержит уникальный id товара, целое число от 1 до 2147483647. Внимание! Необходимо, чтобы id товара был постоянным, и не изменялся от экспорта к экспорту.
Тег <name> содержит название товара, строку до 150 символов. Если название больше, оно обрезается, и в его конце ставится троеточие.
Тег <url> содержит ссылку на страницу товара на сайте магазина-партнёра.
Тег <price> содержит цену описываемого товара, число, разделитель целой и дробной части – точка. Внимание! Не допускаются товары с нулевой ценой, а так же не приветствуются цены, не соответствующие действительности.
Тег <categoryId> содержит id категории из дерева категорий файла экспорта, к которой относится данный товар.
Тег <vendor> содержит название производителя описываемого товара, строку до 100 символов. Это не обязательное поле.
Пример:
<vendor>Nokia</vendor>
Тег <image> содержит ссылку на изображение товара в формате gif, jpg или png. Не обязательное поле. Внимание! Крайне не приветствуется указание вместо изображения товара каких-либо заглушек.
Тег <description> содержит описание товара, строку до 64 Кб. Не обязательное поле. Допускаются следующие HTML-теги: <p>, <br>, <li>, <table>, <tr>, <td>, <ol>, <ul>, <nobr>.
Скачать полное описание требований к файлу экспорта с примерами.