Якщо ви продаєте на Rozetka, ваш каталог уже існує в кабінеті продавця. Не треба вивантажувати його у файл і завантажувати вручну — Elbuz забирає товари напряму через Seller API маркетплейсу за вашим логіном і паролем. Так каталог Rozetka зводиться у ваш базовий каталог Elbuz, де ви керуєте цінами, наявністю й контентом централізовано, а не перемикаючись між кабінетами.
Ця стаття — про підключення саме Rozetka. Загальний порядок для всіх API-джерел описано в огляді імпорту каталогу через API; тут — особливості Rozetka: які дані потрібні для входу, які поля куди лягають у картці, як приходять статуси модерації й що ще, крім каталогу, вміє це підключення. Про завантаження даних загалом — огляд завантаження.
Де це у програмі
У вікні «Імпорт категорій, товарів, виробників» ви створюєте шаблон і обираєте тип «Rozetka». Це API-джерело: жодного файлу не потрібно, підключення відбувається за ключами доступу до кабінету продавця. Один шаблон — це одне підключення до одного акаунта Rozetka. Якщо у вас кілька магазинів на Rozetka, під кожен заводьте окремий шаблон зі своїми даними входу.
1
Логін2
Пароль3
Товари4
Замовлення- Логін — обліковий запис кабінету продавця Rozetka, у демо поле порожнє.
- Пароль — пароль кабінету продавця, у демо поле порожнє.
- Товари — галочка вмикає завантаження товарів у базовий каталог.
- Замовлення — галочка вмикає отримання замовлень з Rozetka.
Що потрібно для підключення
Rozetka не використовує окремі токени чи «застосунки розробника» — підключення відбувається за логіном і паролем вашого кабінету продавця, тими самими, якими ви заходите в кабінет Rozetka. У картці «Підключення» два поля: Логін і Пароль. За ними Elbuz виконує вхід у Seller API (запит на кінцеву точку /sites), отримує тимчасовий токен доступу й далі всі звернення підписує вже ним. Токен живе в межах сеансу; коли він застаріває, програма мовчки входить ще раз і повторює запит — від вас нічого не потрібно. Пароль передається захищеним запитом і зберігається у вашому акаунті Elbuz.
Де взяти доступ: крок за кроком
| Де | Що зробити |
|---|---|
| Кабінет продавця Rozetka | Розділ «Налаштування» → «Безпека API» — тут вмикається й контролюється доступ до API |
| Там само (за потреби) | Кнопка «Генерувати API-токен» — окремий ключ, прив'язаний до ролі співробітника |
| Elbuz | Вікно завантаження → ваш шаблон «Rozetka» → картка «Підключення» → поля «Логін» і «Пароль» |
Підключення Elbuz працює за логіном і паролем кабінету продавця — тими самими, якими ви входите в кабінет; окремо реєструвати застосунок не треба. Роздільні API-токени в кабінеті Rozetka — це її власний засіб безпеки: токен прив'язується до ролі співробітника, ролі «Власник» і «Адміністратор» можуть створювати їх і для інших менеджерів, решта ролей — лише для себе, а на одного менеджера дозволено до десяти токенів.
Rozetka автоматично робить токен неактивним, якщо ним не користуються понад 24 години. Для робочого підключення це не проблема — Elbuz звертається до майданчика за розкладом, і доступ лишається живим. Але якщо ви надовго вимкнете завдання, перший запуск після паузи може завершитися помилкою авторизації: просто перевірте доступ у кабінеті й запустіть ще раз.
Довідка Rozetka для продавців: API — початок роботи (розділ «Особистий кабінет → Інструменти»). Технічний опис усіх методів — в документації Seller API. Якщо доступ не працює, у підтримку Rozetka звертаються за темою «Акаунт, особистий кабінет, API».
Окремої кнопки «Перевірити підключення» для Rozetka немає — правильність входу перевіряється першим пробним запуском (див. нижче).
Вибір даних для завантаження
У картці «Вибір даних для завантаження» галочками ви вмикаєте, що саме тягнути. Для Rozetka вирішальні три перемикачі:
- Товари — головне: забирає каталог продавця в базовий каталог Elbuz і одразу знімає стан карток на майданчику (модерація, помилки, блокування).
- Замовлення — приносить нові замовлення, а разом з ними повернення, статуси накладних (ТТН) і фінанси (комісія, баланс). Детальніше — у розділі «Каталог і замовлення».
- Відгуки — тягне відгуки про магазин і питання до товарів у ваш інбокс модерації, а також службові звернення площадки по замовленнях.
Поряд стоять уточнювальні галочки для каталогу: Фото (завантажувати зображення товарів) і Атрибути (тягнути характеристики). Категорії та Виробники створюються автоматично з даних товару — окремо їх вмикати не треба. Прибрана галочка «Товари» означає, що каталог оновлюватися не буде; так можна залишити своє вичищене наповнення й підтягувати, наприклад, лише замовлення.
Набір галочок у цій картці спільний для всіх API-джерел, тому частина з них до Rozetka не стосується — програма звертається лише до тих даних, які майданчик віддає. Зокрема, Rozetka працює опитуванням за розкладом: миттєвих сповіщень (вебхуків) у неї немає, тож галочка «Використовувати вебхуки» на роботу з Rozetka не впливає — періодичність задається розкладом завдання.
Що потрапляє в картку: маппінг полів
Під час імпорту кожен товар Rozetka розкладається в поля картки Elbuz за таким відповідником. Це не «десь усе разом», а конкретні поля — далі ви бачите, звідки що взялося:
| Дані Rozetka | Поле картки в Elbuz |
|---|---|
name_ua / name / name_ru (за мовою бази) | Назва товару |
description | Повний опис |
price | Ціна |
price_old | Стара ціна (до знижки) |
stock_quantity | Залишок (наявність) |
article | Артикул |
rz_producer / price_producer_name | Виробник |
price_category / rz_category | Категорія (структура каталогу) |
photo (список URL) | Зображення — за увімкненої галочки «Фото» |
params (окремий запит /goods/details) | Характеристики — за увімкненої галочки «Атрибути» |
rz_item_id | Ключ прив'язки до майданчика (за ним ідуть оновлення цін і залишків) |
price_offer_id | Другий ключ прив'язки (offer) |
Назва береться мовою вашої бази: якщо базова мова українська — name_ua, інакше name_ru; якщо потрібного варіанта немає, підставляється наявний. Категорія береться з категорії продавця, а якщо її немає — з категорії самої Rozetka. Виробник — навпаки: спершу з довідника виробників Rozetka, і лише якщо там порожньо, береться назва виробника з даних продавця. Найважливіше поле для подальшої роботи — rz_item_id: саме за ним Elbuz потім оновлює на майданчику ціни й залишки, тому кожен товар приїжджає з цією прив'язкою, а не «сам по собі».
Характеристики й зображення
Rozetka віддає характеристики окремо по кожному товару (запит /goods/details на позицію) — масового вивантаження параметрів у неї немає. Тому для великого каталогу перше завантаження з увімкненими «Атрибутами» триває довше: програма запитує параметри позиція за позицією. Це нормально. Товари, у яких характеристики вже заповнені, наступні прогони пропускають — тобто перший прохід наповнює каталог, а далі добираються лише новинки та оновлюються ціни й наявність. Значення характеристик Elbuz бере навіть тоді, коли Rozetka не зіставила їх зі своїм довідником (тоді використовується власне значення продавця) — так не губиться більшість параметрів.
Зображення завантажуються лише за ввімкненої галочки «Фото» — усі картинки товару в тому порядку, як їх віддає майданчик. Якщо фото вам не потрібні (наприклад, ви ведете власну медіатеку), лишіть галочку знятою, і трафік на завантаження картинок не витрачатиметься.
Скільки даних забирає один прогін
Стелі на кількість товарів немає: скільки позицій у кабінеті, стільки й приїде. Каталог Elbuz читає сторінками по 100 позицій і йде далі, доки Rozetka не скаже, що сторінки скінчилися. Кожна сторінка лишає в журналі свій рядок — «Rozetka: сторінка каталогу 3 з 12, отримано товарів: 300», — тож у журналі видно, скільки сторінок уже пройдено і скільки лишилося.
У базовий каталог товари лягають не в кінці прогону, а пачками по 500 позицій: набралося 500 — пачка записалася, читання триває далі. Тому результат з'являється в каталозі ще до завершення роботи.
Характеристики рахуються окремо, і саме вони задають обсяг роботи. Rozetka віддає їх тільки поштучно, тож на кожен товар, у якого характеристик у каталозі ще немає, іде окремий запит, а між такими запитами програма витримує паузу 0,1 секунди, щоб не тиснути на майданчик. Товари, у яких характеристики вже є, у цей рахунок не потрапляють — наприкінці прогону журнал повідомляє обидва числа: «Rozetka: характеристики завантажено для N товарів, у M вони вже були».
Один запит до Rozetka програма чекає не довше 180 секунд (на встановлення з'єднання — 30). Якщо майданчик відповів помилкою сервера або «забагато запитів», той самий запит повторюється — усього до трьох спроб, із паузою 3 і 6 секунд між ними. Не вийшло і з третьої — читання каталогу припиняється, а в журнал лягає рядок «Rozetka: помилка API —» з текстом причини від самого майданчика. Протухлий токен доступу сюди не належить: на відповідь «не авторизовано» програма мовчки входить ще раз і повторює запит.
Прохід станів карток додає до цього ще шість обходів кабінету — товари з помилками, невалідні, на модерації, приховані модератором, поза ціновим діапазоном і ті, чиї зміни ще чекають підтвердження. Кожен читається так само, сторінками по 100.
Сидіти й чекати біля вікна не треба: журнал прогону живе в Центрі операцій, і картку шаблону можна закрити — як стежити за прогоном.
Якщо перше підключення робиться на великому каталозі, є сенс спершу пройти його з вимкненими «Атрибутами»: тоді прогін обійдеться сторінками каталогу без поштучних запитів. Увімкнути «Атрибути» можна наступним прогоном — він добере характеристики тим товарам, у яких їх ще немає, і не чіпатиме решту.
Статуси карток на майданчику
Разом із каталогом Elbuz окремим проходом знімає стан ваших карток на Rozetka. Програма перебирає розділи кабінету — товари з помилками, невалідні, на модерації, приховані модератором, ті, що не потрапили в допустимий діапазон цін, і ті, чиї зміни ще очікують підтвердження, — і запам'ятовує кожному відповідний стан із текстом причини (помилка, стоп-слова, причина блокування). Зверху в журнал лягає зведення: скільки товарів у кабінеті всього, скільки з них у продажу, скільки неактивних, скільки на модерації й скільки відхилено.
Дивитися на результат цього проходу треба в журналі прогону: сам стан зберігається поруч із прив'язкою товару до майданчика, а окремої колонки чи поля в інтерфейсі для нього немає. Зате журнал дає по рядку на кожну групу — з кількістю й поясненням, чому так: «Rozetka: невалідних товарів: … — майданчик не приймає картку (найчастіше не заповнено обов'язкові характеристики)», «Rozetka: товарів поза допустимим діапазоном ціни: … — ціну не застосовано до перевірки менеджером». Останнім рядком іде стан заявок на модерацію: скільки їх і що з останньою.
Корисна деталь: проблемні позиції (невалідні, відхилені) у звичайну видачу каталогу Rozetka не потрапляють. Щоб ви не втратили саме ті товари, які потребують уваги, Elbuz заводить їх у каталог тим самим механізмом і одразу позначає станом. Так усі товари, які маркетплейс не пропустив, видно у вашій системі, а не лише в кабінеті Rozetka.
Товар зник або його зняли з продажу на Rozetka
Коротка відповідь: з карткою в Elbuz не станеться нічого. Завантаження оновлює те, що приїхало, і жодних висновків з того, чого не приїхало, не робить. Товар, якого в цьому прогоні не було, лишається в каталозі з останньою відомою ціною й останнім залишком: він не деактивується, залишок не обнуляється, у журналі про нього не пишеться ні слова. Загальне правило для всіх прямих підключень описане в огляді API-імпорту.
Змінити це налаштуваннями шаблона не вийде: у наборі галочок Rozetka немає перемикача, який видаляв би зниклі позиції. Тобто зняті з продажу товари прибирають руками — відбором у вікні «Товари» й пакетним видаленням.
Друга половина відповіді неочевидна й важливіша за першу. Ознаку активності з Rozetka Elbuz не переносить: кожному товару, який приїхав у прогоні, ставиться «увімкнено» — і новому, і вже наявному. Тож якщо ви вимкнули картку в Elbuz, а на Rozetka товар лишився в кабінеті, наступний прогін увімкне її знову. Утримати картку вимкненою можна тільки позначкою «Не оновлювати» в ній самій (секція «Захист під час імпорту») — вона ж закриває картку від решти оновлень.
Якщо товар не зник, а змінив стан на майданчику — його приховав модератор, він пішов на повторну модерацію чи його відхилили, — ви побачите це з проходу станів: такі позиції приходять окремими списками кабінету, і журнал показує кількість по кожній групі. Картку при цьому ніхто не вимикає й залишок не обнуляє: майданчик лише повідомляє, що з нею не так.
І остання деталь, через яку буває плутанина: позначка стану не залипає. Прохід станів спершу знімає всі попередні позначки цього шаблону, а потім проставляє їх наново — тільки тим товарам, яких знайшов у кабінеті цього разу. Товар, що виправився, лишається без позначки, і це нормально. Але й у товару, який зник з Rozetka зовсім, позначка теж стане порожньою — «слід» того, що він колись був заблокований, не зберігається.
Службові категорії та виробники
Категорію Elbuz бере з категорії продавця, а якщо її в даних товару немає — з категорії самої Rozetka. Далі працює загальний порядок: програма шукає вашу категорію з такою самою назвою й кладе товар у неї, а не знайшовши — створює нову гілку (як це влаштовано). Виробник шукається в довіднику за назвою й додається новим рядком, якщо такої назви там ще немає.
Товари, у яких назви категорії немає взагалі, потрапляють у службову категорію «Товари - rozetka». Вона створюється вимкненою і без участі у вивантаженнях, тож такі позиції самі собою нікуди не поїдуть, поки ви їх не розкладете.
Розкладати картки з неї по своїх категоріях безпечно. Прив'язка товару до Rozetka — той самий rz_item_id, за яким потім ідуть оновлення цін і залишків, — живе окремим записом і з категорією та виробником ніяк не пов'язана; у картці товару вона показана рядком «ID rozetka #номер шаблону». Перенесли товар в іншу категорію, видалили стару категорію — на прив'язці це не позначиться, наступний прогін так само знайде товар і оновить йому ціну й залишок. Місце вже заведеного товару в дереві повторний прогін теж не міняє: категорія проставляється лише в момент створення картки.
Завантажені документи від цього теж не постраждають: у рядку замовлення записано посилання на сам товар, а не на його категорію чи бренд. Видалення категорії рядки замовлень не рве.
А от видаляти саму службову категорію немає сенсу: наступний прогін створить її знову, щойно з Rozetka приїде товар без категорії. Уже розкладені товари назад у неї не повернуться — вона просто з'явиться порожньою.
Каталог і замовлення
Те саме підключення Rozetka вміє забирати не лише каталог. За ввімкненого перемикача «Замовлення» Elbuz приносить нові замовлення у ваші документи, а разом із ними — заявки на повернення (у документи «Повернення від покупця»), статуси доставки за накладними всіх служб і фінанси: комісія осідає в самому замовленні, а реальні рухи грошей стають прибутковими/видатковими ордерами. Зіставлення статусів замовлень, оплат і доставки Rozetka з вашими налаштовується кнопками в картці «Пов'язані налаштування». Ця стаття — про каталог; якщо потрібні саме замовлення, увімкніть відповідну галочку, а не потрібне — лишіть вимкненим, зайве не завантажуватиметься.
Замовлення й залишок: коли рухається склад
Питання, яке виникає одразу після першого ввімкнення галочки «Замовлення»: чи зменшиться наявність у каталозі, коли з Rozetka приїде десяток нових замовлень. Ні. Саме завантаження складу не торкається взагалі.
Замовлення лягає документом «Замовлення покупця» і лягає непроведеним. Цей тип документа товар не списує — він його резервує, і резерв з'являється лише в момент проведення. Поки менеджер документ не провів, у каталозі не зміниться ні залишок, ні резерв, скільки б замовлень не приїхало.
Далі ланцюжок такий:
- Провели замовлення — товар стає зайнятим: залишок лишається колишнім, але вільна кількість зменшується на замовлену.
- Замовлення дійшло до завершального статусу (виконано, видано, скасовано, повернення) — резерв знімається. Оплата резерв не знімає: оплачене, але не відвантажене замовлення далі тримає товар, інакше його продали б удруге.
- Виписали витратну накладну на це замовлення — відвантажена кількість фізично списується зі складу й перестає рахуватися в резерві. Списує саме витратна накладна, а не замовлення.
- Складський облік у вашій схемі роботи вимкнено (наприклад, дропшипінг) — резерв не ведеться зовсім, і проведення замовлення на наявність теж не впливає.
Повернення з Rozetka приходять документами «Повернення від покупця» — це реєстрація заявки покупця з причиною повернення; сам собою такий документ залишок назад не додає. Гроші майданчика йдуть окремо: комісія записується в поле самого замовлення, реальні рухи по балансу стають прибутковими й видатковими ордерами, а місячні звіти про продані товари — актами виконаних робіт.
Про статуси вже заведених замовлень варто знати два правила. Перше: поки документ не проведено, кожен наступний прогін оновлює його — але ваш статус обробки міняється тільки тоді, коли статус справді змінився на боці Rozetka з минулого разу, тож робота менеджера не затирається на кожному колі. Друге: щойно документ проведено, імпорт не чіпає його більше ніяк — ні статус, ні оплату, ні доставку. Єдиний виняток — комісія майданчика: її записують у замовлення незалежно від того, проведене воно чи ні.
Перший прогін забирає всі замовлення кабінету, наступні — тільки ті, що змінилися з часу попереднього завантаження. Дубля при цьому не буде: документ шукається за номером замовлення Rozetka разом із кодом джерела.
Зворотний запис статусу замовлення
Rozetka — одне з небагатьох підключень, де зв'язок за замовленнями двобічний. Коли менеджер рухає замовлення по ваших статусах, Elbuz уміє повернути відповідний статус назад на майданчик, щоб покупець бачив актуальний стан і вам не доводилося дублювати дію в кабінеті Rozetka.
Працює це так. Відповідність береться з тієї самої таблиці зіставлення статусів, що й на завантаженні, тільки читається у зворотному напрямку: ваш статус — у код статусу Rozetka. Надсилаються лише ті замовлення, у яких статус справді змінився з моменту останньої відправки, тож зайвих звернень до майданчика немає. Разом зі статусом передається номер накладної, якщо він заповнений.
Для переходу в статуси, пов'язані з передачею замовлення у службу доставки, Rozetka вимагає номер накладної. Якщо ТТН у документі порожній, таке замовлення пропускається, а в журналі з'являється запис із його номером. Тому спершу оформіть відправлення й отримайте накладну, і лише потім переводьте замовлення у статус відвантаження.
Важлива організаційна деталь: зворотний запис виконується з боку вивантаження, а не цим шаблоном імпорту. Тобто завантаження замовлень і повернення статусів — два різні завдання, і кожне має власний розклад. Якщо статуси на Rozetka не оновлюються, перевіряйте саме завдання вивантаження, а не імпорт.
Навіщо зводити каталог Rozetka в Elbuz
Сама по собі Rozetka — це вітрина й кабінет продавця, але не система керування товаром. Коли позицій сотні чи тисячі, а поруч є ще свій сайт та інші майданчики, керувати кожним каналом окремо стає важко: ціни розходяться, наявність запізнюється, опис доводиться правити в кількох місцях. Elbuz забирає каталог Rozetka до себе, і далі ви працюєте з товарами централізовано — в одному каталозі, за єдиними правилами націнок і наявності.
Найбільше це відчутно, коли Rozetka не єдиний ваш канал продажу. Той самий товар може одночасно жити на Rozetka, на вашому сайті й на інших маркетплейсах, а ви редагуєте його в одному місці — в Elbuz — і зміни розходяться туди, куди потрібно. Rozetka в такій схемі стає одним із джерел каталогу, а не окремим «острівцем», який доводиться вести руками.
Оновлення за розкладом
Головна користь підключення через API — живе оновлення без ручної роботи. Коли шаблон налаштовано й перевірено, поставте його на розклад кнопкою налаштування завдання в картці «Пов'язані налаштування». Elbuz сам звертатиметься до Rozetka за свіжими даними: ціни й залишки оновлюватимуться, нові товари додаватимуться. Частоту обирайте за потребою — маркетплейси не люблять надто частих звернень, тож для великого каталогу розумніше оновлюватися рідше, ніж щохвилини.
Кожне звернення лишає слід у журналі: скільки товарів оновлено, скільки додано, чи були помилки. Перші кілька разів варто туди зазирати — так ви одразу побачите, якщо, наприклад, змінили пароль у кабінеті Rozetka, а в шаблоні він лишився старим, і оновлення перестали проходити.
Якщо прогін обірвався посередині
Довге перше завантаження з «Атрибутами» — саме той випадок, коли обрив цілком імовірний: зник зв'язок, майданчик тричі поспіль відповів помилкою, прогін зупинили вручну. У каталозі після цього лишається усе, що встигло дійти пачками по 500 позицій, — з новими цінами й залишками; решта товарів стоїть зі старими даними. Сама пачка пишеться не одним рухом, а послідовністю кроків — спершу товари, далі описи, зв'язки з категоріями, характеристики, фото, — тож обрив рівно посеред запису пачки лишає в базі те, що встигло записатися до нього.
Запустити завантаження знову — безпечно. Що при цьому відбувається:
- Дублів не з'явиться. Товар шукається серед уже заведених карток, а не додається другим рядком; прив'язка до майданчика теж шукається за наявною.
- Характеристики не почнуться з нуля. На старті прогону програма складає список товарів, у яких характеристики в каталозі вже є, і в Rozetka їх не перезапитує. Тобто поштучні запити повторюються тільки для тих товарів, до кого минулого разу не дійшло.
- Замовлення не задвояться. Документ шукається за номером замовлення Rozetka, і той, що вже заведений, буде оновлений, а не створений удруге.
- Позначки станів карток можуть виявитися порожніми. Прохід станів улаштований так: спершу знімаються всі попередні позначки цього шаблону, потім вони проставляються наново за шістьма списками кабінету. Обрив саме на цьому проході лишає частину товарів без позначки стану — до наступного повного прогону. На самі картки, ціни й залишки це не впливає.
Зупинити прогін самому можна посиланням «Зупинити» в картці операції. Сигнал перевіряється перед кожним наступним товаром каталогу (а в замовленнях — перед кожною наступною сторінкою), тому зупинка не втрачає набране: те, що вже прочитано, дописується в каталог, і в журналі стає рядок «Rozetka: завантаження зупинено користувачем, оброблено: …». Продовжити з цього ж місця не можна: наступний запуск читає кабінет із першої сторінки заново.
Якщо прогін зробив не те
Два типові випадки: ввели логін не того кабінету й затягли чужий каталог або лишили ввімкненими «Фото» й «Атрибути», хоча медіатеку й характеристики ведете самі.
Що знайдеться відбором. Товари, які створило це підключення, видно у вікні «Товари» за колонкою «Джерело: назва» — це загальний механізм, він описаний в огляді API-імпорту. Виділили рядки, видалили пакетом — разом із картками зникне й прив'язка до Rozetka, тож правильний прогін заведе ці товари наново, з чистого аркуша. Якщо шаблонів Rozetka у вас кілька й треба зрозуміти, з якого саме приїхала конкретна картка, відкрийте її: у списку ідентифікаторів стоїть рядок «ID rozetka #номер шаблону».
Що відбором не знайдеться — картки, які у вас уже були й які прогін лише перезаписав: позначка джерела в них лишилася старою. Їх збирають за колонкою «Дата оновлення» — прогін ставить її кожній зміненій картці.
Фото. Зайвих картинок у старих картках не буде: зображення додаються тільки тим товарам, які прогін створив сам, а у вже наявних фото не чіпаються. Тобто все зайве прибирається разом із помилково заведеними картками.
Характеристики. Наявних значень прогін не перезаписує — існуючим карткам він дописує лише ті характеристики, яких у них не було. Прибрати дописане можна в картці товару, у розділі характеристик: значок кошика з підказкою «Очистити значення атрибутів для товару».
Очищення значень не повертає товар у стан «характеристик немає»: рядки характеристик у картці лишаються, просто порожні. А наступний прогін орієнтується саме на наявність рядків — він вирішить, що характеристики вже завантажені, і поштучним запитом у Rozetka їх не перезапитає. Тому очищення значень і повторний прогін «щоб приїхало заново» не працюють у парі: щоб характеристики запиталися повторно, рядки треба саме видалити — пунктом «Видалити атрибут» у самому рядку.
Часті труднощі
Найчастіша причина, чому підключення не працює, — логін або пароль. Перевірте, що вони введені без зайвих пробілів і що цим самим логіном ви успішно заходите в кабінет продавця. Якщо ви змінили пароль на Rozetka, його треба оновити й у шаблоні Elbuz — інакше чергове звернення завершиться помилкою авторизації, і це буде видно в журналі.
Друга типова ситуація — товари на модерації. Якщо позиції щойно створені на Rozetka й ще не пройшли перевірку, вони приїдуть зі статусом «на модерації»; це не помилка імпорту, а стан на боці маркетплейсу. Так само не варто лякатися, якщо частина характеристик порожня: програма переносить рівно те, що Rozetka віддає, і не вигадує відсутнього. Дозаповнити картки можна вже у своєму каталозі.
Перш ніж ставити шаблон на регулярний розклад, зробіть одне пробне підключення й перевірте на кількох товарах, що каталог тягнеться правильно: назви, ціни, картинки, категорії, статуси. Переконались — тоді вмикайте автоматичне оновлення.
Часті питання
Rozetka видає токен чи ключ — де його взяти?
Не потрібно. На відміну від більшості маркетплейсів, у Rozetka немає окремого токена: підключення відбувається за логіном і паролем кабінету продавця. Elbuz сам отримує від Rozetka тимчасовий токен доступу за цими даними й оновлює його автоматично.
Чи безпечно вводити пароль від кабінету?
Пароль потрібен, бо це єдиний спосіб авторизації в API Rozetka. Він передається захищеним запитом і зберігається у вашому акаунті Elbuz. Якщо колись захочете відкликати доступ — просто змініть пароль у кабінеті Rozetka, і старе підключення перестане працювати.
Чому перше завантаження таке довге?
Rozetka віддає характеристики окремо по кожному товару, тож за ввімкнених «Атрибутів» для великого каталогу програма робить багато запитів і перший прохід триває довше. Наступні оновлення швидші, бо тягнуть переважно ціни й наявність, а вже заповнені характеристики пропускають.
Що означають статуси товарів (модерація, відхилено)?
Це стан позиції на боці Rozetka, а не помилка Elbuz. Elbuz знімає його окремим проходом і зберігає поруч із прив'язкою товару до майданчика, а показує підсумком у журналі прогону: скільки товарів з помилками, скільки невалідних, скільки на модерації, скільки поза ціновим діапазоном. Окремої колонки для цієї позначки в інтерфейсі немає.
Можна тягнути з Rozetka тільки замовлення, без каталогу?
Так. У картці «Вибір даних для завантаження» є окремі галочки: «Товари», «Замовлення», «Відгуки». Увімкніть лише те, що потрібно. Якщо ввімкнено тільки «Замовлення» — каталог оновлюватися не буде, і навпаки.
У мене кілька магазинів на Rozetka — як бути?
Під кожен акаунт заведіть окремий шаблон зі своїми логіном і паролем. Вони не заважають один одному, можуть мати різний розклад і зводять товари в один базовий каталог Elbuz.
Товар зняли з продажу на Rozetka — він вимкнеться в Elbuz?
Ні. Картка лишиться як була: з останньою ціною, останнім залишком і ознакою «увімкнено». Більше того, Elbuz не переносить із Rozetka ознаку активності — кожен прогін ставить товарам, що приїхали, «увімкнено». Якщо ви вимкнули картку в себе, а на Rozetka товар лишився, наступний прогін увімкне її знову; утримати її вимкненою можна лише позначкою «Не оновлювати» в самій картці.
Завантаження обірвалося посередині — можна просто запустити ще раз?
Так. Товари пишуться пачками по 500, тож у каталозі лежить усе, що встигло дійти, а решта стоїть зі старими даними. Повтор не створює дублів і не починає характеристики з нуля: ті товари, у яких характеристики вже завантажені, програма в Rozetka не перезапитує — добираються тільки ті, до кого минулого разу не дійшло.
Чи зменшиться наявність, коли приїдуть замовлення з Rozetka?
Саме завантаження залишок не чіпає. Замовлення лягає документом «Замовлення покупця» і лягає непроведеним, а резерв з'являється тільки після проведення документа. Фізично товар списує вже витратна накладна, а не замовлення.

