Як завантажити каталог і замовлення з Rozetka в Elbuz

Що вміє підключення Rozetka

• Каталог — назва, опис, ціни, залишок, артикул, виробник, категорія, фото й характеристики лягають у картку товару.
• Стани карток — товари з помилками, на модерації, приховані й відхилені видно в журналі, а проблемні картки заводяться в каталог.
• Замовлення — разом із поверненнями, статусами накладних, комісією й рухами грошей.
• Зворотний статус — ваш статус замовлення повертається на Rozetka разом із номером накладної.
• Розклад — шаблон сам оновлює ціни й залишки та додає новинки.

Де це і хто має доступ

Меню

Операції → Завантаження даних → шаблон типу «Rozetka»

Право доступу

вікно «Завантаження» у «Правах груп»

Підготувати

логін і пароль кабінету продавця Rozetka

Один шаблон — одне підключення до одного акаунта Rozetka. Якщо магазинів на Rozetka кілька, під кожен заводьте окремий шаблон зі своїми даними входу.

1

Логін

2

Пароль

3

Товари

4

Замовлення

1. Логін — обліковий запис кабінету продавця Rozetka, у демо поле порожнє.
2. Пароль — пароль кабінету продавця, у демо поле порожнє.
3. Товари — галочка вмикає завантаження товарів у базовий каталог.
4. Замовлення — галочка вмикає отримання замовлень з Rozetka.

Що потрібно від Rozetka

Rozetka не використовує окремих токенів чи «застосунків розробника»: підключення йде за логіном і паролем вашого кабінету продавця. У картці «Підключення» два поля — Логін і Пароль.

За ними Elbuz входить у Seller API, отримує тимчасовий токен доступу й підписує ним усі звернення. Коли токен застаріває, програма мовчки входить ще раз і повторює запит. Пароль передається захищеним запитом і зберігається у вашому акаунті Elbuz.

Де взяти доступ: крок за кроком

Роздільні API-токени в кабінеті Rozetka — її власний засіб безпеки. Токен прив'язується до ролі співробітника: «Власник» і «Адміністратор» створюють їх і для інших менеджерів, решта ролей — лише для себе. На одного менеджера дозволено до десяти токенів.

Окремої кнопки «Перевірити підключення» для Rozetka немає — вхід перевіряється першим пробним запуском.

Що ввімкнути в шаблоні

У картці «Вибір даних для завантаження» для Rozetka вирішальні три галочки:

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

Поряд стоять уточнювальні галочки каталогу: Фото (завантажувати зображення) і Атрибути (тягнути характеристики). Категорії та Виробники створюються з даних товару самі. Знята галочка «Товари» означає, що каталог не оновлюється — так можна тягнути лише замовлення.

Що переноситься в картку

Кожен товар Rozetka розкладається в поля картки Elbuz за таким відповідником:

• Назва — мовою вашої бази: українська база бере українську назву, інша — російську; немає потрібної — підставляється наявна.
• Категорія — з категорії продавця, а якщо її немає — з категорії самої Rozetka.
• Виробник — спершу з довідника виробників Rozetka, і лише за порожнього — назва з даних продавця.
• Прив'язка до майданчика — за нею Elbuz потім оновлює ціни й залишки, тож кожен товар приїжджає з нею.

Характеристики й зображення

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

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

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

Службова категорія «Товари - rozetka»

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

Розкладати картки з неї по своїх категоріях безпечно. Прив'язка до Rozetka живе окремо від категорії й виробника; у картці вона показана рядком «ID rozetka #номер шаблону». Повторний прогін місця товару в дереві не міняє: категорія ставиться лише під час створення картки. Видаляти саму службову категорію немає сенсу — наступний прогін створить її знову порожньою.

Які картки Rozetka не пропускає

Після каталогу Elbuz окремим проходом знімає стан ваших карток на Rozetka. Прохід іде лише тоді, коли каталог прочитано до кінця: після «Зупинити» чи помилки API він не запускається, і лишаються позначки попереднього прогону.

Програма перебирає шість розділів кабінету й запам'ятовує кожному товару стан із текстом причини (помилка, стоп-слова, причина блокування):

• товари з помилками;
• невалідні;
• на модерації;
• приховані модератором;
• поза допустимим діапазоном цін;
• зі змінами, що чекають підтвердження.

Результат дивляться в журналі прогону: окремої колонки для стану в інтерфейсі немає. Зверху — зведення: скільки товарів у кабінеті всього, у продажу, неактивних, на модерації й відхилено. Далі — рядок на кожну групу з поясненням, наприклад «Rozetka: невалідних товарів: … — майданчик не приймає картку (найчастіше не заповнено обов'язкові характеристики)». Останнім рядком іде стан заявок на модерацію.

Проблемні позиції (невалідні, відхилені) у звичайну видачу каталогу Rozetka не потрапляють. Щоб ви їх не втратили, Elbuz заводить їх у каталог і одразу позначає станом.

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

Товар зник або його зняли з продажу на Rozetka

З карткою в Elbuz не станеться нічого: товар, якого не було в прогоні, лишається з останньою ціною й залишком, не вимикається, і в журналі про нього нічого не пишеться — загальне правило. Перемикача, який видаляв би зниклі позиції, у шаблоні Rozetka немає: такі товари прибирають відбором у вікні «Товари» й пакетним видаленням.

Ознаку активності з Rozetka Elbuz не переносить: кожному товару, що приїхав, ставиться «увімкнено» — і новому, і наявному. Якщо ви вимкнули картку в Elbuz, а на Rozetka товар лишився, наступний прогін увімкне її знову. Утримати картку вимкненою можна тільки позначкою «Не оновлювати» в секції «Захист під час імпорту» — вона закриває картку й від решти оновлень.

1

Не оновлювати

1. Не оновлювати — імпорт з Rozetka не змінює в картці ні статус, ні ціну, ні залишок.

Якщо товар не зник, а його приховав модератор чи відхилили, це видно з проходу станів. Картку при цьому ніхто не вимикає й залишок не обнуляє.

Замовлення, повернення й фінанси

З галочкою «Замовлення» те саме підключення приносить:

• нові замовлення — документами «Замовлення покупця»;
• заявки на повернення — документами «Повернення від покупця» з причиною повернення;
• статуси доставки за накладними всіх служб;
• фінанси: комісія записується в саме замовлення, реальні рухи по балансу стають прибутковими й видатковими ордерами, місячні звіти про продані товари — актами виконаних робіт.

Зіставлення статусів замовлень, оплат і доставки Rozetka з вашими налаштовується кнопками в картці «Пов'язані налаштування». Перший прогін забирає всі замовлення кабінету, наступні — тільки змінені з часу попереднього. Дубля не буде: документ шукається за номером замовлення Rozetka разом із кодом джерела.

Замовлення й залишок: коли рухається склад

Саме завантаження складу не торкається. Замовлення лягає непроведеним документом «Замовлення покупця». Такий документ товар не списує, а резервує, і резерв з'являється лише після проведення.

• Провели замовлення — залишок той самий, але вільна кількість зменшується на замовлену.
• Замовлення дійшло до завершального статусу (виконано, видано, скасовано, повернення) — резерв знімається. Оплата резерв не знімає: оплачене, але не відвантажене замовлення далі тримає товар.
• Виписали витратну накладну — відвантажена кількість списується зі складу й перестає рахуватися в резерві.
• Складський облік вимкнено (наприклад, дропшипінг) — резерв не ведеться, і проведення на наявність не впливає.

Документ «Повернення від покупця» — реєстрація заявки покупця; сам собою він залишок назад не додає.

Два правила для вже заведених замовлень:

• Документ не проведено — кожен прогін оновлює його, але ваш статус обробки міняється, лише коли статус на боці Rozetka змінився з минулого разу. Робота менеджера не затирається.
• Документ проведено — імпорт його більше не чіпає: ні статус, ні оплату, ні доставку. Виняток — комісія майданчика, вона записується завжди.

Як замовлення знаходить покупця й товар у каталозі — загальна механіка завантаження замовлень.

Зворотний запис статусу замовлення

З Rozetka зв'язок за замовленнями двобічний: коли менеджер рухає замовлення по ваших статусах, Elbuz повертає відповідний статус на майданчик. Покупець бачить актуальний стан, а дублювати дію в кабінеті Rozetka не доводиться.

• Відповідність береться з тієї самої таблиці зіставлення статусів, що й на завантаженні, у зворотному напрямку.
• Надсилаються лише замовлення, у яких статус змінився з моменту останньої відправки.
• Разом зі статусом передається номер накладної, якщо він заповнений.

Зворотний запис виконує завдання вивантаження, а не шаблон імпорту, і в нього власний розклад. Якщо статуси на Rozetka не оновлюються, перевіряйте завдання вивантаження.

Оновлення за розкладом і обсяг прогону

Перевірений шаблон ставлять на розклад кнопкою налаштування завдання в картці «Пов'язані налаштування»: ціни й залишки оновлюватимуться, нові товари додаватимуться. Для великого каталогу оновлюйтеся рідше, ніж щохвилини, — маркетплейси не люблять надто частих звернень. Як працює розклад — оновлення й розклад API-джерел.

Скільки даних забирає один прогін

• Стелі на кількість товарів немає. Каталог читається сторінками по 100 позицій, доки Rozetka не скаже, що сторінки скінчилися. Кожна сторінка лишає рядок у журналі: «Rozetka: сторінка каталогу 3 з 12, отримано товарів: 300».
• У каталог товари лягають пачками по 500 позицій, тож результат видно ще до кінця прогону.
• Характеристики — окремий запит на кожен товар, у якого їх ще немає, з паузою 0,1 секунди між запитами. Наприкінці журнал пише: «Rozetka: характеристики завантажено для N товарів, у M вони вже були».
• Прохід станів карток після повного каталогу додає ще шість обходів кабінету, теж сторінками по 100.

Один запит програма чекає не довше 180 секунд (на з'єднання — 30). На помилку сервера чи «забагато запитів» запит повторюється — до трьох спроб із паузою 3 і 6 секунд. Не вийшло і з третьої — читання каталогу припиняється, у журналі рядок «Rozetka: помилка API —» з причиною від майданчика.

Сидіти біля вікна не треба: журнал прогону живе в Центрі операцій, картку шаблону можна закрити — як стежити за прогоном.

Сценарії

Каталог ведете в Elbuz, з Rozetka потрібні лише замовлення

Увімкніть «Замовлення» і зніміть «Товари». Прогін принесе замовлення, повернення, статуси накладних і фінанси. Каталог не читається: ціни, залишки й стани карток не оновлюються. Склад від завантаження не рухається — замовлення лягає непроведеним.

Перше підключення великого каталогу

Перший прогін — з «Товари» і знятими «Атрибути»: каталог прийде без поштучних запитів. Другим прогоном увімкніть «Атрибути» — програма запитає характеристики лише для товарів без них. Наявних значень цей прогін не стирає, існуючим карткам лише дописує відсутні.

Фото ведете у власній медіатеці

Зніміть галочку «Фото» — товари каталогу прийдуть без зображень. Виняток: проблемні картки (невалідні, відхилені), які заводить прохід станів, приходять із фото незалежно від галочки.

Треба бачити в Elbuz, які картки Rozetka не пропускає

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

Вимкнена в Elbuz картка не повинна вмикатися прогоном

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

Що робити, коли підключення працює не так

Якщо прогін обірвався посередині

У каталозі лишається усе, що встигло дійти пачками по 500 позицій, решта стоїть зі старими даними. Запустити знову безпечно — як це працює для всіх джерел, описано в огляді. Специфіка Rozetka:

• Характеристики не починаються з нуля — поштучні запити повторяться тільки для товарів, до яких минулого разу не дійшло.
• Замовлення не задвояться — документ шукається за номером замовлення Rozetka.
• Позначки станів після обриву на каталозі лишаються від минулого разу. Обрив саме на проході станів лишає частину товарів без позначки — до наступного повного прогону.
• «Зупинити» в картці операції дописує в каталог уже прочитане й пише в журнал «Rozetka: завантаження зупинено користувачем, оброблено: …». Продовжити з того самого місця не можна: наступний запуск читає кабінет з першої сторінки.

Якщо прогін зробив не те

Нові товари прогону знаходяться у вікні «Товари» за колонкою «Джерело: назва», перезаписані — за «Датою оновлення» (як відкотити прогін). Видалені картки забирають із собою прив'язку до Rozetka. З якого шаблону приїхала картка, видно в її списку ідентифікаторів: рядок «ID rozetka #номер шаблону».

• Фото додаються лише створеним прогоном товарам — зайве зникає разом із цими картками.
• Характеристики наявним карткам лише дописуються. Прибрати дописане можна в картці значком кошика «Очистити значення атрибутів для товару».

1

Очистити значення атрибутів для товару

1. Червоний значок кошика очищає значення атрибутів для товару.

Часті запитання

Rozetka видає токен чи ключ — де його взяти?

Не потрібно. Підключення йде за логіном і паролем кабінету продавця, а тимчасовий токен доступу Elbuz отримує й оновлює сам (що потрібно від Rozetka).

Чи безпечно вводити пароль від кабінету?

Це єдиний спосіб авторизації в API Rozetka. Пароль передається захищеним запитом і зберігається у вашому акаунті Elbuz. Щоб відкликати доступ, змініть пароль у кабінеті Rozetka.

Чому перше завантаження таке довге?

Rozetka віддає характеристики поштучно, тож для великого каталогу з «Атрибутами» запитів багато. Наступні прогони вже заповнені характеристики пропускають (обсяг прогону).

Можна тягнути з Rozetka тільки замовлення, без каталогу?

Так: увімкніть «Замовлення» і зніміть «Товари» (сценарій).

У мене кілька магазинів на Rozetka — як бути?

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

Куди потрапляють відгуки з Rozetka?

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

Суміжні теми

• Якщо треба зрозуміти, як імпорт поводиться з вашими правками й обірваними прогонами, — огляд завантаження даних.
• Якщо замовлення приклеїлося не до того покупця чи товару — завантаження замовлень через API.
• Якщо поряд з Rozetka продаєте на Prom — замовлення з Prom.ua.