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

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

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

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

• yml_catalog
• shop
• currencies
• offers

Опис можливих тегів, атрибутів та значень в <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 значення характеристики товару, повинен містити атрибут 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

<yml_catalog xmlns:sy="http://base.synthetic.ua/ns/1.0" date="2020-04-08 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="28.70"/>

<currency id="EUR" rate="CB"/>

</currencies>

<categories>

<category id="116158384">Новые поступления</category>

<category id="115624418" parentId="112357028">Косметика </category>

<category id="111948963">Товары NEW</category>

</categories>

<offers>

<offer id="648053662" available="true">

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

<sy:p-code>P00383VQ</sy:p-code>

<price>1290</price>

<sy:price_old>1700</sy:price_old>

<stock_quantity>10</stock_quantity>

<sy:warranty>12</sy:warranty>

<sy:delivery_policy>f302334549b84230a052bcbb483542a3</sy:delivery_policy>

<state>Refurbished</state>

<currencyId>UAH</currencyId>

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

<vendor>Samsung</vendor>

<vendorCode>1038</vendorCode>

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

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

<sy:offer_description_ru>Описание предложения</sy:offer_description_ru>

<sy:offer_description_ua>Опис пропозиції</sy:offer_description_ua>

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

</offer>

</offers>

</shop>

</yml_catalog>