Як завантажити каталог з eBay: активні лоти, варіації й замовлення

27 хв

Elbuz забирає активні лоти й замовлення вашого акаунта продавця eBay напряму через API і зводить їх у базовий каталог поруч з іншими каналами продажу.

Коли це знадобиться:

  • Асортимент eBay треба мати в каталозі — кожен активний лот і кожна варіація стають картками з ціною, залишком і категорією.
  • eBay — лише один із ваших майданчиків — товар редагуєте в Elbuz, а ціна й залишок вивантажуються назад на eBay.
  • Ціни й залишки мають оновлюватися щодня — шаблон на розкладі робить це сам, з урахуванням денних лімітів eBay.
  • Замовлення eBay треба вести разом з іншими — кожне лягає документом «Замовлення покупця».

З чого почати: прив'яжіть акаунт eBay кодом у шаблоні завантаження.

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

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

Меню
Довідники → Операції → Завантаження даних
Шаблон
новий шаблон → тип «eBay»; один шаблон — один акаунт продавця
Право доступу
вікно «Завантаження даних» у «Правах груп»
Підготувати
вхід в акаунт продавця eBay для підтвердження доступу
Форма підключення шаблону «Мій магазин eBay» — картка «Підключення»
1User-токен eBay
2Кнопка «Перевірити підключення»
  1. User-токен eBay — вставте сюди токен, якщо не підключаєтесь через застосунок.
  2. Кнопка «Перевірити підключення» перевіряє зв'язок з акаунтом eBay без завантаження даних.

Як працюють шаблони завантаження загалом — огляд завантаження даних.

Що потрібно від eBay: прив'язка застосунку або user-токен

Доступ дається одним із двох способів:

  • Прив'язка застосунку кодом — основний спосіб. Токен видається й оновлюється автоматично, доступ живе довго й продовжується сам; поле токена лишається порожнім.
  • Ручний user-токен вашого застосунку eBay — переважно для розробки чи тестового середовища. Ручний токен завжди в пріоритеті над отриманим через прив'язку.

Як підключити крок за кроком

  1. Створіть шаблон типу «eBay».
  2. Натисніть «Підключити», увійдіть на eBay і підтвердьте доступ.
  3. Введіть показаний код у поле «Код прив'язки» і натисніть «Прив'язати магазин». Працюєте з власним застосунком — замість цього вставте user-токен.
  4. Натисніть «Перевірити підключення».
  5. У картці «Вибір даних для завантаження» увімкніть товари, за потреби й замовлення, збережіть і запустіть.

Прив'язка одна на акаунт eBay: підключили в шаблоні завантаження — шаблон вивантаження працює з тим самим доступом, і навпаки. Кнопка «Підключити» й поле «Код прив'язки» є в обох шаблонах.

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

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

Що саме тягнути, вмикають галочки картки «Вибір даних для завантаження».

Картка «Вибір даних для завантаження» у шаблоні eBay
1Товари
2Фото
3Замовлення
  1. Товари — завантажувати листинги eBay як товари каталогу.
  2. Фото — завантажувати зображення листингів.
  3. Замовлення — отримувати замовлення з 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Фіксована ціна
  1. Не оновлювати — прогін eBay пропускає картку цілком.
  2. Фіксована ціна — прогін eBay не змінює ціну картки.
Що прогін робить з одним лотом. Ліва гілка — лот, якого в каталозі ще немає, права — уже заведена картка: два жовті ромби праворуч і є ваші два способи її захистити.
НіТакТакНіТакНіАктивний лот або варіаціяприйшли в прогоніЄ картка з такою самою назвою?Нова картка: поля лота,характеристики,фото — якщо ввімкнено «Фото»У картці ввімкнено«Не оновлювати»?Картка лишається без змінНазва, опис, кількість і«Активність» — з лота.Порожнє з eBay не затирає ваше—стара ціна, штрихкод і тегилишаютьсяУвімкнено«Фіксована ціна»?Ціна лишається вашаЦіна — з лотаФото, наявні характеристикий категорія не чіпаються
  • Дія або результат
  • Розвилка: далі шлях залежить від відповіді

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

Лот завершився або його зняли з продажу

Elbuz просить у eBay лоти, що завершуються від сьогодні і на 120 днів уперед, і бере тільки ті, у яких стан лістингу активний.

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

Галочки «видаляти те, чого немає в джерелі» у формі eBay немає. Загальне правило — товар зник із джерела.

Якщо зняти «Активність» з картки

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

Як забирати замовлення eBay

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

  • Позиції зв'язуються з картками за номером лота (для варіації — номер лота плюс SKU). Картки немає — вона створюється в службовій категорії з ціною й кількістю з рядка. Тому каталог розумно завантажити першим.
  • Статус береться зі зіставлення: стан виконання — кнопкою «Статуси замовлення», стан оплати — «Статуси оплати» (секція «Пов'язані налаштування»). Не зіставлене отримує перший статус довідника. Стану доставки eBay у цьому обміні не віддає.
  • Історія: перший прогін забирає всю, наступні — тільки змінене. Точка відліку — секція «Розширене», поле «Завантаження замовлень починаючи з дати (РРРР-ММ-ДД)»; далі Elbuz зсуває її сам.
Картка «Повʼязані налаштування» з розкритим блоком «Розширене»
1Статуси замовлення
2Статуси оплати
3Дата початку завантаження замовлень
  1. Статуси замовлення — зіставлення статусів замовлень eBay зі статусами Elbuz.
  2. Статуси оплати — зіставлення статусів оплати.
  3. Завантаження замовлень починаючи з дати (РРРР-ММ-ДД) — з якої дати брати замовлення.

Старі замовлення зі зміненим на eBay статусом оновлюються, а не дублюються — але тільки непроведені. Ваш статус обробки прогін міняє лише тоді, коли статус на eBay справді змінився з минулого разу. Загальна механіка — два статуси одного замовлення.

Одне замовлення eBay у прогоні. Верхній ромб — прив'язка рядків до карток каталогу, нижче — чи створюється новий документ і коли прогін має право змінити ваш статус у вже наявному.
НіТакНіТакТакНіТакНіТакНіСторінка замовлень eBayпо 50Картку для рядка знайденоза номером лота або назвою?Картка створюється в категорії«Товари - ebay - назва шаблона»Замовлення вже є в Elbuz?Новий документ «Замовленняпокупця»непроведенийПерший прогінбез дати відліку?Документ не змінюєтьсяДокумент проведений?Статус на eBay змінивсяз минулого разу?Ваш статус — зі зіставленнястан оплати — якщо зіставленоВаш статус лишаєтьсястан оплати — якщо зіставлено
  • Дія або результат
  • Розвилка: далі шлях залежить від відповіді

Оновлення за розкладом і денні ліміти

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

Журнал показує числа:

  • на кожну сторінку — «eBay: сторінка каталогу 3, отримано товарів: 240»;
  • підсумок — «eBay: каталог завантажено, товарів (включно з варіаціями)» з числом;
  • далі «Оновлення значень на основі формул» і «Завантаження даних завершено!» з «Витрачено часу»;
  • помилка майданчика — червоним, із текстом причини від eBay.

Загальне про журнал — як перевірити, що завантаження пройшло.

Скільки триває прогін

ЩоСторінкаОчікування відповіді
Каталог100 лотів, пауза 1 сдо 180 с
Замовлення50 замовлень, пауза 2 сдо 120 с

Товари пишуться в каталог пачками по 500 позицій прямо під час прогону; стелі на кількість немає. На відмову через ліміт (а для каталогу — й на помилку з боку eBay) запит повторюється до трьох разів із паузою 2, потім 4 секунди. Тривалість вашого каталогу видно в колонці «Витрачено часу» і в «Історії запусків».

Прогін каталогу по сторінках. Цикл праворуч повторюється, доки eBay віддає сторінки, пачки по 500 пишуться в каталог по дорозі, а націнки й пошукові дані рахуються один раз — наприкінці.
ТакНіТакНіТакНіНіТакЗапит сторінки каталогу eBayпо 100 лотівeBay відповів помилкою?Червоний рядок «eBay: помилкаAPI —»прогін зупиненоБеруться лише активні лотиваріація — окремий товарНабралося 500 товарів?Пачка записується в каталогЄ ще сторінки і не натиснуто«Зупинити»?Пауза 1 секундаДописується остання неповнапачкапотім націнки, сортувальні йпошукові даніНатиснуто «Зупинити»?«eBay: каталог завантажено»Помаранчевий рядок«eBay: завантаження зупинено,записано товарів: N —каталог завантажено не повністю»
  • Дія або результат
  • Розвилка: далі шлях залежить від відповіді

Що повертається на 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).

Суміжні теми

Чи була стаття корисною?