Для выставления товаров на SkyMe.ua необходимо подготовить прайс-лист с предложениями в формате XML. В процессе работы магазина адрес ссылки xml должен быть статичным и не меняться. Ссылка должна быть публично доступна в сети.

Требования к XML файлу

  • стандарт XML не допускает использования непечатаемых символов с ASCII-кодами от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки).
  • символы «, &, >, <, ‘ нужно заменять на эквивалентные коды. Требование относится только к тексту и не затрагивает написание тегов;
  • запрещено изменять id товаров, и категорий после добавления на сайт
  • URL-адрес товарного предложения на сайте магазина должен быть закодирован в соответствии со стандартом RFC-1738.
  • допустимая кодировка XML-файла: UTF-8.

Пример XML-файла

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE yml_catalog SYSTEM "shops.dtd">
<yml_catalog date="2011-07-20 14:58">
    <shop>
        <name>ABC</name>
        <company>ABC inc.</company>
        <url>http://www.abc.ua/</url>
        <currencies>
            <currency id="UAH" rate="1"/>
            <currency id="USD" rate="25.5"/>
        </currencies>
        <categories>
            <category id="391">Куртки для мальчиков</category>
            <category id="245" rz_id="4639416">Аромадиффузоры</category>
        </categories>

        <offers>
            <offer id="19305" available="true">
                <url>http://abc.ua/catalog/muzhskaya_odezhda/kurtki/kurtkabx.html</url>
                <price>4499</price>
                <currencyId>UAH</currencyId>
                <categoryId>391</categoryId>
                <picture>http://abc.ua/upload/iblock/a53/a5391cddb40be91705.jpg</picture>
                <picture>http://abc.ua/upload/iblock/9d0/9d06805d219fb525fc.jpg</picture>
                <picture>http://abc.ua/upload/iblock/93d/93de38537e1cc1f8f2.jpg</picture>
                <vendor>Abc clothes</vendor>
                <quantity_in_stock>100</quantity_in_stock>
                <name>Куртка Abc clothes Scoperandom-HH 146 см Черная (1323280942900)</name>
                <description><![CDATA[
<p>Одежда<b>Abc clothes</b> способствует развитию функций головного мозга за счет поощрения мелкой моторики.</p><p>В Abc <b>New Collection</b> будет особенно удобно лазать, прыгать, бегать.</p><p>За счет своей универсальноcти и многофункциональности, <b>Abc clothes</b> отлично подходит:</p><ul><li><b>Для весны</b></li><li><b>Для лета</b></li><li><b>Для ранней осени</b></li></ul><p><b>Состав:</b>• 92% полиэстер, 8%эластан, не токсичность подтверждена лабораторно.</p><p><b>Вес:</b> 305 г</p>]]></description>
                <param name="Рост">146 см</param>
                <param name="Сезон">Весна-Осень</param>
                <param name="Цвет">Черный</param>
                <param name="Стиль">Повседневный (casual)</param>
                <param name="Особенности">Модель с капюшоном</param>
                <param name="Состав">92% полиэстер, 8% эластан</param>
                <param name="Страна производитель товара">Эстония</param>
                <param name="Артикул">58265468</param>
            </offer>

            <offer id="42576" available="true">
                <url>http://abc.ua/catalog/aromadifuzori/greanleaf-heaven.html</url>
                <price>22.50</price>
                <price_old>25.80</price_old>
                <currencyId>USD</currencyId>
                <categoryId>245</categoryId>
                <picture>http://abc.ua/upload/images/detailed/99/GL_signatureRD-haven.jpg</picture>
                <vendor>Greenleaf Haven</vendor>
                <quantity_in_stock>10</quantity_in_stock>
                <name>Аромадиффузор Greenleaf Haven Морская Гавань 118 мл</name>
                <description><![CDATA[
<p>Освежающий аромат морского берега, смешанный запахами лаванды, цветками солнечного жасмина, вместе с оттенками нежного древесного янтаря и сладкого мускуса.</p><p>Срок действия аромата до 4 месяцев.</p><p>Прозрачная стеклянная ромбовая ваза-распылитель запакована в стильную упаковку, включая набор камышовых тростинок, вместе с 133 мл. аромамасла внутри. Освежает и ароматизирует любое комнатное пространство.</p><p>Сделано в США.</p>]]></description>
                <param name="Объем, мл" paramid="140098" valueid="2194404">118</param>
                <param name="Цвет" paramid="140189" valueid="1641734">Прозрачный</param>
                <param name="Аромат" paramid="140133" valueid="1360568">Морская свежесть</param>
                <param name="Наличие аромата" paramid="143288" valueid="1346424">С ароматом</param>
                <param name="Страна-производитель товара" paramid="98900" valueid="619903">США</param>
                <param name="Материал" paramid="142168"><![CDATA[ Стекло/Керамика ]]></param>
            </offer>

        </offers>
    </shop>
</yml_catalog>
        

Описание элементов

ЭлементЭлемент
yml_catalog *Корневой элемент формата YML. Атрибут date указывает дату и время генерации или изменения XML (YML). Дата должна иметь формат YYYY-MM-DD hh:mm.
shop *Содержит описание магазина и его товарных предложений.
nameКороткое название магазина. Не публикуется, используется для внутренней идентификации.
companyПолное наименование компании, владеющей магазином. Не публикуется, используется для внутренней идентификации.
urlURL главной страницы существующего магазина.
currenciesСписок курсов валют магазина. Каждая из валют описывается отдельным элементом currency.
Пример:
<currencies>
<currency id="UAH" rate="1"/>
<currency id="USD" rate="24.50"/>
<currency id="EUR" rate="28.50"/>
<currency id="RUR" rate="0.31"/>
</currencies>
Цены на сайте отображаются только в гривнах. Только у гривны rate=»1″.
В качестве разделителя целой и дробной частей любых чисел в YML независимо от региональных установок используется точка или запятая.
Значение в атрибуте currency id=»…» указывается по стандарту ISO 4217 в виде трёхбуквенного алфавитного (alfa-3) кода валюты.
categoriesСписок категорий магазина. Каждой категории присваиваться уникальный номер, нумерация — на усмотрение магазина.
при любых изменениях в прайс-листе id категорий должны оставаться неизменными;
перед указанием необходимо подобрать конечные категории товара;
рекомендуем указывать название категории согласно названию на нашем сайте. В одной категории не должно быть товаров из разных категорий на нашем сайте;
в одной категории магазина не должно быть товаров из двух разных категорий на нашем сайте.
Пример:
<categories>
<category id="1">Угловые диваны</category>
<category id="2">Смарт-часы</category>
<category id="3">Детские игровые комплексы</category>
</categories>
Максимальное количество символов ━ 255.
offers*Список предложений магазина. Открывается один раз, после тега </categories> . Закрывается в конце документа, перед тегом </shop>
offer *Карточка товара.
Каждому предложению необходимо присвоить уникальный номер id=»…», нумерация – на усмотрение магазина;
Aтрибут available — на текущий момент никак не обрабатывается, учитывается только остаток.
priceЦена товара.
quantity_in_stock *Остатки товара.
currencyId * Валюта, в которой указана цена товара
categoryIdID категории, к которой привязан данный товар.
pictureСсылка на фото товара. Первая фотография в списке будет основной в карточке товара. Ссылка не должна содержать кириллицу и, пробелы
name *Название товара.
description Описание товара.