авантаження прайс-листів

Для успішного розміщення товарів на майданчику Price.ua партнер повинен надати якісний фід. Сам по собі фід — це файл з певною структурою і правилами, що містить інформацію про товари магазину.

Наша система може приймати такі формати фідів:

• XML (краще) (*.xml)
• XLS — MsExcel (*.xls)
• CSV — текст з роздільниками (*.csv)
• YML — Yandex Market Language (*.yml), має схожу структуру як і XML
  xml xls csv yml

Також допустимо розміщення прайс-листів у вигляді.zip і.rar архівів.

Після того, як партнер визначився зі зручним для нього форматом розміщення, наступним питанням є спосіб оновлення фіду. Доступно декілька варіантів — оновлення за посиланням і оновлення через менеджера.

Більш практичним і найкращим варіантом є оновлення за посиланням. Партнер в особистому кабінеті фірми проставляє постійне посилання на свій фід, а його менеджер проставляє бажаний час та періодичність оновлення. В цьому випадку система буде автоматично оновлювати прайс-лист. У разі додавання партнером нових категорій товарів вони будуть доступні на сайті через кілька годин.

Варіант поновлення фида через менеджера менш зручний — якщо у партнера немає можливості розмістити постійне посилання на фід, то він може відправляти актуальний файл менеджеру. У разі виникнення будь-яких питань або помилок партнер буде проінформований менеджером.

Вимоги до XML / YML файлу фіда

• У XML не можна використовувати недруковані символи з ASCII-кодами від 0 до 31 (за винятком символів з кодами 9, 10, 13 — табуляція, переклад рядка, повернення каретки).

• Для коректного розпізнавання фида, особливо в елементах <name> і <description>, символи " & & gt; & lt; ' потрібно замінювати на еквівалентні коди :

  Символ в тексті	Код для XML-файлу
  "	"
  &	&
  >	>
  <	&lt;
  '	&apos;

  Щоб не міняти символи в тексті, їх можна екранувати.

  Приклад назви товару без екранування:
  <name>apple iphone 8 256gb red</name>

  Приклад з екрануванням:
  <name><![CDATA[apple iphone 8 256gb red]]></name>

• Необхідно використовувати тільки допустимі кодування XML-файла: UTF-8, windows-1251.

• Використання HTML-розмітки (наприклад <p>) не допускається для всіх видів товарного фіда.

Опис основних елементів фіду:

Елемент	Опис
<?xml … ?> обов'язковий елемент	Заголовок документу. Повинен починатися з першого рядка з нульового символу і містити оголошення версії xml і інформацію про кодування документа (UTF-8 або windows-1251). <?xml version="1.0" encoding="UTF-8"?>
<price> із зазначенням дати обов'язково	Кореневий розділ товарного фіда. Приклад: <price date="2020-06-04 15:00:08">
<name>	Назва магазину. Приклад: <name>Інтернет-магазин ноутбуків</name>
<currency>	Вказівкакурсу USD для перерахунку цін з USD в UAH. Приклад: <currency id="USD" rate="26.78" />
<catalog> обов'язковий елемент	Обов'язковий елемент, що містить список категорій магазину. Кожна категорія описується окремим елементом <catalog>. Для початку в тезі потрібно вказати id категорії і її назву. Також потрібно вказувати категорії, в яких розміщується ваш товар, з використанням parentId. Приклад вказівки для категорії Ноутбуки: <catalog>   <category id="3955">Комп'ютери і ноутбуки</category>   <category id="7117" parentID="3955">Ноутбуки</category> </catalog>

Далі потрібно вказати перелік товарів з їх описом:

Елемент	Опис
<items> обов'язковий елемент	Елементи містять список товарів магазину, кожна товарна пропозиція описується окремим елементом <item>.
<item> обов'язковий елемент	Елемент вказує на початок даних про товар. Приклад: <item id="22202140"> Можна використовувати як з id, так і без
<categoryId> обов'язковий елемент	В даному елементі потрібно вказати id кінцевої категорії, до якої відноситься ваш товар. У прикладі id 7118 - це номер категорії саме смартфонів, а не загальної (рубрики). Приклад: <categoryId>7118</categoryId>
<vendor> обов'язковий елемент	Вказівка виробника товару. Можна вказувати назву тільки одного виробника для даного товару, якщо виробник невідомий — краще залишити тег порожнім. Приклад: <vendor>Samsung</vendor>
<code> (xml) <vendorCode> (yml)	Код (артикул) моделі. Приклад: для xml: <code>MPF12</code> для yml: <vendorCode>MPF12</vendorCode>
<name> (xml) <model> (yml) обов'язковий елемент	Назва товару. Можна вказувати назву тільки одного товару без характеристик. Забороняється вказувати рекламну та іншу інформацію, що не відноситься до назви товару. Приклад: для xml: <name>Apple iphone 8 256gb red</name> для yml: <model>Apple iphone 8 256gb red</model>
<description> бажаний елемент	Короткий опис. Наприклад, важливі характеристики. Приклад: <description>Приклад</description>
<price> обов'язковий елемент	Приклад Ціна товару у вас на сайті. Вказується числом (без пробілів). Як роздільник коп використовуйте крапку.: <price>11253</price> Якщо ціни надані тільки в доларах, обов'язково вказувати курс перерахунку.
<url> обов'язковий елемент	Посилання на сторінку товару на вашому сайті. Уважно вказуйте посилання, так як саме на нього буде переходити користувач при ауткліку. Всі посилання на товари повинні бути робочими. Приклад: <url>https://mywebsite.com.ua/item/apple-iphone-8-256gb-red.html</url>
<image> (xml) <picture> (yml) обов'язковий елемент	Повний URL на зображення товару. Вказуйте правильну картинку, якщо це iPhone 8 RED, то і на зображенні повинен бути червоний iPhone. Всі посилання на картинки повинні бути робочими. На зображенні не повинно бути будь-яких написів, водяних знаків і ін. Забороняється розміщувати картинки, які не є фотографією товару — заглушки по типу "немає фото", "фото очікується"і т.п. Приклад: для xml: <image>https://images.vcene.com/images/item/apple-iphone-8-256gb-red.jpeg</image> для yml: <picture>https://images.vcene.com/images/item/apple-iphone-8-256gb-red.jpeg</picture>
<guarantee> (xml) <warranty> (yml) бажаний елемент	Гарантія — її термін і тип. Тип гарантії може бути офіційним від виробника або власним від магазину. Термін вказується в місяцях (за замовчуванням). За допомогою атрибута type можна вказати тип гарантії: type="manufacturer" — товар забезпечений гарантією виробника type="shop" — товар забезпечений гарантією магазину Приклад: <guarantee>24</guarantee> <guarantee type="shop">24</guarantee> Якщо необхідно вказати термін у днях, то слід використовувати атрибут unit="days". Приклад: <guarantee unit="days" type="manufacturer">7</guarantee>
<oldprice> бажаний елемент	Олдпрайс — стара ціна. Тег Олдпрайс необхідний, якщо потрібно вказати цілеспрямовану знижку на якийсь товар. Приклад: <price>1599</price> <oldprice>2656</oldprice>
<discounted> бажаний елемент	Дискаунт — причина знижки. Діскаунтед необхідний для розміщення б/у або бракованих товарів. В даному тезі вказується причина знижки. Працює він лише при наявності тега <oldprice>, тобто вказується знижка і причина знижки. Приклад: <discounted>Подряпина на корпусі, нетоварний вигляд</discounted>
<param name="Країна виготовлення"> бажаний елемент	Країна виготовлення товару. Приклад: <param name="Країна виготовлення">Україна</param>
<param name="Розмір"> <param name="Тип"> <param name="Колір"> <param name="Матеріал"> бажаний елемент	Парами — додаткові теги, використання яких не буде зайвим, якщо необхідно швидше прив'язати ваші товари до карток і фільтрів товарів на сайті. Парами передають в прайс-листі характеристики товарів. Парами особливо необхідні при розміщенні товарів в категоріях одяг/взуття. Приклад: <param name="Розмір">100х50х75</param> <param name="Тип">Підлоговий</param> <param name="Колір">Чорний</param> <param name="Матеріал">Дерево</param>

 

Вимоги до XLS / CSV файлу фіда

Дані формати фідів не є кращими, тому що — на відміну від XML/YML — ці формати неможливо ретельно розібрати і розпарсити. Відповідно, якась частина опису ваших товарів може бути недоступна до обробки.
Фід у форматах XLS/CSV повинен містити тільки один лист і не містити будь-яких формул, розміток, прихованих стовпців/рядків. В XLS-файлі повинна розміщуватися тільки одна товарна пропозиція. В CSV-файлі як роздільник полів можна використовувати кому, крапку з комою або табуляцію.

Опис основних елементів фіду:

Елемент	Опис
Категорія обов'язковий елемент	Товари фіду не можуть належати до декількох категорій. Товари повинні відноситься тільки до однієї категорії і відповідати їй в рубрикаторі на сайті.
Виробник обов'язковий елемент	Допускається вказівка тільки одного виробника (у разі, якщо виробник невідомий, поле краще залишити порожнім або відзначити як NoName).
Найменування товару обов'язковий елемент	Як і у випадку з виробником, допустима вказівка тільки однієї моделі товару.
Код товару обов'язковий елемент	Артикул моделі від виробника.
Грн / USD обов'язковий елемент	Ціна товару у вас на сайті. Вказується числом (без пробілів). Як роздільник коп використовуйте крапку. Якщо ціни надані тільки в доларах, обов'язково вказувати курс перерахунку.
Гарантія обов'язковий елемент	Гарантія — її термін і тип. Тип гарантії може бути офіційним від виробника або власним від магазину. Термін вказується в місяцях (за замовчуванням).
URL обов'язковий елемент	Посилання на сторінку товару на вашому сайті. Уважно вказуйте посилання, так як саме на нього буде переходити користувач при ауткліку. Всі посилання на товари повинні бути робочими.
Зображення обов'язковий елемент	Повний URL на зображення товару. Вказуйте правильну картинку, якщо це iPhone 8 RED, то і на зображенні повинен бути червоний iPhone. Всі посилання на картинки повинні бути робочими. На зображенні не повинно бути будь-яких написів, водяних знаків і ін. Забороняється розміщувати картинки, які не є фотографією товару — заглушки по типу "немає фото", "фото очікується"і т.п.