PrestaShop

[Завантажити]

Модуль Nova Post для PrestaShop дозволяє автоматизувати процес доставки товарів, інтегрувати вибір способів доставки безпосередньо у чекаут та керувати відправленнями безпосередньо з панелі управління магазином.

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

Що потрібно для коректної роботи з модулем

• Договір на надання послуг з Nova Post. Для коректної роботи з плагіном необхідний договір бізнес-клієнта з Nova Post. Щоб підписати договір, напишіть на пошту відділу продажів у вашій країні.
• API-ключ. Зареєструйтесь у бізнес-кабінеті My Nova Post та згенеруйте ключ. Детальна інструкція.

Під час налаштування модулю вам необхідно буде вказати:

• Номер договору на логістичні послуги
• Номер договору для післяплати
• API-ключ

Номери договорів не відображаються у бізнес-кабінеті. Якщо вам необхідно дізнатись номер договору, напишіть на пошту відділу продажів у вашій країні.

Встановлення модуля Nova Post у PrestaShop

[Завантажити модуль]

Спосіб 1: Через панель адміністратора

1. Увійдіть у панель керування PrestaShop.
2. Перейдіть у розділ Modules → Module Manager → натисніть Upload a module.
3. Виберіть ZIP-файл модуля Nova Post на комп'ютері та завантажте його.
4. Коли модуль з'явиться у переліку, натисніть Install.

Спосіб 2: Через FTP/SFTP

1. Розпакуйте архів з модулем на комп'ютері.
2. Перевірте структуру папок: папку модуля має бути названо novapost/ і всередині мають міститися файли novapost.php, config.xml, папки controllers/, views/ тощо.

   1. ✅ Правильний шлях: /modules/novapost/
   2. ❌ Неправильно (подвійне вкладення): /modules/novapost/novapost/
3. Підключіться до сервера через FTP/SFTP (або файловий менеджер хостингу).
4. Завантажте папку модуля за шляхом: YOUR_PRESTASHOP_ROOT/modules/.
5. Поверніться в Back Office → Modules → Module Manager, знайдіть модуль Nova Post та натисніть Install.

Початкове налаштування модуля

Важливо: Після встановлення модуля обов’язково очистьте кеш магазину, перш ніж переходити до налаштувань.

Ідентифікуючі дані

Відкрийте модуль Nova Post у панелі PrestaShop:

1

Вкажіть API Key

2

Вкажіть номери договорів

3

Увімкніть запис API-запитів та відповідей у файл var/logs/nova-post.log допомагає у діагностиці та вирішенні помилок

Опція не впливає на швидкість сайту, але потребує наявності вільного місця на диску сервера.

Дозволені країни доставки

Модуль відображає країни, увімкнені у вашому магазині, але ви можете окремо задати країни, для яких буде доступна доставка Nova Post. Для цього перейдіть: Improve → International → Location → Countries і виберіть зі списку тільки ті країни, куди плануєте відправляти через Nova Post (використовуйте Ctrl/Cmd для вибору кількох). Якщо жодна країна не вибрана, доставка буде доступна для країн, які дозволені на рівні налаштування самого магазину.

Дані про відправника

1. Заповніть обов'язкові поля:

• Номер внутрішнього договору
• Номер міжнародного договору
• Прізвище та ім'я
• Мобільний телефон
• Email
• Назва компанії
• Податковий номер компанії (TIN / ІПН)

Важливо: Вказані дані мають збігатись з тими, що вказані у договорі на логістичні послуги.

2. Додаткові поля для доставки замовлень з митним оформленням:

• EORI: Необхідно заповнити, якщо ви здійснюєте міжнародну доставку, яка потребує митного оформлення: з країни поза зоною ЄС – у країну ЄС, з країни ЄС – за межі ЄС.
• IOSS: Ідентифікаційний номер юридичної особи, яка зареєстрована платником ПДВ у системі Import One-Stop Shop. Необхідний для спрощеного митного оформлення у країні доставки. Дозволяє стягувати ПДВ з покупця для товарів до €150 під час оплати замовлення.

Приклад заповнення розділу Sender Information

Місце відправки

Виберіть спосіб відправки та вкажіть необхідні дані відповідно до нього:

• Adress: Для відправки замовлень кур'єром з офісу або складу магазину.
• Branch: Ви самі привозите замовлення у вибране відділення Nova Post або партнерське.

Приклад заповнення для відправки кур'єром з адреси	Приклад заповнення для відправки з відділення

Інформація про товари та пакування за замовчуванням

Якщо в картці товару відсутні вага та габарити, модуль використає значення за замовчуванням з цього розділу. Дані у цьому розділі впливають на розрахунок вартості доставки та доступні місця доставки.

Default Product Information

Розрахунок вартості доставки здійснюється на основі ваги, габаритів, ціни, пункту призначення та типу доставки. Якщо в картці товару відсутні вага та габарити, модуль використає значення за замовчуванням з цього розділу.

Приклад заповнення інформації про товар за замовчуванням

Щоб встановити HS Code за замовчуванням, встановить безплатний модуль HS Code.

Packaging Settings

Оберіть спосіб формування коробок:

• Automatic: Автоматично розраховує та підбирає оптимальні розміри коробок.
• One box: Використовуються фіксовані габарити пакування до всього замовлення.

Приклад заповнення інформації про пакування

Післяплата

Щоб підключити послугу у своєму магазині:

• підпишіть додатковий договір з Nova Post.
• встановіть безплатний модуль PrestaShop COD.

Для налаштування послуги перейдіть у Modules → Nova Post Shipping → Cash on Delivery (COD) Settings:

1. Валюта післяплати: Для коректної роботи має збігатись з валютою країни відправки. Якщо не вказано, буде використано валюту, що вказано у рахунку-фактурі.
2. Bank Accaunt ID: банківський ідентифікатор клієнта, має збігатись з тим, що вказаний у договорі з Nova Post.
3. IBAN: Номер банківського рахунку для зарахування коштів.
4. Платник комісії: Визначає, хто сплачує комісію Nova Post за надання послуги:

   1. Disabled — одержувач
   2. Enabled — відправник

Приклад заповнення розділу налаштування післяплати

Advanced Settings

• Auto-create of Nova Post Shipments:

  • Enable – відправлення автоматично буде створено після оформлення замовлення.
  • Disabled – відправлення необхідно буде створити самостійно з картки замовлення.
• Auto-create User Context: Виберіть Admin PrestaShop, щоб після створення відправлення статус замовлення автоматично змінювався на Shipped. Це технічна вимога PrestaShop; без вибору користувача статус автоматично не змінюватиметься.
• Allowed Delivery Types: Оберіть мінімум один тип доставки, який буде доступний покупцям:

  • Address – доставка кур'єром на адресу одержувача.
  • Branch – доставка у відділення Nova Post, партнерські відділення та пункти.
  • Parcel Locker – доставка у поштомати.

Приклад заповнення розділу Advanced Settings

Налаштування товарів для міжнародної доставки

Якщо відправляєте товари за кордон, необхідно вказати для кожного товару наступні значення:

1. HS-код: Catalog → Product → Basic settings → HS Code. Якщо HS-код не задано для конкретного товару, буде використано загальний HS-код, який ви вказали раніше у налаштуваннях модуля.
2. Країна походження: Catalog → Product → Basic settings → Country of origin.
3. Назва товару англійською: Catalog → Product → Basic settings → Nova Post English Product Name.

Необхідно для формування супровідних документів.

Приклад заповнення інформації про товар для міжнародної доставки

Параметри доставки

Параметри перевізника Nova Post налаштовуються аналогічно до стандартних методів доставки PrestaShop.

• Назва служби доставки: Improve → Shipping → Carriers → Nova Post Shipping → General settings → Carrier Name. Якщо не вказано, за замовчуванням Nova Post.
• Опис служби доставки: Improve → Shipping → Carriers → Nova Post Shipping → General settings → Transit time. За замовчуванням: «Легка доставка для життя та бізнесу!». Можна налаштувати окремий текст для української та англійської мов.
• Посилання на відстеження: Improve → Shipping → Carriers → Nova Post Shipping → General settings → Tracking URL. Заповнюється автоматично.
• Безплатна доставка: Improve → Shipping → Carriers → Nova Post Shipping → Shipping locations and costs → Free shipping.
• Комісія за обробку замовлення: щоб увімкнути для Nova Post, Improve → Shipping → Carriers → Nova Post Shipping → Shipping locations and costs → Add handling costs.
• Розмір коміссії: Improve → Shipping → Preferences → Handling charges. Це налаштування поширюється на всі служби доставки.
• Поріг безплатної доставки за сумою або вагою: Improve → Shipping → Preferences → Free shipping starts at…

Можна налаштувати мінімальну суму замовлення та/або мінімальну вагу замовлення для безплатної доставки.

Керування відправленнями

Створити відправлення для одного замовлення: Orders → Order → Nova Post Delivery → Create Shipment.

Масове створення відправлень: Orders → обираєте декілька замовлень → Bulk actions → Create Nova Post Shipments.

Зміна місця доставки після оформлення замовлення: Покупець не може самостійно змінити відділення після створення замовлення, щоб змінити місце доставки: Orders → Order → Nova Post Delivery.

Видалення або редагування відправлення: Перейдіть у Orders → Order → Nova Post Delivery → Delete Tracking або Orders → Order → Nova Post Documents → Delete Tracking.

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

Документи відправлення: Завантаження та друк документів доступні у розділі Orders → Order → Nova Post Documentation:

• Маркування (Nova Post Marking)
• Інвойс (Nova Post Invoice)
• Міжнародна накладна (Nova Post International)

Шлях покупця на Checkout

Під час оформлення замовлення покупцю будуть доступні способи доставки Nova Post, які ви вибрали у налаштуваннях.

• Адресна доставка Nova Post: Введення точної адреси доставки.
• Доставка у відділення Nova Post: Вибір зручного відділення зі списку.
• Доставка у поштомат Nova Post: Вибір поштомата для отримання.

Мова модуля

Модуль підтримує англійську та українську мови на клієнтській стороні та перемикається автоматично залежно від обраної мови магазину.