Імпорт товарів та послуг на сайт компанії та на маркетплейс, а також експорт з сайту та з маркетплейсу може бути виконаний в одному з наступних форматів:
- файл XML(YML) у форматі, описаному нижче;
- електронна таблиця Excel, файл у форматі XLS, XLSX або CSV, докладний опис цього формату імпорту/експорту см. в документі Імпорт позицій через Excel - формат файлів XLS(X) та CSV.
Як зробити успішний імпорт?
Покрокові рекомендації для коректного імпорту:
Зверніть увагу! Рекомендований розмір yml-файлу до 180 МБ.
Список категорій маркетплейсу
У файлі Список категорій можна знайти прямі посилання та номера (ID) на потрібні категорії.
Як виконати експорт?
Про те, як експортувати товари з сайту вашої компанії, см. Експорт товарів та груп товарів.
Опис формату імпорту та експорту XML(YML)
Нижче описані всі теги, які можуть бути використані при імпорті в форматі XML(YML). Додаткові, не описані в даній документації теги, присутні у файлі експорту, будуть проігноровані під час імпорту.
Зверніть увагу! У форматі XML(YML) існує два варіанти формування назви товару:
- Склеювання назви з параметрів «typePrefix» (приставка назви товару) + vendor (виробник) + model (модель товару), наприклад «Принтер» + «HP» + «Color LaserJet 3000». Для цього в описі товару вказуйте <offer id="12314" type='vendor.model' available="true">.
- Використання тега <name>. Тег <name> ігнорується, якщо вказано параметр type='vendor.model'.
Важливо! Дата знижки посиланням не надсилається. За наявності знижки, вона буде завантажена на сайт за замовчуванням терміном на 31 день. Також не передаються посиланням описи/фотографії груп.
Стандарт XML/YML не допускає використання недрукованих спеціальних символів. Також символи ", &, >, <, ' потрібно замінювати на еквівалентні коди:
| Символ у тексті | Код для XML/YML-файлу |
| " | " |
| & | & |
| > | > |
| < | < |
| ' | ' |
Приклад поля |
Опис |
|---|---|
| <?xml version="1.0" encoding="UTF-8"?> |
Кодування файлу XML, Можливі значення: windows-1251, UTF-8. |
|
<!DOCTYPE yml_catalog SYSTEM "shops.dtd"> |
Технічна інформація. |
|
<shop> |
Початок опису файлу імпорту. |
|
Групи товарів на сайті компанії |
|
|
<categories> |
Початок опису блоку груп товарів. |
|
<category id="Ідентифікатор_групи">Назва_групи</category> |
Мінімальний варіант складається з Ідентифікатор_групи та Назва_групи |
|
<category id="Ідентифікатор_групи" parentId="Ідентифікатор_батьківської_групи" portal_id="ID_категорії_на_порталі" portal_url="Посилання_на_категорію_на_порталі" > Назва_групи</category> |
Розширенний варіант: Ідентифікатор_батьківської_групи - унікальний ідентифікатор, використовується для створення вкладеної структури груп в кабінеті та на сайті компанії. ID_категоріі_на_порталі - унікальний ідентифікатор категорії маркетплейсу, в якій будуть опубліковані товари даної групи. Посилання_на_категорію_портала - посилання на категорію маркетплейсу, в якій будуть опубліковані товари даної групи. Список категорій |
|
</categories> |
Кінець опису блоку груп. |
| Товари та послуги | |
| <offers> | Початок опису блоку імпортованих товарів/послуг. |
|
<offer id="ID_позиції" available="Наявність" in_stock="Готово до відправки" type="vendor.model" selling_type="Тип_товару" group_id="ID_різновиду"> |
ID_позиції - Обов'язкове поле, за яким надалі буде виконуватися оновлення даної позиції. selling_type — тип товару на Prom.ua. r — «Товар продається тільки в роздріб» "available" — статус наявності товару "склад або true"— в наявності "" — немає в наявності "false" — немає в наявності.
Параметр "group_id" (числовий параметр, від 1 до 999999999)- це унікальний номер, який використовується для маркування основного товару та його різновидів. Детальніше про імпорт різновидів XML/YML. Параметр in_stock = "true" вказує статус «Готово до відправки». Приклад: <offer id="161305" available="true" in_stock="true"> |
|
<name>Назва _товару</name> |
Обов`язкове поле. Якщо вказано параметр (type='vendor.model') тег <name> ігнорується. |
|
<name_ua>Назва _товару_укр</name_ua> |
Назва позиції українською. Якщо у файлі імпорту не буде заповнено description_ua, назва товарів українською не оновиться. Щоб переклад товару оновився, у нього мають бути заповнені обидва поля ― назва та опис українською. |
|
<typePrefix>Приставка_імені_товару</typePrefix> |
Використовується тільки з тегом «vendor.model» для склеювання назви з параметрів «typePrefix» (приставка назви товару) + vendor (виробник) + model (модель товару), наприклад «Принтер» + «HP» + «Color LaserJet 3000». |
|
<categoryId>Ідентифікатор_групи</categoryId> |
Обов'язкове поле. Відповідає ідентифікатору групи або ідентифікатору підгрупи в блоці опису груп <catalog>. |
|
<portal_category_id> ID_категорії_на_порталі </portal_category_id> |
Унікальний ідентифікатор категорії маркетплейсу, в якій буде опубліковано цей товар після імпорту. Список категорій |
| <portal_category_url> Посилання_на_категорію_порталу </portal_category_url> |
Посилання на категорію маркетплейсу, в якій буде опубліковано товар після імпорту.
|
|
<price>Ціна</price> |
Ціна (число від 0.01 до 9999999999) або ціна з урахуванням знижки. Параметр обов'язковий тільки при зазначенні тега <oldprice>.
|
|
<oldprice>Ціна_товару_без_знижки</oldprice> або <price_old>Ціна_товару_без_знижки</price_old> |
Якщо у товара є знижка, в даному полі вказується ціна без урахування знижки. Тег <price> є обов'язковим при наявності <oldprice> При використанні <oldprice> і <discount> значення знижки будуть проігноровані. Важливо! Значення <oldprice> буде мати пріоритет над значеннями <price_old> чи <old_price>. |
|
<discount>Знижка</discount> |
Знижка задана в відсотках або абсолютних значеннях. Приклад: 30% або 20. Знижка застосовується на період у 30 днів. Тег <price> є обов'язковим. При використанні <oldprice> і <discount> значення знижки будуть проігноровані. |
|
<minimum_order_quantity>Кількість_товарів |
Числове значення. Для товарів з типом «Товар продається тільки оптом» для зазначення мінімальної кількості доступної для замовлення (поле «При замовленні від") |
|
<quantity_in_stock>Кількість товару на складі</quantity_in_stock> або <stock_quantity>Кількість товару на складі</stock_quantity> |
Числове значення Важливо! Значення <quantity_in_stock> буде мати пріоритет над <stock_quantity>. |
| <prices> <price> <value>Оптова_ціна1</value> <quantity>Кількість1</quantity> </price> <price> <value>Оптова_ціна2</value> <quantity>Кількість2</quantity> </price> </prices> |
Зазначення оптових цін для товарів типу «Товар продається тільки оптом». |
| <price> Рознічна_ціна </price> <prices> <price> <value>Оптова_ціна</value> <quantity>Кількість</quantity> </price> </prices> |
Зазначення оптових цін для типів товарів «Товар продається оптом та в роздріб». |
|
<currencyId>Валюта</currencyId> |
Валюта, в якій вказана ціна (UAH, BYR, KZT, EUR, USD). |
| <picture>Посилання1</picture> • • • <picture>Посилання10</picture> |
Посилання на фотографію товару. Може бути зазначено від 1 до 10 посилань. |
| <vendor>Назва_виробника</vendor> |
Обов'язкове поле тільки при використанні параметра «vendor.model», оскільки бере участь у формуванні назви товару. Бренд, торгова марка або назва підприємства-виробника, під знаком якого виготовлений товар (можливо значення «Власне виробництво»).
|
|
<model>Модель</model> |
Модель товару. Використовується тільки з параметром «vendor.model» для склеювання назви з параметрів «typePrefix» (приставка назви товару) + vendor (виробник) + model (модель товару), наприклад «Принтер» + «HP» + «Color LaserJet 3000». |
|
<vendorCode>Код(Артикул)</vendorCode> або |
Код товару (артикул) необхідний для швидкого та зручного пошуку потрібної позиції на сайті компанії та в особистому кабінеті при телефонному зверненні клієнта. Довжина артикулу - 25 символів (цифри, кирилиця, латиниця, знаки «-», «_», «.», «/» та пробіл). Важливо! Значення <vendorCode> буде мати пріоритет над значеннями <barcode> та <article>. |
| <country>Країна_виробник</country> | Необов'язкове поле. |
|
<param name="Назва_характеристики" unit="Одиниця_виміру_характеристики"> Значення_характеристики_товару</param> |
Характеристика товару. Ліміт: до 100 характеристик на одну позицію Щоб додати характеристику, встановлену для категорії товару, необхідно скопіювати її назву, одиницю вимір та значення з блоку «Характеристики» на сторінці додавання/редагування товару. Вигрузка характеристик для категорій в форматі XML Значення характеристики може бути простим або множинним. Наприклад, множинна характеристика «Матеріал корпусу» (Алюміній, Пластмаса) або «Стандарт зв'язку» (GSM, CDMA). Значення множинних характеристик у файлі імпорту розділяйте символом «|» — GSM | CDMA |
|
<description>Опис_товару</description> |
Опис товару. Обов'язкове поле. Текст опису може містити HTML-теги, в такому випадку обов'язково повинен бути вкладений в тег <! [CDATA [...]]>. Приклад: <description> <! [CDATA [<p> Чоботи, як чоботи. <br> Матеріал верху: юхта, юхта з кирзою. <br> Підошва - гума. </ p>]]></description> |
|
<description_ua>Опис_товару_укр</description_ua> |
Опис товару українською. Важливо! Якщо у файлі імпорту не буде заповнено name_ua, опис товарів українською не оновиться. |
|
<regions> |
Місцезнаходження товару. Наприклад, місто, де знаходиться склад компанії, з якого товар відправлять покупцю. Можна вказати лише населені пункти з переліку, до 3-х для одного товару. Населений пункт можна вказати за назвою чи ID. Перелік регіонів: |
| <keywords>Ключевое_слово_1, Ключевое_слово_2, ..., Ключевое_слово_N</keywords> |
Ключові слова (пошукові запити, теги) розділені комою. |
| <keywords_ua>Ключове_слово_1, Ключове_слово_2, ..., Ключове_слово_N</keywords_ua> |
Ключові слова українською (пошукові запити, теги) розділені комою. |
| <gtin>Код_маркування</gtin> |
Міжнародний код маркування та обліку логістичних одиниць (GTIN) для фіда Google Merchant Center. Детальніше |
| <mpn>Номер_пристрою</mpn> |
Унікальний (каталожний) номер пристрою (MPN) для фіда Google Merchant Center. Детальніше |
| </offer> | Кінець опису блоку позиції. |
| </offers> | Кінець опису блоку імпортованих товарів/послуг. |
| </shop> | Кінець опису файлу імпорту. |