Перейти до вмісту
FOPilot

Prom.ua — як створити API-токен

Створення персонального API-токена в кабінеті продавця Prom.ua та підключення до FOPilot.

Через API Prom.ua FOPilot читає замовлення, змінює їхні статуси, додає номер ТТН до замовлення та оновлює ціни й залишки товарів.

Створення токена

  1. Увійдіть у кабінет продавця Prom.ua (my.prom.ua).
  2. Відкрийте Налаштування → Управління API-токенами.
  3. У блоці «Створення особистого токена» вкажіть назву (наприклад, «FOPilot») і термін дії.
  4. У блоці «Доступ» надайте доступ до розділів:
    • Замовлення — читання та зміна (статуси, ТТН);
    • Товари — якщо хочете оновлювати залишки та ціни;
    • Доставка — для запису номера ТТН у замовлення.
  5. Натисніть «Створити токен», потім у списку активних токенів — «Дивитись» і скопіюйте токен.

📷 Скріншот: блок «Доступ» з позначеними розділами «Замовлення» та «Товари».

Підключення до 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 з текстом.