Exchange

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

Кореневий елемент формату YML.

Атрибут date вказує дату і час генерації або зміни XML (YML). Дата повинна мати формат YYYY-MM-DD hh:mm.

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

Інформація про інтернет-магазин.

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

Назва магазину. На сайті не публікується, використовується для внутрішньої ідентифікації.

Максимальна кількість символів ━ 255.

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

Назва компанії. Не публікується, використовується для внутрішньої ідентифікації.

Максимальна кількість символів ━ 255.

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

url-адреса головної сторінки магазину.

Максимальна кількість символів ━ 255.

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

Перелік курсу валют. Кожна валюта описується окремим елементом currency.

Значення в атрибуті currency id потрібно вказувати у вигляді трибуквеного алфавітного коду валюти: UAH USD EUR (стандарт ISO 4217).

Лише у гривні rate="1". Роздільником цілої та дробової частини частини є крапка або кома.

Приклад: (Товар представляється лише в грн)

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

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

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

Приклад:

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

Атрибут, який забезпечує автоматичну зв'язку категорії прайс-листа з категорією сайту DYBOK.

Вказується лише в переліку категорій, для offer вказується лише основний category_id.

Приклад:

id=”12345” ━ ідентифікатор категорії у вашій систем;
dybok_id=”253” ━ ідентифікатор відповідної категорії на сайті DYBOK.

Пріоритет dybok_id вище, ніж у назви категорії. Наприклад, якщо назва категорії в прайс-листі «Кухня», а в атрибуті dybok_id буде вказано значення категорії «Шафа», то автоматично буде зв'язок з категорією «Шафа».

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

Список всіх товарних позицій. Відкривається після тегу </categories>. Закривається перед тегом </shop>.

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

Інформація про товарну позицію.

• кожен товар описується в окремому елементі offer;
• кожна позиція повинна мати унікальний id, нумерація дозвільна, допускається використання символів: Aa-Zz і 0-9, не допускається використання кирилиці та пробілів;
• забороняється змінювати id, якщо товар вже доданий на сайт DYBOK;
• атрибут available вказує наявність товару:
  true — товар в наявності,
  false — немає в наявності.

Кожен товар потрібно передавати окремим унікальним offer id (колір, розмір, об'єм, комплектація тощо).

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

Залишок товару Ціле цифрове значення. Товар буде в наявності поки цей параметр більше ніж 0.

Обов'язково вказувати для кожного offer, позиції без тегу будуть у статусі «немає в наявності».

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

url-адреса сторінки товару на сайті продавця.

Максимальна кількість символів ━ 500.

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

Ціна Ціле або дробове числове значення. Роздільником цілої та дробової частин використовуйте крапку або кому.

Ціна з копійками на сайті DYBOK буде округлена.

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

Перекреслена ціна (стара ціна товару). Ціле або дробове числове значення. Використовується для відображення знижки та розміру знижки.

Значення <price_old> має бути вище значення <price>.

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

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

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

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

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

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

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

Якщо на вашому сервері встановлено обмеження на завантаження файлу, необхідно додати у виключення наступні ip-адреси:

185.149.41.36

Торгова марка/виробник. Система буде співставляти з наявними виробниками.

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

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

Назва товару

• у прайс-листі не може бути дві чи більше позицій з абсолютно однаковою назвою;
• максимальна кількість символів — 255.

name_ru — назва позиції українською мовою. Якщо в прайс-листі не вказується українська назва для товару, на маркетплейсі буде застосований переклад

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

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

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

description_ru — опис товару українською мовою. Якщо в прайс-листі немає українського опису, на сайті буде застосований переклад

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

Стан товару.

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

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

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

Характеристики та фільтри

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

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

Приклад:

Максимальна кількість символів ━ 500.

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

id характеристики (параметра) на сайті DYBOK. Використовується для автоматичної зв’язки параметра.

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

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

Приклад:

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

id значення характеристики (параметра) на сайті DYBOK. Використовується для автоматичної прив'язки значення.

Приклад:

Максимальна кількість символів ━ 255.

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

Використовується для вказання текстової характеристики двома мовами.
value lang="uk" — українська;
value lang="ru" — російська.

Приклад:

Максимальна кількість символів ━ 255.