Всі статті

Вимоги до 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>