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

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

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

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

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

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

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

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

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

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

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

<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>

<sy:offer_description_ru>Опис товару іншою мовою</sy:offer_description_ru>

<sy:offer_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>]]></sy:offer_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>