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

Нова Пошта — як отримати API-ключ

Покрокова інструкція, як створити API-ключ у бізнес-кабінеті Нової Пошти та підключити його до FOPilot.

API-ключ Нової Пошти дає FOPilot доступ до довідника міст і відділень, розрахунку вартості, створення і видалення ТТН, списку ваших накладних, трекінгу та друку наклейок — від імені вашого відправника.

Що потрібно

  • Акаунт у бізнес-кабінеті Нової Пошти (new.novaposhta.ua) — для ФОП і юросіб.
  • Відправник (контрагент), від імені якого ви відправляєте посилки. Для ФОП це зазвичай ви як приватна особа або ФОП з договором.

Створення ключа

  1. Увійдіть у бізнес-кабінет Нової Пошти.
  2. Відкрийте Налаштування → Безпека.
  3. У блоці «Мої ключі API» натисніть «Створити ключ».
  4. Ознайомтеся з ліцензійною угодою API та підтвердьте.
  5. Скопіюйте створений ключ.

📷 Скріншот: розділ «Безпека» з кнопкою «Створити ключ».

Підключення до FOPilot

  1. Кабінет → Підключення → Нова Пошта → Підключити.
  2. Вставте ключ, за бажання вкажіть назву (наприклад, «Основний склад»), натисніть «Перевірити і зберегти».
  3. Ми перевіримо ключ запитом списку ваших відправників і покажемо назву відправника.
  4. Перейдіть у Кабінет → Доставка і оберіть відправника, контактну особу, місто й відділення, звідки відправляєте посилки.

Поради

  • Створіть окремий ключ саме для FOPilot — його легко видалити, не зачіпаючи інші інтеграції.
  • Якщо у вас кілька відправників (наприклад, два склади), підключіть кілька ключів — кожен з'явиться окремим підключенням.
  • Друк ТТН і наклейок працює через наші короткоживучі посилання: ваш ключ ніколи не потрапляє в чат чи в посилання.

Часті помилки

Повідомлення Що робити
API key expired / API auth fail Ключ видалено або він недійсний — створіть новий і перепідключіть.
«Акаунт не має відправника» Завершіть реєстрацію в бізнес-кабінеті й додайте контрагента-відправника.
AfterpaymentOnGoodsCost недоступний «Контроль оплати» потребує договору з Новою Поштою. Змініть правило накладеного платежу на «Грошовий переказ» у налаштуваннях доставки.