Епіцентр — один із найбільших українських маркетплейсів. Якщо ви на ньому продаєте, замовлення надходять у кабінет продавця; Elbuz забирає їх напряму через Merchant API і перетворює на документи, з якими працюють ваші менеджери. Так продажі з Епіцентру опиняються в одній черзі обробки разом з іншими каналами.
Ця стаття — про підключення саме Епіцентру. Загальний порядок для всіх систем із замовленнями описано в огляді імпорту замовлень через API; тут — особливості Епіцентру: де взяти токен, що приходить у документ і як зіставляються статуси. Каталог товарів цим підключенням не завантажується — асортимент їде на майданчик у зворотному напрямку, XML-фідом.
Де це у програмі
У вікні імпорту створіть шаблон і оберіть тип «Епіцентр». Це API-джерело: файл не потрібен, підключення відбувається за токеном. Один шаблон — одне підключення до одного кабінету продавця.
1
Поле «Токен»2
Кнопка «Перевірити підключення»- Поле «Токен» — сюди вставляється токен із кабінету Епіцентра.
- Кнопка «Перевірити підключення» перевіряє з'єднання з маркетплейсом за введеним токеном.
Де взяти токен: крок за кроком
| Де | Що зробити |
|---|---|
| Кабінет продавця Епіцентр | Увімкнути перемикач API в додаткових налаштуваннях — після цього з'явиться потрібна вкладка |
| Там само | «Налаштування» → «Налаштування компанії» → вкладка «API» → кнопка «Згенерувати» |
| Там само | Скопіювати токен іконкою праворуч від поля |
| Elbuz | Вікно завантаження → ваш шаблон «Епіцентр» → картка «Підключення» → поле «Токен» |
Генерувати токени може адміністратор компанії. Кількість не обмежена — усі створені ключі активні одночасно, тож під інтеграцію з Elbuz зручно завести окремий токен і не змішувати його з іншими сервісами.
Токени Епіцентру не мають терміну дії й працюють, доки ви їх не видалите. Це зручно (нічого не «протухає»), але й небезпечно: будь-хто, у кого опиниться токен, отримає доступ до ваших замовлень. Передавайте його лише технічному спеціалісту й не пересилайте у відкритих чатах. Якщо ключ скомпрометовано — видаліть його в кабінеті іконкою кошика (обмін за ним одразу припиниться) і згенеруйте новий.
Кнопка «Оновити ключ» у кабінеті видає новий токен, а попередній лишається у списку активних — тобто старі інтеграції продовжать працювати, доки ви не видалите їхній ключ вручну.
Як підключити крок за кроком
Створіть шаблон типу «Епіцентр». Вставте токен у картці «Підключення». Натисніть «Перевірити підключення» — Elbuz звернеться до майданчика й одразу скаже, чи приймає він ваш ключ; це швидше, ніж запускати завантаження наосліп. Переконайтесь, що ввімкнено завантаження замовлень, збережіть і запустіть.
Перший запуск варто перевірити очима: відкрийте кілька завантажених замовлень і звірте позиції, суми, покупця й статус. Переконались — ставте шаблон на розклад.
Що приходить із замовленням
З кожного замовлення Епіцентру Elbuz бере ось що:
| Дані Епіцентру | Поле документа в Elbuz |
|---|---|
| номер замовлення | Зовнішній номер |
| внутрішній ідентифікатор замовлення | Ключ, за яким замовлення впізнається повторно |
| ім'я, по батькові, прізвище отримувача | Ім'я, по батькові, прізвище |
| ідентифікатор покупця | Прив'язка контрагента до джерела |
| телефон і пошта | Телефон, пошта |
| дані доставки | Адреса доставки |
| сума замовлення | Сума документа |
| коментар до замовлення | Опис замовлення |
| ознака оплати | Статус оплати: «Оплачено» або «Очікування» |
| статус замовлення | Статус документа (див. таблицю нижче) |
| дати створення й зміни | Дати замовлення на майданчику |
У рядках замовлення приходять назва, артикул, ціна, кількість, сума рядка, одиниця виміру, а також посилання на товар і його зображення на майданчику.
Як позиції зв'язуються з вашим каталогом
Разом із рядком замовлення Епіцентр повертає ідентифікатор товару у вашій системі — тобто рівно те значення, яке ви самі передали майданчику в полі ідентифікатора свого XML-фіду. Що саме там стоїть, вирішуєте ви в шаблоні вивантаження: це може бути внутрішній номер товару, його код або артикул.
Elbuz на це не покладається наосліп: отримане значення перевіряється всіма способами по черзі — і як внутрішній код товару, і як його номер, а якщо воно схоже на артикул, спрацює зіставлення «артикул + назва». Тому підключення працює незалежно від того, який ідентифікатор ви обрали для фіду.
Найточніше воно виходить, коли каталог на Епіцентр вивантажений засобами Elbuz: тоді ідентифікатор у фіді й у замовленні гарантовано один і той самий. Якщо асортимент заливали на майданчик вручну або чужим інструментом, позиції шукатимуться за артикулом і назвою — це працює, але менш надійно. Товари, яких у каталозі немає зовсім, не губляться: для них створюється картка у службовій категорії (докладніше — в огляді імпорту замовлень).
Статуси і їх зіставлення
В Епіцентру власний набір станів замовлення, і Elbuz зводить їх до ваших статусів. Це зіставлення вбудоване в саме підключення:
| Статус в Епіцентрі | Статус документа в Elbuz |
|---|---|
| Новий | Новий |
| Підтверджений продавцем | Погодження |
| Підтверджений | Підтвердження |
| Відправлений | Відвантажено |
| Готовий до видачі | Доставлено |
| Отриманий | Видано |
| Завершений; Закритий | Виконано |
| Скасований; Скасований продавцем | Скасовано |
| Повернений | Повернуто |
| Запит на повернення | Чекає рішення щодо повернення |
| Завершений і Закритий (відмова продавця) | Відхилено |
У картці «Пов'язані налаштування» є кнопки ручного зіставлення статусів і видів оплати та доставки. Порядок такий самий, як у Kaspi та Prom: спершу спрацьовує вбудоване зіставлення з таблиці вище, а ваші ручні правила добирають лише те, для чого відповідності не знайшлося.
Зверніть увагу на дві особливості Епіцентру. По-перше, замовлення, яке довго лишається в проміжному статусі, майданчик сам переводить у «Завершено» — тож у Elbuz воно теж оновиться при черговому завантаженні. По-друге, оплату Епіцентр передає не статусом, а ознакою «оплачено»: якщо вона стоїть, документ отримує статус оплати «Оплачено», інакше — «Очікування».
Розклад і оновлення
Епіцентр працює опитуванням: Elbuz сам звертається до нього за розкладом — миттєвих сповіщень (вебхуків) тут немає. Розклад задають кнопкою налаштування завдання в картці «Пов'язані налаштування». Частоту обирайте за оборотом: активному магазину має сенс перевіряти замовлення кілька разів на годину, спокійному вистачить кількох разів на добу.
Щоб не тягнути одне й те саме двічі, Elbuz веде інкремент за датою зміни: майданчик віддає лише ті замовлення, які змінилися після попереднього завантаження. Перший запуск забирає історію приблизно за останній місяць — цього досить, щоб підхопити все, що зараз в обробці. Замовлення читаються сторінками, тож великий обсяг вантажиться поступово; кожен запуск лишає слід у журналі: скільки замовлень отримано й чи були помилки.
Навіщо зводити замовлення Епіцентру в Elbuz
Кабінет Епіцентру добре показує замовлення самого Епіцентру, але якщо каналів кілька, продажі опиняються в різних місцях. Звівши їх у Elbuz, ви обробляєте все в одній черзі: списання зі складу, облік покупців, єдині статуси, друк документів. Менеджеру не треба тримати окрему вкладку маркетплейсу, а історія покупок клієнта збирається у вашій базі контрагентів.
Разом із вивантаженням каталогу виходить замкнений цикл: товари з цінами й залишками їдуть на майданчик фідом, а замовлення повертаються в Elbuz через API. Обидва напрямки працюють за розкладом, тож щоденної ручної роботи не лишається.
Часті труднощі
Найчастіша причина, чому замовлення не приходять, — токен. Перевірте, що він скопійований повністю, без зайвих пробілів і без обрізаного «хвоста», і що ключ не видалено в кабінеті. Кнопка «Перевірити підключення» показує це одразу: якщо майданчик ключ не приймає, ви побачите повідомлення, не чекаючи завантаження.
Друга ситуація — замовлення є, а позицій у ньому немає або вони не знайшли товар. Це питання не підключення, а зіставлення: перевірте, чи вивантажений каталог на Епіцентр засобами Elbuz і чи збігається ідентифікатор у фіді з тим, що використовується в каталозі. Докладно порядок пошуку описано в огляді імпорту замовлень.
Заведіть під Elbuz окремий токен і назвіть його зрозуміло. Тоді, якщо доступ доведеться відкликати, ви видалите саме його й не зламаєте інші інтеграції, які працюють з тим самим кабінетом.
Часті питання
Чи можна цим підключенням завантажити товари в каталог?
Ні. Це підключення приносить лише замовлення. Товари рухаються у зворотному напрямку: ви вивантажуєте каталог на Епіцентр XML-фідом — про це окрема стаття про вивантаження на Епіцентр.
Чи потрібно оновлювати токен раз на певний період?
Ні, у токенів Епіцентру немає терміну дії — вони працюють, доки ви їх не видалите. Саме тому до них варто ставитися як до пароля: доступ за таким ключем не «згасне» сам.
Чи змінюється статус замовлення на Епіцентрі, коли я обробляю його в Elbuz?
Поки ні: підключення працює в один бік — замовлення приходять із майданчика, а статус на його боці ви змінюєте в кабінеті. Якщо там статус зміниться, наступне завантаження підхопить його разом з оновленим замовленням.
Скільки токенів можна створити?
Скільки завгодно — усі створені ключі активні одночасно. Кнопка «Оновити ключ» видає новий токен, а попередній лишається робочим, доки ви не видалите його вручну.
За який період підтягнуться замовлення під час першого запуску?
Приблизно за останній місяць — цього досить, щоб підхопити все, що зараз в обробці. Далі працює інкремент: беруться лише замовлення, змінені після попереднього завантаження.
Чому в кабінеті немає вкладки «API»?
Вкладка з'являється після ввімкнення відповідного перемикача в додаткових налаштуваннях, а генерувати токени може адміністратор компанії. Якщо вкладки немає — швидше за все, у вашого користувача інша роль.