Як завантажити каталог з Amazon: прив'язка застосунку і Marketplace ID

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

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

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

Меню

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

Шаблон

новий шаблон → тип «Amazon»; один шаблон — один акаунт і одна площадка

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

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

Підготувати

вхід у Seller Central і Marketplace ID вашої площадки

1

Поле Seller ID

2

Поле Marketplace ID майданчика

1. Seller ID заповнюється автоматично після прив'язки застосунку.
2. Marketplace ID майданчика — код регіону Amazon (наприклад, США ATVPDKIKX0DER).

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

Що потрібно від Amazon: прив'язка застосунку і Marketplace ID

Прив'язка застосунку кодом

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

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

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

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

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

1. Створіть шаблон типу «Amazon» і спершу вкажіть Marketplace ID: від нього залежить, куди поведе «Підключити» — на вхід Amazon для Європи чи для Північної Америки (US, CA, MX, BR).
2. Натисніть «Підключити», підтвердіть доступ, введіть код у «Код прив'язки» → «Прив'язати магазин».
3. Натисніть «Перевірити підключення».
4. У картці «Вибір даних для завантаження» увімкніть товари, за потреби — замовлення; збережіть і запустіть.

Прив'язка одна на акаунт Amazon: зробили її в шаблоні завантаження — шаблон вивантаження працює з тим самим доступом, і навпаки.

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

Не приходять з Amazon: характеристики (у звіті їх немає — заповнюєте у своєму каталозі), стара ціна і штрихкод. Артикул продавця, ASIN і батьківський ASIN зберігаються в прив'язці картки — за артикулом продавця потім ідуть зворотні оновлення цін і залишків.

Чому каталог збирається у два кроки

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

У звіті артикул, назва, опис, ціна, кількість, ASIN і стан лістингу. Потім Elbuz дозбирує довідкові дані за ASIN — бренд, категорію, фото, зв'язок варіантів — пачками по 20 кодів із паузою: Amazon жорстко обмежує частоту звернень.

Варіанти й категорія

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

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

Що робить повторний прогін з вашими правками

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

• Перезаписується зі звіту: назва, опис, ціна, кількість, активність, бренд і «Артикул (SKU)» — без попередження.
• Порожнє не затирає вашого: штрихкоду, старої ціни й тегів у звіті немає, тож заповнені руками значення лишаються; нульова ціна в наявній картці теж не записується. Кількість 0 записується як є — статус «Немає на складі».
• Не чіпаються: фото (додаються тільки новим карткам), характеристики, місце в дереві категорій.
• Правила націнки проходять лише по щойно створених картках; у наявній лишається сума, яку віддав Amazon.

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

1

Не оновлювати

2

Фіксована ціна

1. Не оновлювати — закриває картку від прогону Amazon повністю.
2. Фіксована ціна — прогін Amazon не змінює ціну товару.

Дві площадки Amazon в один каталог

Під кожну площадку — свій шаблон зі своїм Marketplace ID. Далі все залежить від назв лістингів:

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

Прив'язка до Amazon у картки одна: її рядок (артикул продавця, ASIN, тип товару) створює шаблон, що дійшов до картки першим. Зворотне оновлення піде за його артикулом. Розвести джерела можна лише позначкою «Не оновлювати».

Лістинг зник або перестав бути активним

Загальне правило — товар зник із джерела.

Що дає зняття «Активності»

Вимкнена картка з усіма даними лишається в каталозі; змінюється відбір у вивантаження — нові шаблони беруть тільки активні товари. Увімкнули назад — усе як було.

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

Як завантажувати замовлення Amazon

Увімкніть «Замовлення» в картці «Вибір даних для завантаження» — вони тягнуться опитуванням за розкладом. Персональних даних покупців Amazon не віддає: з адреси доїжджають лише місто, індекс і країна.

• Документ — «Замовлення покупця», непроведений: залишок і резерв не зміняться, доки документ не проведуть.
• Номер Amazon стає номером у джерелі; повторне завантаження дубля не створює.
• Позиції чіпляються до карток за артикулом продавця (SKU).
• Статуси — за зіставленням у секції «Повʼязані налаштування»: стан замовлення — «Статуси замовлення», спосіб оплати — «Статуси оплати», рівень доставки — «Види доставки». Не зіставлений стан лягає першим статусом довідника.

1

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

2

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

3

Види доставки

4

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

1. Статуси замовлення — зіставлення статусів замовлень Amazon зі статусами каталогу.
2. Статуси оплати — зіставлення статусів оплати.
3. Види доставки — зіставлення способів доставки.
4. Завантаження замовлень починаючи з дати — з якої дати Amazon віддає замовлення.

Перший прогін забирає всю історію, далі — лише змінене після дати останнього завантаження. Дата в секції «Розширене», поле «Завантаження замовлень починаючи з дати (РРРР-ММ-ДД)»; порожня — «тягнути все спочатку».

Склад кожного замовлення запитується окремо. Не вдався запит — прогін зупиняється червоним рядком «Amazon: помилка API — …», замовлення поточної сторінки не зберігаються, а дата не зсувається: наступний прогін запитає їх знову.

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

Як оновлювати ціни й залишки на Amazon

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

• Відправляються ціна й залишок — по запиту на артикул із паузою чверть секунди (ліміт Amazon). У журналі: «Amazon: ціни та залишки оновлено, позицій: 120 (помилок: 0)».
• Працює лише для карток із прив'язкою до лістингу, тобто тих, що приїхали з Amazon; решта пропускається рядком «Amazon: пропущено позицій без прив`язки до лістингів Amazon».
• Потрібен заповнений Seller ID, інакше — «Amazon: не підключено акаунт, не вказано Seller ID або Marketplace ID».

Щоб виставити товари, яких на Amazon ще немає, увімкніть у шаблоні вивантаження «Публікувати нові товари». Зі штрихкодом EAN чи UPC Elbuz публікує пропозицію на наявну картку Amazon, без штрихкоду — заводить нову, і тоді в категорії товару має бути зіставлений тип товару Amazon. Чого бракує, скаже рядок «Amazon: не опубліковано нових товарів».

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

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

Сценарії

Звести каталог однієї площадки й тримати його свіжим

Що ввімкнути. Шаблон типу «Amazon» з «Marketplace ID майданчика» вашої країни; у «Вибір даних для завантаження» — «Товари» і «Фото»; розклад кнопкою «Налаштування розкладу».

Що вийде. Кожен рядок звіту стає карткою з назвою, описом, ціною, кількістю й артикулом, а з довідника Amazon доїжджають бренд, категорія, фото й сімʼя варіантів. Фото отримують лише нові картки, зняті з Amazon лістинги прибирайте руками.

Складом керуєте в Elbuz, а Amazon лише продає

Що ввімкнути. У картках — «Не оновлювати» в секції «Захист під час імпорту»; окремо — шаблон вивантаження типу «Amazon» із Seller ID і Marketplace ID.

Що вийде. Прогін каталогу такі картки не змінює, а вивантаження відправляє на Amazon ціну й залишок з Elbuz. Назву, опис і фото лістингу вивантаження не чіпає.

Потрібні лише замовлення, каталог ведете інакше

Що ввімкнути. Тільки «Замовлення», «Товари» вимкнено; за потреби — дата в полі «Завантаження замовлень починаючи з дати (РРРР-ММ-ДД)».

Що вийде. Каталог прогін не торкає, кожне замовлення лягає документом «Замовлення покупця» з позиціями за артикулом продавця. Вулиці й телефону покупця не буде — Amazon їх не віддає.

Виставити на Amazon товари, яких там ще немає

Що ввімкнути. У шаблоні вивантаження — «Публікувати нові товари»; у картках — EAN або UPC, а для товарів без штрихкоду — зіставлений тип товару Amazon у категорії.

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

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

Якщо прогін обірвався

Порядок роботи: замовлення звіту, очікування, завантаження звіту, дозбір даних за ASIN і лише потім запис у каталог пачками по 500. До кінця дозбору ASIN у каталог не пишеться нічого: обрив на перших етапах, зокрема невдала пачка ASIN, лишає каталог без змін. Обрив на записі лишає записані пачки оновленими. Загальне — якщо прогін обірвався.

Повтор безпечний — дублів не буде, але звіт замовляється заново: продовження з місця обриву немає.

• Готовність звіту перепитується до 60 разів, пауза зростає до 15 секунд; далі — «Amazon: помилка API — report timeout».
• Одну відповідь Amazon програма чекає до 120 секунд, файл звіту завантажує з лімітом 300 секунд.
• На HTTP 429 запит повторюється до трьох разів із паузами 3, 6 і 9 секунд.

Якщо вказали не той Marketplace ID

Європейські коди ведуть на європейський сервер, далекосхідні — на далекосхідний, а будь-який інший код (зокрема з помилкою) — на північноамериканський. «Перевірити підключення» відповідає «Підключення працює. Amazon», але сам Marketplace ID не звіряє: німецький код замість польського вона пропустить.

• Код з іншого регіону — червоний рядок «Amazon: помилка API — …», каталог не змінився.
• Код площадки, де ви не продаєте — «Amazon: каталог завантажено, товарів: 0», каталог не змінився.
• Код сусідньої площадки, де ви продаєте — приїде каталог іншої країни й перезапише ваші картки за збігом назв.

Третій випадок шукайте у «Товарах» за «Датою оновлення» на день прогону; нові картки — за «Джерело: назва» і в категорії «Товари - amazon». Масового відкату немає; окремо зберігається лише ціна, якщо ввімкнено історію цін. Детальніше — якщо завантажили не те.

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

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

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

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

Amazon спершу готує звіт з усіма лістингами, а Elbuz потім дозбирує деталі за ASIN. Це нормальний хід, а не зависання (два кроки).

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

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

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

Ні. Amazon не віддає персональних даних: приходить склад замовлення, а з адреси — місто, індекс і країна.

Чи затре повторний прогін мої правки в картці?

Так: назву, опис, ціну, кількість і активність перезапише. Штрихкод, стару ціну й теги, фото, характеристики й категорію не чіпає. Закріпити картку — «Не оновлювати» (повторний прогін).

Чи можна тримати свою ціну на частині товарів Amazon?

Так: увімкніть у картці «Фіксована ціна» (секція «Захист під час імпорту»). Ціну й стару ціну прогін не змінить, решту полів оновлюватиме як звичайно (повторний прогін).

Суміжні теми

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