Всі статті
Покупцям
Загальна інформація
Продавцям

Вимоги до XML(Hotline) файлу


Загальні вимоги


  1. Заборонено змінювати id елементу item після синхронізації. Це призведе до деактивації пропозиції.
  2. Всі теги повинні бути закритими. Наприклад: <vendor>Apple</vendor>

Список обов’язкових елементів:
  • xml version
  • price
  • date
  • items
  • rate обов’язковий, якщо є ціни в доларах



Опис можливих тегів, атрибутів та значень в <item>...<item/>


  1. name обов’язковий елемент, містить назву товару, до 500 символів
  2. id обов’язковий елемент, ідентифікатор товарної пропозиції, унікальний в межах файлу, до 100 символів
  3. categoryid ідентифікатор категорії до якої відноситься пропозиція
  4. vendor обов’язковий елемент, бренд товару, до 100 символів
  5. code не обов’язковий елемент, містить в собі модель товару, використовується при відсутності name
  6. priceRUAH обов’язковий елемент, ціна пропозиції в гривнях
  7. priceRUSD не обов’язковий елемент, ціна пропозиції в доларах
  8. rate курс долара, обов’язковий елемент якщо є ціни в доларах
  9. stock необов'язковий елемент, статус наявності пропозиції. Якщо цей тег має значення Немає або Нет то пропозиція буде вважатися як "немає в наявності". Відсутність цього тега чи будь-яке інше значення визначається як "в наявності".
  10. condition не обов’язковий елемент, стан пропозиції. Можливі значення 0 - новий, 1 - відновлений, 2 - уцінка, 3 - вживаний. Також можна вказати різновид вживаного стану такими значеннями: used_perfect - Б/У Ідеальний, used_well - Б/У Хороший, used_satisfy - Б/У Задовільний
  11. guarantee не обов’язковий елемент, містить в собі термін гарантії пропозиції, стандартно вказується кількість місяців. Якщо потрібно вказати у днях, слід використати атрибут unit
  12. image обов’язковий елемент, посилання на зображення. Для товарів з вживаним станом, уцінкою та відновлений фото з тегу додаються у фото пропозиції при її створенні
  13. description містить опис товару. Вміст тегу повинен бути огорнутий в <![CDATA[опис товару]]> для корректного сприйняття та відображення символьних даних
  14. param значення характеристики товару, повинен містити атрибут name - назва характеристики, та unit - одиниця виміру для чисельних значень


Внутрішні теги

Призначені тільки для передачі даних на маркетплейсі Synthetic. При їх використанні до кореневого тегу yml_catalog потрібно додати наступний атрибут та значення xmlns:sy="http://base.synthetic.ua/ns/1.0 (Приклад <yml_catalog date="2019-11-22 11:01" xmlns:sy="http://base.synthetic.ua/ns/1.0">)


  1. sy:p-code код товару до якого автоматично буде прив'язана товарна пропозиція
  2. sy:warranty термін гарантійного обслуговування, вказується кількість місяців
  3. sy:price_old ціна без знижки (стара ціна). На Маркетплейсі відображається як перекреслена ціна під поточною
  4. sy:delivery_policy політика доставки. Потрібно вказати ідентифікатор політики
  5. sy:offer_description_ua та sy:offer_description_ru опис пропозиції на українській та російській мовах


Зразок правильно складеного XML


<?xml version="1.0" encoding="UTF-8"?>

<price>

<date>2021-10-08 12:35</date>

<rate>26.50</rate>

<categories>

<category>

<id>59</id>

<name>Ноутбуки та комп'ютери</name>

</category>

<category>

<id>64</id>

<parentId>59</parentId>

<name>Жорсткі диски</name>

</category>

<items>

<item>

<id>62554</id>

<categoryId>64</categoryId>

<name>Жесткий диск Samsung Spinpoint M7E 640GB 5400rpm 8MB HM641JI 2.5" SATA II</name>

<vendor>Samsung</vendor>

<code>1038</code>

<condition>1</condition>

<guarantee>12</guarantee>

<url>https://yourshop.ua/p648053662-zhestkij-disk-samsung.html</url>

<image>https://yourshop.ua/1725669954_zhestkij-disk-samsung-1.jpg</image>

<image>https://yourshop.ua/1725669954_zhestkij-disk-samsung-2.jpg</image>

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

<priceRUAH>1290</priceRUAH>

<priceRUSD>48.67</priceRUSD>

<description>

<![CDATA[Компания Samsung Electronics представляет 2,5-дюймовый жесткий диск Spinpoint M7E, который может выдерживать в процессе работы нагрузки силой до 400G продолжительностью до 2 мс. Spinpoint M7E имеет как жесткое шасси, так и прочную внешнюю оболочку, что делает его идеальным решением для мобильных пользователей. В Spinpoint M7 применяются технологии шумоподавления SilentSeek и NoiseGuard, призванные минимизировать уровень шума от механических операций привода. Благодаря отсутствию галогена в конструкции устройства новинка соответствует жестким европейским нормам RoHS. ]]>

</description>

<param name="Высота" unit="мм">9.5</param>

<param name="Форм-фактор">2.5"</param>

<param name="Объем жесткого диска" unit="GB">640.0</param>

<param name="Ширина" unit="мм">69.85</param>

<param name="Интерфейс">SATA II (SATA/300)</param>

<param name="Назначение">Для ноутбука</param>

<param name="Вид">Внутренний</param>

<param name="Скорость вращения" unit="об/мин">5400.0</param>

<param name="Тип диска">HDD</param>

<param name="Совместимость интерфейса">

SATA (SATA/150)|SATA II (SATA/300)|SATA III (SATA/600)</param>

<param name="Объем буфера" unit="MB">8</param>

<param name="Пропускная способность" unit="Мб/сек">300.0</param>

<param name="Вес" unit="г">106.0</param>

<param name="Уровень шума" unit="дБ">26.0</param>

<param name="Длина" unit="мм">100.2</param>

</item>

</items>

</price>