Доставка

Нова Пошта

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

Для роботи потрібен API-ключ Нової Пошти. Усе інше — місто, відділення, дані отримувача — система підтягує автоматично.

Підключення API#

  1. 1

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

  2. 2

    Натисніть «Додати метод» і оберіть тип доставки:

  3. 3
    • Нова Пошта — до відділення — клієнт забирає посилку у відділенні
    • Нова Пошта — кур'єром — кур'єр доставляє на адресу клієнта
  4. 4

    Введіть API-ключ Нової Пошти. Ключ можна отримати в особистому кабінеті на novaposhta.ua у розділі Налаштування → API → Створити ключ.

  5. 5

    Вкажіть відділення відправника — місто і номер відділення, звідки ви відправляєте посилки. Ці дані підставляються у кожну ТТН автоматично.

  6. 6

    Натисніть «Зберегти», а потім «Перевірити з'єднання». Якщо ключ коректний і відділення знайдено — з'явиться зелена позначка.

Можна додати обидва методи — «До відділення» і «Кур'єром» — з одним API-ключем. При оформленні замовлення оператор або клієнт обирає потрібний.

Що дає підключений API#

МожливістьБез APIЗ API
Вибір методу доставки у замовленніТакТак
Автопідстановка міст і відділеньНіТак
Створення ТТН зі сторінки замовленняНіТак
Друк накладної у PDFНіТак
Автоматичний трекінг статусуНіТак
Видалення ТТН зі сторінки замовленняНіТак

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

Створення ТТН#

Коли замовлення готове до відправки, накладну можна сформувати в один клік.

  1. 1

    Відкрийте сторінку замовлення зі статусом «Готово» і методом доставки Нова Пошта.

  2. 2

    Натисніть кнопку «Створити ТТН» у правому верхньому куті.

  3. 3

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

  4. 4

    Перевірте адресу: місто і відділення (або вулицю і будинок для кур'єрської доставки) — підтягуються з замовлення.

  5. 5

    Заповніть параметри відправлення:

  6. 6
    • Вага (кг) — загальна вага посилки. Автоматично розраховується на основі ваги позицій, отриманої від слайсера.
    • Оголошена вартість — підтягується із суми замовлення.
    • Опис вмісту — коротке найменування вмісту, наприклад «3D-моделі».
    • Кількість місць — кількість окремих упаковок.
  7. 7

    Натисніть «Створити». Накладна формується в обліковому записі Нової Пошти, а номер ТТН зберігається у блоці «Доставка» замовлення.

Перед першим створенням ТТН перевірте, що у налаштуваннях вказано коректне відділення відправника. Якщо воно не вказане або введене з помилкою — кнопка «Створити» поверне помилку від API Нової Пошти.

Друк ТТН#

Після успішного створення накладної кнопка «Створити ТТН» замінюється на «Друк ТТН». Натисніть її — PDF відкриється у новій вкладці. Роздрукуйте і прикріпіть до посилки.

Трекінг і статус доставки#

Після створення ТТН у блоці «Доставка» замовлення з'являється:

  • Номер ТТН — унікальний трекінг-номер відправлення
  • Статус доставки — поточний стан від Нової Пошти («Прийнято», «У дорозі», «Прибуло у відділення» тощо)
  • Очікувана дата отримання — розрахунковий день доставки
  • Фактична дата отримання — проставляється після видачі

Статус оновлюється автоматично. Щоб синхронізувати вручну — натисніть «Оновити статус» у меню дій замовлення.

Після того як клієнт отримав посилку і Нова Пошта проставила відповідний статус — переведіть замовлення у «Завершено» вручну. Статус замовлення в Placraftic не змінюється автоматично на основі статусу доставки.

Видалення ТТН#

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

Видалення ТТН з Placraftic анулює накладну у Новій Пошті. Якщо посилка вже прийнята перевізником — анулювання може бути відхилено з боку Нової Пошти. У цьому випадку зверніться до підтримки Нової Пошти або скасуйте накладну вручну через їхній особистий кабінет.

Скасування замовлення у Placraftic не видаляє ТТН автоматично — потрібно зробити це вручну.

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

Ім'я клієнта не приймається при створенні ТТН#

Нова Пошта вимагає кирилицю для імені та прізвища отримувача. Якщо клієнт при реєстрації ввів ім'я латиницею — відредагуйте його в картці клієнта перед створенням ТТН.

Кнопка «Створити ТТН» недоступна#

Кнопка відображається лише якщо:

  • Метод доставки замовлення — Нова Пошта
  • ТТН для цього замовлення ще не створено
  • У налаштуваннях студії підключений API

Перевірте всі три умови. Якщо метод доставки — самовивіз або інший — кнопка не з'явиться.

API-ключ перестав працювати#

Ключі Нової Пошти можуть бути деактивовані або перевидані. Перейдіть до Налаштування → Доставка, відредагуйте метод і введіть новий ключ. Після збереження натисніть «Перевірити з'єднання» для підтвердження.

Пов'язані розділи#