UA
RU
Як імпортувати товари з характеристиками за допомогою 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">Картина по номерам Идейка Пушистое облачко 30*30см KHO4212</description>
		<description lang="ua">Картина за номерами Идейка Пушистое облачко 30*30см KHO4212</description>
		<attribute_set code="3343">Картины по номерам</attribute_set>
		<param paramcode="13183" name="Размер" valuecode="d7c3d344fd844ca187739e4f6a4d5baa">15x30</param>
		<param paramcode="11887" name="Холст" valuecode="c5380bbfa7fca64b5496a10bfde38b3a">полиэстр</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>
    Це елемент на позначення початку опису блоку товарів для імпорту.
    <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>
    Це елемент на позначення кінцевої категорії товару. Тут обов'язково потрібно вказати:

    <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>
    Вкажіть повну назву товару українською мовою, аналогічно до того, як ви вносили назву російською.
    Наприклад: <name lang="ua">Поліроль для фар CarBi BN1234 100мл</name>
    Тип даних: string
    <attribute_set code="3343">Картины по номерам</attribute_set>
    Тут вкажіть код набору атрибутів та його назву.

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

    <param lang="ua" paramcode="767" name="Комплектация"><![CDATA[Холст на підрамнику, пензлі, фарби.]]></param>
    Текстові характеристики (наприклад опис, комплектація) мають бути вказані двома мовами та закриті в CDATA.
    Тип даних: string

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


      <param paramcode="3176" name="Тематика" valuecode="bsz6btxa,wle9vq5zsirz1dni">животные,коты</param>
      Якщо вам потрібно додати характеристику типу multiselect (кілька значень), коди значень цих характеристик (valuecode) та їх назви потрібно вказувати через кому.


        <param paramcode="width" name="Ширина"><![CDATA[100]]></param>
        Цифрові характеристики (ширина, довжина, висота, глибина, вага) вносяться за аналогією до текстових (але цифрами без букв), у мм та г відповідно, закриваючись в CDATA.
        Тип даних: float


        </offer>
        Цей елемент означає кінець опису блоку однієї товарної позиції. Використовуйте його для розмежування товарів у шаблоні.
        </offers>
        Цей елемент означає завершення опису блоку товарів, що імпортуються. Використовуйте його після того, як внесете всі товари до шаблону.
        </yml_catalog>
        Цей елемент використовується на позначення завершення опису файлів імпорту. Вкажіть його останнім у шаблоні.
        Типи атрибутів та їх значення:

        • Text - характеристика має бути внесена у вільній текстовій формі. Мінімальна кількість символів 1, максимальна - 12160.

        • String - характеристика має бути внесена у вільній текстовій формі. Мінімальна кількість символів - 1, максимальна - 256.

        • Float - характеристика має бути внесена цифрами без букв (дробові числа). Є можливість вказати від'ємне число. Мінімальна кількість символів: -9999999, максимальна: 9999999

        • Int - характеристика має бути внесена цифрами без букв (цілі числа). Є можливість вказати від'ємне число. Мінімальна кількість символів: -9999999, максимальна: 9999999

        • Select - з наведеного переліку характеристик можна обрати лише одне значення.

        • Multiselect - з наведеного переліку характеристик можна обрати кілька значень.
        Після внесення товарів до шаблону збережіть зміни у файлі та завантажте його до розділу "Імпорт" особистого кабінету. У способі імпорту вкажіть "Файл", оберіть опцію "Оновити все" та натисніть кнопку "Імпортувати".
        Якщо у вас виникли труднощі із завантаженням товарів або додаткові питання, будь ласка, зверніться до служби підтримки: support@epicentrm.com.ua
        Бажаємо вам успіхів у продажах!