> For the complete documentation index, see [llms.txt](https://docs.jedidesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jedidesk.com/nalashtuvannya-jedidesk-ai/nalashtuvannya-bazi-tovariv-poslug-dlya-jedidesk-ai.md). # Налаштування бази товарів/послуг для JediDesk AI Jedidesk використовує прайс-листи для масового додавання та оновлення товарів. Нижче наведено детальні вимоги до формату файлу, заповнення полів та рекомендації для успішного імпорту. ### 1. Призначення прайс-листа Прайс-лист — це структурований файл з даними про товари, який використовується для:\ \- початкового імпорту.\ \- регулярного оновлення цін, залишків і контенту. ### 2. Технічні вимоги * допустиме кодування даних — UTF-8; * стандарт YML не допускає використання недрукованих символів з ASCII-кодами від 0 до 31 (за винятком символів з кодами 9, 10, 13 — табуляція, перенесення рядка, повернення каретки); * url-адреса товарної пропозиції повинна бути закодована відповідно до стандарту RFC-1738; * Приклад реалізації [прайс-листа](https://public.rozetka.market/sellerrozetka/s1596/xml-pricelist-exaple.xml). * символи ", &, > <, ' потрібно замінювати на еквівалентні коди. (приклади) | Символ в тексті | Код в 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.

categories

*обов'язковий елемент

Перелік категорій товарів. Для кожної категорії вказується унікальний ідентифікатор (id), нумерація дозвільна.

  • id категорій повинні залишатися незмінними;
  • parentId - можливість ваказати батьківську категорію для побудови ієрархії;
  • рекомендуємо, щоб в одній категорії в прайс-листі не було товарів з двох різних категорій сайту;
  • рекомендуємо вказувати назву категорії згідно з назвою на сайті;
  • максимальна кількість символів ━ 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>.

currencyId

необов'язковий елемент

Валюта, в якій вказана ціна товару: UAH / USD / EUR.

categoryId

*обов'язковий елемент

Ідентифікатор категорії, до якої відноситься товар.

picture

необов'язковий елемент

url-адреса зображення товару. Посилання повинно мати сертифікат безпеки (https), не має містити кирилицю та пробіли, максимальна кількість символів ━ 1999.

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

vendor

*обов'язковий елемент

Бренд товару (торгова марка/виробник).

article

необов'язковий елемент

Артикул товару.

name або model

*обов'язковий елемент

Назва товарної позиції.

  • максимальна кількість символів — 255.

description

*обов'язковий елемент

Текстовий опис товару.

  • максимальна кількість символів — 50 000;
  • опис можна форматувати за допомогою HTML тегів, які потрібно згрупувати в розділі CDATA.

state

необов'язковий елемент

Стан товару. Використовується для продажу уцінених, вживаних чи відновлених товарів.

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

За замовчуванням (і якщо тег state не вказаний) товарам встановлюється статус new.

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 фото (ведуть на сторінку, а не файл).\ \- Некоректна категорія.