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

Support EVA.UA

Останнє оновлення 2 місяці тому

Щоб розмістити товари на маркетплейсі EVA продавцю необхідно підготувати прайс-лист товарів у форматі XML. Це структурований формат передачі даних про товари. 

Технічні вимоги

  • url-адреса на xml прайс-лист повинна бути статичною і не змінюватися;
  • допустиме кодування даних — UTF-8;
  • стандарт XML (YML) не допускає використання недрукованих символів з ASCII-кодами від 0 до 31 (за винятком символів з кодами 9, 10, 13 — табуляція, перенесення рядка, повернення каретки);
  • url-адреса товарної пропозиції повинна бути закодована відповідно до стандарту RFC-1738;
  • символи ", &, > <, ' потрібно замінювати на еквівалентні коди. Вимога стосується лише написання тексту і не стосується написання тегів;
  • заборонено змінювати id товарів і категорій після додавання на сайт EVA;
  • User-Agent для завантаження XML та фото: EvaMerchantBot/1.0,
    Mozilla-рядок для фото;
  • зовнішні IP EVA для whitelist: 138.197.179.150, 164.92.129.224.

    Приклад 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>

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

    15 з 19 сподобалась ця стаття