Требования к 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 опис пропозиції на українській та іноземній мовах

Параметри (Атрибути)

name - назва атрибуту. Ваша внутрішня назва, для синхронізації не використовується.
sy_attr_code - код атрибуту. За цим кодом ваш параметр співставляється з відповідним атрибутом вказаного типу товару.
sy_value_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>

Продавцам