Prom.ua — маркетплейс №1 в Україні й частина міжнародної родини майданчиків EVO. Якщо ви продаєте на Prom, замовлення надходять у ваш кабінет; Elbuz забирає їх напряму через API й перетворює на документи, з якими працюють ваші менеджери. Так замовлення Prom опиняються в одній черзі обробки разом із продажами з інших каналів.
Ця стаття — про підключення саме Prom. Загальний порядок для всіх систем із замовленнями описано в огляді імпорту замовлень через API; тут — особливості Prom: який ключ потрібен, що з зіставленням статусів і як Elbuz уміє повертати статус назад у Prom. Prom через це підключення приносить замовлення; про завантаження товарів Prom — окремо (див. нижче).
Де це у програмі
У вікні імпорту створіть шаблон і оберіть тип «Prom» (EVO). Це API-джерело: файл не потрібен, підключення відбувається за токеном. Один шаблон — одне підключення до одного кабінету Prom.
Що потрібно для підключення
Для Prom потрібне лише одне значення — Токен. Це ключ доступу до API, який видається в кабінеті Prom (розділ налаштувань / API). Ви вставляєте його в поле «Токен» у картці «Підключення» — і цього достатньо. Токен це доступ до вашого кабінету, тож зберігайте його як пароль; якщо потрібно відкликати доступ, перевипустіть токен у кабінеті Prom і оновіть його в шаблоні.
Як підключити крок за кроком
Створіть шаблон типу «Prom». Вставте токен у картці «Підключення». Переконайтесь, що ввімкнено завантаження замовлень. Збережіть і запустіть. Перше підключення забере наявні замовлення, наступні — лише нові й змінені. Радимо перший запуск перевірити очима: відкрийте кілька завантажених замовлень і звірте позиції, суми, покупця й статус.
Що приходить із замовленням
Із кожного замовлення Prom Elbuz бере склад позицій (товари, кількість, ціни), дані покупця, суми й поточний статус. На основі цього створюється документ — замовлення покупця. Товари приходять як рядки замовлення, тож окремо вантажити каталог для приймання замовлень не потрібно. Покупець із замовлення заводиться у вашу базу контрагентів, тож історія його звернень і покупок збирається в одному місці, а не лишається лише в кабінеті Prom.
Зворотний запис статусу в Prom
Особливість Prom — двобічний зв'язок. Elbuz не лише забирає замовлення, а й уміє повертати статус назад у Prom: коли менеджер обробив замовлення в Elbuz (підтвердив, відправив, скасував), відповідний статус можна проставити й на боці Prom. Так покупець бачить актуальний стан свого замовлення, а вам не треба дублювати дію в двох системах. Скасування передається з причиною, як того вимагає Prom.
Статуси і їх зіставлення
У Prom свої статуси замовлення (новий, прийнято, доставлено, скасовано, чернетка, оплачено) і стани оплати. Elbuz зводить їх до власних — базове зіставлення вже вбудоване. Прямо у формі шаблону є кнопки тонкого налаштування: відповідність зовнішніх статусів замовлення, доставки й оплати вашим внутрішнім, а також типів оплати (наприклад, «Пром-оплата» Elbuz відносить до оплати через маркетплейс, «Безготівковий розрахунок» — до банківського переказу, «Накладений платіж» — до післяплати). Це стане в пригоді, якщо ваші внутрішні статуси відрізняються від типових.
А як щодо товарів Prom
Це підключення приносить саме замовлення. Каталог Prom завантажується іншим шляхом — файлом у форматі маркетплейсів EVO (XLSX для prom.ua, satu.kz, deal.by) або через YML. Тобто товари й замовлення Prom розведено: асортимент ви заливаєте імпортом XLSX (EVO), а замовлення — цим API-підключенням. Це зручно: каталог зазвичай оновлюють рідше й пачками, а замовлення потрібні свіжими й часто.
Розклад, оновлення й ліміти
Prom працює поллінгом: Elbuz сам звертається за розкладом і забирає свіжі замовлення — вебхука (миттєвого сповіщення) немає. Розклад визначає, наскільки швидко нові замовлення потраплять у Elbuz; для активного магазину має сенс перевіряти часто. Розклад задають кнопкою налаштування завдання прямо у формі шаблону. Prom обмежує частоту звернень до API, тому Elbuz свідомо забирає замовлення сторінками з невеликими паузами — це нормальний, безпечний темп. Elbuz веде інкремент за номером останнього замовлення, тож повторно те саме не тягнеться. Перше підключення забирає наявні замовлення за розумний період назад, тож історія не губиться, а далі підхоплюється лише те, що з'явилося після останнього завантаженого замовлення. Кілька кабінетів Prom можна вести паралельно — під кожен свій шаблон із власним токеном і розкладом, і всі вони наповнюють одну спільну чергу замовлень у Elbuz.
Навіщо зводити замовлення Prom в Elbuz
Кабінет Prom добре показує замовлення самого Prom, але якщо каналів кілька, продажі опиняються в різних місцях. Звівши замовлення Prom в Elbuz, ви обробляєте їх в одній черзі: списання зі складу, облік покупців, єдині статуси, друк документів — а статус ще й повертається в Prom автоматично. Менеджеру не треба тримати окрему вкладку Prom.
Одразу налаштуйте зіставлення статусів під свій процес — тоді зворотний запис у Prom працюватиме коректно: обробили замовлення в Elbuz, і покупець на Prom бачить правильний стан без вашої додаткової дії.
Що далі із завантаженими замовленнями
Завантажити замовлення — це початок. Далі вони живуть у Elbuz як документи «замовлення покупця», і з ними працюють як зі звичайними: підтверджують, резервують і списують товар зі складу, оформлюють доставку й друкують документи, ведуть покупця в базі контрагентів. А завдяки зворотному запису статус обробки повертається в Prom автоматично, тож покупець завжди бачить актуальний стан. Якщо ви тільки починаєте знайомство з системою, орієнтуйтеся на загальну карту дій — з чого почати і куди рухатися: там показано весь робочий цикл в Elbuz.
Коли Prom — не єдиний ваш канал, його замовлення сходяться в один список разом з іншими майданчиками, і менеджер обробляє їх однаково. Загальні принципи роботи із замовленнями з різних систем описано в огляді імпорту замовлень через API — Prom підпорядковується тому самому порядку, а вирізняється двобічним зв'язком (запис статусу назад) і тим, що каталог у нього завантажується окремо, форматом EVO.
Типовий сценарій для продавця з України виглядає так: асортимент ви заливаєте імпортом XLSX (EVO) й тримаєте актуальним, а замовлення тягнете цим API-підключенням і обробляєте в Elbuz. Обидва потоки — товари й замовлення — сходяться в одній системі, і Prom перестає бути окремим «острівцем», який доводиться вести руками в його власному кабінеті.
Часті питання
Де взяти токен Prom?
Токен видається в кабінеті Prom, у розділі налаштувань / API. Ви вставляєте його в поле «Токен» у формі шаблону — це єдине, що потрібно для підключення.
Чому не завантажуються товари Prom?
Бо це підключення приносить лише замовлення. Каталог Prom вантажать окремо — файлом формату EVO (XLSX) або через YML. Так товари й замовлення Prom розведено навмисно.
Elbuz може змінювати статус замовлення на Prom?
Так. Коли ви обробляєте замовлення в Elbuz, статус можна повернути назад у Prom (підтверджено, відправлено, скасовано з причиною). Покупець бачить актуальний стан, а ви не дублюєте дію в двох системах.
Як налаштувати відповідність статусів?
Базове зіставлення вбудоване. Для тонкого налаштування у формі шаблону є кнопки: статус замовлення, доставки, оплати, а також типи оплати й доставки — там ви задаєте, який статус Prom відповідає якому вашому.
Замовлення з'являються з затримкою — чому?
Prom працює поллінгом, без миттєвих сповіщень, тож нові замовлення підтягуються під час чергового запуску за розкладом. Щоб затримка була меншою, поставте частіший розклад — з урахуванням лімітів Prom на частоту звернень.