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