Імпорт товарів та послуг на сайт компанії та на маркетплейс, а також експорт з сайту та з маркетплейсу може бути виконаний в одному з наступних форматів:
- електронна таблиця Excel, файл у форматі XLS, XLSX або CSV (опис цього формату імпорту/експорту див. нижче);
- файл YML.
Важливо! Імпорт у форматі XLS може працювати нестабільно. Радимо зберігати файл у форматі XLS(X)
Як зробити успішний імпорт?
Покрокові рекомендації для коректного імпорту:
Як виконати експорт?
Про те, як експортувати товари з сайту вашої компанії, див. документ Експорт товарів і груп товарів.
Опис формату імпорту та експорту XLS/XLSX та CSV
Увага!
- Формат файлу імпорту збігається з форматом файлу експорту, не залежить від розширення файлу XLS, XLSX або CSV та описаний нижче.
- Файл імпорту/експорту в форматі XLS, XLSX містить дві вкладки: «Export Products Sheet» (опис самих товарів) та «Export Groups Sheet» (опис структури товарних груп).
- Файл імпорту/експорту в форматі CSV містить тільки одну вкладку.
- Файл імпорту в форматі CSV підтримує кодування utf-8 або utf-16.
- Для успішного імпорту необхідно заповнити всі обов'язкові поля у файлі імпорту, а на вкладці «Export Groups Sheet» потрібно вказати правильну структуру груп компанії.
- Перший рядок таблиці у файлі імпорту завжди повинен містити заголовки полів, зазначені нижче (стовпець «Назва поля» в таблиці).
- Кожен рядок файлу імпорту на вкладці «Export Products Sheet» містить опис тільки однієї товарної позиції або послуги.
- У таблиці повинні бути заповнені всі обов'язкові поля ( «Назва_позіції», «Опис», «Ідентіфікатор_товара», «Унікальний_ідентифікатор» (для вже доданих раніше товарів)).
- Якщо у файлі імпорту не буде заповнено Назва_укр та Опис_укр, переклади товарів не оновляться. Якщо переклад є, ви можете обрати, чи оновлювати його. Якщо встановити прапорець "Переклади" ― буде оновлено всі переклади у файлі. Якщо прибрати прапорець, жоден переклад не оновиться.
Товари та послуги: вкладка «Export Products Sheet»
Назва поля | Формат даних | Опис значення |
---|---|---|
Код_товару | рядок до 25 символів | Код товару (артикул) необхідний для швидкого та зручного пошуку потрібної позиції на сайті компанії та в особистому кабінеті при телефонному зверненні клієнта. Довжина артикулу - 25 символів (цифри, кирилиця, латиниця, знаки «-», «_», «.», «/» та пробіл). |
Назва_позиції | рядок до 110 символів | Найменування товару або послуги російською мовою. |
Назва_позиції_укр | рядок до 130 символів |
Найменування товару або послуги українською мовою. |
Пошукові_запити | рядок до 1024 символів |
Пошукові запити використовуються для пошуку у каталозі маркетплейсу. Містить пошукові запити для позиції російською мовою, перераховані через кому (не більше 1024 символів). Довжина кожного слова не більш 50 символів. |
Пошукові_запити_укр | рядок до 1024 символів |
Пошукові запити використовуються для пошуку в каталозі маркетплейсу. Містить пошукові запити для позиції українською мовою, перераховані через кому (не більше 1024 символів). Довжина кожного слова не більш 50 символів. |
Опис | рядок до 12160 символів |
Опис даного товару або послуги російською мовою. |
Опис_укр | рядок до 12160 символів |
Опис даного товару або послуги українською мовою. |
Тип_товару | рядок | Поле визначає приналежність товару до оптових, роздрібних або послуг. Для правильного визначення рекомендується ставити назву категорії та належність товару. r ― товар продається тільки в роздріб w ― товар продається тільки оптом u ― товар продається оптом і в роздріб s ― послуга |
Ціна | число від 0.01 до 9999999999 | Ціна товару або послуги |
Ціна_від | рядок |
Поле визначає встановлена для товару "ціна від". Приймає одне з двох значень:
|
Валюта | рядок | Валюта, грошова одиниця ціни UAH | USD | EUR | CHF | GBP | JPY | PLZ | інша | BYN | KZT | MDL | р | дол | $ | грн |
Одиниця_виміру | рядок | шт. | упаковка | комплект | пара | м | пог.м | кг | набір | рулон | пач | моток | кв.м | од. | 100 г | л | бобіна | лист | г |
Мінімальний_обсяг_замовлення | число | Мінімальний обсяг замовлення |
Оптова_ціна | число | Оптові ціни, розділені символом "крапка з комою" ― ';' |
Мінімальне_замовлення_опт | число | Мінімальний обсяг замовлення відповідний оптовими цінами, також розділений ';' |
Кількість | число | Використовується для зазначення залишку товарів. |
Посилання_зображення | рядок |
Посилання на зображення в інтернеті (URL). Посилань може бути декілька. Розділяти необхідно комою з пробілом (приклад: http://example.com/box.gif, http://example.com/box-foto2.gif) Зверніть увагу: можна імпортувати зображення з Google Диска. Для цього потрібно дати доступ до файлу зображення адресою import@uaprom-prod-1495098375216.iam.gserviceaccount.com. |
Вага,кг | число |
Вага товару |
Ширина,см | число |
Габарити товару: ширина |
Висота,см | число |
Габарити товару: висота |
Довжина,см | число |
Габарити товару: довжина |
Наявність | рядок |
Наявність товару, готового до відправки: "-" — немає в наявності "!" — товар в наявності «Готово до відправки». Доступно лише для компаній з високими показниками якості обслуговування клієнтів. Детальніше цифра, наприклад, "9" — к-ть днів на доставку, якщо товар під замовлення |
Знижка | Позитивне число або число з % | Якщо у товара є знижка, в даному полі вказується величина знижки або відсоток. Приклад: 12.5, 30%. |
Термін_дії_знижки_від |
дата | Дата початку дії знижки. |
Термін_дії_знижки_до | дата | Дата закінчення дії знижки. |
Ярлик | рядок | Рядок ярлика товару. Якщо у файлі заповнений стовбчик «Ярлик», то його значення буде завжди оновлюватися, навіть якщо налаштування «Оновити примусово" не виставлено. |
Виробник | рядок до 255 символів |
Бренд, торгова марка або назва підприємства-виробника, під знаком якого виготовлений товар (можливо значення «Власне виробництво»). Назва виробника імпортується в описі характеристик товару, поле «Виробник». Увага! Зазначений вами виробник буде імпортований, якщо він є в базі виробників маркетплейсу. Перевірити наявність виробника або додати нового виробника можна при додаванні/редагуванні товару. |
Країна_виробник | рядок до 255 символів | Імпортується до опису характеристик товару, поле «Країна виробник». |
HTML_заголовок | рядок до 250 символів |
HTML-заголовок SEO-налаштувань товару російською мовою Група SEO-налаштувань товару доступна, якщо включено додаток «SEO-настройки». При імпорті значення SEO-налаштувань товару оновлюються, тільки якщо поля заповнені. Якщо при імпорті поля порожні, то значення SEO-налаштувань товару не оновлюються. При експорті ці поля вивантажуються, тільки якщо вказано призначені для користувача налаштування. При налаштуваннях за замовчуванням поля будуть порожніми. Якщо всі SEO-поля задані та відповідають вимогам, тоді автоматично буде встановлено налаштування «Використовувати власні налаштування». Якщо всі поля не відповідають вимогам або не задані, встановлюється налаштування «Значення за замовчуванням за шаблонами». |
HTML_заголовок_укр | рядок до 270 символів |
HTML-заголовок SEO-налаштувань товару українською мовою. Група SEO-налаштувань товару доступна, якщо включено додаток «SEO-налаштування». При імпорті значення SEO-налаштувань товару оновлюються, тільки якщо поля заповнені. Якщо при імпорті поля порожні, то значення SEO-налаштувань товару не оновлюються. При експорті ці поля вивантажуються, тільки якщо вказано призначені для користувача налаштування. При налаштуваннях за замовчуванням поля будуть порожніми. Якщо всі SEO-поля задані і відповідають вимогам, тоді автоматично буде встановлено налаштування «Використовувати власні налаштування». Якщо всі поля не відповідають вимогам або не задані, встановлюється налаштування «Значення за замовчуванням за шаблонами». |
HTML_опис | рядок до 250 символів | HTML-опис SEO-налаштувань товару російською мовою |
HTML_опис_укр | рядок до 270 символів | HTML-опис SEO-налаштувань товару українською мовою. |
Подарунки | рядок | Номери рядків або ID товару в поточному файлі тих товарів, які є подарунками. Номери вказуються через крапку з комою (наприклад: 3;4). Можуть вказуватися не тільки для основного товару, але і для різновидів. Важливо! Різновид не може бути подарунком. |
Супутні | рядок |
Номери рядків в поточному файлі тих товарів, які є супутніми. Номери вказуються через крапку з комою (наприклад: 3;4). Можуть вказуватися не тільки для основного товару, але і для різновидів. Важливо! Різновид не може бути супутнім. |
ID_Подарунків | рядок |
ID товарів, які є подарунками. Номери вказуються через крапку з комою (наприклад, 1095011184; 655298076). Якщо при експорті встановлено налаштування «Експортувати подарунки», то пріоритетним є це поле. Якщо в цьому полі значення не вказано, подарунки беруться з поля «Подарунки» за номером рядка в файлі. Можуть вказуватися не тільки для основного товару, але і для різновидів. |
ID_Супутніх | рядок |
ID товарів, які є супутніми. Номери вказуються через крапку з комою (наприклад, 1095011184; 655298076). Якщо при експорті встановлено налаштування «Експортувати супутні», то пріоритетним є це поле. Якщо в цьому полі значення не вказано, супутні беруться з поля «Супутні» за номером рядка в файлі. Можуть вказуватися не тільки для основного товару, але і для різновидів. |
Номер_групи | число |
Дозволяє розміщувати товар в конкретну групу у вас на сайті. Номер групи можна знайти за посиланням на групу http://example.com/g123456-test_group |
Назва_групи | рядок до 100 символів | Назва групи товарів/послуг. Дане поле не імпортується при завантаженні файлу на сайт компанії. |
Посилання_підрозділу | рядок | Адреса підрозділу каталогу. Наприклад, для розділу «Ноутбуки»: http://prom.ua/Noutbuki. Для зручності ви можете скористатися пошуком або рубрикатором і вибрати кінцевий розділ товару. Список категорій |
Спосіб_пакування | рядок до 500 символів | Спосіб упаковки товару |
Особисті_нотатки | рядок | Особисті нотатки через кому |
Продукт_на_сайті | рядок |
Адреса продукту на сайті компанії. Дане поле не імпортується при завантаженні файлу на сайт компанії. |
Код_маркування_(GTIN) | рядок | Міжнародний код маркування та обліку логістичних одиниць (GTIN) для фіда Google Merchant Center |
Номер_пристрою_(MPN) | рядок | Унікальний (каталожний) номер пристрою (MPN) для фіда Google Merchant Center |
Ідентифікатор_товару | рядок до 255 символів | Ідентифікатор необхідний для однозначного зіставлення товару в файлі імпорту з цим-же товаром на сайті компанії. Може містити символи та числа. Обов'язкове поле. |
Унікальний_ідентифікатор | Позитивне число | Унікальний ідентифікатор товару - службова інформація, яка використовується для ідентифікації товару або послуги виключно на нашому маркетплейсі. Даний ідентифікатор заповнюється автоматично при експорті та не повинен змінюватися вручну. Значення унікального ідентифікатора - число, яке можна знайти на посиланні на товар на маркетплейсі або на сайті компанії. |
Ідентифікатор_підрозділу | рядок | Технічна інформація про ідентифікатор підрозділу. Не рекомендується міняти цей параметр ніколи. Цей параметр заповнюється автоматично при експорті даних з нашої системи. Список категорій |
Ідентифікатор_групи | рядок | Технічна інформація про ідентифікатор групи товарів у вашій системі. Вказує на категорію товару/послуги на зовнішньому сайті вашої компанії або в іншій системі. Використовується в системі імпорту з XML та YML файлів. Це поле буде використовуватися під час вивантаження даних з каталогу маркетплейсу та імпорті назад у вашу систему. |
ID_групи_різновидів | число повинно бути від 0 до 999999999 | «ID_групи_різновідів» - це ідентифікатор різновиду товару, тобто унікальний номер, який використовується для маркування товарів з різновидами. Всі товари з одним і тим же номером «ID_групи_різновидів» та заповненими полями «Назва_Характеристики» та «Значення_Характеристики» вважаються різновидами товарів. Перший товар в списку - основний. Створювати різновиди необхідно на основі заповнених характеристик основного товару. І на основі заповнених характеристик основного товару будуються різновиди. Так як основний товар є одним із різновидів і у нього повинні бути заповнені поля «Назва_Характеристики» та «Значення_Характеристики». Значення характеристик, на яких побудовані різновиди, повинні бути унікальними для кожного різновиду та основного товару. Детальніше про імпорт різновидів |
Де_знаходиться_товар | Рядок або число |
Населений пункт, в якому знаходяться товари та звідки їх відправлять покупцю. Можна вказати до 3-х населених пунктів для одного товара. Розділяйте їх символом "крапка з комою" ― ';'. Можна вказати лише населені пункти з переліку за їх назвою чи ID. Перелік доступних регіонів: |
Назва_Характеристики | рядок |
Назва характеристики товару з категорії, в якій розміщується товар, або назву користувальницької характеристики. Скопіювати точну назву характеристики категорії можна з блоку «Характеристики» на сторінці додавання/редагування товару або перейшовши до відповідної категорії. Приклад назви характеристики для товару з категорії «Крісла для керівників»: Щоб додати кілька характеристик, скопіюйте цей стовпець разом зі стовпцями «Одиниця_виміру_Характеристики» та «Значення_Характеристики» кілька разів. Порядок зазначення характеристик не має значення (характеристики можуть йти вперемішку з користувацькими характеристиками). Увага! У файлі імпорту стовпці опису кожної окремої характеристики повинні завжди бути в такому порядку: «Назва_Характеристики», «Одиниця_виміру_Характеристики», «Значення_Характеристики». Примітка: Описаний в цій інструкції формат імпорту характеристик є третьою за рахунком версією. На маркетплейсі підтримується зворотна сумісність форматів імпорту - характеристики, описані у файлі імпорту в одному з попередніх форматів, будуть успішно імпортовані. Однак експорт характеристик завжди виконується в новому, описаному тут форматі. Рекомендуємо вам завжди описувати характеристики в файлі імпорту відповідно до цих інструкцій. |
Одиниця_виміру_Характеристики | рядок |
Одиниця виміру характеристики для обраної категорії товару, або одиниця виміру користувальницької характеристики. Скопіювати точну назву одиниці виміру характеристики категорії можна з блоку «Характеристики» на сторінці додавання/редагування товару або перейшовши до відповідної категорії на маркетплейсі. Для користувальницьких характеристик рекомендуємо вказувати стандартні одиниці виміру. Приклад назви одиниці вимірювання для товару з категорії «Крісла для керівників»: шт. Щоб додати кілька характеристик, скопіюйте цей стовпець разом зі стовпцями кілька разів. Порядок зазначення характеристик не має значення (характеристики категорії можуть йти вперемішку з користувацькими характеристиками). Увага! У файлі імпорту стовпці опису кожної окремої характеристики повинні завжди бути в такому порядку: «Назва_Характеристики», «Одиниця_виміру_Характеристики», «Значення_Характеристики». Навіть якщо стовпець «Одиниця_виміру_Характеристики» не заповнений, він все одно повинен бути присутнім у файлі імпорту щоб уникнути помилок. Примітка: Описаний в цій інструкції формат імпорту характеристик є третьою за рахунком версією. На маркетплейсі підтримується зворотна сумісність форматів імпорту - характеристики, описані у файлі імпорту в одному з попередніх форматів, будуть успішно імпортовані. Однак експорт характеристик завжди виконується в новому, описаному тут форматі. Рекомендуємо вам завжди описувати характеристики в файлі імпорту відповідно до цих інструкцій. |
Значення_Характеристики | рядок |
Значення характеристики для обраної категорії товару або значення користувальницької характеристики. Значення характеристик може бути простим або множинним. Приклад множинного значення характеристики «Матеріал корпусу»: Алюміній, Пластмаса; для характеристики «Стандарт зв'язку»: GSM, CDMA, EDGE. Значення множинних характеристик у файлі імпорту поділяються символом «|». Приклад: «Алюміній | Пластмаса» або «GSM | CDMA | EDGE» (лапки в файлі імпорту не потрібні). Щоб додати кілька характеристик, скопіюйте цей стовпець разом зі стовпцями «Назва_Характеристики» і «Вимірювання_Характеристики» кілька разів. Порядок зазначення характеристик не має значення (характеристики категорії можуть йти вперемішку з користувацькими характеристиками). Увага! У файлі імпорту стовпці опису кожної окремої характеристики повинні завжди бути в такому порядку: «Назва_Характеристики», «Одиниця_виміру_Характеристики», «Значення_Характеристики». Примітка: Описаний в цій інструкції формат імпорту характеристик є третьою за рахунком версією. На маркетплейсі підтримується зворотна сумісність форматів імпорту - характеристики, описані у файлі імпорту в одному з попередніх форматів, будуть успішно імпортовані. Однак експорт характеристик завжди виконується в новому, описаному тут форматі. Рекомендуємо вам завжди описувати характеристики в файлі імпорту відповідно до цих інструкцій. |
Зверніть увагу: блоків характеристик («Назва_Характеристики», «Одиниця_виміру_Характеристики», «Значення_Характеристики») може бути кілька, під кожну характеристику товару. Порядок блоків не важливий. Рекомендуємо розміщувати блоки характеристик в останніх стовбцях файлу.
Групи: вкладка «Export Groups Sheet»
Назва поля | Формат даних | Опис значення |
---|---|---|
Номер_групи | Число | Номер групи товарів/послуг на сайті компанії. Номер групи можно знайти за посиланням на группу: http://example.com/g123456-test_group |
Назва_групи | рядок до 100 символів | Назва групи товарів/послуг російською мовою. |
Назва_групи_укр | рядок до 100 символів | Назва групи товарів/послуг українською мовою. |
Ідентифікатор_групи | Число | Зовнішній ідентифікатор групи товарів/послуг (наприклад, номер групи товарів в 1С). |
Номер_батьківської_групи | Число | Номер батьківської групи, в яку входить дана група товарів / послуг. Якщо батьківської для даної групи є коренева група, це поле повинно бути порожнім. |
Ідентифікатор_батьківської_групи | Число | Зовнішній ідентифікатор батьківської групи, в яку входить дана група товарів/послуг. Якщо батьківської для даної групи є коренева група, це поле повинно бути порожнім. |
Посилання_зображення_групи | Посилання на зображення в інтернеті (URL). Наприклад: http://example.com/box.jpg | |
HTML_заголовок_групи | рядок до 250 символів |
HTML-заголовок для SEO-налаштувань групи російською мовою Група SEO-налаштувань групи доступна, якщо включено додаток «SEO-настройки». При імпорті значення SEO-налаштувань групи оновлюються, тільки якщо поля заповнені. Якщо при імпорті поля порожні, то значення SEO-налаштувань групи не оновлюється. При експорті ці поля вивантажуються, тільки якщо зазначені для користувача налаштування. При налаштуваннях за замовчуванням поля будуть порожніми. Якщо всі SEO-поля задані і всі відповідають вимогам, тоді автоматично буде встановлено налаштування «Використовувати свої налаштування». Якщо всі поля не відповідають вимогам або не задані, встановлюється налаштування «Значення за замовчуванням за шаблонами». |
HTML_заголовок_групи_укр | рядок до 270 символів |
HTML-заголовок українською мовою для SEO-налаштувань групи Група SEO-налаштувань групи доступна, якщо включено додаток «SEO-настройки». При імпорті значення SEO-налаштувань групи оновлюються, тільки якщо поля заповнені. Якщо при імпорті поля порожні, то значення SEO-налаштувань групи не оновлюється. При експорті ці поля вивантажуються, тільки якщо зазначені для користувача налаштування. При налаштуваннях за замовчуванням поля будуть порожніми. Якщо всі SEO-поля задані і всі відповідають вимогам, тоді автоматично буде встановлене налаштування «Використовувати свої налаштування». Якщо всі поля не відповідають вимогам або не задані, встановлюється налаштування «Значення за замовчуванням за шаблонами». |
HTML_опис_групи | рядок до 250 символів | HTML-опис для SEO-налаштувань групи російською мовою |
HTML_опис_групи_укр | рядок до 270 символів | HTML-опис українською мовою для SEO-налаштувань групи |
Опис_групи_до_списку_товарних_позицій | рядок до 32767 символів | опис російською мовою до списку товарних позицій |
Опис_групи_до_списку_товарних_позицій_укр | рядок до 32767 символів | опис українською мовою до списку товарних позицій |
Опис_групи_після_списку_товарних_позицій | рядок до 32767 символів | опис російською мовою після списку товарних позицій |
Опис_групи_після_списку_товарних_позицій_укр | рядок до 32767 символів | опис українською мовою після списку товарних позицій |