Prom.ua — як створити API-токен
Створення персонального API-токена в кабінеті продавця Prom.ua та підключення до FOPilot.
Через API Prom.ua FOPilot читає замовлення, змінює їхні статуси, додає номер ТТН до замовлення та оновлює ціни й залишки товарів.
Створення токена
- Увійдіть у кабінет продавця Prom.ua (my.prom.ua).
- Відкрийте Налаштування → Управління API-токенами.
- У блоці «Створення особистого токена» вкажіть назву (наприклад, «FOPilot») і термін дії.
- У блоці «Доступ» надайте доступ до розділів:
- Замовлення — читання та зміна (статуси, ТТН);
- Товари — якщо хочете оновлювати залишки та ціни;
- Доставка — для запису номера ТТН у замовлення.
- Натисніть «Створити токен», потім у списку активних токенів — «Дивитись» і скопіюйте токен.
📷 Скріншот: блок «Доступ» з позначеними розділами «Замовлення» та «Товари».
Підключення до FOPilot
Кабінет → Підключення → Prom.ua → Підключити — вставте токен і натисніть «Перевірити і зберегти». Ми перевіримо доступ читанням одного замовлення.
Кілька магазинів на Prom? Підключіть токен кожного — у відповідях інструментів замовлення позначаються назвою підключення.
Що вміє FOPilot з Prom.ua
- Список і деталі замовлень (з маскуванням телефонів покупців у відповідях).
- Зміна статусу: нове → прийняте → виконане, скасування з обов'язковою причиною (наприклад, «немає в наявності»).
- Запис номера ТТН у замовлення після створення накладної.
- Оновлення залишку (
quantity_in_stock), наявності та ціни товарів за ID або артикулом.
Часті помилки
| Помилка | Причина |
|---|---|
| 401 | Токен видалено або закінчився термін дії — створіть новий. |
| 403 | Токен не має доступу до розділу — додайте розділ у налаштуваннях токена. |
| «Cancelling needs a reason» | Prom вимагає причину скасування: not_available, price_changed, buyers_request, not_enough_fields, duplicate, invalid_phone_number, less_than_minimal_price або another з текстом. |