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

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

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

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

Меню

Довідники → Операції → Завантаження даних

Шаблон

новий шаблон → тип «eBay»; один шаблон — один акаунт продавця

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

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

Підготувати

вхід в акаунт продавця eBay для підтвердження доступу

1

User-токен eBay

2

Кнопка «Перевірити підключення»

1. User-токен eBay — вставте сюди токен, якщо не підключаєтесь через застосунок.
2. Кнопка «Перевірити підключення» перевіряє зв'язок з акаунтом eBay без завантаження даних.

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

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

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

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

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

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

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

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

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

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

1

Товари

2

Фото

3

Замовлення

1. Товари — завантажувати листинги eBay як товари каталогу.
2. Фото — завантажувати зображення листингів.
3. Замовлення — отримувати замовлення з eBay.

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

• Залишок — реальна доступна кількість: 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 не змінює ціну картки.

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

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

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

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

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

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

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

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

1

Статуси замовлення

2

Статуси оплати

3

Дата початку завантаження замовлень

1. Статуси замовлення — зіставлення статусів замовлень eBay зі статусами Elbuz.
2. Статуси оплати — зіставлення статусів оплати.
3. Завантаження замовлень починаючи з дати (РРРР-ММ-ДД) — з якої дати брати замовлення.

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

Як опублікувати нові лоти на eBay

З галочкою «Публікувати нові товари» в шаблоні вивантаження Elbuz створює лот із вашої картки: фіксована ціна, заголовок до 80 символів, до 12 фото, EAN, стан, опис картки. Brand і MPN заповнюються самі: виробник і артикул.

• Категорія. Її зіставляють у вікні зіставлення категорій, для кожного сайту eBay (DE, FR, US тощо) можна окремо. Без жодного зіставлення товар не публікується: «eBay: не опубліковано нових товарів: N (немає зіставлення категорії eBay)».
• Обов'язкові аспекти. Вони зіставляються там само, з атрибутами товару. Для аспекта зі списком підходить лише варіант eBay, багатозначні значення пишуться через кому. Зіставлення аспекта одне на атрибут, тому якщо на сайтах ім'я аспекта різне, перевірте журнал кожного сайту. Без обов'язкового аспекта лот не створюється: «eBay: «…» — не заповнено обов'язкові аспекти категорії: …».
• Адреса складу й політики акаунта. Без них публікація неможлива, журнал скаже про це окремим рядком.

Варіації: одне сімейство — один лот

Товари одного сімейства (поле «Назва родини (варіації)»), якщо у вибірці їх два й більше, публікуються одним лотом із варіаціями. Варіанти мають відрізнятися атрибутами з позначкою «Опція товару», назва осі — це зіставлений аспект eBay або ваш атрибут. У журналі буде «eBay: сімейство «…» опубліковано одним лістингом з N варіантами (лістинг …)». Якщо варіанти не відрізняються або в одного варіанта не заповнений обов'язковий аспект, не публікується все сімейство, причину скаже журнал.

Ціна й залишок опублікованих лотів, зокрема варіантів, далі оновлюються за розкладом.

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

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

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

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

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

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

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

Що повертається на eBay

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

Нові лоти публікує галочка «Публікувати нові товари» шаблону вивантаження.

На який сайт eBay іде вивантаження

Сайт задає поле «Версія API (параметри майданчика)» шаблону вивантаження: EBAY_DE, EBAY_FR, EBAY_PL, EBAY_GB, EBAY_US тощо — будь-який із 19 сайтів eBay. Порожнє поле — EBAY_US. Мова лоту й валюта ціни — за сайтом: для EBAY_DE німецька й євро, для EBAY_PL польська й злоті. Продаєте на кількох сайтах — заведіть шаблон вивантаження на кожен.

Каталог, замовлення, ціни й залишки працюють з лотами на будь-якому сайті eBay. Для нового лота потрібні:

• категорія eBay цього сайту — у вікні зіставлення категорій на вкладці eBay виберіть сайт у списку й зіставте категорії; дерево категорій у кожного сайту своє. Без зіставлення для сайту береться категорія, зіставлена раніше без вибору сайту; немає й її — товар пропускається;
• адреса складу в акаунті й три бізнес-політики (доставка, оплата, повернення) для цього сайту в Seller Hub — інакше журнал напише «eBay: публікація нових лістингів неможлива…», а товари пропустяться;

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

Сценарії

Уперше завести асортимент eBay у каталог

Увімкніть «Товари» і «Фото», «Замовлення» поки лишіть вимкненими. Натисніть «Перевірити підключення», потім запустіть завантаження. Вийде: кожен активний лот стає карткою, кожна варіація — окремою карткою, категорії розгортаються за шляхом з eBay, фото приходять з новими картками. Лоти без категорії ляжуть у вимкнену «Товари - ebay».

Щоночі оновлювати ціни й залишки, не втрачаючи своєї роботи над карткою

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

Забирати з eBay лише замовлення, а каталог вести в Elbuz

Вимкніть «Товари», увімкніть «Замовлення» і спершу зіставте статуси кнопками «Статуси замовлення» і «Статуси оплати». Вийде: рядки прив'язуються до карток за номером лота, а без прив'язки — до картки з точно такою назвою. Не збіглася назва — з'явиться нова картка в «Товари - ebay - назва шаблона».

Керувати цінами варіацій на eBay з Elbuz

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

Що робити, коли eBay не завантажується

Якщо прогін обірвався або його зупинили

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

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

Якщо завантажили не те

Створене цим підключенням відбирається у вікні «Товари» за колонками «Джерело: назва» (назва шаблона) і «Джерело: код» (ebay) і видаляється пакетом — навіть після видалення шаблона. Перезаписані картки шукайте за «Датою оновлення»; масово повернути старі значення не вийде. Детальніше — якщо завантажили не те.

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

Чи зберігаються категорії лотів?

Так. Elbuz розгортає повний шлях категорії eBay, тож розділи каталогу зберігають структуру, а не приходять пласким списком (категорії).

Повторний імпорт задвоїть лоти?

Ні, поки назви лотів не міняються: прогін знаходить картку за назвою й перезаписує її. Перейменований на eBay лот дасть нову картку, а стара лишиться зі старими даними.

Чому в картках немає старої ціни й штрихкоду?

eBay їх не віддає. Те, що ви вписали в ці поля руками, прогін не затирає (повторний прогін).

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

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

Чи зрушить залишок, коли приїде замовлення з eBay?

Ні. Замовлення лягає непроведеним документом «Замовлення покупця», а він не змінює ні залишку, ні резерву, поки ви його не проведете.

Чи може Elbuz виставити на eBay нові лоти?

Так, галочкою «Публікувати нові товари» в шаблоні вивантаження — на будь-якому з 19 сайтів eBay, за зіставленої категорії цього сайту й налаштованих у Seller Hub адреси складу й бізнес-політик (сайт вивантаження).

Суміжні теми

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