Требования к XML(YML)

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

Заборонено змінювати offer_id після синхронізації. Це призведе до деактивації пропозиції.
Всі теги повинні бути закритими. Наприклад: <currencies> ... </ currencies>, або <currency id="USD" rate="35"/>.
Файл повинен мати кодування UTF-8.

Список обов’язкових елементів:

yml_catalog
shop
currencies
offers
categories - список ваших категорій. sy_code - код категорії Synthetic.

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

offer обов’язковий елемент, повинен містити атрибути: id - ідентифікатор товарної пропозиції (унікальний в межах файлу, до 100 символів), available - наявність пропозиції, значення true - в наявності, false - не в наявності.
name обов’язковий елемент, містить в собі назву товару, до 500 символів
vendor обов’язковий елемент, бренд товару, до 100 символів
vendorCode містить код виробника
url посилання на товар
price обов’язковий елемент, ціна пропозиції
state стан пропозиції, можливі значення: new - новий, refurbished - відновлений, discount - уцінка, used - вживаний. Також можна вказати різновид вживаного стану такими значеннями: used_perfect - Б/В Ідеальний, used_well - Б/В Хороший, used_satisfy - Б/В Задовільний
stock_quantity або quantity доступна кількість товарів
picture обов’язковий елемент, посилання на зображення. Для товарів із вживаним станом, уцінкою та відновлений фото з тегу додаються у фото пропозиції при її створенні
description містить опис товару. Вміст тегу повинен бути огорнутий в <![CDATA[опис товару]]> для корректного сприйняття та відображення символьних даних
param значення характеристики товару, повинен містити атрибут

Список дозволених тегів у середині description:

    "br",
    "b",
    "strong",
    "p",
    "i",
    "em",
    "ul",
    "ol",
    "li",
    "h1",
    "h2",
    "h3",
    "h4",
    "h5",
    "h6".

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

Призначені тільки для передачі даних на маркетплейсі 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">)

sy_spc код товару до якого автоматично буде прив'язана товарна пропозиція
sy_warranty термін гарантійного обслуговування, вказується кількість місяців
sy_price_old ціна без знижки (стара ціна). На маркетплейсі відображається як перекреслена ціна під поточною
sy_delivery_policy політика доставки. Потрібно вказати ідентифікатор політики
sy_offer_description_ua та sy_offer_description_ru опис пропозиції на українській та іноземній мовах

Параметри/Атрибути товару (param)

Властивості тегу param:

name - назва атрибуту. Ваша внутрішня назва, для синхронізації не використовується.
sy_attr_code - код атрибуту. За цим кодом ваш параметр співставляється з відповідним атрибутом вказаного типу товару.
sy_value_code - код значення. За цим кодом ваше значення співставляється з відповідним значенням маркетплейсу.
sy_unit_code - код одиниці виміру.

Правила обробки тегів param:

Завантажуються лише ті атрибути для яких вказано код sy_attr_code. Якщо код не задано, такий атрибут ігнорується.
Для атрибутів з передбаченим списком (списковий атрибут) слід вказувати код значення зі списку sy_value_code. У випадку якщо ви не вкажете код значення, товар не потрапить у фільтр категорії.
Безсписковим атрибутам (наприклад: вага, довжина ітд.) код значення не передбачений.
Тип атрибуту NUMERIC - при обробці з вмісту тегу використовуються лише числа, всі приставки типу "ГБ, М, КГ ітд." ігноруються. Використовується базова одиниця виміру атрибуту.
Ви можете використати одну з сумісних одиниць виміру вказавши властивість sy_unit_code.
Якщо атрибут підтримує декілька значень, ви можете вказувати цей атрибут декілька разів з різними значеннями.

В особистому кабінеті продавця на сторінці правила синхронізації, ви можете завантажити:

Список дозволених атрибутів для категорії/типу
Список існуючих значень атрибутів (для спискових атрибутів)

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

<yml_catalog xmlns:sy="http://base.synthetic.ua/ns/1.0" date="2025-12-21 09:32">
<shop>
<name>Інтернет магазин "Your-Shop"</name>
<company>Інтернет магазин "Your-Shop"</company>
<url>https://https://yourshop.ua/</url>
<currencies>
<currency id="UAH" rate="1"/>
<currency id="USD" rate="42.70"/>
<currency id="EUR" rate="CB"/>
</currencies>
<categories>
<category id="1" sy_code="C320580">Ноутбуки</category>
<category id="2" sy_code="C337965">Смартфони</category>
<category id="3" sy_code="C441077">Планшети</category>
</categories>
<offers>
<offer id="648053662" available="true">
<categoryId>1</categoryId>
<sy_spc>P06705ZH</sy_spc>
<price>9995.00</price>
<sy_price_old>12995.00</sy_price_old>
<stock_quantity>10</stock_quantity>
<sy_warranty>12</sy_warranty>
<sy_delivery_policy>f302334549b84230a052bcbb483542a3</sy_delivery_policy>
<state>New</state>
<currencyId>UAH</currencyId>
<name> Ноутбук 14" Lenovo V14-IGL Intel Celeron N4020 RAM 4GB SSD 128GB Windows 11</name>
<vendor>Lenovo</vendor>
<sy_type>PTD-00103</sy_type>
<picture>https://cdn.synthetic.com.ua/media/assets/images/9/a/4/d/7/6/9/8/9/b/4/6/4/2/4/e/full/9a4d76989b46424eb94fdae8d2b89a24.png</picture>
<picture>https://cdn.synthetic.com.ua/media/assets/images/2/f/a/4/7/d/8/3/d/3/5/d/4/6/6/5/full/2fa47d83d35d4665a671c2c7837a839e.png</picture>
<description_ru><![CDATA [ Опис товару іншою мовою ]]></description_ru>
<description_ua>
<![CDATA[<p>Екран 14" TN (1920 x 1080) Full HD / Intel Celeron N4020 1.1 - 2.8 ГГц (2/2 ядра) / RAM 4 ГБ DDR4 / SSD 128 ГБ / Intel UHD Graphics 600 / Wi-Fi 5 / Bluetooth 4.2 / TPM модуль / Windows 11 / 1.6 кг</p><p><br></p><p><br></p><p><strong>Практичний мобільний ноутбук</strong></p><p>Lenovo V14-IGL важить всього 1,6 кг, тому його зручно носити на аудиторні заняття або приймати в ділові поїздки. З цим ноутбуком можна до шостої години не замислюватися про пошуки розетки. Робочим планам не завадить навіть розлита на клавіатуру кава. SDD-накопичувач на 128 ГБ дозволяє зберігати необхідну інформацію, а TPM 2.0 захистить особисті та комерційні дані від небажаного зчитування.</p>]]></description_ua>
<param name="Вид" sy_attr_code="AND-533594" sy_value_code="VLD-64251"></param>
<param name="Об'єм SSD" sy_attr_code="AND-534870" sy_value_code="VLD-5031075">128 гб</param>
<param name="Процесор" sy_attr_code="AND-497020" sy_value_code="VLD-75698">Intel Celeron N4020</param>
<param name="Вага" sy_attr_code="AND-00001" sy_value_code="VLD-80399">1,6 кг</param>
</offer>
</offers>
</shop>
</yml_catalog>

Продавцам