Prom.ua API автоматизація: оновлення за 1 годину

Якщо у вас на Prom.ua більше 200 товарів, ви напевно ловили себе на думці: «знову весь четвер пішов на оновлення цін». Залишки змінюються щодня, постачальники піднімають закупку, конкуренти демпінгують — а ви руками правите по 50 карток і молитеся, щоб не з'їхали характеристики. Prom.ua API автоматизація — це той випадок, коли одне рішення на вихідних економить 15–20 годин на тиждень назавжди.

У цій статті розберемо, як за одну годину налаштувати оновлення каталогу через API: де взяти ключ, які тарифи реально потрібні, які поля можна змінювати програмно і як не вилетіти за rate limit у 1 запит на секунду. Без води — лише те, що працює на практиці.

Чому ручне оновлення каталогу вбиває маржу

Ручна робота з каталогом виглядає безкоштовною, але це ілюзія. Якщо власник або менеджер витрачає 3 години щодня на правки цін і залишків, при ставці навіть 200 грн/година це 12 000 грн на місяць — і це лише прямі витрати часу.

Реальні втрати глибші. Розглянемо типові сценарії:

• Розсинхрон залишків. Ви продали останню одиницю на Rozetka, але на Prom.ua вона ще висить «в наявності». Покупець оформляє замовлення, ви скасовуєте — рейтинг продавця падає на 0,1 бала, а це мінус позиції в пошуку.
• Запізнілі ціни. Постачальник підняв закупівлю на 8% у понеділок, ви оновили роздріб у п'ятницю. За тиждень продали 40 одиниць у мінус.
• Помилки копіпасту. При ручному оновленні 500 товарів через адмінку 1–2% завжди йдуть з помилкою — не та категорія, зник опис, злетіли характеристики.
• Вікно для конкурентів. Поки ви оновлюєте старим способом, магазин з автоматизацією вже змінив ціни тричі за день під динаміку ринку.

Коли каталог переходить позначку 300–500 SKU, ручне оновлення стає фізично неможливим без жертв. І саме тут починається розмова про API.

Що дає Prom.ua API і коли вже пора підключати

API Prom.ua — це інтерфейс, через який ваші скрипти або сторонні сервіси можуть читати і змінювати дані магазину без входу в адмінку. Це не «ще одна функція», а окремий канал керування каталогом.

Які задачі закриває API

• Оновлення цін і залишків з обліковки (1С, Дія.Бізнес, Excel, Google Sheets)
• Масова заміна описів і характеристик
• Імпорт нових товарів від постачальника за прайсом
• Синхронізація з іншими майданчиками (Rozetka, Horoshop, власний сайт на WooCommerce чи Shopify)
• Вивантаження замовлень у CRM
• Автоматичне приховування товарів, яких немає на складі

Точка, коли автоматизація окупається

Підключати API має сенс, якщо у вас виконується хоча б одна з умов:

1. Каталог понад 200 активних SKU
2. Ціни змінюються частіше ніж раз на тиждень
3. Ви продаєте на 2+ майданчиках одночасно
4. Витрачаєте більше 5 годин на тиждень на правки в адмінці
5. У вас дропшипінг-модель і постачальник дає актуальний прайс

Якщо хоча б один пункт — ваш, наступний крок зрозумілий: отримати ключ.

Як отримати API-ключ Prom.ua: покрокова інструкція

Сам процес займає 5–10 хвилин, але є нюанси, через які новачки втрачають по півдня. Розберемо по кроках.

1. Зайдіть у кабінет продавця на my.prom.ua під обліковим записом, який має права адміністратора магазину.
2. Відкрийте розділ «Налаштування» → «API» у бічному меню. Якщо пункту немає — у вас не той тариф (про це нижче).
3. Натисніть «Створити токен». Система запропонує вибрати дозволи: читання товарів, редагування товарів, керування замовленнями, групи. Для повної автоматизації відмічайте всі — пізніше їх можна звузити.
4. Скопіюйте токен у безпечне місце. Він показується один раз. Якщо втратили — створюйте новий, старий деактивуйте.
5. Перевірте токен запитом до https://my.prom.ua/api/v1/products/list з заголовком Authorization: Bearer ВАШ_ТОКЕН. Якщо повертається JSON зі списком товарів — все працює.

Один аккаунт може мати кілька токенів з різними правами. Це зручно: для синхронізації залишків з 1С даєте токен лише на редагування цін, для аналітики — лише на читання. Якщо токен витече до підрядника, ви не втратите весь магазин.

Тарифи Pro і Pro+: за що реально платите

Доступ до API Prom.ua відкривається тільки на платних тарифах. На безкоштовному «Старт» розділу API просто немає — і це перший підводний камінь, через який зупиняються половина спроб автоматизації.

Pro: базовий рівень

Тариф Pro коштує орієнтовно 2500–3000 грн на рік (ціни Prom.ua переглядає, перевіряйте перед покупкою). Сюди входить:

• Доступ до повного API (товари, замовлення, групи)
• До 5000 товарів у каталозі
• Базова статистика і експорт замовлень
• Стандартний rate limit — 1 запит на секунду

Для магазину до 1500–2000 SKU цього вистачає з запасом.

Pro+: для великих каталогів

Pro+ коштує приблизно 6000–7500 грн на рік і має сенс, якщо у вас понад 5000 товарів, потрібен пріоритетний саппорт або розширені інструменти просування. На рівні API різниця невелика — той самий ліміт 1 req/sec, ті самі ендпоінти.

Практичний висновок: починайте з Pro. Перейти на Pro+ можна за день, коли реально упретесь у обмеження каталогу.

Які поля товару можна редагувати через API

API Prom.ua дозволяє керувати майже всім, що є в адмінці — але з кількома винятками, на яких варто зупинитися окремо.

Що оновлюється без проблем

• Назва товару (name) — до 200 символів
• Опис (description) — HTML підтримується
• Ціна і стара ціна (price, discount) — для акцій
• Залишок і статус наявності (quantity_in_stock, presence)
• Артикул (sku)
• Категорія і група (group_id)
• Зображення (images) — масив URL
• Характеристики (attributes) — пари ключ-значення
• Ключові слова (keywords)
• Статус публікації (status: on/off/deleted/draft)

Для якісних описів та характеристик корисно подивитися підбірку Опис товару для Prom.ua: 7 прикладів які продають — там розібрано структуру, яку Prom.ua індексує найкраще.

Де є обмеження

• Зміна валюти товару після створення — лише через підтримку
• Видалення зображень — тільки повна заміна масиву, точкове видалення одного фото неможливе
• Деякі категоріальні характеристики мають фіксований словник значень — довільний рядок не пройде
• Поле «Гарантія» має формати, які потрібно передавати рядком за шаблоном

Перш ніж писати інтеграцію на 500 товарів, протестуйте її на 2–3, перевірте всі поля очима в адмінці. Це врятує від великого розкату по каталогу з помилковими даними.

Rate limit 1 запит/сек: як не зупинити синхронізацію

Головне обмеження Prom.ua API — один запит на секунду. На вигляд мало, але на практиці цього вистачає для більшості магазинів, якщо правильно будувати логіку.

Що означає 1 req/sec на практиці

За хвилину ви можете зробити 60 запитів, за годину — 3600. Один запит на оновлення може містити до 100 товарів пакетом (метод products_edit). Тобто за годину теоретично оновлюється 360 000 SKU. Реальність скромніша через мережеві затримки і обробку — закладайте близько 200 000 товарів за годину при пакетному оновленні.

Проблеми починаються, коли скрипт пише по одному товару за запит. 5000 товарів × 1 секунда = 83 хвилини тільки на цикл. Якщо запускати кожні 15 хвилин — синхронізація просто не встигатиме завершуватися.

Три правила, які рятують від 429 Too Many Requests

1. Завжди використовуйте пакетні методи. products_edit_by_external_id приймає масив до 100 елементів — це 100× прискорення.
2. Робіть паузу 1100 мс між запитами, а не рівно 1000. Сервер інколи рахує час жорстко, і ви ловите помилку на ідеально-точному ритмі.
3. Реалізуйте exponential backoff. При 429-й помилці чекайте 2 секунди, потім 4, потім 8. Не довбіть API — це найшвидший спосіб отримати тимчасовий бан токена.

Якщо писати все це руками не хочеться, є готові рішення на ринку — і саме тут зручно поглянути на сервіси, які беруть rate limit, retry-логіку і мапінг полів на себе.

Сценарій за 1 годину: від нуля до робочої автоматизації

Покажу реалістичний таймлайн, який повторювали десятки магазинів, з якими ми працювали.

1. 0–10 хв: отримання API-ключа в кабінеті Prom.ua, перевірка токена тестовим запитом через Postman або curl.
2. 10–25 хв: підготовка джерела даних. Зазвичай це Google Sheets або CSV-вивантаження з 1С з колонками: артикул, ціна, залишок.
3. 25–45 хв: підключення Google Sheets або файлу до сервісу автоматизації (Make, Zapier, n8n або спеціалізована платформа на кшталт Revenza). Налаштування мапінгу: артикул → external_id, ціна → price, залишок → quantity_in_stock.
4. 45–55 хв: тестовий прогін на 5 товарах. Перевірка в адмінці Prom.ua, що все оновилося коректно.
5. 55–60 хв: увімкнення розкладу — оновлення кожні 30 хвилин або щогодини, залежно від того, як часто змінюється ваш прайс.

За одну годину ви отримуєте систему, яка надалі працює сама. Якщо хочете заощадити навіть цей час — на Revenza для магазинів на Prom.ua інтеграція налаштовується за 15 хвилин і одразу включає AI-генерацію описів та характеристик для нових товарів.

Що робити з вже існуючим хаосом у каталозі

API чудово оновлює, але не виправляє те, що вже є. Якщо у вас 800 карток без характеристик, з описами на 50 символів і дублями — спочатку треба навести порядок.

Найшвидший шлях — пакетна обробка через AI: вивантажуєте каталог, генеруєте нормальні описи й SEO-характеристики, заливаєте назад через той самий API. Детальний процес для великих каталогів описано в матеріалі Як заповнити 500 товарів на Prom.ua за вечір — там є конкретні шаблони і часові оцінки.

Після очистки автоматизація працює зовсім інакше: ви оновлюєте не «спадщину», а живий каталог, який системно росте за позиціями і конверсією.

FAQ: коротко про найчастіші питання

Чи можна користуватися API на тарифі «Старт»?

Ні. API доступне лише на Pro і Pro+. Це обмеження самого Prom.ua, обійти його неможливо. Перехід на Pro окупається першим же місяцем, якщо у вас більше 200 товарів.

Скільки коштує підтримка інтеграції щомісяця?Якщо пишете самі — лише вартість тарифу Prom.ua і, можливо, хостинг скрипта (5–10 USD на VPS). Готові сервіси на кшталт Make чи спеціалізованих платформ для e-commerce беруть 15–50 USD на місяць залежно від кількості операцій.

Що робити, якщо постачальник дає прайс у форматі XLSX, а не XML?

Це норма. Зберігайте файл у Google Sheets, і будь-який сервіс автоматизації прочитає його як джерело. XML потрібен лише для прямого імпорту в адмінку Prom.ua — для API формат не має значення.

Як часто можна оновлювати ціни без бана?

Технічно — хоч щохвилини, поки тримаєтесь у межах 1 req/sec. Практично достатньо раз на 30–60 хвилин для залишків і раз на день для цін, якщо ринок не дуже динамічний.

Що буде, якщо в API передати неіснуючий external_id?

Метод products_edit_by_external_id поверне помилку для конкретного товару, але інші зі списку оновляться. Тому пакетне оновлення безпечніше за поодинокі запити — одна помилка не валить усю синхронізацію.

Замість висновку

Prom.ua API автоматизація — це не «технічна складність для розробників», а звичайний інструмент керування часом. Година налаштування зараз — мінус 15 годин ручної роботи щотижня далі. І чим більший каталог, тим швидше окупається кожен крок.

Якщо не хочеться розбиратися з токенами, rate limit і retry-логікою самостійно — можна зареєструватися безкоштовно в Revenza і підключити магазин Prom.ua за 15 хвилин. Платформа сама бере на себе синхронізацію, генерує описи для нових товарів і слідкує, щоб залишки не розсинхронізовувалися. А ви займаєтесь тим, заради чого взагалі починали — продажами.