Magento
Модуль Nova Post Shipping для Magento 2 / Adobe Commerce — це офіційне професійне рішення для автоматизації міжнародної та локальної доставки у понад 16 країн Європи та в Україну.
Модуль інтегрує інтерактивний віджет карти в checkout Magento, дозволяє автоматично або вручну генерувати експрес-накладні (ЕН), розраховувати тарифи у реальному часі чи за фіксованою ставкою, роздруковувати повний комплект супровідних та митних документів безпосередньо з списку замовлень (Order Grid) або картки замовлення (Order View).
Основні можливості модуля та доступна географія доставки
Що потрібно для коректної роботи з модулем
Договір на надання послуг з Nova Post. Для коректної роботи з плагіном необхідний договір бізнес-клієнта з Nova Post. Щоб підписати договір, напишіть на пошту відділу продажів у вашій країні.
API-ключ. Зареєструйтесь у бізнес-кабінеті My Nova Post та згенеруйте ключ: детальна інструкція. За потреби провести тестування, згенеруйте тестовий API-ключ за посиланням.
Встановлення модуля Nova Post у Magento
Модуль можна встановити двома офіційними способами:
Завантаження з Adobe Commerce Marketplace: Перейдіть на сторінку модуля Nova Post, додайте його до свого акаунту та встановіть через Web Setup Wizard або компонентний менеджер.
Встановлення через Composer (рекомендовано): Виконайте командні стрічки у терміналі вашого сервера в кореневій директорії Magento:
Налаштування модуля
Налаштування у розділі Nova Post Base
Перейдіть: Stores → Configuration → Nova Post → Nova Post Base
Departure Countries: Виберіть країни, з яких ви здійснюватимете відправку замовлень (країни реєстрації вашого бізнесу/складів). Обрані країни надалі відображатимуться у списку доступних краін-відправників у базових налаштуваннях: Nova Post Settings → Shipment Departure Method → Country.
Налаштування у розділі Nova Post Settings
Перейдіть: Stores → Configuration → Nova Post → Nova Post Settings
Розділ API Configuration
Налаштування робочого середовища. Вставте робочий API-ключ, який згенерували у бізнес-кабінеті.
Налаштування тестового середовища. Поставте Yes у полі Testing API, якщо проводите тестування. Вставте тестовий API-ключ у поле Stage API Key. Це дозволить перевірити створення відправлень без створення реальних накладних та нарахування оплати за послуги.
Розділ Contract Numbers
Domestic Contract Number: Вкажіть номер договору для доставки по країні.
International Contract Number: Вкажіть номер договору для міжнародної доставки. Для доставки в інші країни.
Розділ Sender Data
Заповніть поля:
First Name / Last Name: Ім'я та прізвище відправника.
Email / Phone: Контактна електронна пошта та номер телефону.
Company TIN: Податковий номер компанії (ЄДРПОУ / ІПН / NIP / VAT ID).
Company Name: Офіційна назва компанії.
EORI Code: Код EORI (Economic Operators Registration and Identification). Обов'язково для міжнародних відправлень, які проходять митне оформлення (між ЄС та країнами поза ЄС).
IOSS: Номер Import One-Stop Shop. Використовується для спрощеної сплати ПДВ при продажу товарів вартістю до €150 покупцям у ЄС з-за меж ЄС.
Розділ Shipment Departure Method
Налаштуйте спосіб передачі посилок перевізнику:
Division : Ви самостійно приноситимете посилки у вибране відділення, пункт або поштомат Nova Post.
Address (Адреса): Виклик кур'єра Nova Post на ваш склад або в офіс.
Розділ Product Information
Дані за замовчуванням використовуються для розрахунку вартості доставки, якщо в картці товару не заповнено індивідуальні параметри:
Default Product Weight (kg): Вага товару за замовчуванням.
Length / Width / Height (cm): Габарити товару за замовчуванням.
Default HS Code: Універсальний код для класифікації товарів на митниці за замовчуванням.
Розділ Shipment Automation
Automatic Shipment Creation визначає спосіб створення відправлень:
Yes = автоматично після оформлення замовлення покупцем. Покупець одразу отримає лист з номером посилки для відстеження.
No = відправлення створює менеджер через адмін-панель.
Розділ Carrier Shipping Calculation
Налаштуйте розрахунок вартості доставки для кожного з типів доставки: Nova Post to Division (у відділення/поштомат) та Nova Post to Address (кур'єром на адресу).
Для кожного типу вкажіть Calculation Mode:
Carrier Calculation: Розрахунок у реальному часі через API Nova Post залежно від ваги, габаритів, оголошеної або фактурної цінності та місця доставки.
Flat Rate: Фіксована вартість доставки, вказана продавцем.
Free Delivery (Опціонально): Увімкніть опцію та вкажіть поріг суми замовлення: Free Delivery Threshold. При досягненні цієї суми у кошику доставка для покупця стає безплатною.
Налаштування способів доставки
Перейдіть: Stores → Configuration → Sales → Delivery Methods → Nova Post
У цьому розділі активуються служби доставки, які бачитиме покупець на сторінці Checkout, для цього у полі Enabled for Checkout встановіть Yes.
Carrier Title, Method Title for Division, Method Title for Adress: поля визначають назву перевізника та способу доставки. Заповненюється автоматично.
Show Method If Not Applicable: вкажіть, чи потрібно показувати покупцеві спосіб доставки, якщо він не доступний для його регіону.
Sort Order:
Розділи Nova Post to Division та Nova Post to Address
Applicable countries визначає, в які країни доступна доставка. Налаштуйте доступність кожного способу доставки окремо.
All Allowed Countries – всі дозволені країни.
Sell to specific countries – виберіть країни, для яких буде доступна доставка Nova Post. Вказуйте тільки ті, у яких оперує Nova Post.
Перелік країн, куди можлива доставка Nova Post: Україна, Молдова, Польща, Литва, Чехія, Румунія, Німеччина, Словаччина, Естонія, Латвія, Угорщина, Італія, Велика Британія, Іспанія, Франція, Австрія, Нідерланди, США.
Налаштування валюти
Перейдіть: Stores → Configuration → General → Currency Setup
Base Currency: вкажіть валюту розрахунку з Nova Post здійснює внутрішні розрахунки у Базовій валюті магазину (Base Currency), яка повинна відповідати валюті вашого договору з Nova Post. Наприклад, якщо відправки здійснюються з території Польщі, у Base Currency слід казати PLN, якщо з Румунії — RON.
Default Display Currency: валюта, яка відображається покупцю.
Allowed Currencies:
Якщо ви також використовуєте валюту відображення, яка відрізняється від базової, Magento конвертує вартість доставки за курсом вашого магазину (Stores → Currency Rates). Це стандартна поведінка Magento для всіх способів доставки.
Налаштування товарів
Модуль додає спеціальний блок Nova Post Product Settings у кожну картку товару: Catalog → Products → редагування товару.
Оскільки стандартно Magento підтримує лише вагу, модуль додає відсутні поля, необхідні для точного розрахунку тарифів та митного оформлення:
Length (cm) / Width (cm) / Height (cm): Індивідуальні габарити товару. Якщо залишити порожніми, будуть використані базові значення з налаштувань модуля.
Product Title in English: Назва товару англійською мовою (обов'язково для міжнародних декларацій та інвойсів). Якщо поле порожнє, система використовує стандартну назву товару з Magento.
HS Code: Код класифікації товару.
Зверніть увагу: Доставка Nova Post доступна тільки для фізичних товарів (Simple Products). Якщо у кошику знаходяться лише віртуальні товари, крок вибору доставки в Magento пропускається. Для налаштування товарів (Configurable Products) переконайтеся, що всі дочірні Simple Products мають вказану вагу та габарити.
Управління замовленнями та створення накладних
Як створити експрес-накладну
Доступно у двох режимах: Order View або Order Grid.
Order View – створення відправлення з картки замовлення
Order Grid – створення відправлення із переліку замовлень
Перейдіть у Sales → Orders та відкрийте потрібне замовлення.
У блоці Nova Post натисніть кнопку Create Shipment.
У модальному вікні Create Shipment - Preview перевірте дані:
Sender: Дані відправника (з налаштувань модуля).
Recipient: Контакти та адреса/відділення отримувача.
Parcels & Items: Габарити, вага, склад посилки, HS-коди та вартість товарів.
Note: Додаткова примітка до відправлення (за потреби).
Натисніть Create Shipment у кутку модального вікна.
Перейдіть у розділ Sales → Orders.
У колонці Nova Post Shipment у рядку відповідного замовлення натисніть Create Shipment.
Перевірте дані у вікні попереднього перегляду та підтвердіть створення.
Після успішної генерації накладної в колонці Nova Post Shipment з'явиться її номер у вигляді активного гіперпосилання для швидкого відстеження.
Як згенерувати супровідні документи
Залежно від напрямку доставки модуль автоматично генерує необхідний пакет документів:
Доставка в межах однієї країни або в межах ЄС: стандартна наліпка з маркуванням та штрих-кодом у форматі 100x100 мм.
Доставка за напрямками: non-EU → EU та EU → non-EU:
Label: Стандартна маркувальна наліпка 100x100 мм.
International Label: Міжнародна транспортна накладна з розширеними даними.
Invoice: Комерційний інвойс (рахунок-фактура) для митниці.
Як роздрукувати супровідні документи
Order View
Order Grid
Натисніть іконку потрібного документа безпосередньо у колонці Nova Post Shipment.
У блоці Nova Post або через меню Actions у верхній панелі натисніть іконку відповідного документа. У модальному вікні відкриється PDF-попередній перегляд із кнопками для завантаження чи друку.
Як дізнатись номер відправлення та відстежити посилку
Order View
Order Grid
Номер відправлення – це активне посилання. Клікніть на нього, щоб перейти на сторінку відстеження Nova Post із деталізацією маршруту. Мова сторінки відстеження визначається автоматично відповідно до налаштувань мови поточного подання магазину.
Як змінити дані у експрес-накладній
Якщо в замовленні потрібно змінити вагу, адресу чи склад товарів після створення ЕН, потрібно видалити поточну ЕН та згенерувати нову з потрібними даними:
У колонці Nova Post Shipment у переліку замовлень або у блоці Nova Post у самому замовленні натисніть іконку Смітника (Trash Can).
Підтвердіть дію у вікні запиту ("Are you sure you want to delete shipment...").
Після видалення попереднього трек-номера система знову відобразить кнопку Create Shipment, дозволяючи згенерувати нову накладну з оновленими параметрами.
Як надати доступ менеджеру
Модуль інтегрований у рольову модель безпеки Magento. У розділі System → Permissions → User Roles ви можете гнучко розмежувати права для різних менеджерів:
Create Shipment — дозвіл на створення накладних.
Delete Shipment — дозвіл на видалення/скасування ЕН.
Print Documents — дозвіл на завантаження та друк супровідних документів.
API Logs
Усі запити та відповіді API при взаємодії з Nova Post записуються в окремий лог-файл, відокремлений від загальних логів Magento. Логи містять:
Успішні операції — ID замовлення, статус відповіді, номер експрес-накладної.
Помилкові операції — ID замовлення, деталі помилки.
Мережеві збої та перевищення часу очікування (таймаути).
Модуль записує логи Nova Post у окремі файли:
var/log/novapost/debug.logvar/log/novapost/error.log
Токени авторизації та конфіденційні дані автоматично видаляються з усіх записів у логах.
Шлях покупця у Checkout
Під час оформлення замовлення з доставкою Nova Post покупцю необхідно:
Вказати контактні дані: Email, ім'я, прізвище, номер телефону, країну, місто, вулицю, будинок та поштовий індекс.
Вибрати спосіб доставки Nova Post:
Доставка у відділення / Поштомат: Покупець натискає на інтерактивний віджет карти, вибирає зручну точку на карті або через пошук за адресою, обирає тип (відділення чи поштомат) та підтверджує вибір.
Доставка кур'єром: Доставка здійснюється за адресою, вказаною у контактних даних.
Вказати спосіб оплати: Онлайн-оплата або післяплата (COD).
Підтвердити замовлення.
Після генерації накладної покупцю автоматично надсилається брендований e-mail із деталями замовлення, номером ЕН та прямим посиланням на сторінку відстеження посилки.
