Імпорт через YML — формат файлу
Для того щоб товари з вашого сайту синхронізувалися з сайтом на ПодКапот потрібно зробити імпорт товарів та послуг на сайт компанії та на маркетплейс Podkapot.com.ua наступного формату: XML(YML) у форматі, описаному нижче;
Як зробити успішний імпорт?
Покрокові рекомендації для коректного імпорту:
Зверніть увагу! Рекомендований розмір yml-файлу до 180 МБ.
Список категорій маркетплейсу
Спиок ID категорій запчастин та марок моделей авто можна знайти в адмінці сайту в розділі Мої товари / Імпорт товарів / ID рубрик та моделей - там є всі номера (ID) на потрібні категорії та марки моделі авто.
Опис формату імпорту та експорту XML(YML)
Нижче описані всі теги, які можуть бути використані при імпорті в форматі XML(YML). Додаткові, не описані в даній документації теги, присутні у файлі експорту, будуть проігноровані під час імпорту.
Зверніть увагу! У форматі XML(YML) існує два варіанти формування назви товару:
- Склеювання назви з параметрів «typePrefix» (приставка назви товару) + vendor (виробник) + model (модель товару), наприклад «Фара» + «Depo» + «212-11P3L-LDEM1». Для цього в описі товару вказуйте <offer id="12314" type='vendor.model' available="true">.
- Використання тега <name>. Тег <name> ігнорується, якщо вказано параметр type='vendor.model'.
Стандарт 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="Ідентифікатор_батьківської_групи"> Назва_групи</category> | Розширенний варіант: Ідентифікатор_батьківської_групи - унікальний ідентифікатор, використовується для створення вкладеної структури груп в кабінеті та на сайті компанії. |
</categories> | Кінець опису блоку груп. |
Товари та послуги | |
<offers> | Початок опису блоку імпортованих товарів/послуг. |
<offer id="ID_позиції" available="Наявність"> | ID_позиції - Обов'язкове поле, за яким надалі буде виконуватися оновлення даної позиції. "available" — статус наявності товару "true"— в наявності "" — немає в наявності "false" — немає в наявності. |
<name>Назва _товару</name> | Обов`язкове поле. |
<categoryId>Ідентифікатор_групи</categoryId> | Обов'язкове поле. Відповідає ідентифікатору групи або ідентифікатору підгрупи в блоці опису груп <catalog>. |
<price>Ціна</price> | Ціна (число від 0.01 до 9999999999) або ціна з урахуванням знижки. |
<currencyId>Валюта</currencyId> | Валюта, в якій вказана ціна (UAH, EUR, USD, PLZ). |
<picture>Посилання1</picture> • • • <picture>Посилання10</picture> | Посилання на фотографію товару. Може бути зазначено від 1 до 10 посилань. |
<vendor>Назва_виробника</vendor> <vendorCode>Код_запчастини</vendorCode> | Не обов'язкове поле. Бренд, торгова марка або назва підприємства-виробника, під знаком якого виготовлений товар (можливо значення «Власне виробництво»). |
<country>Країна_виробник</country> | Необов'язкове поле. |
<param name="Назва_характеристики" unit="Одиниця_виміру_характеристики"> Значення_характеристики_товару</param> | Характеристика товару. Ліміт: до 100 характеристик на одну позицію Щоб додати характеристику, встановлену для категорії товару, необхідно скопіювати її назву, одиницю вимір та значення з блоку «Характеристики» на сторінці додавання/редагування товару. Значення характеристики може бути простим або множинним. Наприклад, множинна характеристика «Матеріал корпусу» (Алюміній, Пластмаса) або «Стандарт зв'язку» (GSM, CDMA). Значення множинних характеристик у файлі імпорту розділяйте символом «|» — GSM | CDMA |
<car> <make>Nissan</make> <model>Teana</model> </car> | Не обов'язкове поле. |
<description>Опис_товару</description> | Опис товару. Обов'язкове поле. Текст опису може містити HTML-теги, в такому випадку обов'язково повинен бути вкладений в тег <! [CDATA [...]]>. Приклад: <description> <! [CDATA [<p> Фара передня Nissan Teana. <br> Стан: Новий <br> Виорбник: Depo </ p>]]></description> |
<keywords>Ключевое_слово_1, Ключевое_слово_2, ..., Ключевое_слово_N</keywords> | Ключові слова (пошукові запити, теги) розділені комою. |
</offer> | Кінець опису блоку позиції. |
</offers> | Кінець опису блоку імпортованих товарів/послуг. |
</shop> | Кінець опису файлу імпорту. |
Немає коментарів:
Дописати коментар