Підключення Нової Пошти

Інтеграція з Новою Поштою підключає Placraftic до вашого бізнес-кабінету НП через API. Після підключення система зможе формувати ТТН прямо зі сторінки замовлення, відстежувати статус доставки в реальному часі і пропонувати клієнтам вибір міста та відділення — без жодного ручного введення в кабінеті НП.

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

Перейдіть до Налаштування → Доставка → Нова Пошта.

Що потрібно перед початком#

Вимога	Де отримати
Обліковий запис на novaposhta.ua	novaposhta.ua → Реєстрація
Активований бізнес-кабінет	Особистий кабінет → «Мій профіль» → «Бізнес»
API-ключ	Особистий кабінет → «Налаштування» → «Безпека» → «API-ключі»
Хоча б один контрагент-відправник	Особистий кабінет → «Контрагенти»

Якщо ви використовуєте НП як фізична особа — спочатку активуйте бізнес-кабінет. Без нього розділ «API-ключі» у налаштуваннях не відображається. Активація безкоштовна і займає кілька хвилин.

Крок 1. Отримайте API-ключ#

1
Перейдіть на novaposhta.ua і увійдіть до особистого кабінету.
2
Відкрийте «Налаштування» → «Безпека» у верхньому меню кабінету.
3
Перейдіть до розділу «API-ключі» і натисніть «Згенерувати новий ключ».
4
Скопіюйте згенерований ключ. Він виглядає як довгий рядок із букв і цифр:
5
```
a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
```
6
Збережіть ключ у безпечному місці — після закриття сторінки повторно переглянути його в кабінеті НП неможливо.

API-ключ надає доступ до вашого бізнес-кабінету НП — передавати його третім особам не можна. Якщо ключ потрапив не до тих рук — видаліть його у кабінеті НП і згенеруйте новий, потім оновіть його у Placraftic.

Крок 2. Введіть API-ключ у Placraftic#

1
Перейдіть до Налаштування → Доставка → Нова Пошта.
2
Вставте скопійований ключ у поле «API-ключ Нової Пошти».
3
Натисніть «Зберегти ключ». Placraftic перевірить ключ, зверніться до API НП і, якщо все правильно, збереже його.

Після успішного збереження ключа сторінка розкриється для подальшого налаштування відправника.

Якщо ви отримали помилку «Невірний API-ключ» — переконайтесь, що скопіювали ключ повністю без зайвих пробілів. Якщо ключ точно правильний — перевірте, що бізнес-кабінет НП активований і ключ не видалений у кабінеті.

Крок 3. Налаштуйте відправника#

Після збереження API-ключа система автоматично завантажить дані вашого бізнес-кабінету НП. Заповніть три блоки.

Контрагент і контактна особа#

Контрагент — юридична або фізична особа у вашому кабінеті НП, від імені якої відправляються посилки. Список підтягується з НП автоматично.
Контактна особа — представник контрагента, чиє ім'я і телефон з'являться в накладній як відправник. Список залежить від обраного контрагента.
Телефон відправника — номер телефону у форматі +38 (0XX) XXX XX XX. Використовується у ТТН як контактний телефон відправника.

Якщо список контрагентів порожній — переконайтесь, що у вашому кабінеті НП є хоча б один активний контрагент у розділі «Мої контрагенти». Без контрагента створиити ТТН неможливо.

Адреса відправки#

Оберіть тип відправлення — він визначає, звідки кур'єр НП забирає посилки:

Тип	Опис	Поля
З відділення	Ви привозите посилки у відділення НП	Місто + відділення
З адреси (кур'єр)	Кур'єр НП забирає посилки за вашою адресою	Місто + вулиця + будинок + квартира

Далі заповніть відповідні поля:

1
Оберіть тип відправлення: «З відділення» або «З адреси (кур'єр)».
2
Знайдіть місто — почніть вводити назву (мінімум 2 символи), система запропонує варіанти з бази НП.
3
Для відправлення з відділення: оберіть відділення зі списку, що завантажується автоматично після вибору міста.
4
Для відправлення з адреси: знайдіть вулицю (мінімум 2 символи), введіть номер будинку і, за потреби, номер квартири/офісу.
5
Натисніть «Зберегти».

Перевірка налаштувань#

Після збереження відкрийте будь-яке замовлення з методом доставки «Нова Пошта» і натисніть «Створити ТТН». Якщо форма відкривається і дані відправника підставляються автоматично — інтеграція працює коректно.

Вкладка «Нова Пошта» у розділі «Доставка» з'являється лише якщо в налаштуваннях активований метод доставки НП. Якщо вкладка не відображається — перейдіть до Налаштування → Доставка → Загальне і увімкніть потрібний метод.

Часті питання#

Контрагенти не завантажуються після збереження ключа#

Placraftic запитує список контрагентів напряму з API НП. Якщо список порожній або не завантажується:

Перевірте, що ключ збережено (кнопка «Зберегти ключ» не повинна бути активною)
Переконайтесь, що у кабінеті НП є хоча б один активний контрагент
Спробуйте оновити сторінку

Нова Пошта (доставка) — створення ТТН, друк накладної, трекінг і видалення
Telegram-бот — клієнти в Telegram також можуть вибирати доставку НП при оформленні замовлення
Методи доставки — увімкнення і налаштування методів доставки студії