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