Відділ сайту й маркетплейсів один із відділів вашої AI-корпорації

Інтеграція з Prom.ua: Prom API без програміста

Інтеграція з Prom.ua підключає ваш кабінет до Elbuz: замовлення приходять через Prom API за токеном в один список із замовленнями сайту й Rozetka, а товари, ціни й наявність ідуть на Prom XML-фідом з вашого каталогу.

  • Prom API
  • Токен
  • XML-фід
  • YML
  • XLSX
  • Замовлення
  • Статуси
  • ProSale
Відділ сайту й маркетплейсів Elbuz у розрізі: товари з каталогу пакуються в кольорові фіди й трубами йдуть до кіосків майданчиків, а замовлення з них повертаються в одну чергу

Що інтеграція з Prom робить за продавця

Шість справ, які без неї робляться руками в кабінеті Prom або файлом Excel щоранку.

Каталог XML-фідом

Elbuz збирає ваш каталог у фід формату Prom (YML) і кладе його за постійним посиланням, а Prom сам забирає його за розкладом. У фід ідуть назва, опис, ціна, фото, виробник і характеристики, а розміри й кольори складаються в одну картку з вибором варіанта. Дані товару ведуться один раз у каталозі товарів (PIM).

Файл XLSX без дублів

Для повного обміну з усіма колонками Prom той самий каталог вивантажується файлом Excel у форматі Prom: аркуш товарів і аркуш груп. У кожному рядку стоїть ідентифікатор товару, тож Prom оновлює наявні позиції, а не створює копії. Ключ у файлі й у фіді однаковий: каталог можна залити файлом, а далі тримати свіжим фідом.

Ціни з комісією Prom

Шаблон вивантаження бере своє поле ціни або рахує її формулою — наприклад, базова ціна плюс націнка, що покриває комісію Prom за обраним режимом ProSale. Ціна на вашому сайті й на Rozetka лишається своєю. Правила націнки.

Наявність без ручних правок

Наявність рахується з ваших складів і прайсів постачальників, і кожен прогін збирає фід заново. Товар без залишку лишається у фіді з позначкою «немає в наявності». Якщо вночі зламався прайс і наявність обвалилася, стоп-правило зупинить вивантаження, і на посиланні лишиться вчорашній фід.

Замовлення через API

Замовлення Prom приходять за розкладом документом «Замовлення покупця» разом із покупцем, доставкою, ТТН, оплатою, промокодом і комісією Prom. Позиції знаходять свої картки за кодом товару, повторне завантаження дубля не створює. Далі їх обробляють поруч із замовленнями сайту й Rozetka — див. керування замовленнями.

Статуси й повідомлення покупців

Статуси замовлення й оплати Prom зводяться до ваших без налаштування. Увімкніть передачу статусів, і зміна статусу в Elbuz піде на Prom, а скасування — з причиною. Повідомлення покупців Prom стають зверненнями в службі підтримки, і відповідь менеджера йде назад на Prom.

Prom API: що він дає і що Elbuz робить сам

Щоб підключити Prom через API, писати код і наймати фрілансера не потрібно: запити, ліміти й розбір відповідей Elbuz бере на себе.

Що відкриває API Prom.ua

Prom.ua дає програмам доступ до кабінету компанії: замовлень, товарів і груп, клієнтів і повідомлень. Програма звертається до нього з токеном, який продавець створює у своєму кабінеті. Опис методів — у документації API Prom.ua, але для роботи через Elbuz читати її не обовʼязково.

Що Elbuz бере на себе

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

Prom не надсилає миттєвих сповіщень про нові замовлення: Elbuz звертається сам, з тією частотою, яку ви ставите в розкладі шаблону.

Де взяти токен Prom API

Токен — єдине, що Elbuz потрібно від Prom. Його створює власник компанії або користувач з роллю «Адміністратор».

  • Декабінет Prom«Налаштування» → «Управління API-токенами» → «Створити токен»
  • Права«Замовлення і повідомлення»читання — щоб забирати замовлення; читання і запис — щоб передавати статуси й відповідати покупцям
  • Строкдо одного рокустрок задаєте ви; перед закінченням продовжте токен або вставте новий у шаблон

Токен відкриває доступ до кабінету, тож зберігайте його як пароль. Порядок і права встановлює Prom, і вони можуть змінюватися. Покрокове підключення — у довідці з Prom (відкривається в новій вкладці).

Як це працює: Prom — ще один канал вашого каталогу

Окрема база товарів під Prom не потрібна: він бере товари з каталогу, який ви вже ведете для сайту й інших маркетплейсів.

  1. Каталогтовари, ціни й залишки від постачальників і з вашого складу
  2. Шаблон PromXML-фід або XLSX: свій відбір товарів, правило ціни й розклад
  3. Prom забираєфід за постійним посиланням оновлює ціни й наявність
  4. Замовлення назадчерез API — у той самий список, що й замовлення сайту

Той самий каталог наповнює ваш сайт, Rozetka, Епіцентр і товарні фіди для Google Shopping, Meta і TikTok.

Екрани Elbuz: каталог, шаблони вивантаження й замовлення

Ті самі вікна працюють з усіма маркетплейсами: картка товару, шаблони вивантаження і список замовлень.

Картка товару в Elbuz: назва й описи кожною мовою, фото, виробник, категорія й заповненість
Одна картка товару — для Prom, сайту й інших маркетплейсів
Шаблони вивантаження в Elbuz: окремий для кожного маркетплейсу, фіду й сайту
Шаблони вивантаження: окремий для кожного маркетплейсу й фіду
Список замовлень у Elbuz: замовлення маркетплейсів і сайту з плитками оплат і доставки
Замовлення Prom, Rozetka й сайту в одному списку

Як підключити Prom до Elbuz

Два шаблони: вивантаження несе каталог на Prom, завантаження забирає замовлення. Обидва налаштовуються у вікнах Elbuz.

  1. Каталогуже продаєте на Prom — завантажте його файл XLSX в Elbuz, групи стануть категоріями
  2. Фідстворіть шаблон вивантаження «prom.ua (XML)» і вставте його посилання в кабінет Prom
  3. Токенвставте токен у шаблон завантаження «Prom.ua (API)»
  4. Перевірказапустіть шаблон і звірте кілька замовлень з кабінетом Prom
  5. Розкладфід і замовлення оновлюються далі без вас

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

Питання про інтеграцію з Prom.ua

Покрокове підключення — у довідці з Prom.

Що таке Prom API?

Це офіційний інтерфейс Prom.ua, через який програми працюють з кабінетом компанії: замовленнями, товарами, клієнтами й повідомленнями. Доступ відкриває токен, створений у кабінеті. В Elbuz через нього приходять замовлення, повідомлення покупців і йдуть назад статуси, а каталог Prom забирає XML-фідом.

Як отримати токен для API Prom.ua?

У кабінеті Prom: «Налаштування» → «Управління API-токенами» → «Створити токен», з правами на групу «Замовлення і повідомлення». Створює його власник компанії або адміністратор. Покроково — у довідці з Prom.

Чи потрібен програміст, щоб підключити Prom через API?

Ні. В Elbuz уже є готові шаблони: «Prom.ua (API)» для замовлень і «prom.ua (XML)» для каталогу. Ви вставляєте токен, копіюєте посилання на фід у кабінет Prom і ставите розклад.

Як вивантажити товари на Prom: XML чи XLSX?

Для щоденного оновлення цін і наявності зручніший XML-фід: Prom сам забирає його за посиланням. Для повного обміну з усіма колонками Prom — файл XLSX. Ідентифікатор товару в них однаковий, тож формати можна поєднувати. Див. XML-фід для Prom і файл XLSX.

Чи не задвоїть Prom товари після вивантаження з Elbuz?

Ні. Prom дублює позиції, коли у файлі немає ідентифікатора товару. Elbuz ставить його в кожен рядок файлу й у кожну пропозицію фіду, тож Prom оновлює наявні позиції, а нові додає.

Чи змінюється статус замовлення на Prom, коли я обробляю його в Elbuz?

Так, якщо в «Зверненнях» увімкнено перемикач «Передавати статус замовлення на маркетплейс» і ваш статус зіставлено зі статусом Prom. З коробки він вимкнений. Зміни, зроблені в кабінеті Prom, у вже завантажене замовлення не повертаються. Див. дії AI із замовленнями.

Як закласти комісію Prom і ProSale в ціну?

Шаблон вивантаження Prom рахує свою ціну формулою — наприклад, базова ціна плюс націнка, що покриває комісію обраного режиму ProSale, — і не змінює ціну на сайті. Див. правила націнки. Тарифи й режими ProSale — у статті як продавати на Prom.ua, формули з прикладами — у статті як порахувати націнку.

Як швидко замовлення Prom зʼявляються в Elbuz?

На черговому запуску за розкладом: Prom не надсилає миттєвих сповіщень, Elbuz звертається сам. Для активного магазину ставте розклад частіше — ліміти Prom це дозволяють.

Можна підключити кілька кабінетів Prom?

Так. Кожен кабінет — окремий шаблон зі своїм токеном і розкладом, а замовлення всіх лягають в один список. Розрізняє їх колонка «Джерело: назва».

14 днів безкоштовно

Підключіть Prom до свого каталогу

Відділ сайту й маркетплейсів входить у вашу AI-корпорацію разом з усіма іншими відділами. 50 € на балансі після реєстрації й 14 днів, щоб перевірити інтеграцію на своїх товарах.

Спробувати безкоштовно