Як підключити Allegro до Elbuz: оферти, замовлення й прив'язка без ручного токена

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

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

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

Меню

Довідники → Операції → Завантаження даних → новий шаблон типу «Allegro.pl»

Інші входи

Довідники → Операції → Вивантаження даних — шаблон для цін і залишків

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

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

Підготувати

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

Один шаблон — одне підключення до одного акаунта продавця Allegro. Файл не потрібен.

1

Access-токен Allegro

2

Перевірити підключення

1. Access-токен Allegro — потрібен лише за ручного підключення, не потрібен при вході через застосунок.
2. Перевірити підключення — кнопка перевірки з'єднання з акаунтом Allegro.

Що потрібно від Allegro

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

Другий спосіб — ручний access-токен, для розробки чи тестового середовища. Ручний токен Allegro живе близько 12 годин, тож для постійної роботи не годиться.

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

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

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

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

З Allegro не приходять опис і стара ціна. Опис на Allegro зберігається у власному блоковому форматі майданчика — заповніть його в каталозі або підтягніть з іншого джерела.

Штрихкод, виробник і варіанти

Штрихкод і виробник на Allegro — звичайні параметри оферти. Elbuz знаходить їх за назвою: «EAN» або «GTIN» стає штрихкодом (лишаються тільки цифри), «Marka», «Producent» чи «Brand» — виробником. Не заповнив продавець параметр — поле лишиться порожнім. Коли параметрів в оферті немає, Elbuz бере їх із картки товару Allegro, до якої оферта прив'язана.

Варіантів у звичному сенсі в Allegro немає: кожен розмір чи колір — окрема оферта, тому в Elbuz вони приходять окремими картками, а не сім'єю.

Категорії

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

Не вдалося визначити категорію — товар лягає у службову «Товари - allegro», вимкнену й без участі у вивантаженнях. Перенесіть товари у свої розділи; як прибрати службову категорію: службові категорії та бренди.

Що перезапише повторний прогін

Кожен прогін забирає всі оферти заново, а не лише змінені. Ідентифікатор оферти Elbuz зберігає як прив'язку шаблону, і повторний прогін того ж шаблону знаходить картку саме за нею. Якщо шаблон видалили й створили заново, прив'язки ще немає, і прогін шукає картку за назвою.

• Ви перейменували картку в Elbuz — прогін знайде її за прив'язкою й поверне назву з Allegro без попередження.
• Оферту перейменували на Allegro — картка та сама, назва оновиться. Друга картка з'явиться лише без прив'язки й з назвою, що вже не збігається; стара лишиться зі старими цифрами.

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

Два джерела з однаковими ID

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

Оферта зникла з Allegro або зійшла з публікації

Картка оферти, якої в прогоні не було, лишається як була — з останньою ціною й залишком, без рядка в журналі. Галочки видалення відсутніх у формі Allegro немає, тож зняті з продажу позиції прибирайте руками.

Оферта, що прийшла, але не продається: ACTIVE — картка ввімкнена, будь-який інший стан — вимкнена. Залишок переписується тим, що віддала Allegro: нуль дає «Немає на складі», більше нуля — «В наявності».

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

Як приходять замовлення Allegro

Замовлення Allegro віддає формами оформлення (checkout-forms); вмикає їх галочка «Замовлення». Кожна форма заводиться документом «Замовлення покупця», непроведеним — залишок і резерв не зміняться, поки документ не проведуть.

• Номер у джерелі — ідентифікатор форми; за ним документ знаходиться при повторі, дубля не буде.
• Валюта — з підсумку замовлення, за замовчуванням PLN.
• Покупець заводиться контрагентом за логіном Allegro; телефон — з адреси доставки, без нього — з профілю.
• Рядки шукають картки за ідентифікатором оферти, потім за назвою; не знайшли — нова картка у вимкненій категорії «Товари - allegro - ‹назва шаблона›».

Поле «Завантаження замовлень починаючи з дати» у розділі «Розширене» вирішує, що робить прогін:

• Поле порожнє — прогін забирає замовлення підряд і тільки додає нові.
• Дата є (програма ставить її сама за останнім завантаженим замовленням) — прогін бере змінене від неї й оновлює заведені документи: оплату, доставку, способи оплати й доставки.

Ваш статус обробки змінюється тільки тоді, коли статус змінився на боці Allegro. Проведені документи прогін не оновлює зовсім.

1

Завантаження замовлень починаючи з дати

1. Завантаження замовлень починаючи з дати (РРРР-ММ-ДД) — замовлення старші за цю дату не завантажуються.

Allegro не віддає більше 10 000 замовлень за один прохід (сторінками по 100). Дійшовши до цієї межі, прогін зупиняється, наступний піде від дати останнього завантаженого замовлення.

Як ціни й залишки повертаються на Allegro

Завантаження наповнює базовий каталог і на цьому зупиняється. Щоб ціни й залишки поверталися на Allegro, у вікні «Вивантаження даних» заведіть окремий шаблон типу «Allegro.pl». Він оновлює ціну й залишок за тією самою прив'язкою до оферти, пачками по 25 позицій за запит, і має власний розклад.

На Allegro старі цифри — дивіться на шаблон вивантаження, а не перезапускайте завантаження.

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

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

Скільки оферт іде за один прохід

Стелі на кількість оферт немає. Оферти забираються сторінками по 1000, і на кожну йде ще окремий запит за повною карткою з параметрами й фото — каталог на тисячу оферт означає тисячу з гаком звернень. Товари пишуться в каталог пачками по 500.

У журналі — рядок на кожну сторінку («Allegro: сторінка каталогу N, отримано оферів: M») і підсумок «Allegro: каталог завантажено, оферів: N». Прогін живе в Центрі операцій, вікно шаблону можна закрити.

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

• Помилка на сторінці каталогу обриває завантаження: червоний рядок «Allegro: помилка API —» з текстом відмови, решта сторінок не забирається.
• Помилка на повній картці однієї оферти прогін не зупиняє: оферта заводиться з даних списку — без характеристик і фото, без рядка в журналі.
• «Забагато звернень» — до трьох повторів із паузами 3, 6 і 9 секунд, потім «HTTP 429: retry limit reached».
• «Зупинити» в Центрі операцій спрацьовує на межі сторінки: поточну (до 1000 оферт або 100 форм оформлення) прогін дочитає й запише, завершальний крок виконає.

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

Сценарії

1

Товари

2

Фото

3

Замовлення

1. Товари — завантаження офертів з Allegro до каталогу.
2. Фото — разом із товарами завантажуються їхні зображення.
3. Замовлення — завантаження замовлень з Allegro.

Allegro дивиться рівно на три галочки картки «Вибір даних для завантаження»: «Товари», «Фото» й «Замовлення». Категорії, виробники й характеристики приїжджають разом з офертами.

Тримати каталог Allegro в Elbuz актуальним без ручного токена

Що ввімкнути. Прив'язку застосунку кодом, поле токена — порожнім; «Товари» і, для зображень, «Фото»; потім розклад.

Що вийде. Нові оферти стають картками з фото й характеристиками, у наявних оновлюються ціна, залишок і активність. Нові фото до заведених карток не доїдуть, а зниклі з Allegro оферти не вимкнуться.

Писати свої описи й ціни, а з Allegro брати залишок і стан

Що ввімкнути. Для опису — нічого. Для ціни — «Фіксована ціна» в картках; щоб прогін не чіпав картку взагалі — «Не оновлювати».

Що вийде. Опис, стара ціна й теги лишаються вашими. За «Фіксованої ціни» ціна стоїть, а залишок і активність оновлюються.

Брати з Allegro лише замовлення

Що ввімкнути. «Замовлення» — увімкнено, «Товари» — вимкнено.

Що вийде. Кожна форма оформлення стає непроведеним «Замовленням покупця». Без каталогу рядки шукають картки за назвою, а не знайшовши — заводять нові у вимкненій категорії «Товари - allegro - ‹назва шаблона›». Після першого прогону з'являється дата, і далі в непроведених документах оновлюються оплата й доставка.

Запустили не той шаблон — зупинити

Що натиснути. «Зупинити» в Центрі операцій.

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

Що робити, коли Allegro не віддає дані

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

Де взяти токен Allegro?

За звичайного підключення — ніде: доступ видає прив'язка застосунку кодом і оновлює сам. Ручний токен потрібен для тестів (що потрібно).

Чи затре повторний прогін опис, який я написав?

Ні. Allegro описів не віддає, а порожнє не пишеться поверх заповненого (повторний прогін).

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

Ні, картку знаходить прив'язка оферти, навіть після перейменування. Дубль можливий лише після видалення й перестворення шаблону (повторний прогін).

Що буде з карткою, якщо оферту зняли з продажу?

Оферта не в стані ACTIVE — картка вимкнеться. Оферта зникла зі списку — картка лишиться зі старою ціною й залишком (зникла оферта).

Чому розміри й кольори прийшли окремими картками?

На Allegro кожен варіант — окрема оферта, сімей там немає (варіанти).

Два джерела віддають товари з однаковими ID і затирають одне одного — що робити?

У файлових шаблонах і тунелі увімкніть «Перевірити унікальність записів з урахуванням цього джерела завантаження». Картки Allegro інше джерело зачепить лише збігом назви — захистіть їх «Не оновлювати» (однакові ID).

Суміжні теми

• Якщо потрібна загальна механіка завантаження — розклад, обрив, службові категорії: огляд завантаження даних.
• Якщо ви тільки починаєте й шукаєте порядок дій після імпорту: з чого почати і куди рухатися.
• Якщо замовлення з Польщі приходять ще й із Ceneo: замовлення Ceneo.
• Якщо продаєте ще й на Kaufland: підключення Kaufland.