Нова Пошта — як отримати API-ключ
Покрокова інструкція, як створити API-ключ у бізнес-кабінеті Нової Пошти та підключити його до FOPilot.
API-ключ Нової Пошти дає FOPilot доступ до довідника міст і відділень, розрахунку вартості, створення і видалення ТТН, списку ваших накладних, трекінгу та друку наклейок — від імені вашого відправника.
Що потрібно
- Акаунт у бізнес-кабінеті Нової Пошти (new.novaposhta.ua) — для ФОП і юросіб.
- Відправник (контрагент), від імені якого ви відправляєте посилки. Для ФОП це зазвичай ви як приватна особа або ФОП з договором.
Створення ключа
- Увійдіть у бізнес-кабінет Нової Пошти.
- Відкрийте Налаштування → Безпека.
- У блоці «Мої ключі API» натисніть «Створити ключ».
- Ознайомтеся з ліцензійною угодою API та підтвердьте.
- Скопіюйте створений ключ.
📷 Скріншот: розділ «Безпека» з кнопкою «Створити ключ».
Підключення до FOPilot
- Кабінет → Підключення → Нова Пошта → Підключити.
- Вставте ключ, за бажання вкажіть назву (наприклад, «Основний склад»), натисніть «Перевірити і зберегти».
- Ми перевіримо ключ запитом списку ваших відправників і покажемо назву відправника.
- Перейдіть у Кабінет → Доставка і оберіть відправника, контактну особу, місто й відділення, звідки відправляєте посилки.
Поради
- Створіть окремий ключ саме для FOPilot — його легко видалити, не зачіпаючи інші інтеграції.
- Якщо у вас кілька відправників (наприклад, два склади), підключіть кілька ключів — кожен з'явиться окремим підключенням.
- Друк ТТН і наклейок працює через наші короткоживучі посилання: ваш ключ ніколи не потрапляє в чат чи в посилання.
Часті помилки
| Повідомлення | Що робити |
|---|---|
API key expired / API auth fail |
Ключ видалено або він недійсний — створіть новий і перепідключіть. |
| «Акаунт не має відправника» | Завершіть реєстрацію в бізнес-кабінеті й додайте контрагента-відправника. |
AfterpaymentOnGoodsCost недоступний |
«Контроль оплати» потребує договору з Новою Поштою. Змініть правило накладеного платежу на «Грошовий переказ» у налаштуваннях доставки. |