Підготовка прайс-листу XML
Support EVA.UA
Останнє оновлення 11 днів тому
Щоб розмістити товари на маркетплейсі EVA продавцю необхідно підготувати прайс-лист товарів у форматі XML. Це структурований формат передачі даних про товари.
Технічні вимоги
- url-адреса на xml прайс-лист повинна бути статичною і не змінюватися;
- допустиме кодування даних — UTF-8;
- стандарт XML (YML) не допускає використання недрукованих символів з ASCII-кодами від 0 до 31 (за винятком символів з кодами 9, 10, 13 — табуляція, перенесення рядка, повернення каретки);
- url-адреса товарної пропозиції повинна бути закодована відповідно до стандарту RFC-1738;
- символи ", &, > <, ' потрібно замінювати на еквівалентні коди. Вимога стосується лише написання тексту і не стосується написання тегів;
- заборонено змінювати id товарів і категорій після додавання на сайт EVA.
Приклад XML
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2024-03-27 18:18">
<shop>
<name>EVA</name>
<company>EVA</company>
<url>https://eva.ua/</url>
<currencies>
<currency rate="1" id="UAH"/>
<currency rate="40" id="USD"/>
<currency rate="42" id="EUR"/>
</currencies>
<categories>
<category id="000000055 ">Комплекти постільної білизни EVA</category>
</categories>
<offers>
<offer available="true" id="00005">
<price>988</price>
<price_old>1544</price_old>
<stock_quantity>88</stock_quantity>
<currencyId>UAH</currencyId>
<categoryId>000000055</categoryId>
<picture>https://pwa-api.eva.ua/img/512/512/resize/8/1/816814_1_1732535829.jpg</picture>
<picture>https://pwa-api.eva.ua/img/512/512/resize/8/1/816814_2_1732535830.jpg></picture>
<vendor>ТЕП</vendor>
<article>AT215E</article>
<name>Комплект постельного белья ТЕП Happy Sleep Grey Dots двуспальный 180х215 см серый</name>
<name_ua>Комплект постільної білизни ТЕП Happy Sleep Grey Dots двоспальний 180х215 см сірий</name_ua>
<description>
<![CDATA[<p>Качественный комплект постельного белья украинского бренда ТЭП обрадует изысканным, лаконичным дизайном и будет способствовать атмосфере уюта и гармонии в спальне. Он изготовлен из ранфорса – натуральной хлопчатобумажной ткани. Она приятна на ощупь, крепкая, износостойкая, хорошо переносит стирку и длительно сохраняет первоначальный цвет рисунка. Постельное белье легко гладить.</p><p><strong>В комплекте есть</strong> - пододеяльник, 180х215 см, 1 шт;Простынь, 220х215 см, 1 шт;Наволочка, 50х70 см, 2 шт).</p><p><strong>Советы:</strong> Перед первым использованием стирайте белье при температуре 30 °C. В дальнейшем рекомендуется стирать при температуре 40 °C. Чтобы придать ей мягкость и изысканный аромат, а также для упрощения утюжка пользуйтесь любимым кондиционером для белья.</p><p><strong>Состав товара:</strong> Комплект постельного белья ТЭП Happy Sleep Statly двуспальный (пододеяло, 180х215 см + простыня, 220х215 см + 2 наволочки, 50х70 см). Хлопок 100%.</p>]]></description>
<description_ua><![CDATA[<p>Якісний комплект постільної білизни українського бренду ТЕП порадує вишуканим, лаконічним дизайном і сприятиме атмосфері затишку й гармонії в спальні. Він виготовлений із ранфорсу — натуральної бавовняної тканини. Вона приємна на дотик, міцна, зносостійка, гарно переносить прання та тривалий час зберігає первинний колір малюнку. Постільну білизну легко прасувати.</p><p><strong>У комплекті є - </strong>підковдра, 180х215 см, 1 шт;Простирадло, 220х215 см, 1 шт;Наволочка, 50х70 см, 2 шт).</p><p><strong>Поради: </strong>Перед першим використанням виперіть білизну за температури 30 °C. Надалі її рекомендовано прати за температури 40 °C. Щоб надати їй м’якості й вишуканого аромату, а також для спрощення прасування користуйтеся улюбленим кондиціонером для білизни.</p>]]></description_ua>
<param name="Матеріал">Бавовна</param>
<param name="Спальний розмір">Двоспальні</param>
<param name="Розмір підковдри">180 х 215 см</param>
<param name="Розмір наволочки">2 х 50х70 см</param>
<param name="Розмір простирадла">215 х 220 см</param>
<param name="Колір">Сірий</param>
<param name="Країна-виробник товару">Україна</param>
</offer>
</offers>
</shop>
</yml_catalog>
Опис елементів даних в xml
Елемент | Значення |
yml_catalog *обов'язковий елемент | Кореневий елемент формату YML. Атрибут date вказує дату і час генерації або зміни XML (YML). Дата повинна мати формат YYYY-MM-DD hh:mm. |
shop *обов'язковий елемент | Містить опис магазину і його товарних пропозицій. |
name необов'язковий елемент | Коротка назва магазину. Не публікується, використовується для внутрішньої ідентифікації. Максимальна кількість символів ━ 255. |
company необов'язковий елемент | Повна назва компанії. Не публікується, використовується для внутрішньої ідентифікації. Максимальна кількість символів ━ 255. |
url необов'язковий елемент | URL головної сторінки існуючого магазину. Максимальна кількість символів ━ 255. |
currencies *обов'язковий елемент | Список курсу валют магазину. Кожна з валют описується окремим елементом currency. Значення в атрибуті currency id="..." потрібно вказувати за стандартом ISO 4217 (у вигляді трибуквеного алфавітного коду валюти: UAH USD EUR). Приклад: <currencies> <currency id="UAH" rate="1"/> <currency id="USD" rate="39.2"/> <currency id="EUR" rate="41.5"/> </currencies> |
categories *обов'язковий елемент | Список категорій товарів. Для кожної категорії вказується унікальний id, нумерація дозвільна.
Приклад: <categories> <category id="1">Дитяча парфумерія</category> <category id="2">Тонуючі засоби для волосся</category> <category id="3">Ремувери для волосся</category> </categories> Максимальна кількість символів ━ 255. |
eva_id (для тегу category) необов'язковий елемент | Атрибут забезпечує автоматичну зв'язку категорії прайс-листа з категорією сайту EVA. Вказується лише в списку категорій, в товару вказується ваш id категорії. Приклад: <categories> <category id="12345" eva_id="106303">Жіноча парфумерія</category> </categories> id=”12345” ━ ваш id категорії; eva_id=”106303” ━ id ті категорії на EVA, де повинні бути розміщені товари. Пріоритет eva_id вище, ніж у назви категорії. Наприклад, якщо назва категорії в XML файлі «Засіб для миття волосся», а в атрибуті eva_id буде вказано id категорії «Шампуні» на сайті EVA, то автоматично буде зв'язок з категорією «Шампуні». |
offers *обов'язковий елемент | Список пропозицій магазину. Відкривається після тегу </categories>. Закривається перед тегом </shop>. |
offer *обов'язковий елемент | Інформація про товарну позицію.
Кожен різновид товару потрібно передавати окремим унікальним offer id (колір, розмір, об'єм, комплектація тощо). |
stock_quantity або quantity_in_stock *обов'язковий елемент | Залишки товару. Ціле цифрове значення. Товар буде в наявності поки цей параметр більше ніж 0. Обов'язково вказувати тег для кожного offer в прайс-листі, позиції без тегу будуть у статусі «Немає в наявності». |
url (в offer) необов'язковий елемент | url-адреса сторінки товару на сайті продавця. Максимальна кількість символів ━ 500. |
price *обов'язковий елемент | Ціна товару. Ціле або дробове числове значення. Роздільником цілої та дробової частин використовуйте крапку або кому. Ціна з копійками на сайті EVA буде округлена. |
price_old або old_price необов'язковий елемент | Перекреслена ціна (стара ціна товару). Ціле або дробове числове значення. Використовується для відображення знижки на товар. Значення <price_old> має бути вище значення <price>. |
price_promo або promo_price необов'язковий елемент | Промо-ціна, яка використовується, щоб додати товар у промо-розсилку (промо-сторінку). Ціле або дробове числове значення. |
currencyId *обов'язковий елемент | Валюта, в якій вказана ціна товару: UAH USD EUR. |
categoryId *обов'язковий елемент | Ідентифікатор категорії, до якої відноситься товар. |
picture *обов'язковий елемент | url-адреса зображення товару. Перша фотографія в списку буде основною на сторінці товару. Посилання не може містити кирилицю і пробіли, максимальна кількість символів ━ 1999. Мінімальна кількість фото ━ 1, максимальна ━ 15. Максимальний розмір одного зображення ━ 10 Мб. Зображення має бути квадратним, не менше ніж 512х512 px. |
vendor *обов'язковий елемент | Бренд товару (торгова марка / виробник). |
article необов'язковий елемент | Артикул товару. |
name необов'язковий елемент name_ua *обов'язковий елемент | Назва товарної позиції.
name — назва товару російською. name_ua — назва товару українською мовою. Якщо використовуєте тільки українську версію назви, ця назва буде відображена лише на українській версії сайту. Автоперекладу поки немає. |
description необов'язковий елемент description_ua *обов'язковий елемент | Опис товару.
description — опис товару російською. description_ua — опис товару українською мовою. Якщо використовуєте тільки українську версію опису, цей опис буде відображений лише на українській версії сайту. Автоперекладу поки немає. |
state необов'язковий елемент | Стан товару. Використовується для продажу вживаних чи відновлених товарів.
За замовчуванням (і якщо тег state невказаний) товарам проставляється статус new. |
param *обов'язковий елемент | Характеристики товару (параметри). Назва характеристики вказується в атрибуті name. Назва та значення обов'язково мають бути заповнені, не допускається наявність незаповненого тегу. В багатозначному тестовому параметрі значення перераховуються через роздільник <br> і закриваються в CDATA. Приклад: <param name="Колір">Чорний</param> <param name="Додаткові характеристики"><![CDATA[ Прасувати на температурі не більш ніж 110 °C Не можна вибілювати засобами, які виділяють хлор Прання за температури 30 °C.]]></param> Максимальна кількість символів ━ 255. |
paramid необов'язковий елемент | id характеристики (параметра) на сайті EVA. Використовується для автоматичної зв’язки параметра. Якщо тип параметра: ComboBox, List Values, List, Checkbox, CheckBoxGroup, CheckBoxGroupValues ━ обов'язково вказувати атрибут valueid Приклад: <param name="Колір" paramid="136895" valueid="1150615">Коричневий</param> |
valueid необов'язковий елемент | id значення характеристики (параметра) на сайті EVA. Використовується для автоматичної прив'язки значення. Приклад: <param name="Сезон" paramid="39560" valueid="2296922, 2645254, 63320">Осіння, Весняна, Літня</param> Максимальна кількість символів ━ 255. |
value lang необов'язковий елемент | Використовується для вказання текстової характеристики двома мовами. value lang="uk" — українська; value lang="ru" — російська. Використовується для автоматичної прив'язки значення. Приклад: <param name="Рекомендації по догляду"> <value lang="uk">Не відбілювати</value> <value lang="ru">Не отбеливать</value> </param> Максимальна кількість символів ━ 255. |