Якщо ви продаєте на Rozetka, ваш каталог уже існує в кабінеті продавця. Не треба вивантажувати його у файл і завантажувати вручну — Elbuz забирає товари напряму через API маркетплейсу за вашим логіном і паролем. Так каталог Rozetka зводиться у ваш базовий каталог Elbuz, де ви керуєте цінами, наявністю й контентом централізовано, а не перемикаючись між кабінетами.
Ця стаття — про підключення саме Rozetka. Загальний порядок для всіх API-джерел описано в огляді імпорту каталогу через API; тут — особливості Rozetka: які дані потрібні для входу, що приходить у каталог і на що звернути увагу. Про завантаження даних загалом дивіться огляд завантаження.
Де це у програмі
У вікні імпорту ви створюєте шаблон і обираєте тип «Rozetka». Це API-джерело: жодного файлу не потрібно, підключення відбувається за ключами доступу до кабінету продавця. Один шаблон — це одне підключення до одного акаунта Rozetka. Якщо у вас кілька магазинів на Rozetka, під кожен заводьте окремий шаблон зі своїми даними входу.
Що потрібно для підключення
Rozetka не використовує окремі токени чи «застосунки розробника» — підключення відбувається за логіном і паролем вашого кабінету продавця, тими самими, якими ви заходите в кабінет Rozetka. У формі шаблону два поля: Логін і Пароль. Elbuz за ними отримує від Rozetka тимчасовий токен доступу й далі працює вже за ним; пароль передається захищеним запитом і зберігається у вашому акаунті Elbuz.
Окремо реєструвати нічого не треба: доступ до API вмикається на боці кабінету продавця Rozetka. Використовуйте логін і пароль, під якими ви входите в кабінет. Якщо вхід у кабінет не працює або доступ до API закрито — це вирішується в підтримці Rozetka, а не в Elbuz.
Як підключити крок за кроком
Порядок простий. Створіть шаблон типу «Rozetka». Введіть логін і пароль кабінету продавця в картці «Підключення». Увімкніть у блоці «Що завантажувати», що саме вам потрібно — товари (каталог), а за потреби й замовлення. Збережіть і запустіть. Перше підключення забирає наявний каталог, наступні запуски оновлюють його — нові товари додаються, ціни й наявність оновлюються.
Радимо перший запуск зробити «на пробу» й перевірити кілька карток очима: чи правильно приїхали назви, ціни, картинки й категорії. Переконались — далі ставте шаблон на розклад, щоб оновлення відбувались самі.
Що потрапляє в каталог
З Rozetka в базовий каталог Elbuz переносяться товари з їхніми назвами, цінами, залишками, категоріями, зображеннями та характеристиками. Характеристики Rozetka віддає окремо по кожному товару, тому для великого каталогу перше завантаження триває довше — програма запитує параметри позиція за позицією. Це нормально: наступні оновлення вже швидші, бо тягнуть переважно ціни й наявність.
Разом із товарами Elbuz бачить і їхній статус на Rozetka: на модерації, відхилено, прийнято, ціна на перевірці. Це зручно — ви одразу помічаєте позиції, які маркетплейс не пропустив, і не шукаєте їх у кабінеті вручну. Що саме брати з каталогу, ви керуєте чекбоксами в шаблоні: можна тягнути все, а можна лишити свій вичищений опис і оновлювати тільки ціни та наявність.
Каталог і замовлення
Те саме підключення Rozetka вміє забирати не лише каталог, а й замовлення, а також супутні дані: повернення, статуси ТТН, фінанси (комісія, баланс), відгуки про магазин і товари. Усе це вмикається окремими перемикачами в шаблоні. Ця стаття — про каталог; якщо вам потрібні саме замовлення, увімкніть відповідний чекбокс, і Rozetka приноситиме нові замовлення у ваші документи. Хочете тільки каталог — лишіть замовлення вимкненими, зайве не завантажуватиметься.
Навіщо зводити каталог Rozetka в Elbuz
Сама по собі Rozetka — це вітрина й кабінет продавця, але не система керування товаром. Коли позицій сотні чи тисячі, а поруч є ще свій сайт та інші майданчики, керувати кожним каналом окремо стає важко: ціни розходяться, наявність запізнюється, опис доводиться правити в кількох місцях. Elbuz забирає каталог Rozetka до себе, і далі ви працюєте з товарами централізовано — в одному каталозі, за єдиними правилами націнок і наявності.
Найбільше це відчутно, коли Rozetka не єдиний ваш канал продажу. Той самий товар може одночасно жити на Rozetka, на вашому сайті й на інших маркетплейсах, а ви редагуєте його в одному місці — в Elbuz — і зміни розходяться туди, куди потрібно. Rozetka в такій схемі стає одним із джерел каталогу, а не окремим «острівцем», який доводиться вести руками.
Оновлення за розкладом
Головна користь підключення через API — живе оновлення без ручної роботи. Коли шаблон налаштовано й перевірено, поставте його на розклад кнопкою налаштування завдання прямо у формі шаблону. Elbuz сам звертатиметься до Rozetka за свіжими даними: ціни й залишки оновлюватимуться, нові товари додаватимуться. Частоту обирайте за потребою — маркетплейси не люблять надто частих звернень, тож для великого каталогу розумніше оновлюватися рідше, ніж щохвилини.
Кожне звернення лишає слід у журналі: скільки товарів оновлено, скільки додано, чи були помилки. Перші кілька разів варто туди зазирати — так ви одразу побачите, якщо, наприклад, змінили пароль у кабінеті Rozetka, а в шаблоні він лишився старим, і оновлення перестали проходити.
Часті труднощі
Найчастіша причина, чому підключення не працює, — логін або пароль. Перевірте, що вони введені без зайвих пробілів і що цим самим логіном ви успішно заходите в кабінет продавця. Якщо ви змінили пароль на Rozetka, його треба оновити й у шаблоні Elbuz — інакше чергове звернення завершиться помилкою авторизації, і це буде видно в журналі.
Друга типова ситуація — товари на модерації. Якщо позиції щойно створені на Rozetka й ще не пройшли перевірку, вони приїдуть зі статусом «на модерації»; це не помилка імпорту, а стан на боці маркетплейсу. Так само не варто лякатися, якщо частина характеристик порожня: програма переносить рівно те, що Rozetka віддає у своєму інтерфейсі, і не вигадує відсутнього. Дозаповнити картки можна вже у своєму каталозі.
Перш ніж ставити шаблон на регулярний розклад, зробіть одне пробне підключення й перевірте на кількох товарах, що каталог тягнеться правильно: назви, ціни, картинки, категорії, статуси. Переконались — тоді вмикайте автоматичне оновлення.
Часті питання
Rozetka видає токен чи ключ — де його взяти?
Не потрібно. На відміну від більшості маркетплейсів, у Rozetka немає окремого токена: підключення відбувається за логіном і паролем кабінету продавця. Elbuz сам отримує від Rozetka тимчасовий токен доступу за цими даними.
Чи безпечно вводити пароль від кабінету?
Пароль потрібен, бо це єдиний спосіб авторизації в API Rozetka. Він передається захищеним запитом і зберігається у вашому акаунті Elbuz. Якщо колись захочете відкликати доступ — просто змініть пароль у кабінеті Rozetka, і старе підключення перестане працювати.
Чому перше завантаження таке довге?
Rozetka віддає характеристики окремо по кожному товару, тож для великого каталогу програма робить багато запитів і перший прохід триває довше. Наступні оновлення швидші, бо тягнуть переважно ціни й наявність.
Що означають статуси товарів (модерація, відхилено)?
Це стан позиції на боці Rozetka, а не помилка Elbuz. Програма показує його, щоб ви одразу бачили товари, які маркетплейс ще перевіряє або не пропустив, і не шукали їх у кабінеті вручну.
Можна тягнути з Rozetka тільки замовлення, без каталогу?
Так. У шаблоні є окремі перемикачі: завантажувати товари й завантажувати замовлення. Увімкніть лише те, що потрібно. Якщо ввімкнено тільки замовлення — каталог оновлюватися не буде, і навпаки.
У мене кілька магазинів на Rozetka — як бути?
Під кожен акаунт заведіть окремий шаблон зі своїми логіном і паролем. Вони не заважають один одному, можуть мати різний розклад і зводять товари в один базовий каталог Elbuz.