Інструкція з налаштування інтеграції з Rozetka

На маркетплейсі у якості продавця можуть реєструватися ФОП II–III групи, юридичні особи або фізичні особи; для ФОП і юросіб потрібна довідка з банку про рахунок IBAN, для фізособи — паспорт, РНОКПП і банківські реквізити. 

4. Як зареєструвати магазин на Rozetka

Для заповнення та надсилання заявки в електронному вигляді необхідно перейти в розділ «Продавати на розетці» та натиснути на кнопку «Заповнити заявку».

Якщо ви користуєтеся програмою Торгсофт, то при заповненні заявки в полі «Чи готові ви створити/надати XML вивантаження в форматі YML» можна поставити «ТАК».

Поле «Посилання на прайс» залиште порожнім. Посилання на прайс-лист у вигляді XML файлу буде створено у Торгсофт  пізніше.

4.1. Чому на початку можна не вказувати посилання на XML файл

Після розгляду заявки, менеджери Rozetka зв'яжуться з вами для уточнення деталей. На етапі узгодження умов договору необхідно повідомити менеджеру Rozetka, що ви плануєте використовувати API для формування XML файлу, який відповідає вимогам Rozetka. 

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

Для роботи з API «Розетки» потрібен логін та пароль для доступу в Особистий кабінет. Логін та пароль видають менеджери сервісу в момент підписання договору про співпрацю, після виконання підготовчих процедур. Рішення про співпрацю «Розетка» приймає індивідуально з кожним клієнтом.

4.2. Запит доступу до Особистого кабінету підприємця на Rozetka

Запитайте у менеджера логін та пароль від Особистого кабінету, щоб сформувати прайс-лист з використанням API та надати менеджеру Rozetka посилання ваш XML файл для модерації та успішного підписання договору.

4.3. Чому важливо отримати доступ до Особистого кабінету на Rozetka

Програма для маркетплейса Торгсофт допоможе підготувати XML файл (прайс-лист) в правильному форматі відповідно до вимог до XML файлу Rozetka. 

За допомогою режиму Торгсофт «Майстер налаштування маркетплейса Rozetka» ви створите необхідний XML файл. Для цього режиму потрібні персональні дані від Особистого кабінету Rozetka, щоб за допомогою API підтягнути потрібні дані:

Таким чином ви значно заощадите час, якщо ці параметри підтягнуться автоматично в Торгсофт. Їх не доведеться власноруч шукати на сервісі, вручну прописувати категорії, характеристики по кожному товару та виробників.

Для вашого магазину менеджер Rozetka може висунути вимоги щодо кількості унікальних позицій товару в прайс-листі, який потрібно надати для модерації. Вимоги до кількості унікальних позицій товару індивідуальні для кожного потенційного продавця сервісу Rozetka та залежать від специфіки магазину й асортименту товарів. І для тих, кому встановлена кількість унікальних товарів буде занадто велика - потрібні дані від Особистого кабінету для підготовки XML файлу, тому що кількість унікальних товарів в прайс-листі для модерації можуть дорівнювати числу всіх товарів, які доведеться спочатку опублікувати на Rozetka.

Якщо ви отримали доступ до Особистого кабінету, то перелік доступних характеристик можна отримати в розділі  «Управління товарами» або за допомогою завантаження через режим «Майстер налаштування маркетплейс Rozetka» у Торгсофт.

Якщо доступу до Особистого кабінету немає, то характеристики доведеться шукати серед подібних товарів на сайті Rozetka.

5. Як підготувати прайс-лист для Rozetka

Як підготувати посилання на прайс-лист (XML файл) :

5.1. Налаштування об'єкту синхронізації в Торгсофт

Налаштування об'єкту синхронізації - найперше налаштування з необхідними параметрами для успішного сполучення з Rozetka.

Після активації додаткової функції «Інтеграція з Rozetka» необхідно:

Вкладка «Загальне»

На формі «Об'єкт синхронізації» є вкладка «Загальне» з полями, які частково потрібно заповнити:

На вкладці «Центри обліку» встановіть галочку навпроти центрів обліку з яких будуть синхронізуватися товари в Rozetka. Додаткові поля вкладки «Центри обліку»:

На вкладці «Час синхронізації» вкажіть час автоматичної синхронізації програми Торгсофт та Rozetka.

Для створення нового завдання автоматичної синхронізації натисніть «Додати». У вікні «Час синхронізації» оберіть спочатку параметр - виконавця автоматичної синхронізації - сервер додатків чи програму Торгсофт. Сервер додатків - це додатковий компонент програми Торгсфот, який відповідає за виконання автоматичних завдань.

Також на вкладці «Час синхронізації» можна задати період синхронізації. При натисканні на кнопку «Створити інтервал синхронізації» з'явитися вікно, де також необхідно заповнити поля «Час початку», «Інтервал» та «Час закінчення» й натиснути «Зберегти».

Після налаштування режиму «Майстер налаштування маркетплейс Rozetka» на вкладці «Файли синхронізації» відображатимуться автоматично створені динамічні характеристики. Ці значення у Торгсофт присвоюються полям Rozetka згідно з вимогами до xml файлу. Динамічні характеристики та їх значення будуть наповнювати XML файл (прайс-лист) - TSGoods.xml, який автоматично створюється програмою Торгсофт.

За замовчуванням ця форма містить 6 полів, які будуть доповнюватися новими параметрами по мірі заповнення характеристик товарів. Якщо ви випадково видалили одну або кілька записів за замовчуванням - скористайтеся кнопкою «Додати всі поля в файл синхронізації».

Можна синхронізувати з Rozetka будь-яке доступне поле картки товару або будь-яку динамічну характеристику. Важливо виконувати ці дії у режимі «Майстер налаштування маркетплейс Rozetka». Для ручного додавання нового поля синхронізації натисніть «Додати». У вікні «Поле файлу синхронізації товарів» оберіть «Тип даних» та вкажіть значення поля «Назва колонки».

У разі вибору в поле «Тип даних» значення «Динамічна характеристика» крім поля «Назва колонки» оберіть найменування цієї характеристики у полі «Динамічна характеристика товару».

5.2. Формування прайс-листа для Розетки у Торгсофт

Майстер налаштування маркетплейс Rozetka» допоможе підготувати, заповнити та створити XML файл. Попри те, що сервіс Rozetka за інформацією з розділу Підготовка прайс-листа товарів не співпрацює зі сторонніми ресурсами, які пропонують послуги підготовки прайс-листа, Торгсофт підготує та створить прайс-лист згідно з вимогами до XML файлу.

Крім вимог до структури XML-файлу, які дотримані в Торгсофт, товари в прайс-листі також повинні відповідати вимогам до оформлення карток товарів:

Всі параметри товару: назва, опис, виробник, ціна, наявність, характеристики та фотографії повинні строго відповідати критеріям «Розетки». Інакше XML файл не пройде перевірку.

Навіть після підписання договору з «Розеткою», затвердження прайс-листа та першої синхронізації з маркетплейсом, картка товару повинна відповідати вимогам «Розетки». В іншому випадку «проблемні» позиції будуть приховані на сайті. Тому дотримуйтесь вимог (крім роботи з XML-тегами, тому що це враховано в Торгсофт при створенні XML файлу).

Перед створенням прайс-листа за допомогою Торгсофт визначте правильні кінцеві категорії на Rozetka, в яких ви плануєте опублікувати товари. Як це правильно зробити описано в довідковому центрі маркетплейс Rozetka в розділі Вибір правильних категорій.

Заповнення товарів та створення XML-файлу (прайс-листа) відбувається в «Майстрі налаштування маркетплейса Rozetka» в Торгсофт. Для роботи з режимом «Майстер настройки маркетплейса Rozetka» зайдіть у пункт меню «Склад» та виберіть форму «Синхронізація з інтернет-магазином». Натисніть на «Майстер налаштування маркетплейс Rozetka» (іконка з зображенням логотипу «Розетки»).

Ознайомимося з формою «Майстер налаштування маркетплейс Rozetka» докладніше.

Зберегти базу даних Rozetka - дія доступна, якщо у вас є доступ до Особистого кабінету в Rozetka та в налаштуваннях об'єкту синхронізації заповнені поля «Ім'я користувача» та «Пароль». Ця дія зберігає базу даних Rozetka в базу даних Торгсофт, а саме інформацію про:

Процес завантаження інформації з «Розетки» в Торгсофт тривалий, тому завантажуйте базу даних лише після появи істотних змін у Rozetka.

Перестворити поля файлу синхронізації - дія заново створює необхідні поля для вивантаження на Rozetka згідно із заповненими характеристиками категорій. Актуально в тому випадку, якщо у налаштуваннях об'єкта синхронізації на вкладці «Файли синхронізації» видалено вручну поле, яке автоматично створюється при заповненні характеристики категорії товару.

Провести аналіз файлу синхронізації - дія проводить аналіз прайс-листа на заповнення полів «Назва», «Виробник», «Категорія», «Ціна» та «Ціна зі знижкою».

Змінити налаштування об'єкта синхронізації - дія викликає форму «Об'єкт синхронізації» для зміни налаштування синхронізації.

Вкладка Робота з товарами призначена для роботи з видами товару; заповнення категорії, назви, виробника, опису та характеристик товарів, що експортуються.

Вкладка Аналіз файлу синхронізації зображає помилки після аналізу прайс-листа, які потрібно виправити.

5.3. Як описати товари для Розетки

Крок 1. Фотографії товару

Наявність фотографій до товарів - перша й обов'язкова умова, аби приступити до заповнення інформації про товар для вивантаження на маркетплейс Rozetka. Згідно з вимогами до фотографій товару, картка товару повинна містити хоча б одну фотографію, максимум - 15.

Крок 2. Налаштування видів товарів 

Крок 3. Вибір та налаштування Товарної групи

В налаштуваннях об'єкту синхронізації оберіть Товарну групу, товари якої потрібно вивантажити. Якщо необхідно вивантажити абсолютно усі товари з Торгсофт - Товарну групу не обирайте.

Для створення Товарної групи для Rozetka використовуйте лише такі вкладки:

Нюанс: вкладки «Виробник», «Сезон», «Постачальник» та «Плюс товари (послуги)» для включення товарів, які не належать обраного виду товару - ніяк не вплинуть на товарну групу для маркетплейса Rozetka.

У нашому прикладі у Товарній групі, яку ми експортуємо в маркетплейс - вид товару «Взуття».

Крок 4. Зв'язування категорій з Rozetka

Далі кожен вид товару потрібно зв'язати з кінцевою категорією на «Розетці». Виконати це можна двома способами: «Зв'язати вид товару з категорією товару Rozetka» або «Зв'язати вид товару та всі підлеглі види товару з категорією товару Rozetka».

Якщо немає доступу до Особистого кабінету Rozetka

Після отримання доступу до API та дії «Зберегти базу даних Rozetka» на головній формі майстра налаштування, створені вручну категорії автоматично поміняються на категорії «Розетки», якщо вони існують.

Якщо є доступ до Особистого кабінету Rozetka

За наявності доступу до API та успішно виконаної дії «Зберегти базу даних Rozetka», в Торгсофт з'явиться довідник категорій Rozetka. Вам залишиться лише обрати кінцеву категорію «Розетки», в якій буде опубліковано товар.

Після зв'язування кожної категорії Rozetka з кожним видом товару в Торгсофт отримаємо наступне:

Якщо ви помилися та прив'язали некоректну категорію - скористайтеся однією з двох дій: «Від'єднання виду товару з категорією товару Rozetka» або «Від'єднання виду товару та всіх підпорядкованих видів товару з категорією товару Rozetka». Після - прив'яжіть правильну категорію.

Крок 5. Масовий вибір Виробника товару

Товарам певного виду товару, його підвидам можна масово призначити загального Виробника за допомогою дій «Встановити виробника для всіх товарів виду товару» або «Встановити виробника для всіх товарів виду товару включаючи підлеглі види товару».

За наявності доступу до API та успішно виконаній дії «Зберегти базу даних Rozetka» поле Виробник можна масово заповнити наявним Виробником з «Розетки».

Крок 6. Заповнення інформації про товари для Rozetka

Після прив'язки кожного виду товару до категорії на Rozetka переходимо до заповнення даних про товар у формі «Товари, які беруть участь в синхронізації».

Поля в формі «Товари, які беруть участь в синхронізації»:

У формі «Товари, які беруть участь в синхронізації» ви також зможете:

Крок 7. Заповнення додаткових характеристик товару для маркетплейса

Робоча область майстра налаштування - «Параметри категорії».
Ця форма призначена для заповнення відмінних властивостей та ознак товару для експорту. 

За наявності доступу до API після зв'язування виду товару з категорією Rozetka таблиця «Параметри категорії» заповниться автоматично усіма доступними характеристиками категорії «Розетки». Автоматичне заповнення можливе лише у тому випадку, якщо в формі «Товари, які беруть участь в синхронізації» будуть товари.

Неповний приклад переліку характеристик категорії «Принтери етикеток» на Rozetka, які підтягнулися у програму Торгсофт автоматично за допомогою API:

При наведенні курсору миші на «знак питання» у правій частині з'явиться підказка, як заповнювати потрібний параметр категорії.

Без доступу до API таблиця «Параметри категорії» буде порожня й всі найменування характеристик доведеться заповнювати вручну, попередньо підшукавши параметри в одному або в декількох товарах на «Розетка» у відповідній категорії.

Крок 8. Робота з базовими характеристиками товару для «Розетки»

У Rozetka є основні характеристики, які беруть участь в фільтрі пошуку товару. Якщо не заповнити базові характеристики товару, то користувач під час пошуку за допомогою фільтрів маркетплейсу не знайде ваш товар на «Розетці». Мінімальна кількість характеристик для товару — 3. Характеристики мають відповідати фото, опису й назві, а логістичні параметри бажано заповнювати для коректного розрахунку доставки. 

За наявності доступу до API базові характеристики у таблиці «Параметри категорії» підсвічені червоним кольором.

Без доступу до API основні характеристики доведеться знайти самостійно у маркетплейсі, створити їх власноруч у формі «Параметри категорії» та заповнити значеннями.

Для створення параметра базової характеристики без доступу до API у формі «Параметри категорії» потрібно зробити одне з двох:

Назва параметра категорії має бути ідентичною назві чинної характеристики на Rozetka. Створені вами характеристики у Торгсофт будуть пов'язані з чинними на «Розетка». Якщо характеристики товару на «Розетка» немає - її потрібно додати у текстовий опис до товару. Ви не можете створити свою унікальну характеристику на «Розетка», якщо вона не передбачена на сервісі.

Крок 9. Заповнення однакових характеристик для всіх товарів категорії

Характеристики товарів можуть повторюватися. Якщо потрібно заповнити однаковим значенням характеристики всіх товарів категорії, то при наявності доступу до API та без доступу до API скористайтеся наступними діями області «Параметри категорії».

Крок 10. Опис товару

Робоча область майстра налаштування - «Опис товару».
Після заповнення характеристик, єдине, що нам залишилося заповнити по кожному товару - його опис згідно вимогами до опису товару. В області «Опис товару» доступні стандартні компоненти для редагування HTML тексту.

Крок 11. Аналіз файлу синхронізації

Після того, як ви заповнили всі параметри, поля та необхідну інформацію про товар у Торгсофт для Rozetka, потрібно «Провести аналіз файлу синхронізації».

Програма Торгсофт відкриє вкладку «Аналіз файлу синхронізації», проведе аналіз прайс-листа та сповістить, якщо:

За наявності зауважень необхідно обов'язково їх виправити, щоб потім XML файл пройшов модерацію на маркетплейсі. З форми «Аналіз файлу синхронізації» можна одразу «перейти до товару» із зауваженням та виправити помилки.

Якщо у «Майстрі налаштування маркетплейс Rozetka» заповнена вся інформація та «Аналіз файлу синхронізації» не містить ніяких помилок - приступаємо до вивантаження XML файлу (прайс-листа) на FTP-сервер, створення публічного посилання та передачі посилання на прайс-лист менеджеру Rozetka для модерації файлу.

5.4. Створення посилання на прайс-лист для Rozetka

Щоб передати посилання на XML файл, його необхідно завантажити на FTP-сервер, який ви вказали в налаштуваннях об'єкту синхронізації. На FTP-сервер будуть вивантажені фотографії всіх товарів, які включені в прайс-лист.
Спочатку експортуйте дані вручну в формі «Синхронізація з інтернет-магазином» у Торгсофт. Автоматичну синхронізацію бажано провести вже після того, як посилання на XML файл буде у менеджера та прайс-лист пройде успішну модерацію на «Розетці».

Аби виконати синхронізацію вручну, зайдіть у Торгсофт на форму «Синхронізація з інтернет-магазином» та натисніть «Відмітити всі фото». Ця дія відмітить всі фотографії товарів для експорту з прайс-листом. Після - натисніть «Провести синхронізацію».

Дія «Провести синхронізацію» експортує всі фотографії товарів та прайс-лист на вказаний FTP-сервер. Зверніть увагу, що на вкладці «Товари синхронізації» список товарів може відрізнятися від того, який буде експортовано на Rozetka. Це може бути пов'язано з тим, що у майстрі налаштувань доступні товари лише з фото та відсутні товари, додані в товарну групу через вкладку «Плюс товари та послуги».
Вкладка «Журнал синхронізації» відобразить дані про успішну синхронізацію.

Після успішного експорту даних, перевірте доступ до XML файлу за посиланням. Для цього у браузері за посиланням https: //мійсайт.ua/каталог/rozetka/TSGoods.xml повинна відобразитися інформація з товарами з XML-файлу.

Перед тим, як передати менеджеру посилання до прайс-листа для модерації, проведіть валідацію XML-файлу за допомогою спеціального інструменту маркетплейс Rozetka. Після інформації про успішну перевірку, зателефонуйте менеджеру Rozetka та надайте посилання на ваш прайс-лист.

6. Додавання та продаж товарів на Rozetka

Після підписання договору з «Розеткою» може знадобитися додавання нових товарів або оновлення параметрів чинних товарів на Rozetka. Все це робіть за допомогою режиму «Майстер налаштування маркетплейс Rozetka».

Перегляньте вимоги до додавання нових товарів та вимоги по оновленню теперішніх товарів перед тим, як додати або оновити товари в прайс-листі.

Ми прочитали вимоги та можемо виділити наступне:

Торгсофт автоматично оновлює файл прайс-листа TSGoods.xml з інформацією про ціни та наявність товару на FTP-сервері. Для цього не забудьте налаштувати «Час синхронізації» в Торгсофт в об'єкті синхронізації. Ручна синхронізація потрібна лише при першому експорті прайс-листа та при зміні його змісту: додаванні та оновленні товарів.

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

Роботу із замовленнями та клієнтами бажано вести або тільки в Торгсофт, або тільки на маркетплейсі Rozetka для підтримки актуальної наявності товарів у програмі та відповідно на «Розетці». Для роботи з замовленнями з Rozetka в Торгсофт використовуйте режим «Торгівля з випискою рахунку». 

Автоматизувати роботу зі службами доставлення допоможе додаткова функція «Інтеграція з Новою поштою» і «Інтеграція з Укрпоштою». У Торгсофт в режимі «Торгівля з випискою рахунку» формуйте і друкуйте ТТН за виписаними рахунками, відстежуйте статус посилки, відправляйте номер ТТН клієнту за допомогою функції «Масові розсилки клієнтам».

7. Обмеження та вимоги по роботі з додатковою функцією «Інтеграція з Rozetka.ua»

До обмежень можна віднести наступні моменти:

До вимог з боку Торгсофт можна віднести лише наявність SQL Server 2008 і вище, на якому буде працювати база даних Торгсофт з встановленим рівнем сумісності у властивостях бази даних в SQL Server 100 і вище.