3️⃣Налаштування бази товарів/послуг для JediDesk AI
Вимоги до xml файлу
Jedidesk використовує прайс-листи для масового додавання та оновлення товарів. Нижче наведено детальні вимоги до формату файлу, заповнення полів та рекомендації для успішного імпорту.
1. Призначення прайс-листа
Прайс-лист — це структурований файл з даними про товари, який використовується для: - початкового імпорту. - регулярного оновлення цін, залишків і контенту.
2. Технічні вимоги
допустиме кодування даних — UTF-8;
стандарт YML не допускає використання недрукованих символів з ASCII-кодами від 0 до 31 (за винятком символів з кодами 9, 10, 13 — табуляція, перенесення рядка, повернення каретки);
url-адреса товарної пропозиції повинна бути закодована відповідно до стандарту RFC-1738;
Приклад реалізації прайс-листа.
символи ", &, > <, ' потрібно замінювати на еквівалентні коди. (приклади)
Символ в тексті
Код в XML
"
&quot;
&
&amp;
>
&gt;
<
&lt;
'
&apos;
*Вимога стосується лише написання тексту і не стосується написання тегів;
3. Опис тегів та елементів даних в xml:
yml_catalog
*обов'язковий елемент
Кореневий елемент формату YML. Атрибут date вказує дату і час генерації або зміни XML (YML). Дата повинна мати формат YYYY-MM-DD hh:mm.
shop
*обов'язковий елемент
Інформація про інтернет-магазин.
name
необов'язковий елемент
Назва магазину. На сайті не публікується, використовується для внутрішньої ідентифікації.
Максимальна кількість символів ━ 255.
company
необов'язковий елемент
Назва компанії. Не публікується, використовується для внутрішньої ідентифікації.
Максимальна кількість символів ━ 255.
url
необов'язковий елемент
url-адреса головної сторінки магазину.
Максимальна кількість символів ━ 255.
currencies
*обов'язковий елемент
Перелік курсу валют. Кожна валюта описується окремим елементом currency.
Значення в атрибуті currency id потрібно вказувати у вигляді трибуквеного алфавітного коду валюти: UAH USD EUR (стандарт ISO 4217).
Лише у гривні rate="1". Роздільником цілої та дробової частини частини є крапка або кома.
Приклад:
<currencies>
<currency id="UAH" rate="1"/>
<currency id="USD" rate="36.6"/>
<currency id="EUR" rate="37.9"/>
</currencies>categories
*обов'язковий елемент
Перелік категорій товарів. Для кожної категорії вказується унікальний ідентифікатор (id), нумерація дозвільна.
id категорій повинні залишатися незмінними;
рекомендуємо, щоб в одній категорії в прайс-листі не було товарів з двох різних категорій сайту;
рекомендуємо вказувати назву категорії згідно з назвою на сайті;
максимальна кількість символів ━ 255.
Приклад:
<categories>
<category id="1">Кутові дивани</category>
<category id="2">Смарт-годинник</category>
<category id="3">Дитячі ігрові комплекси</category>
</categories>offers
*обов'язковий елемент
Список всіх товарних позицій. Відкривається після тегу </categories>. Закривається перед тегом </shop>.
offer
*обов'язковий елемент
Інформація про товарну позицію.
кожен товар описується в окремому елементі offer;
кожна позиція повинна мати унікальний id, нумерація дозвільна, допускається використання символів: Aa-Zz і 0-9, не допускається використання кирилиці та пробілів;
забороняється змінювати id, якщо товар вже доданий на ваш сайт;
атрибут available вказує наявність товару: true — товар в наявності, false — немає в наявності.
Кожен різновид товару потрібно передавати окремим унікальним offer id (колір, розмір, об'єм, комплектація тощо).
stock_quantity або quantity_in_stock
*обов'язковий елемент
Залишки товару. Ціле цифрове значення. Товар буде в наявності поки цей параметр більше ніж 0.
Обов'язково вказувати для кожного offer, позиції без тегу будуть у статусі «немає в наявності».
url (в offer)
необов'язковий елемент
url-адреса сторінки товару на сайті продавця.
Максимальна кількість символів ━ 500.
price
*обов'язковий елемент
Ціна товару. Ціле або дробове числове значення. Роздільником цілої та дробової частин використовуйте крапку або кому.
price_old або old_price
необов'язковий елемент
Перекреслена ціна (стара ціна товару). Ціле або дробове числове значення. Використовується для відображення знижки на товар.
Значення <price_old> має бути вище значення <price>.
price_promo або promo_price
необов'язковий елемент
Промо-ціна, яка використовується щоб додати товар на промо-сторінку.
Ціле або дробове числове значення.
currencyId
необов'язковий елемент
Валюта, в якій вказана ціна товару: UAH / USD / EUR.
categoryId
*обов'язковий елемент
Ідентифікатор категорії, до якої відноситься товар.
picture
необов'язковий елемент
url-адреса зображення товару. Посилання повинно мати сертифікат безпеки (https), не має містити кирилицю та пробіли, максимальна кількість символів ━ 1999.
Перша фотографія в списку буде основною на сторінці товару.
Мінімальна кількість ━ 1, максимальна ━ 15. Максимальний розмір одного зображення (файлу) ━ 10 Мб.
vendor
*обов'язковий елемент
Бренд товару (торгова марка/виробник).
article
необов'язковий елемент
Артикул товару.
name або model
*обов'язковий елемент
name_ua або model_ua
необов'язковий елемент
Назва товарної позиції.
у прайс-листі не може бути дві чи більше позицій з абсолютно однаковою назвою;
максимальна кількість символів — 255.
name_ua — назва позиції українською мовою. Якщо в прайс-листі не вказується українська назва для товару, на маркетплейсі буде застосований автоматичний переклад
description
*обов'язковий елемент
description_ua
необов'язковий елемент
Текстовий опис товару.
максимальна кількість символів — 50 000;
опис можна форматувати за допомогою HTML тегів, які потрібно згрупувати в розділі CDATA.
description_ua — опис товару українською мовою. Якщо в прайс-листі немає українського опису, на сайті буде застосований автоматичний переклад.
state
необов'язковий елемент
Стан товару. Використовується для продажу уцінених, вживаних чи відновлених товарів.
new — новий товар;
stock — уцінений товар;
used — вживаний товар;
refurbished — відновлений товар.
За замовчуванням (і якщо тег state не вказаний) товарам встановлюється статус new.
docket
необов'язковий елемент
docket_ua
необов'язковий елемент
Короткий опис товару. Обов’язково використовувати для вказання причини уцінки товару (якщо товар має відповідний статус). Текстове поле, максимальна кількість символів ━ 255.
param
необов'язковий елемент
Характеристики товару (параметри).
Назва характеристики вказується в атрибуті name. Назва та значення обов'язково мають бути заповнені, не допускається наявність незаповненого тегу.
В багатозначному текстовому параметрі значення перераховуються через роздільник <br> і закриваються в CDATA.
Приклад:
<param name="Колір">Чорний</param>
<param name="Додаткові характеристики"><![CDATA[Прасувати за температури не більше ніж 110 °C <br>
Не можна вибілювати засобами, які містять хлор <br>
Прання за температури 30 °C.]]></param>Максимальна кількість символів ━ 500.
paramid
необов'язковий елемент
id характеристики (параметра) на сайті. Використовується для автоматичної зв’язки параметра.
id параметрів та їх значень для конкретної категорії можна завантажити в кабінеті продавця, розділ «Управління товарами» → «Довідники».
Якщо тип параметра: ComboBox, List Values, List, Checkbox, CheckBoxGroup, CheckBoxGroupValues ━ обов'язково вказувати атрибут valueid.
Приклад:
<param name="Колір" paramid="136895" valueid="1150615">Коричневий</param>valueid
необов'язковий елемент
id значення характеристики (параметра) на сайті. Використовується для автоматичної прив'язки значення.
Приклад:
<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.
4. Оновлення даних
- Для оновлення ціни/залишків достатньо передати `id`, `price`, `quantity`. - Опис і фото змінюються при повторному імпорті з тим же `id`. - Можливе часткове оновлення — тільки змінені поля.
5. Типові помилки
- Ціна з комою замість крапки. - Порожнє поле `id`. - Непрямі URL фото (ведуть на сторінку, а не файл). - Некоректна категорія.
Last updated
Was this helpful?