Приклади та призначення основних тегів при імпорті в форматі XML
Увага! Поля, не описані в даній документації, ігноруються під час імпорту.
| Приклад поля | Опис |
|---|---|
| Кодування файлу XML | |
| <?xml version="1.0" encoding="Назва_кодування"?> | Можливі значення: windows-1251, UTF-8. |
| <shop> | Початок опису файлу імпорту |
| Курс валюти | |
| <currency code="USD" rate="Помножувач_курсу_USD"/> | Помножувач_курсу_USD використовується для перерахунку ціни на позицію в UAH з даного курсу, якщо ціна на товар / послугу вказана в USD. |
| Групи на сайті компанії | |
| <catalog> |
Початок опису блоку груп товарів. На основі назв груп в даному файлі імпорту:
|
| <category id="Номер_групи"> Назва_групи</category> | Назва групи на сайті компанії, а також унікальний номер групи в файлі імпорту. |
| <category id="Номер_групи/підгрупи" parentId="Номер_батьківської_групи" portal_id="ID_категорії_на_порталі" portal_url="Посилання_на_категорію_портала" > Назва_групи/підгрупи</category> |
Примітки: • Якщо вказані обидва значення 'portal_id' та 'portal_url', буде використано значення першого вірного параметра. • Тег 'portal_id' має пріоритет перед 'portal_url'. Увага! Даний параметр використовується тільки на Prom.ua. Файл з даними параметром може викликати помилку при імпорті в інші системи. |
| </catalog> | Кінець опису блоку груп. |
| Товари та послуги | |
| <items> | Початок опису блоку імпортованих товарів/послуг. |
| <item id="ID_позиції" selling_type="Тип_товару"> |
Початок опису блоку товарної позиції. Вказується унікальний порядковий номер товару/послуги в файлі імпорту (ID), за яким надалі буде виконуватися оновлення даної позиції. Параметр selling_type - це тип товару на Prom.ua. Тіп_товара визначає розміщення товару в каталозі за ознакою оптового продажу. Тип «Послуга» призначений для розміщення послуг, що надаються приватним особам або компаніям. Увага! Даний параметр використовується тільки на Prom.ua. Файл з даними параметром може викликати помилку при імпорті в інші системи. Можливі значення: r, w, u, s.
|
| <name>Назва_товару</name> | Назва товару, обов'язкове поле. |
| <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'. Увага! Даний параметр використовується тільки на Prom.ua. Файл з даними параметром може викликати помилку при імпорті в інші системи. |
| <priceusd>Ціна_доллар</priceusd> | Ціна товару в USD. Необов'язкове поле. |
| <priceuah>Ціна_гривня</priceuah> | Ціна товару в гривнях. Необов'язкове поле. Завжди відображається за замовчуванням. |
| <prices> <price> <value>Оптова_ціна1</value> <quantity>Кількість1</quantity> </price> <price> <value>Оптова_ціна2</value> <quantity>Кількість2</quantity> </price> </prices> |
Зазначення оптових цін для типів товарів «Товар продається тільки оптом». Увага! Даний параметр використовується тільки на Prom.ua. Файл з даними параметром може викликати помилку при імпорті в інші системи. |
|
<price> |
Зазначення оптових цін для типів товарів «Товар продається оптом та в роздріб». Увага! Даний параметр використовується тільки на Prom.ua. Файл з даними параметром може викликати помилку при імпорті в інші системи. |
| <image>Посилання1</image> * * * <image>Посилання10</image> |
Посилання на зображення позиції. Необов'язкове поле. |
| <vendor>Назва_виробника</vendor> | Обов'язкове поле. Бренд, торгова марка або назва підприємства-виробника, під знаком якого виготовлений товар (можливо значення «Власне виробництво»). Назва виробника імпортується в атрибут «Виробник» в описі товару. Увага! Вказаний вами виробник буде імпортований тільки якщо він є в базі виробників порталу. Перевірити його наявність та додати нового виробника можна при додаванні/редагуванні товару в поле «Виробник» (блок «Портальні характеристики»). |
| <vendorCode>Код(Артикул)</vendorCode> або <barcode>Код(Артикул)</barcode> | Код товару (артикул) необхідний для швидкого та зручного пошуку потрібної позиції на сайті компанії та в особистому кабінеті при телефонному зверненні клієнта. Довжина артикулу - 25 символів (цифри, кирилиця, латиниця, знаки «-», «_», «.», «/» та пробіл). |
| <country>Країна_виробник</country> | Необов'язкове поле. Імпортується в атрибут «Країна виробник» в описі товару. |
| <param name="Назва_характеристики" unit="Одиниця_вимірювання_значення"> Значення_характеристики_товару</param> | Назви характеристик та одиниці вимірювання значень необхідно скопіювати з блоку 'портальні характеристики' на сторінці додавання/редагування товару в Кабінеті Компанії. Значення характеристики може бути простим або множинним. Наприклад, множинна характеристика «Матеріал корпусу» (Алюміній, Пластмаса) або «Стандарт зв'язку» (GSM, CDMA). Значення множинних характеристик у файлі імпорту розділяйте символом «|». Увага! Даний тег використовується тільки на нашому порталі. При спробі імпортувати файл з тегом «param» в іншу систему може виникнути помилка." |
| <description>Опис_товару</description> | Опис товару. Обов'язкове поле. Текст опису товару може містити HTML-теги та обов'язково повинен бути укладений в тег <! [CDATA [...]]>. Приклад: <description> <![CDATA [<p>Чоботи, як чоботи.<br>Матеріал верху: юхта, юхта з кирзою.<br>Підошва - гума.</P>]]></description> |
| <available>Наявність</available> |
Зазначення наявності для товару. Значення «склад» або «true» відповідає статусу товару «В наявності», значення «false» - статусу «Під замовлення». Якщо в даному полі порожньо - товар буде імпортовано в статусі «Немає в наявності». |
| <in_stock>Наявність на складі</in_stock> |
Наявність товару «На складі». Доступно лише для компаній з високими показниками якості обслуговування. Детальніше Значення «true» відповідає статусу товару «На складі». Приклад: <in_stock>true</in_stock>. Якщо ви не гарантуєте наявність «На складі» і хочете завантажити товар в статусі «В наявності», не вказуйте параметр <in_stock> |
|
<regions> |
Місцезнаходження товару. Наприклад, місто, де знаходиться склад компанії, з якого товар відправлять покупцю. Можна вказати лише населені пункти з переліку, до 3-х для одного товару. Населений пункт можна вказати за назвою чи ID. Перелік регіонів: |
| <keywords>Ключове_слово_1, Ключове_слово_2, ..., Ключове_слово_N</keywords> | Ключові слова (пошукові запити, теги) товарної позиції або послуги. |
| </item> | Кінець опису блоку позиції. |
| </items> | Кінець опису блоку імпортованих товарів/послуг. |
| </shop> | Кінець опису файлу імпорту. |