eMAG — маркетплейс №1 у Румунії, а також працює в Болгарії та Угорщині. Якщо ви там продаєте, ваш каталог уже є в кабінеті продавця; Elbuz забирає товари напряму через Marketplace API eMAG і зводить їх у ваш базовий каталог, де ви керуєте цінами й наявністю та роздаєте асортимент на інші канали.
Ця стаття — про підключення саме eMAG. Загальний порядок для будь-якого API-джерела описано в огляді імпорту каталогу через API; тут — особливості eMAG: які дані потрібні, як обрати країну, навіщо білий список IP і вимога GPSR. Про завантаження даних загалом дивіться огляд завантаження.
Де це у програмі
У вікні імпорту створіть шаблон і оберіть тип «eMAG». Це API-джерело: файл не потрібен, підключення відбувається за логіном, паролем і країною. Один шаблон — одне підключення до однієї країни eMAG. Якщо ви продаєте в кількох країнах, під кожну заведіть окремий шаблон.
Що потрібно для підключення
eMAG не використовує токени чи «застосунки розробника» — підключення відбувається за трьома значеннями:
- API-логін — окремий логін для API з кабінету продавця eMAG (це не той самий логін, яким ви заходите у веб-кабінет; API-доступ видається окремо).
- API-пароль — пароль до цього API-доступу.
- Площадка (країна) —
ro(Румунія),bg(Болгарія) абоhu(Угорщина). За цим значенням Elbuz обирає правильну доменну зону API eMAG.
API-логін і пароль створюються в кабінеті продавця eMAG у розділі доступу до Marketplace API. Це окремі облікові дані саме для інтеграцій — не плутайте їх із логіном веб-кабінету.
Білий список IP — обов'язково
Головна особливість eMAG, через яку найчастіше «не працює»: маркетплейс приймає API-виклики лише з дозволених IP-адрес. Поки IP-адресу Elbuz не внесено до білого списку у вашому кабінеті eMAG, навіть правильні логін і пароль не спрацюють — eMAG просто відхилить звернення. Тому перший крок підключення — додати IP Elbuz у білий список у налаштуваннях доступу кабінету продавця. Потрібну IP-адресу підкаже підтримка Elbuz.
Вимога GPSR
Для товарів на європейських площадках eMAG діє регламент безпеки продукції GPSR: до карток мають бути прив'язані дані про відповідальну особу й виробника. У формі шаблону є окрема кнопка налаштувань GPSR — там ви задаєте ці дані, щоб вивантаження й робота з каталогом відповідали вимогам eMAG. Для самого завантаження каталогу в Elbuz GPSR не обов'язковий, але знадобиться, щойно ви працюватимете з публікацією товарів назад на eMAG.
Як підключити крок за кроком
Спершу внесіть IP Elbuz у білий список у кабінеті eMAG. Потім створіть шаблон типу «eMAG», введіть API-логін, API-пароль і оберіть країну. Скористайтесь кнопкою «Перевірити підключення» — вона робить легкий запит і одразу каже, чи приймає eMAG ваш доступ (це також швидка перевірка, чи спрацював білий список). Потім у блоці «Що завантажувати» увімкніть потрібне — товари, а за потреби й замовлення — збережіть і запустіть.
Що потрапляє в каталог
Із eMAG у базовий каталог Elbuz переносяться товари (оферти) з назвами, цінами, залишками, категоріями, зображеннями й характеристиками. eMAG віддає каталог сторінками, тож великий асортимент вантажиться поступово. Позиції впізнаються за їхніми ідентифікаторами, тож повторні запуски оновлюють наявні картки, а не задвоюють їх. Що саме брати, ви керуєте чекбоксами шаблону: можна тягнути все, а можна оновлювати лише ціни й наявність.
Каталог і замовлення
Те саме підключення вміє забирати не лише каталог, а й замовлення eMAG. Ця стаття — про каталог; якщо потрібні замовлення, увімкніть відповідний перемикач у шаблоні. Хочете тільки товари — лишіть замовлення вимкненими, зайве не завантажуватиметься.
Навіщо зводити каталог eMAG в Elbuz
Кабінет продавця eMAG добре тримає оферти, але керувати великим асортиментом і кількома країнами чи каналами з нього незручно. Elbuz забирає каталог eMAG до себе й дає єдине місце, де ви рахуєте ціни за правилами націнок, стежите за наявністю й наповнюєте картки контентом. Ціни й залишки можна тримати актуальними автоматично — вони тягнуться з прайсів постачальників, а звідти розходяться на канали. Продаєте в кількох країнах eMAG — під кожну свій шаблон, а товари зводяться в один каталог.
Оновлення за розкладом
Коли підключення налаштовано й перевірено, поставте шаблон на розклад кнопкою налаштування завдання прямо у формі. Elbuz сам звертатиметься до eMAG за свіжими даними: ціни й залишки оновлюватимуться, нові товари додаватимуться. Кожен запуск лишає слід у журналі: скільки товарів оновлено, скільки додано, чи були помилки; перші кілька разів варто туди зазирати.
Часті труднощі
Перша й найчастіша причина, чому нічого не тягнеться, — IP не в білому списку. Якщо логін і пароль точно правильні, а eMAG відхиляє звернення, майже завжди справа саме в цьому: внесіть IP Elbuz у білий список у кабінеті eMAG. Кнопка «Перевірити підключення» допоможе локалізувати проблему — вона робить легкий запит, який спирається саме на авторизацію й білий список.
Друга — плутанина з логіном. API-доступ eMAG це окремі логін і пароль, не ті, якими ви заходите у веб-кабінет. Якщо підставити «звичайні» дані входу, авторизація не пройде. І третє — країна: якщо обрати не ту площадку (ro замість bg тощо), Elbuz звертатиметься не до тієї доменної зони, і каталог не приїде.
Почніть із білого списку IP — це найчастіша причина відмов eMAG. Спершу внесіть IP Elbuz у кабінеті продавця, потім вводьте API-логін, пароль і країну, і лише тоді тисніть «Перевірити підключення». Так ви не гадатимете, у чому річ.
Що далі після завантаження
Завантажити каталог — це лише перший крок. Далі товари з eMAG живуть у вашому базовому каталозі Elbuz нарівні з рештою асортименту: їх можна зіставити з позиціями постачальників, порахувати ціни продажу за правилами націнок, налаштувати наявність і стоп-правила, а потім вивантажити на інші канали продажу. Саме заради цього каталог і зводять в одне місце — щоб керувати ним централізовано, а не в кабінеті кожного майданчика окремо.
Якщо ви тільки починаєте, орієнтуйтеся на загальну карту дій — з чого почати і куди рухатися. Там по кроках показано весь шлях: від підключення джерела до автооновлення цін, наявності й додавання новинок. Стаття, яку ви читаєте, закриває саме перший крок цього шляху для eMAG — підключення й завантаження каталогу.
Коротко порядок такий: після імпорту перевірте кілька карток очима (назви, ціни, картинки, категорії), потім налаштуйте ціноутворення й наявність, і лише коли переконаєтесь, що все рахується правильно, поставте оновлення на розклад. Тоді каталог підтримуватиметься актуальним без вашої участі.
Часті питання
Логін і пароль правильні, а eMAG не пускає — чому?
Майже завжди IP-адресу Elbuz не внесено до білого списку в кабінеті eMAG. Маркетплейс приймає API-виклики лише з дозволених адрес. Додайте IP Elbuz у білий список — адресу підкаже підтримка.
Який логін вводити — від веб-кабінету?
Ні. У eMAG API-доступ це окремі логін і пароль, які видаються в кабінеті продавця для інтеграцій. Дані входу у веб-кабінет тут не підходять.
Що вписати у поле країни?
Код площадки: ro (Румунія), bg (Болгарія) або hu (Угорщина). За ним Elbuz обирає правильну доменну зону API. Продаєте в кількох країнах — заведіть окремий шаблон під кожну.
Що таке GPSR і чи потрібен він для імпорту?
GPSR — європейський регламент безпеки продукції: до карток мають бути прив'язані дані про відповідальну особу й виробника. Для самого завантаження каталогу він не обов'язковий, але знадобиться при публікації товарів назад на eMAG. Дані задаються окремою кнопкою у формі.
Можна тягнути з eMAG тільки замовлення?
Так. У шаблоні є окремі перемикачі: завантажувати товари й завантажувати замовлення. Увімкніть лише те, що потрібно.