Підготовка прайс-листу XML

Support EVA.UA

Останнє оновлення 5 днів тому

Щоб розмістити товари на маркетплейсі 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="2026-03-18 18:18">

<shop>

<name>EVA</name>

<company>EVA</company>

<url>https://eva.ua/</url>

<currencies>

<currency rate="1" id="UAH"/>

<currency rate="44" id="USD"/>

<currency rate="50" 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>Качественный комплект постельного белья украинского бренда ТЭП обрадует изысканным, лаконичным дизайном и будет способствовать атмосфере уюта и гармонии в спальне. Он изготовлен из ранфорса &ndash; натуральной хлопчатобумажной ткани. Она приятна на ощупь, крепкая, износостойкая, хорошо переносит стирку и длительно сохраняет первоначальный цвет рисунка. Постельное белье легко гладить.</p><p><strong>В комплекте есть</strong> - пододеяльник, 180х215 см, 1 шт;Простынь, 220х215 см, 1 шт;Наволочка, 50х70 см, 2 шт).</p><p><strong>Советы:</strong> Перед первым использованием стирайте белье при температуре 30 &deg;C. В дальнейшем рекомендуется стирать при температуре 40 &deg;C. Чтобы придать ей мягкость и изысканный аромат, а также для упрощения утюжка пользуйтесь любимым кондиционером для белья.</p><p><strong>Состав товара:</strong> Комплект постельного белья ТЭП Happy Sleep Statly двуспальный (пододеяло, 180х215 см + простыня, 220х215 см + 2 наволочки, 50х70 см). Хлопок 100%.</p>]]></description>

<description_ua><![CDATA[<p>Якісний комплект постільної білизни українського бренду ТЕП порадує вишуканим, лаконічним дизайном і сприятиме атмосфері затишку й гармонії в спальні. Він виготовлений із ранфорсу &mdash; натуральної бавовняної тканини. Вона приємна на дотик, міцна, зносостійка, гарно переносить прання та тривалий час зберігає первинний колір малюнку. Постільну білизну легко прасувати.</p><p><strong>У комплекті є - </strong>підковдра, 180х215 см, 1 шт;Простирадло, 220х215 см, 1 шт;Наволочка, 50х70 см, 2 шт).</p><p><strong>Поради:&nbsp;</strong>Перед першим використанням виперіть білизну за температури 30 &deg;C. Надалі її рекомендовано прати за температури 40 &deg;C. Щоб надати їй м&rsquo;якості й вишуканого аромату, а також для спрощення прасування користуйтеся улюбленим кондиціонером для білизни.</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="44"/>
    <currency id="EUR" rate="50"/>
</currencies>

categories
*обов'язковий елемент
Список категорій товарів. Для кожної категорії вказується унікальний id, нумерація дозвільна.

  • id категорій повинні залишатися незмінними;
  • рекомендуємо, щоб в одній категорії в прайс-листі не було товарів з двох різних категорій сайту EVA;
  • рекомендуємо вказувати назву категорії згідно з назвою на сайті EVA.

Приклад:

<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, нумерація дозвільна;
  • offer id повинен залишатися незмінним, забороняється змінювати id, якщо товар вже доданий на сайт EVA;
  • атрибут available вказує наявність товару: true — товар в наявності, false — немає в наявності.

Кожен різновид товару потрібно передавати окремим унікальним 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
необов'язковий елемент
Промо-ціна, яка використовується як акційна ціна на сайті.
Комбінація: price+price_promo
price - перекреслена ціна (2500),
price_promo - акційна ціна зі знижкою (1799)

Ціле або дробове числове значення.
currencyId
*обов'язковий елемент
Валюта, в якій вказана ціна товару: UAH USD EUR.
categoryId
*обов'язковий елемент
Ідентифікатор категорії, до якої відноситься товар.
picture
*обов'язковий елемент
url-адреса зображення товару. Перша фотографія в списку буде основною на сторінці товару. Посилання не може містити кирилицю і пробіли, максимальна кількість символів ━ 1999.

Мінімальна кількість фото ━ 1, максимальна ━ 15. Максимальний розмір одного зображення ━ 10 Мб.

Зображення має бути квадратним, не менше ніж 512х512 px.
vendor
*обов'язковий елемент
Бренд товару (торгова марка / виробник).
article
необов'язковий елемент
Артикул товару.
name
необов'язковий елемент
name_ua
*обов'язковий елемент
Назва товарної позиції.

  • у прайс-листі не може бути два товари з абсолютно однаковою назвою;
  • бренд, вказаний в назві товару має відповідати тегу <vendor>.
  • Максимальна кількість символів ━ 255.

name — назва товару російською.
name_ua — назва товару українською мовою. 
Якщо використовуєте тільки українську версію назви, ця назва буде відображена лише на українській версії сайту. Автоперекладу поки немає.
description
необов'язковий елемент
description_ua
*обов'язковий елемент
Опис товару.

  • опис не має містити посилань, номерів телефонів, адрес, пропозицій послуг чи акцій, цін, картинок тощо;
  • опис можна форматувати за допомогою html-тегів. HTML теги можуть використовуватись лише в <![CDATA[]]>;
  • мінімальна кількість символів — 30; 
  • максимальна кількість символів — 60 000.

description — опис товару російською.
description_ua
— опис товару українською мовою.
Якщо використовуєте тільки українську версію опису, цей опис буде відображений лише на українській версії сайту. Автоперекладу поки немає.
param
*обов'язковий елемент
Параметри товару (характеристики).

Назва параметру вказується в атрибуті param. Назва та значення обов'язково мають бути заповнені, не допускається наявність незаповненого тегу.

В багатозначному тестовому параметрі значення перераховуються через роздільник <br> і закриваються в CDATA.

Приклад:
<param name="Колір">Чорний</param>
<param name="Додаткові характеристики"><![CDATA[
Прасувати на температурі не більш ніж 110 °C
Не можна вибілювати засобами, які виділяють хлор
Прання за температури 30 °C.]]></param>

Максимальна кількість символів ━ 255.
Країна виробництва
необов'язковий елемент
передається через тег <param name> назва параметра "Країна виробництва" із відповідним значенням 

Приклад в XML:
<param name="Країна виробництва">Україна</param>
paramid
необов'язковий елемент
Id характеристики (параметра) на сайті EVA. Використовується для автоматичної зв’язки параметра.

Id параметрів та їх значень для конкретної категорії можна завантажити в кабінеті продавця, розділ «Довідник атрибутів»

Якщо тип параметра: ComboBox, List Values, List, Checkbox, CheckBoxGroup, CheckBoxGroupValues ━ обов'язково вказувати атрибут valueid.

Приклад:
<param name="Колір" paramid="136001" valueid="1150255">Коричневий</param>
valueid
необов'язковий елемент
Id значення характеристики (параметра) на сайті EVA. Використовується для автоматичної прив'язки значення. Максимальна кількість символів: 255.

Приклад:
<param name="Сезон" paramid="39560" valueid="2296922, 2645254, 63320">Осіння, Весняна, Літня</param>

value lang
необов'язковий елемент
Використовується для вказання текстової характеристики двома мовами. Максимальна кількість символів: 255.

value lang="uk" — українська;
value lang="ru" — російська.

Приклад:
<param name="Комплектація">
<value lang="uk">Підковдра 180х215 см — 1 шт; Простирадло 220х215 см — 1 шт; Наволочка 50х70 см — 2 шт</value>
<value lang="ru">Пододеяльник 180х215 см — 1 шт; Простыня 220х215 см — 1 шт; Наволочка 50х70 см — 2 шт</value>
</param>

Чи була ця стаття корисною?

14 з 16 сподобалась ця стаття