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