Підготовка прайс-листу 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>Качественный комплект постельного белья украинского бренда ТЭП обрадует изысканным, лаконичным дизайном и будет способствовать атмосфере уюта и гармонии в спальне. Он изготовлен из ранфорса &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="39.2"/>
    <currency id="EUR" rate="41.5"/>
</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
необов'язковий елемент
Промо-ціна, яка використовується, щоб додати товар у промо-розсилку (промо-сторінку).

Ціле або дробове числове значення.
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
— опис товару українською мовою.
Якщо використовуєте тільки українську версію опису, цей опис буде відображений лише на українській версії сайту. Автоперекладу поки немає.
state
необов'язковий елемент
Стан товару. Використовується для продажу вживаних чи відновлених товарів.

  • used — вживаний товар;
  • refurbished — відновлений товар;
  • new — новий товар;

За замовчуванням (і якщо тег 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.

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

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