РУС УКР

Технические требования к прайс-листам

Ваш прайс-лист может быть в одном из таких форматов:

  • Excel (прайс-лист должен быть расположен на первом листе файла Excel и не должен содержать формул, а также скрытых строк и столбцов);
  • XML (или YML).

Для автоматической загрузки прайс-листа его необходимо опубликовать на сайте интернет-магазина и предоставить доступ для загрузки по протоколу HTTP. Для доступа к прайс-листу запрещено использовать автотизацию, использование скриптов для перенаправления или загрузки файлов (в частности, файлов фото).

Описание  и примеры файлов прайс-листа:

Общие рекомендации по формату прайс-листа

Формат ibud-XML

Формат hotline-XML

Формат YML

Формат Excel

Общие рекомендации по формату прайс-листа

Товарная позиция должна содержать такие поля:

  • уникальный идентификатор, который должен быть уникальным и неизменным от загрузки к загрузке прайса,

  • название товара,

  • категория товара (одна, которая должна быть приближена к структуре каталогов ibud.ua). Должна быть уникальной и неизменной от загрузки к загрузке прайса,

  • цена в гривнах (или цена в у.е. с обязательным указанием курса пересчета).

Необязательные, но желательные поля:

  • описание товара,
  • единицы измерения товара,

  • артикул товара,

  • фото товара (доступні формати JPG, PNG, GIF),

  • ссылка на соответствующую страницу товара на вашем сайте.

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

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

В поле наименование товара (теги <name> или <model>) запрещается указывать любые слова, которые не относятся к наименованию товара, кроме определения цвета. Максимальное количество 100 символов.

Использование HTML-разметки в тексте прайс-строк не допускается.

В поле описания товарного предложения (<description>) запрещается указывать слова, которые не относятся к описанию товара (кроме определения размера, конфигурации, комплектации).

Товарные предложения, на которые заказы не принимаются, не должны присутствовать в прайс-листе.

В личном кабинете компании, на странице «Настройка XML-импорта» в блоке «Выборочное обновление позиций» указываются поля прайс-листов, которые должны обновляться при повторном импорте файла (настройки общее - для всех типов файлов).

Поскольку сайт ibud.ua двуязычный (украинский и русский), то в форматах ibud-XML и Excel-файлах прайс-листов содержатся поля для перевода; соответствующие поля есть.

Формат ibud-XML

Пример у формате ibud-XML: загрузить.

Товарная позиция должна содержать обязательные поля: название товара, цена, категория товара, id (номер товара в базе Вашей компании), url (ссылка на страницу товара на сайте продавца).

Перечень категорий, брендов и наименований в одной модели запрещается.

Номер id товарной позиции в прайсе должен быть уникальным и оставаться неизменным от экспорта к экспорту прайc-листа. Номер id должен содержать цифры.

В поле названия товара нужно указывать лишь слова, которые относят к обозначению конкретного товара.

Использование html-разметки в тексте прайс-строк запрещено.

Путь к картинкам должен состоять из латинских букв, цифры, знак «минус», подчеркивания. Форматы картинок jpg, jpeg, png или gif (без прозрачных частей).

Стандарт xml требует замены некоторых символов на эквивалентные им символьные примитивы:

СимволЗамена
< &lt;
> &gt;
& &amp;
' &apos;
" &quot;

Более подробные рекомендации по составлению текстовой части прайс-предложения см. здесь https://ibud.ua/ru/faq-question/prays-predlozheniya-27

Описание атрибутов

    <?xml version="1.0" encoding="utf-8"?>
    <!DOCTYPE xml_catalog SYSTEM "shops.dtd">

Стандартный XML- заголовок со ссылкой на файл описания формата (DTD). Заголовок должен начинаться с первой строки, с нулевого символа и содержать объявление версии xml и информацию о кодировании документа. Вторую строчку заголовка XML-документа определяет ссылку на файл описания формата данных (DTD). Здесь достаточно отметить лишь имя файла shops.dtd.

    <yml_catalog date="2015-03-15 23:01">

XML-документ может содержать только один корневой элемент. Формат YML как корневой использует элемент <yml_catalog>. Атрибут date элемента <yml_catalog> должен соответствовать дате и времени генерации XML-файла на стороне магазина. Дата должна иметь формат YYYY-MM-DD hh: mm.

Елемент <shop> содержит описание товарных предложений.

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

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

Параметры:

id — идентификатор вашей категории.

parentId — идентификатор высшей по иерархии (родительской) категории.

    <offer id="1" available="в наличии">

Атрибут id  идентификатор товарной позиции, который должен быть уникальным и оставаться неизменным от экспорта к экспорту прайс-листа.

Атрибут available отражает наличие соответствующего товара. Данный элемент может принимать следующие значения:

  • "нет в наличии" или "0";
  • "в наличии" или "1", либо "true";
  • "под заказ" или "2", либо "false";
  • "наличие уточняйте" или "3".
    <name>Вата базальтовая 50 мм</name>

Название товара.

    <name_translate>Вата базальтова 50 мм</name_translate>

Перевод названия товара (поле не обязательно).

    <price>19</price>

Цена товара.

    <currencyId>UAH</currencyId>

Валюта, в которой выводится цена.

    <measure>шт</measure>

Единицы измерения товара (шт | т | кг | г | м3 | м2 | л | пог. м | км | м | мм | рулон | мешок | пара | упаковка | ч | день | сутки | месяц | объект | услуга и др.).

    <producer>Польша</producer>

Наименование производителя товара.

    <producer_translate>Польща</producer_translate>

Наименование производителя товара.

    </url>

Внешняя ссылка для товара.

    <category>минеральная вата_512</category>

Идентификатор категории товара.

    <picture>
        https://imageserver.ibud.ua/third/2014/12/06/original/1417877658-56794.jpg
    </picture>

Ссылка на фото товара.

    <description>Вата Rockwool - натуральный, неорганический продукт.</description>

Описание товара.

    <description_translate>
        Вата Rockwool - натуральний, неорганічний продукт.
    </description_translate>

Перевод описания товара (поле не обязательно).

    <article>23512</article>

Артикул товара.

Формат hotline-XML

Пример у формата XML: загрузить.

Товарная позиция должна содержать обязательные поля:

  • категория товара (одно наименование модели).  Должна быть уникальной и неизменной от загрузки к загрузке прайса,

  • <priceUAH> цену в гривнах (также цена задается в долларах <priceUSD> (одновременно можно указать только одну валюту)),

  • действующая розничная цена в долларах, не обязательное поле, на сайте не отображается,

  • <id> (номер модели в базе фирмы),

  • <description> (описание товара),

  • <categoryId> (идентификатор каталога, в который будут отнесен товар).

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

Описание атрибутов:

    <?xml version="1.0" encoding="utf-8"?>
    <!DOCTYPE xml_catalog SYSTEM "shops.dtd">

Стандартный XML-заголовок со ссылкой на файл описания формата (DTD). Заголовок должен начинаться с первой строки, с нулевого символа и содержать объявление версии xml и информацию о кодировании документа. Вторую строчку заголовка XML-документа определяет ссылку на файл описания формата данных (DTD). Здесь достаточно отметить лишь имя файла shops.dtd.

Элемент <price> содержит описание магазина и его товарных предложений.

    <price>
        <items>
            <item>...</item>
            <item>...</item>
            ...
        </items>
    </price>
    <date>2010-05-25 17:00</date>

Дата генерации файла в формате РРРР-ММ-ДД ГГ:ХХ.

    <firmName>Супермаркет пилососів</firmName>

 Название магазина (например, Супермаркет пилососів).

    <firmId>1234</firmId>

Уникальный код фирмы, светится в аккаунте.

    <categories>
        <category>
            <id>1</id>
            <name>Електроніка</name>
        </category>
        <category>
            <id>2</id>
            <parentId>1</parentId>
            <name>Мобільні телефони</name>
        </category>
    </categories>

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

Параметры:

id — идентификатор вашей категории товаров.

parentId — идентификатор высшей по иерархии (родительской) категории.

name — название категории.

    <items>...</items>

В элементе <items> содержится список товарных предложений магазина. Каждое товарное предложение описывается отдельным элементом <item>.

    <items>
        <item>...</item>
        <item>...</item>
        ...
    </items>

Начало описания одной товарной позиции.

    <item>
    <id>3278</id>

Идентификатор товарной позиции должен быть уникальным и оставаться неизменным от экспорта к экспорту прайс-листа.

    <categoryId>2</categoryId>

Идентификатор категории товарной позиции.

    <code>15224F</code>

Код модели (артикул производителя).

    <vendor>PROFiL</vendor>

Наименование производителя.

    <name>Труба водосточная Profil 75 мм 3 м коричневая</name>

Наименование модели.

    <description>Труба водосточна Profil применяется для слива воды</description>

Описание товара, поле можно оставить пустым.

    <url>http://shop.ua/1/2/123.html</url>

Ссылка на страницу товара на Вашем сайте.

    <image>http://shop.ua/img/1/2/123.jpg</image>

Ссылка на изображение товара в Вашем сайте

    <priceRUAH>1000</priceRUAH>

Действующая розничная цена в гривнах.

    <stock>в наличии</stock>

Наличие товара на сайте. Принимаются следующие значения:

  • "нет в наличии" или "0";
  • "в наличии" или "1", либо "true";
  • "под заказ" или "2", либо "false";
  • "наличие уточняйте" или "3".
    </item>

Окончание описания товарной позиции.

    <item>
    ...
    </item>

Следующие товарные позиции.

Формат YML

Пример в формате YML: загрузить.

YML (Yandex Market Language) — это стандарт, разработанный Яндексом для принятия и размещения информации от магазинов. YML базируется на стандарте XML (XML DTD). Единственный формат представления данных позволяет быстро и качественно обрабатывать информацию о товарах и услугах, предоставляемой магазинами.

В ссылках, указанных в YML-файле, не рекомендуется использовать пробелы и кириллические символы. Это может привести к невалидности файла.

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

Символ в тексте Код для YML-файла

"

&quot;

&

&amp;

>

&gt;

<

&lt;

'

&apos;

Описание атрибутов:

    <?xml version="1.0" encoding="utf-8"?>
    <!DOCTYPE yml_catalog >

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

Вторая строчка заголовка XML-документа определяет ссылку на файл описания формата данных (XML, DTD). Здесь достаточно отметить лишь имя файла shops.dtd, путь указывать не нужно.

    <yml_catalog date="2010-04-01 17:00">
        <shop>
        <...>
        </shop>
    </yml_catalog>

XML-документ может содержать только один корневой элемент. Формат YML как корневой использует элемент <yml_catalog>. Атрибут date элемента <yml_catalog> должен соответствовать дате и времени генерирования YML-файла на стороне магазина. Дата должна иметь формат YYYY-MM-DD hh: mm.

    <shop>
        <name>BestShop</name>
        <company>Best online seller Inc.</company>
        <url>http://best.seller.ua/</url>
        <currencies> ... </currencies>
        <categories> ... </categories>
        
        <offers> ... </offers>
    </shop>

Элемент <shop> содержит описание магазина и его товарных предложений.

    <currencies>
        </currency id="UAH">
    </currencies>

Элемент <currencies> задает валюту, в которой передаются цены на товары магазина.

Данные о ценах принимаются в гривнах (UAH), долларах (USD) и евро (EUR).

    <categories>
        <category id="1">Покрівельні матеріали</category>
        <category id="2" parentId="1">Бітумна черепиця</category>
        <category id="3" parentId="1">Водостічні системи</category>
        <category id="4">Кладочні матеріали</category>
        <category id="5" parentId="4">Водостічні системи</category>
    </categories>

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

Параметры:

id — идентификатор вашей категории.

parentId — идентификатор высшей по иерархии (родительской) категории.

    <offers>

В элементе <offers> содержится список товарных предложений магазина. Каждое товарное предложение описывается отдельным элементом <offer>.

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

Описание одного товара.

    <offer id="12346" available="true">

id  уникальный идентификатор товара, который должен быть уникальным и неизменным от загрузки к загрузке прайса.

available — элемент, который отражает наличие соответствующего товара. Данный атрибут может принимать следующие значения:

  • "нет в наличии" или "0";
  • "в наличии" или "1", либо "true";
  • "под заказ" или "2", либо "false";
  • "наличие уточняйте" или "3".
    <url>http://best.seller.ua/product_page.asp?pid=12348</url>

Ссылка на страницу товара на Вашем сайте (в ссылках, указанных в YML-файле, не рекомендуется использовать пробелы и кириллические символы. Это может привести к невалидности файла.)

    <price>699.54</price>

Цена товара. Цена округляется до двух знаков после запятой.

    <currencyId>USD</currencyId>

Идентификатор валюты товара (UAH, EUR, USD).

    <measure>шт</measure>

Единицы измерения товара (шт | т | кг | г | м3 | м2 | л | пог. м | км | м | мм | рулон | мешок | пара | упаковка | ч | день | сутки | месяц | объект | услуга и др.).

    <categoryId>6</categoryId>

Идентификатор категории товара. Один товар может относиться только к одной категории.

    <picture>http://best.seller.ua/img/device12345.jpg</picture>

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

    <name>Кирпич клинкерный Евротон Корсика 250х120х65 мм желтый</name>

Название товара. Максимальное количество 100 символов. Также название товара можно заключать в теги <model> Кирпич клинкерный Евротон Корсика 250х120х65 мм желтый <model>. Использовать один тип тегов <name> или <model>.

    <vendor>Longines</vendor>

Производитель товарной позиции.

    <vendorCode>A1234567B</vendorCode>

Артикул товарной позиции.

    <description>Кирпич клинкерный Евротон Корсика устойчив к неблагоприятным атмосферным явлениям:
перепадам температур, морозу, повышенной влажности.
</description>

Описание товарной позиции.

    </offer>

Окончание описания одного товара.

Формат Excel

Пример в формате xls: загрузить.

Перечень колонок в xls-файле (обязательные поля обозначены символом «*»).

id* – уникальный идентификатор товара. Если в колонке id прописать "0" (ноль), то при повторном импорте прайс-листа товарные предложения будут идентифицироваться как новые.

name* – название товара.

name_translate – перевод названия товара (не обязательно поле).

price – цена товара.

currencyId* – идентификатор валюты товара (UAH, RUR, USD).

measure – единицы измерения товара (шт, кг и т.п).

producer – производитель товара.

producer_translate – производитель товара (не обязательно поле).

available – наличие товара. Данное поле прнимает следующие значения:

  • "нет в наличии" или "0";
  • "в наличии" или "1";
  • "под заказ" или "2";
  • "наличие уточняйте" или "3".

url – ссылка на внешний сайт.

category* – идентификатор категории товараДолжен быть уникальным и неизменным от загрузки к загрузке прайса.

picture – ссылка на изображение соответствующее товарное предложение.

description* – описание товарного предложения.

description_translate – описание товарного предложения (не обязательно поле).

article – артикул товарной позиции.