Інтеграція з «Новою Поштою» дозволяє покупцям обирати відділення, поштомат або адресну доставку прямо під час оформлення замовлення, а вам — створювати експрес-накладні (ЕН) безпосередньо з картки замовлення, без ручного перенесення даних у кабінет перевізника.
Крок 1. Отримайте API-ключ у кабінеті Нової Пошти
- Зареєструйте бізнес-кабінет на сайті new.novaposhta.ua або увійдіть у наявний.
- Відкрийте Налаштування → Безпека і натисніть Створити ключ.
Кабінет Нової Пошти: Налаштування → Безпека - Підтвердіть створення ключа кнопкою Створити.
Підтвердження створення API-ключа - Скопіюйте значення в колонці Ключ — воно знадобиться на кроці 4.
Копіювання API-ключа
Зверніть увагу: API-ключ створюється строком на 1 рік. Після завершення терміну дії ключ перестає працювати — як його продовжити, описано наприкінці статті.
Крок 2. Увімкніть метод доставки «Нова Пошта»
В адмін-панелі магазину відкрийте Магазин → Методи доставки. Метод «Нова Пошта» вже є у стандартному списку — переконайтеся, що тумблер у колонці Вмк/Вимк увімкнено.
У редагуванні методу можна задати поріг «Безкоштовна доставка від, грн» — якщо сума замовлення досягає цього значення, доставка для покупця стає безкоштовною.
Важливо: не видаляйте метод «Нова Пошта» зі списку — з ним пов'язані поля вибору міста та відділення в оформленні замовлення. Якщо метод тимчасово не потрібен, просто вимкніть його тумблером.
Крок 3. Прив'яжіть методи оплати
Відкрийте Магазин → Методи оплати і в кожному способі оплати, який має бути доступний для «Нової Пошти», додайте її в полі Методи доставки. Без цієї прив'язки покупець, обравши «Нову Пошту», не побачить жодного способу оплати.
Крок 4. Створіть акаунт у розділі «Нова Пошта»
Відкрийте Інтеграції → Нова Пошта. Розділ складається з трьох вкладок: Список ЕН, Довідники та Акаунти. Поки акаунт не створено, ви побачите попередження «Необхідно створити акаунт».
Перейдіть на вкладку Акаунти, натисніть + Створити і заповніть форму:
- API ключ — ключ, отриманий на кроці 1;
- Назва — довільна назва акаунта, наприклад назва магазину;
- Платник — хто за замовчуванням сплачує доставку: Відправник, Одержувач чи Третя особа;
- Метод оплати — Готівка або Безготівковий;
- Тип вантажу — Посилка, Вантаж, Документи, Шини-диски або Палети;
- Тип доставки — типова схема, наприклад Відділення-Відділення.
Перший створений акаунт автоматично стає основним — саме його API-ключ система використовує для всіх запитів до Нової Пошти. Акаунтів може бути кілька (наприклад, різні відправники), основний позначено у списку.
Крок 5. Імпортуйте довідники
Перейдіть на вкладку Довідники і натисніть Імпорт довідників. З'явиться повідомлення «Імпорт розпочато. Очікуйте...» — система у фоновому режимі завантажить із API Нової Пошти Області, Населені пункти та Відділення/Поштомати; на вкладці видно лічильники завантажених записів.
Нова Пошта регулярно відкриває нові відділення, тому імпорт варто час від часу повторювати.
Крок 6. Вкажіть місто та відділення відправника
Поверніться на вкладку Акаунти та відкрийте акаунт на редагування. Після імпорту довідників у формі доступні поля Місто та Відділення з пошуком — вкажіть, звідки відправлятимете посилки. За потреби уточніть Тип отримувача й інші параметри за замовчуванням та натисніть Зберегти.
Крок 7. Перевірте оформлення замовлення
Відкрийте сайт магазину, додайте товар у кошик та оберіть доставку «Нова Пошта». У формі мають з'явитися поля: Тип (Відділення / Поштомат / Адреса), Область, Місто і Відділення або поштомат. Якщо списки міст порожні — див. розділ «Якщо щось не працює».
Створення експрес-накладної із замовлення
Коли покупець оформив замовлення з доставкою Новою Поштою, відкрийте його у Магазин → Замовлення — у картці замовлення є вкладка Нова Пошта:
- місто й відділення одержувача підставляються із замовлення автоматично;
- вкажіть параметри відправлення: оголошену вартість, дату відправки, вагу та габарити місць, опис вантажу; за потреби увімкніть Контроль оплати або замовте Зворотну доставку;
- натисніть Сгенерувати ЕН — накладна створиться в кабінеті Нової Пошти. Готову ЕН можна роздрукувати, перегенерувати після змін або видалити.
Усі створені накладні зібрані у Інтеграції → Нова Пошта → Список ЕН: номер, дата, одержувач, вага, статус, вартість і дата доставки.
Продовження терміну дії API-ключа
Ключ діє один рік. Щоб продовжити його: у кабінеті Нової Пошти відкрийте Налаштування → Безпека, натисніть іконку годинника «Продовжити термін дії ключа» навпроти потрібного ключа та підтвердіть кнопкою Підтвердити.
Продовжити можна лише ключ, термін дії якого ще не сплив і який не вилучено. Якщо термін уже минув — створіть новий ключ і оновіть його в акаунті (крок 4).
Якщо щось не працює
- У кошику порожній список міст чи відділень — не виконано імпорт довідників (крок 5) або API-ключ недійсний.
- Попередження «Необхідно вказати API ключ» чи «Необхідно створити акаунт» — немає активного основного акаунта з ключем (крок 4).
- Покупець обрав «Нову Пошту», але не бачить способів оплати — способи оплати не прив'язані до методу доставки (крок 3).
- ЕН не створюється — перевірте термін дії API-ключа та заповненість міста і відділення відправника в акаунті (крок 6).