Elbuz забирає активні лоти й замовлення вашого акаунта продавця eBay напряму через API і зводить їх у базовий каталог поруч з іншими каналами продажу.
Коли це знадобиться:
- Асортимент eBay треба мати в каталозі — кожен активний лот і кожна варіація стають картками з ціною, залишком і категорією.
- eBay — лише один із ваших майданчиків — товар редагуєте в Elbuz, а ціна й залишок вивантажуються назад на eBay.
- Ціни й залишки мають оновлюватися щодня — шаблон на розкладі робить це сам, з урахуванням денних лімітів eBay.
- Замовлення eBay треба вести разом з іншими — кожне лягає документом «Замовлення покупця».
З чого почати: прив'яжіть акаунт eBay кодом у шаблоні завантаження.
Що вміє підключення eBay
- Підключається кодом прив'язки — доступ видається й продовжується сам, токен вводити не треба.
- Переносить лот у картку — назву, опис, артикул, ціну, реальний залишок, категорію повним шляхом, бренд, характеристики й фото.
- Розкладає варіації — кожен розмір чи колір стає окремою карткою.
- Забирає замовлення і заводить їх документом «Замовлення покупця» з вашими статусами.
- Оновлюється за розкладом у межах денних лімітів eBay.
- Віддає назад ціну й залишок через шаблон вивантаження, за потреби публікує нові лоти.
Де це і хто має доступ
- Меню
- Довідники → Операції → Завантаження даних
- Шаблон
- новий шаблон → тип «eBay»; один шаблон — один акаунт продавця
- Право доступу
- вікно «Завантаження даних» у «Правах груп»
- Підготувати
- вхід в акаунт продавця eBay для підтвердження доступу
1
User-токен eBay2
Кнопка «Перевірити підключення»- User-токен eBay — вставте сюди токен, якщо не підключаєтесь через застосунок.
- Кнопка «Перевірити підключення» перевіряє зв'язок з акаунтом eBay без завантаження даних.
Як працюють шаблони завантаження загалом — огляд завантаження даних.
Що потрібно від eBay: прив'язка застосунку або user-токен
Доступ дається одним із двох способів:
- Прив'язка застосунку кодом — основний спосіб. Токен видається й оновлюється автоматично, доступ живе довго й продовжується сам; поле токена лишається порожнім.
- Ручний user-токен вашого застосунку eBay — переважно для розробки чи тестового середовища. Ручний токен завжди в пріоритеті над отриманим через прив'язку.
Як підключити крок за кроком
- Створіть шаблон типу «eBay».
- Натисніть «Підключити», увійдіть на eBay і підтвердьте доступ.
- Введіть показаний код у поле «Код прив'язки» і натисніть «Прив'язати магазин». Працюєте з власним застосунком — замість цього вставте user-токен.
- Натисніть «Перевірити підключення».
- У картці «Вибір даних для завантаження» увімкніть товари, за потреби й замовлення, збережіть і запустіть.
Прив'язка одна на акаунт eBay: підключили в шаблоні завантаження — шаблон вивантаження працює з тим самим доступом, і навпаки. Кнопка «Підключити» й поле «Код прив'язки» є в обох шаблонах.
«Перевірити підключення» нічого не завантажує: робить один короткий запит про привілеї продавця тими самими ключами, що й прогін. Відповідь — «Підключення працює» або «Підключення не вдалося» з текстом відмови від eBay.
Що переноситься в картку
Що саме тягнути, вмикають галочки картки «Вибір даних для завантаження».
1
Товари2
Фото3
Замовлення- Товари — завантажувати листинги eBay як товари каталогу.
- Фото — завантажувати зображення листингів.
- Замовлення — отримувати замовлення з eBay.
Кожен лот eBay розкладається в поля картки Elbuz так:
| Дані eBay | Поле картки в Elbuz |
|---|---|
| назва лота | Назва (для варіації — «Назва — M / Red») |
| опис лота | Повний опис |
| SKU лота або варіації | Артикул |
| поточна ціна (для варіації — її ціна) | Ціна |
| виставлена кількість мінус продана | Залишок |
категорія виду Root:Sub:Leaf | Категорія — повним шляхом |
характеристика Brand | Виробник |
| решта характеристик лота | Характеристики |
| специфіки варіації (Size, Color…) | Опції варіанта |
| фото лота й фото набору варіації | Зображення — за увімкненої галочки «Фото» |
| ідентифікатор лота (за потреби з SKU) | Ключ прив'язки |
- Залишок — реальна доступна кількість: Elbuz віднімає продане від виставленого. Більше нуля — статус «В наявності», нуль — «Немає на складі»; окремо статус не налаштовується.
- Виробник береться з характеристики
Brand, якщо продавець її заповнив: окремого поля на eBay немає. - Не приходять стара ціна і штрихкод — eBay їх не віддає.
- Лише активні лоти — завершені й чернеткові в каталог не потрапляють (лот завершився).
Варіації й характеристики
Кожна варіація лота (розмір, колір) приходить окремою карткою з назвою на кшталт «Назва лота — M / Red», зі своєю ціною, залишком і артикулом. Назва лота записується всім варіаціям у поле «Назва родини (варіації)» — за ним вони видно в сітці разом. Головним товаром з опціями вони не стають: кожна варіація — самостійна картка.
Специфіки варіації стають опціями, звичайні характеристики лота — характеристиками.
Варіації без власного SKU Elbuz будує стійкий маркер за набором специфік, тож повторний імпорт дублів не плодить. Але вивантаження ціни й залишку на eBay таку картку пропустить: варіацію на майданчику адресують лише по SKU. Керуєте цінами з Elbuz — проставте варіаціям SKU в кабінеті eBay.
Категорії
Категорія Root:Sub:Leaf розгортається в шлях «Root / Sub / Leaf». Elbuz шукає вашу категорію з таким самим повним шляхом, потім — з такою самою назвою будь-де в дереві (від останнього рівня до кореня), і лише потім створює гілку. Дублів на кшталт «Ноутбуки (2)» не буде, доки назви збігаються.
Лоти без категорії лягають у службову категорію «Товари - ebay», товари з рядків замовлень, яких немає в каталозі, — у «Товари - ebay - назва вашого шаблона». Обидві вимкнені й без вивантаження. Переносьте картки з них вільно: повторний прогін місця в дереві не змінює. Детальніше — службові категорії.
Видалення категорії забирає з собою всю гілку разом із товарами, для яких вона основна, — з описами, фото, характеристиками й питаннями. Спершу перенесіть картки, потім видаляйте. Рядки вже заведених документів не постраждають: у документі лежать власні копії назви, ціни й кількості.
Що робить повторний прогін із вашими правками
Повторний запуск шукає вже заведену картку за назвою. Номер лота (ItemID) зберігається окремо як прив'язка до лістингу — для зворотного оновлення цін і залишків. Загальна механіка — імпорт каталогу через API.
- Перезаписуються з eBay: назва, повний опис, ціна, кількість, статус наявності, «Активність», а виробник, артикул і назва родини — коли в лоті заповнені. Попередження не буде.
- Порожнім не затираються: стара ціна, штрихкод і теги — eBay їх не віддає, ваші значення лишаються. Кількість і «Активність» записуються завжди, нуль теж.
- Не чіпаються у вже заведеної картки: фото (лише нові картки), характеристики (нові не дописуються), місце в дереві категорій.
Закріпити картку цілком — перемикач «Не оновлювати» в секції «Захист під час імпорту» картки (той самий прапорець — колонка «Не оновлювати (прапор)» у вікні «Товари»). Зберегти лише ціну — «Фіксована ціна»: назву, опис і кількість прогін оновлює, ціни лишаються вашими. Детальніше — як закріпити своє значення.
1
Не оновлювати2
Фіксована ціна- Не оновлювати — прогін eBay пропускає картку цілком.
- Фіксована ціна — прогін eBay не змінює ціну картки.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Перейменували лот у кабінеті eBay — наступний прогін не впізнає стару картку й заведе нову. Стара лишиться зі старими цінами, і разом вони виглядатимуть як дублікат. Якщо назви лотів міняються часто, звіряйте каталог після прогону відбором за колонкою «Дата оновлення».
Лот завершився або його зняли з продажу
Elbuz просить у eBay лоти, що завершуються від сьогодні і на 120 днів уперед, і бере тільки ті, у яких стан лістингу активний.
| Що сталося на eBay | Що буде з карткою в Elbuz |
|---|---|
| Лот завершився або знятий з продажу | Нічого: лишається з останньою ціною, залишком і увімкненою «Активністю», без рядка в журналі. Прибирайте її руками |
| Лот активний, але товар розкупили | Кількість приходить нульовою, статус — «Немає на складі» |
Галочки «видаляти те, чого немає в джерелі» у формі eBay немає. Загальне правило — товар зник із джерела.
Якщо зняти «Активність» з картки
Кожен активний лот приїжджає з увімкненою «Активністю», і прогін її перезаписує: зняли — наступний прогін мовчки ввімкне назад. Щоб вимкнення трималося, поставте картці «Не оновлювати». Дані картки при вимкненні не губляться — фото, характеристики й прив'язка до лістингу лишаються.
Як забирати замовлення eBay
Те саме підключення забирає нові й змінені замовлення — увімкніть галочку «Замовлення». Кожне лягає документом «Замовлення покупця», непроведеним: залишок і резерв не рухаються, поки ви не проведете документ.
- Позиції зв'язуються з картками за номером лота (для варіації — номер лота плюс SKU). Картки немає — вона створюється в службовій категорії з ціною й кількістю з рядка. Тому каталог розумно завантажити першим.
- Статус береться зі зіставлення: стан виконання — кнопкою «Статуси замовлення», стан оплати — «Статуси оплати» (секція «Пов'язані налаштування»). Не зіставлене отримує перший статус довідника. Стану доставки eBay у цьому обміні не віддає.
- Історія: перший прогін забирає всю, наступні — тільки змінене. Точка відліку — секція «Розширене», поле «Завантаження замовлень починаючи з дати (РРРР-ММ-ДД)»; далі Elbuz зсуває її сам.
1
Статуси замовлення2
Статуси оплати3
Дата початку завантаження замовлень- Статуси замовлення — зіставлення статусів замовлень eBay зі статусами Elbuz.
- Статуси оплати — зіставлення статусів оплати.
- Завантаження замовлень починаючи з дати (РРРР-ММ-ДД) — з якої дати брати замовлення.
Старі замовлення зі зміненим на eBay статусом оновлюються, а не дублюються — але тільки непроведені. Ваш статус обробки прогін міняє лише тоді, коли статус на eBay справді змінився з минулого разу. Загальна механіка — два статуси одного замовлення.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Оновлення за розкладом і денні ліміти
Коли підключення перевірено, поставте шаблон на розклад кнопкою «Налаштування розкладу» в картці «Повʼязані налаштування». eBay має денні ліміти звернень, спільні на застосунок: надто частий розклад для великого асортименту впиратиметься в них. Великий каталог оновлюйте рідше — наприклад, раз на добу вночі.
Журнал показує числа:
- на кожну сторінку — «eBay: сторінка каталогу 3, отримано товарів: 240»;
- підсумок — «eBay: каталог завантажено, товарів (включно з варіаціями)» з числом;
- далі «Оновлення значень на основі формул» і «Завантаження даних завершено!» з «Витрачено часу»;
- помилка майданчика — червоним, із текстом причини від eBay.
Загальне про журнал — як перевірити, що завантаження пройшло.
Скільки триває прогін
| Що | Сторінка | Очікування відповіді |
|---|---|---|
| Каталог | 100 лотів, пауза 1 с | до 180 с |
| Замовлення | 50 замовлень, пауза 2 с | до 120 с |
Товари пишуться в каталог пачками по 500 позицій прямо під час прогону; стелі на кількість немає. На відмову через ліміт (а для каталогу — й на помилку з боку eBay) запит повторюється до трьох разів із паузою 2, потім 4 секунди. Тривалість вашого каталогу видно в колонці «Витрачено часу» і в «Історії запусків».
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Що повертається на eBay
Завантаження назад нічого не віддає: це робить шаблон у вікні «Вивантаження даних» зі своїм розкладом (шаблони вивантаження). На eBay він передає тільки ціну й залишок за прив'язкою, яку створило завантаження; опис, фото й категорія лістингу лишаються за eBay.
Нові лоти публікує галочка «Публікувати нові товари» шаблону вивантаження. Потрібні зіставлена категорія eBay і налаштовані в Seller Hub адреса складу й бізнес-політики (доставка, оплата, повернення) — інакше журнал напише, що публікація неможлива, а товари пропустяться.
Сценарії
Уперше завести асортимент eBay у каталог
Увімкніть «Товари» і «Фото», «Замовлення» поки лишіть вимкненими. Натисніть «Перевірити підключення», потім запустіть завантаження. Вийде: кожен активний лот стає карткою, кожна варіація — окремою карткою, категорії розгортаються за шляхом з eBay, фото приходять з новими картками. Лоти без категорії ляжуть у вимкнену «Товари - ebay».
Щоночі оновлювати ціни й залишки, не втрачаючи своєї роботи над карткою
Поставте шаблон з «Товарами» на нічний розклад. Карткам, де ціну ведете самі, увімкніть «Фіксована ціна»; тим, які прогін не повинен чіпати, — «Не оновлювати». Вийде: ціна, кількість і наявність щоночі приходять з eBay; фото, наявні характеристики й місце в дереві лишаються. Назву й опис прогін поверне з лота, а картку завершеного лота доведеться прибрати руками.
Забирати з eBay лише замовлення, а каталог вести в Elbuz
Вимкніть «Товари», увімкніть «Замовлення» і спершу зіставте статуси кнопками «Статуси замовлення» і «Статуси оплати». Вийде: рядки прив'язуються до карток за номером лота, а без прив'язки — до картки з точно такою назвою. Не збіглася назва — з'явиться нова картка в «Товари - ebay - назва шаблона».
Керувати цінами варіацій на eBay з Elbuz
Проставте кожній варіації SKU в кабінеті eBay і завантажте каталог. Вийде: варіація прив'яжеться до лістингу за парою «номер лота + SKU», і вивантаження оновлюватиме на eBay її ціну й залишок. Варіацію без SKU вивантаження пропустить.
Що робити, коли eBay не завантажується
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «eBay: акаунт не підключено» | Прив'язку не виконано і токен не введено — прогін навіть не звертається до eBay | Прив'яжіть акаунт кодом (як підключити) |
| «Підключення не вдалося» з текстом від eBay | Доступ протермінований або ручний токен недійсний | Прив'яжіть акаунт заново або замініть user-токен (що потрібно від eBay) |
| «eBay: помилка API —» з текстом причини | Найчастіше — протермінований доступ або вичерпаний денний ліміт | Натисніть «Перевірити підключення»; якщо справа в ліміті — зменште частоту розкладу (розклад і ліміти) |
| Товарів у каталозі менше, ніж лотів у кабінеті | Приходять лише активні лоти; завершені й чернетки — ні | Нічого — так задумано (лот завершився) |
| Два однакові товари з різними назвами | Лот перейменували на eBay — прогін завів нову картку | Видаліть стару: вона знаходиться за старою «Датою оновлення» (повторний прогін) |
| Ціна варіації на eBay не оновлюється | У варіації немає SKU — адресувати її на eBay нічим | Проставте SKU в кабінеті eBay і завантажте каталог ще раз (варіації) |
Якщо прогін обірвався або його зупинили
Після помилки eBay прогін зупиняється одразу за невдалою сторінкою. Те, що встигло записатися пачками, лишається оновленим, решта — зі старими даними. Запустіть прогін ще раз: він почне з першої сторінки, дублів не буде, а націнки й пошукові дані доробить наприкінці. Загальна механіка — якщо прогін обірвався.
- Увімкнені й товари, й замовлення — після невдалого каталогу замовлення все одно забираються, але підсумок прогону — невдача.
- Кнопка «Зупинити» в Центрі операцій — прогін дочитує поточну сторінку, записує прийняте й відпрацьовує завершальні кроки. Журнал пише помаранчевий рядок «eBay: завантаження зупинено, записано товарів: N — каталог завантажено не повністю». Так само зупиняються й замовлення.
Якщо завантажили не те
Створене цим підключенням відбирається у вікні «Товари» за колонками «Джерело: назва» (назва шаблона) і «Джерело: код» (ebay) і видаляється пакетом — навіть після видалення шаблона. Перезаписані картки шукайте за «Датою оновлення»; масово повернути старі значення не вийде. Детальніше — якщо завантажили не те.
Часті запитання
Чи зберігаються категорії лотів?
Так. Elbuz розгортає повний шлях категорії eBay, тож розділи каталогу зберігають структуру, а не приходять пласким списком (категорії).
Повторний імпорт задвоїть лоти?
Ні, поки назви лотів не міняються: прогін знаходить картку за назвою й перезаписує її. Перейменований на eBay лот дасть нову картку, а стара лишиться зі старими даними.
Чому в картках немає старої ціни й штрихкоду?
eBay їх не віддає. Те, що ви вписали в ці поля руками, прогін не затирає (повторний прогін).
Можна тягнути з eBay тільки замовлення?
Так. Вимкніть «Товари» й увімкніть «Замовлення» в картці «Вибір даних для завантаження» (сценарій).
Чи зрушить залишок, коли приїде замовлення з eBay?
Ні. Замовлення лягає непроведеним документом «Замовлення покупця», а він не змінює ні залишку, ні резерву, поки ви його не проведете.
Чи може Elbuz виставити на eBay нові лоти?
Так, галочкою «Публікувати нові товари» в шаблоні вивантаження — за зіставленої категорії eBay і налаштованих у Seller Hub адреси складу й бізнес-політик (що повертається на eBay).
Суміжні теми
- Якщо треба зрозуміти, як шаблон завантаження поводиться з будь-яким джерелом, — Завантаження даних у каталог.
- Якщо підключаєте ще й інші майданчики через API — Імпорт каталогу через API.
- Якщо замовлення з eBay треба звести з іншими каналами — Завантаження замовлень із майданчиків.
- Якщо каталог зведено і далі треба ціни й наявність з прайсів постачальників — З чого почати і куди рухатися.

