Імпорт каталогу з Amazon через API

5 хв

Amazon — найбільший маркетплейс світу, і якщо ви на ньому продаєте, ваш каталог уже живе в кабінеті продавця (Seller Central). Elbuz забирає товари напряму через офіційний інтерфейс Amazon — SP-API — і зводить їх у ваш базовий каталог, де ви керуєте цінами й наявністю та роздаєте асортимент на інші канали.

Ця стаття — про підключення саме Amazon. Загальний порядок для будь-якого API-джерела описано в огляді імпорту каталогу через API; тут — особливості Amazon: як відбувається прив'язка, навіщо Marketplace ID і що приходить у каталог. Про завантаження даних загалом дивіться огляд завантаження.

Де це у програмі

У вікні імпорту створіть шаблон і оберіть тип «Amazon». Це API-джерело: файл не потрібен. Один шаблон — одне підключення до одного акаунта продавця й однієї площадки Amazon.

Як відбувається підключення

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

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

Marketplace ID — обов'язкове поле

Amazon працює як набір окремих площадок по країнах, і кожна має свій Marketplace ID. Це поле обов'язкове: за ним Elbuz розуміє, з якою країною ви працюєте, і сам обирає правильний регіональний сервер Amazon (Європа, Північна Америка чи Далекий Схід). Приклади: Німеччина — A1PA6795UKMFR9, Польща — A1C3SOZRARQ6R3, США — ATVPDKIKX0DER. Marketplace ID вашої площадки можна подивитися в довідці Seller Central або в налаштуваннях акаунта.

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

Створіть шаблон типу «Amazon». Виконайте прив'язку застосунку кодом у відповідній картці — Seller ID підставиться сам. Укажіть Marketplace ID вашої площадки. Скористайтесь кнопкою «Перевірити підключення», щоб переконатися, що доступ працює. Потім у блоці «Що завантажувати» увімкніть потрібне — товари, а за потреби й замовлення — збережіть і запустіть.

Що потрапляє в каталог

Каталог Amazon Elbuz забирає у два кроки, і це варто розуміти. Спершу Amazon готує звіт з усіма вашими лістингами — для великого каталогу це триває кілька хвилин, програма чекає, доки звіт буде готовий. Потім Elbuz дозбирує деталі по товарах (назви, зображення, характеристики) через каталожний інтерфейс Amazon, звертаючись пачками. У підсумку в базовий каталог приходять товари з цінами, залишками, зображеннями й характеристиками. Позиції впізнаються за артикулом (SKU) і кодом ASIN, тож повторні запуски оновлюють наявні картки, а не задвоюють їх. Батьківські й дочірні позиції (товар та його варіанти) Amazon пов'язує через ASIN, і Elbuz зберігає цей зв'язок, а не розсипає варіанти на окремі непов'язані картки.

Каталог і замовлення

Те саме підключення вміє забирати не лише каталог, а й замовлення — вони тягнуться опитуванням за розкладом. Персональні дані покупців Amazon за замовчуванням не віддає, тож у Elbuz приходить сам факт і склад замовлення, без приватних відомостей. Ця стаття — про каталог; якщо потрібні замовлення, увімкніть відповідний перемикач у шаблоні.

Seller Central добре тримає лістинги, але керувати великим асортиментом і одночасно кількома каналами продажу з нього незручно. Elbuz забирає каталог Amazon до себе й дає єдине місце, де ви рахуєте ціни за правилами націнок, стежите за наявністю й наповнюєте картки. Ціни й залишки можна тримати актуальними автоматично — вони тягнуться з прайсів постачальників, а звідти розходяться на канали.

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

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

Коли підключення налаштовано й перевірено, поставте шаблон на розклад кнопкою налаштування завдання прямо у формі. Elbuz сам звертатиметься до Amazon за свіжими даними. Через те, що каталог готується звітом, надто частий розклад сенсу не має — для великого асортименту розумно оновлюватися рідше. Кожен запуск лишає слід у журналі: скільки товарів оновлено, скільки додано, чи були помилки; перші кілька разів варто туди зазирати.

Часті труднощі

Перша типова заминка — Marketplace ID. Якщо його не вказано або вказано від іншої країни, Elbuz звертатиметься не до тієї площадки, і каталог або не приїде, або приїде не той. Перевірте, що Marketplace ID відповідає саме тій країні, де ви продаєте.

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

Перед першим повним завантаженням натисніть «Перевірити підключення» й переконайтесь, що прив'язка й Marketplace ID правильні. Це заощадить час: краще побачити помилку доступу одразу, ніж чекати кілька хвилин на звіт і лише потім дізнатися, що площадку вказано не ту.

Що далі після завантаження

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

Якщо ви тільки починаєте, орієнтуйтеся на загальну карту дій — з чого почати і куди рухатися. Там по кроках показано весь шлях: від підключення джерела до автооновлення цін, наявності й додавання новинок. Стаття, яку ви читаєте, закриває саме перший крок цього шляху для Amazon — підключення й завантаження каталогу.

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

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

Де взяти токен доступу Amazon?

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

Що таке Marketplace ID і де його взяти?

Це ідентифікатор площадки Amazon по країні. За ним Elbuz обирає правильний регіональний сервер. Приклади: Німеччина A1PA6795UKMFR9, Польща A1C3SOZRARQ6R3, США ATVPDKIKX0DER. ID вашої площадки є в довідці Seller Central.

Чому перше завантаження триває кілька хвилин?

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

Я продаю на Amazon у кількох країнах — як бути?

Під кожну площадку заведіть окремий шаблон зі своїм Marketplace ID. Товари з усіх площадок зводитимуться в один базовий каталог Elbuz.

Чи приходять дані покупців із замовленнями?

Ні. Amazon за замовчуванням не віддає персональні дані покупців, тож у Elbuz приходить факт і склад замовлення без приватних відомостей.

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