Як імпортувати товари за допомогою XML-файлу

Щоб імпортувати до кабінету товари з характеристиками за допомогою XML-файлу, вам необхідно правильно заповнити файл, спираючись на приклад шаблону, наведеного нижче, та використавши API довідники для внесення характеристик.

Токен для API: 5a6489d1a5c48c9d174bd31f2a0a8fd0
Список категорій можна отримати тут: https://api.epicentrm.com.ua/swagger/#/PIM/getCategoriesV2
Набір атрибутів знаходиться тут: https://api.epicentrm.com.ua/swagger/#/PIM/getAttributeSetsV2
Перелік доступних опцій для обраного набору атрибутів: https://api.epicentrm.com.ua/swagger/#/PIM/getAttributeOptionsV2

Будь ласка, використовуйте ендпоінти версії V2, оскільки версія V1 наразі не підтримуюється і незабаром буде деактивована.

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="{date}">
<offers>
<offer id="1122334455" available="true">
<price>163</price>
<price_old>199</price_old>
<category code="3343">Картини за номерами</category>
<picture>https://nikids.co.ua/upload/iblock/3fa/b7dc01a3adb1d84ee1.jpg</picture>
<name lang="ru">Картина по номерам Идейка Пушистое облачко 30*30см KHO4212</name>
<name lang="ua">Картина за номерами Ідейка Пухнаста хмаринка 30*30см KHO4212</name>
<description lang="ru"><![CDATA[<p>Картина по номерам Идейка Пушистое облачко 30*30см KHO4212</p>]]></description>

<description lang="ua"><![CDATA[<p>Картина за номерами Ідейка Пухнаста хмаринка 30*30см KHO4212</p>]]></description>

<attribute_set code="3343">Картини за номерами</attribute_set>
<param paramcode="13183" name="Розмір" valuecode="d7c3d344fd844ca187739e4f6a4d5baa">15x30</param>
<param paramcode="11887" name="Полотно" valuecode="c5380bbfa7fca64b5496a10bfde38b3a">поліестер</param>

<param paramcode="measure" name="Міра виміру" valuecode="measure_pcs">шт.</param>

<param paramcode="ratio" name="Мінімальна кратність товару"><![CDATA[1]]></param>

<param paramcode="9875" name="Рівень складності" valuecode="b15bfd532157cfd62c9ba04987760e9c">середній</param>
<param paramcode="3176" name="Тематика" valuecode="bsz6btxa,wle9vq5zsirz1dni">тварини, коти</param>
<param lang="ru" paramcode="767" name="Комплектация"><![CDATA[Холст на подрамнике, краски, кисти.]]></param>
<param lang="ua" paramcode="767" name="Комплектація"><![CDATA[Полотно на підрамнику, пензлі, фарби.]]></param>
<param paramcode="country_of_origin" name="Країна-виробник" valuecode="chn" >Китай</param>
<param paramcode="brand" name="Бренд" valuecode="cz1445500250k5a9">Ідейка</param>
<param paramcode="width" name="Ширина"><![CDATA[10]]></param>
<param paramcode="height" name="Висота"><![CDATA[20]]></param>
<param paramcode="length" name="Глибина"><![CDATA[30]]></param>
<param paramcode="weight" name="Вага"><![CDATA[1000]]></param>
<param paramcode="barcodes" name="Штрих код"><![CDATA[4826664899]]></param>
</offer>
</offers>
</yml_catalog>

Усі зміни, які вам необхідно буде внести до елементів шаблону, позначені червоним кольором.
Будь ласка, уважно ознайомтеся із усіма вимогами до заповнення елементів.

<?xml version="1.0" encoding="UTF-8"?> 

Початкові елементи xml-шаблону, що не потребують внесення змін. 

<yml_catalog date="{date}"> 

У атрибуті date елементу <yml_catalog> необхідно вказати дату та час, коли було згенеровано YML-файл.

Дата має бути у такому форматі: рік-місяць-день години:хвилини.

Наприклад: <yml_catalog date="{2020-11-09 15:15}">

<offers>

Дата має бути у такому форматі: рік-місяць-день години:хвилини.

Наприклад: <yml_catalog date="{2020-11-09 15:15}">

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

<offer id="1122334455" available="true"> 

Це початок опису блоку товару — тут ми вказуємо артикул товару та його наявність.
Ця інформація потрібна для автооновлення існуючого товару або заведення нового.

  • offer id — унікальний номер (код) товару, який ви зазвичай використовуєте для його ідентифікації у власній базі чи прайсах. 
Формат артикулу — цифрове або буквено-цифрове значення без розділових знаків, максимальна довжина артикулу — 25 символів.
Тип даних: string

  • available — наявність товару на складі. Якщо товар є у наявності, після available вказуємо "true". Якщо товару в наявності немає, вказуємо "false".
Тип даних: boolean

<price>99</price> 

У цьому елементі необхідно зазначити поточну (актуальну) ціну на товар. Звертаємо вашу увагу, що значення ціни має бути у гривні. Використовуйте цифри без букв.
Якщо вам потрібно вказати ціну з копійками (наприклад, 25 грн 78 копійок), у якості розділового знаку між числами використовуйте крапку: <price>25.78</price>
Тип даних: float

<price_old>199</price_old> 

Тут необхідно вказати ціну товару, що була до знижки (якщо ви імпортуєте новий товар зі знижкою), або стару ціну, що наразі зазначена на сайті (якщо ви плануєте оновити ціну товару).
Якщо знижка на товар не передбачена, видаліть цей тег з файлу імпорту.
Тип даних: float

<category code="3343">Картини за номерами</category>
Це елемент на позначення кінцевої категорії товару. Тут обов'язково потрібно вказати:

  • Код категорії (code) у цифрових значеннях.
Дані: https://api.epicentrm.com.ua/swagger/#/PIM/getCategoriesV2filter[hasChild]=false
Поле: "code"
Тип даних: string

  • Назву кінцевої категорії російською або українською мовою.
Дані: https://api.epicentrm.com.ua/swagger/#/PIM/getCategoriesV2filter[hasChild]=false
Поле: "translations":[{"title"}]
Тип даних: string
<picture>https://nikids.co.ua/upload/iblock/3fa/3faf609fe.jpg</picture> 

Тут потрібно вказати посилання на зображення товару.

Зверніть увагу на формат посилання, наведений у прикладі.

Нагадуємо, що фото мають бути гарної якості та зроблені на білому фоні (або студійні). Мінімальне розширення зображень - 600х500 пікселів.

Головне фото (те, яке покупець бачить першим на сайті) не може містити водяних знаків, має відображати загальний екстер'єр вашого товару та займати від 80% усього зображення. Неприпустиме знаходження у кадрі сторонніх предметів.

Якщо вам потрібно додати кілька фотографій, вкажіть посилання на них через кому та пробіл, наприклад: http://example.com/box., http://example.com/box-foto2.

Перше посилання буде головним фото товару.

<name lang="ru">назва російською</name> 

Якщо ви бажаєте, щоб ваш товар після публікації відображався також на російській версії сайту, впишіть повну назву товару російською мовою, дотримуючись ось такого формату: [назва категорії] + [особливість] + [бренд] + [модель] + [інші характеристики]. Максимально допустима кількість символів у назві – 100.
Наприклад: <name lang="ru">Полироль для фар CarBi BN1234 100мл</name>
Тип даних: string

<name lang="ua">назва українською</name> 

Вкажіть повну назву товару українською мовою, дотримуючись формату: [назва категорії] + [особливість] + [бренд] + [модель] + [інші характеристики]. Максимально допустима кількість символів у назві – 100.
Наприклад: <name lang="ua">Поліроль для фар CarBi BN1234 100мл</name>
Тип даних: string

<description lang="ru">опис на російській</description>

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

Зверніть увагу! Опис можливо форматувати за допомогою html-тегів, його потрібно передавати в <![CDATA[]]>. В описі допускається використання наступних тегів: <p>, <br>, <b>, <ul>, <li>, <table>, <tr>, <td>. Інші теги будуть видалені.
Наприклад: <description lang="ru"><![CDATA[<p>Кастрюля имеет привлекательный вид, прекрасную функциональность, надежную и эргономичную конструкцию.</p><p><b>Особенности изделия:</b></p><ul><li>высококачественная полировка поверхности;</li><li>прочная конструкция из нержавеющей стали;</li><li>трехслойное капсульное дно для быстрого нагрева.</li></ul>]]></description>



<description lang="ua">опис на українській</description>
Внесіть основну інформацію про товар українською мовою, стисло та вичерпно. Максимальна довжина опису складає 12160 символів.

Зверніть увагу! Опис можливо форматувати за допомогою html-тегів, його потрібно передавати в <![CDATA[]]>. В описі допускається використання наступних тегів: <p>, <br>, <b>, <ul>, <li>, <table>, <tr>, <td>. Інші теги будуть видалені.
Наприклад: <description lang="ua"><![CDATA[<p>Каструля має привабливий вигляд, прекрасну функціональність, надійну й ергономічну конструкцію.</p><p><b>Особливості виробу:</b></p><ul><li>високоякісне полірування поверхні;</li><li>міцна конструкція з нержавіючої сталі;</li><li>тришарове капсульне дно для швидкого нагрівання.</li></ul>]]></description>
<attribute_set code="3343">Картини за номерами</attribute_set>
Тут вкажіть код набору атрибутів та його назву.

  • Code - код значення набору атрибутів.
Перелік доступних наборів атрибутів передається у списку всіх категорій.
Значення "attributeSets": [ { "code": "6406" } ]
Приклад: https://api.epicentrm.com.ua/swagger/#/PIM/getCategoriesV2?filter[hasChild]=false
Поле: "code"
Тип даних: string

  • Назву атрибут-сету можна вказати будь-якою мовою.
Дані: https://api.epicentrm.com.ua/swagger/#/PIM/getAttributeSetsV2?filter[ids][]=693
Поле: "translations":[{"title"}]
Тип даних: string

<param lang="ru" paramcode="767" name="Комплектация"><![CDATA[Холст на подрамнике, краски, кисти.]]></param>

Текстові характеристики (наприклад, комплектація) мають бути закриті в CDATA.
Тип даних: string
<param lang="ua" paramcode="767" name="Комплектація"><![CDATA[Полотно на підрамнику, пензлі, фарби.]]></param>
  • paramcode - вказуємо код характеристики, використовуючи цифрові значення.
Приклад: https://api.epicentrm.com.ua/swagger/#/PIM/getAttributeSetsV2?filter[ids][]=693
Поле: "items"->"attributes"->"code
Зверніть увагу, що код у характеристиці українською мовою та код у той самій характеристиці російською мають збігатися.
Тип даних: string

 

  • name - вказуємо назву характеристики потрібною мовою, використовуючи текстові значення.
Приклад: https://api.epicentrm.com.ua/swagger/#/PIM/getAttributeSetsV2?filter[ids][]=693
Поле: "items"->"attributes"->"translations"->"title
Тип даних: string

<param paramcode="9875" name="Рівень складності" valuecode="b15bfd532157cfd62c9ba04987760e9c">середній</param>
Якщо вам потрібно додати характеристику типу select (одне значення), вкажіть:

  • paramcode - код атрибута, використовуючи цифрові значення.
Приклад: https://api.epicentrm.com.ua/swagger/#/PIM/getAttributeSetsV2?filter[ids][]=693
Поле: "items"->"attributes"->"code"
Тип даних: string

  • name - назву атрибута будь-якою мовою, використовуючи текстові значення.
Приклад: https://api.epicentrm.com.ua/swagger/#/PIM/getAttributeSetsV2?filter[ids][]=693
Поле: "items"->"attributes"->"translations"->"title"
Тип даних: string

  • valuecode - код значення атрибута, використовуючи цифрові (буквено-цифрові) значення.
Приклад: https://api.epicentrm.com.ua/swagger/#/PIM/getAttributeSetsV2/2493/attributes/491/options?page=1
Поле: "items"->"code"
Тип даних: string
<param paramcode="3176" name="Тематика" valuecode="bsz6btxa,wle9vq5zsirz1dni">тварини, коти</param>
Якщо вам потрібно додати характеристику типу multiselect (кілька значень), коди значень цих характеристик (valuecode) та їх назви потрібно вказувати через кому.

  • paramcode - вказуємо код атрибута, використовуючи цифрові значення.
Приклад: https://api.epicentrm.com.ua/swagger/#/PIM/getAttributeSetsV2?filter[ids][]=693
Поле: "items"->"attributes"->"code"
Тип даних: string

  • name - вказуємо назву атрибутів будь-якою мовою, використовуючи текстові значення.
Приклад: https://api.epicentrm.com.ua/swagger/#/PIM/getAttributeSetsV2?filter[ids][]=693
Поле: "items"->"attributes"->"translations"->"title"
Тип даних: string

  • valuecode - вказуємо коди значення атрибутів, використовуючи цифрові (буквено-цифрові) значення.
Приклад: https://api.epicentrm.com.ua/swagger/#/PIM/getAttributeSetsV2/2493/attributes/491/options?page=1
Поле: "items"->"code"
Тип даних: string
<param paramcode="width" name="Ширина"><![CDATA[100]]></param>

Цифрові характеристики (ширина, довжина, висота, глибина, вага) вносяться за аналогією до текстових (але цифрами без букв), у мм та г відповідно, закриваючись в CDATA.

Тип даних: float

  • paramcode - вказуємо код характеристики, використовуючи цифрові значення.
Приклад: https://api.epicentrm.com.ua/swagger/#/PIM/getAttributeSetsV2?filter[ids][]=693
Поле: "items"->"attributes"->"code
Тип даних: string

  • name - вказуємо назву характеристики будь-якою мовою, використовуючи текстові значення.
Приклад: https://api.epicentrm.com.ua/swagger/#/PIM/getAttributeSetsV2?filter[ids][]=693
Поле: "items"->"attributes"->"translations"->"title"
Тип даних: string

</offer> 

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

</offers> 

Цей елемент означає завершення опису блоку товарів, що імпортуються. Використовуйте його після того, як внесете всі товари до шаблону. 

</yml_catalog> 

Цей елемент використовується на позначення завершення опису файлів імпорту. Вкажіть його останнім у шаблоні. 

Типи атрибутів та їх значення: 

  • Text - характеристика має бути внесена у вільній текстовій формі. Мінімальна кількість символів 1, максимальна - 12160.
  • String - характеристика має бути внесена у вільній текстовій формі. Мінімальна кількість символів - 1, максимальна - 256.
  • Float - характеристика має бути внесена цифрами без букв (дробові числа). Є можливість вказати від'ємне число. Мінімальна кількість символів: -9999999, максимальна: 9999999
  • Int - характеристика має бути внесена цифрами без букв (цілі числа). Є можливість вказати від'ємне число. Мінімальна кількість символів: -9999999, максимальна: 9999999
  • Select - з наведеного переліку характеристик можна обрати лише одне значення.
  • Multiselect - з наведеного переліку характеристик можна обрати кілька значень.
Після внесення товарів до шаблону збережіть зміни у файлі та завантажте його до розділу "Імпорт" особистого кабінету. У способі імпорту вкажіть "Файл", оберіть опцію "Оновити все" та натисніть кнопку "Імпортувати".

Якщо у вас виникли труднощі із завантаженням товарів або додаткові питання, будь ласка, зверніться до служби підтримки: merchant@epicentrk.ua

ПОВ'ЯЗАНІ СТАТТІ

Написати в підтримку: merchant@epicentrk.ua