МАГАЗИНЫ

Требования к файлу экспорта

Для подключения к системе необходимо подготовить файл экспорта в формате XML.

Структура файла экспорта:

Краткое описание тегов:

Атрибут 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 не указан, либо равен нулю – родительской категорией для описываемой считается корневая.
Максимальная допустимая вложенность категорий – шесть уровней. Желательная - менее четырёх.
Пример:

Тег <items> содержит все описания товаров в файле экспорта.

Тег <item> содержит описание отдельного товара. Атрибут id содержит уникальный id товара, целое число от 1 до 2147483647. Внимание! Необходимо, чтобы id товара был постоянным, и не изменялся от экспорта к экспорту.

Тег <name> содержит название товара, строку до 150 символов. Если название больше, оно обрезается, и в его конце ставится троеточие. Внимание! Название товара должно быть указано по формату {Бренд} {Модель}, например, Nokia E96. Также не допускаются названия товаров, полностью написанные заглавными буквами.

Тег <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>.

Тег <vendorCode> содержит VPN (vendor part number) - уникальный код товара (код производителя), строку до 100 символов. Внимание! Настоятельно рекомендуем заполнять это поле.
Пример:
<vendorCode>K770IZWA</vendorCode>

Скачать полное описание требований к файлу экспорта с примерами.