> For the complete documentation index, see [llms.txt](https://api-portal.novapost.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-portal.novapost.com/gotovi-integraciyi/popular_integration/populyarni-integraciyi/prestashop.md).
# PrestaShop
[**\[Завантажити\]**](https://gitlab.com/novadigitalhub/novapost-shipping-prestashop)
Модуль Nova Post для PrestaShop дозволяє автоматизувати процес доставки товарів, інтегрувати вибір способів доставки безпосередньо у чекаут та керувати відправленнями безпосередньо з панелі управління магазином.
[**Основні можливості модуля та доступна географія доставки**](https://novapost.com/uk-pl/for-business/integrations-prestashop)
### Що потрібно для коректної роботи з модулем
* **Договір на надання послуг з Nova Post**. Для коректної роботи з плагіном необхідний договір бізнес-клієнта з Nova Post. Щоб підписати договір, напишіть [на пошту відділу продажів у вашій країні](https://api-portal.novapost.com/help-center).
* **API-ключ**. Зареєструйтесь у бізнес-кабінеті My Nova Post та згенеруйте ключ. [Детальна інструкція](https://api-portal.novapost.com/uk/api-nova-post/start/api-keys).
{% hint style="warning" %}
Під час налаштування модулю вам необхідно буде вказати:
* Номер договору на логістичні послуги
* Номер договору для післяплати
* API-ключ
{% endhint %}
Номери договорів не відображаються у бізнес-кабінеті. Якщо вам необхідно дізнатись номер договору, напишіть [на пошту відділу продажів у вашій країні](https://api-portal.novapost.com/help-center).
### Встановлення модуля Nova Post у PrestaShop
[**\[Завантажити модуль\]**](https://gitlab.com/novadigitalhub/novapost-shipping-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**.
### Початкове налаштування модуля
{% hint style="warning" %}
**Важливо**: Після встановлення модуля обов’язково очистьте кеш магазину, перш ніж переходити до налаштувань.
{% endhint %}
#### Ідентифікуючі дані
Відкрийте модуль Nova Post у панелі PrestaShop:
{% stepper %}
{% step %}
#### Вкажіть API Key
{% endstep %}
{% step %}
#### Вкажіть номери договорів
{% endstep %}
{% step %}
#### Увімкніть запис API-запитів та відповідей у файл `var/logs/nova-post.log` допомагає у діагностиці та вирішенні помилок
Опція не впливає на швидкість сайту, але потребує наявності вільного місця на диску сервера.
{% endstep %}
{% endstepper %}
#### Дозволені країни доставки
Модуль відображає країни, увімкнені у вашому магазині, але ви можете окремо задати країни, для яких буде доступна доставка Nova Post.\
\
Для цього перейдіть: **Improve** → **International** → **Location** → **Countries** і виберіть зі списку тільки ті країни, куди плануєте відправляти через Nova Post (використовуйте `Ctrl/Cmd` для вибору кількох).\
\
Якщо жодна країна не вибрана, доставка буде доступна для країн, які дозволені на рівні налаштування самого магазину.
#### Дані про відправника
1\. Заповніть обов'язкові поля:
* Номер внутрішнього договору
* Номер міжнародного договору
* Прізвище та ім'я
* Мобільний телефон
* Email
* Назва компанії
* Податковий номер компанії (TIN / ІПН)
{% hint style="info" %}
Важливо: Вказані дані мають збігатись з тими, що вказані у договорі на логістичні послуги.
{% endhint %}
2\. Додаткові поля для доставки замовлень з митним оформленням:
* **EORI**: Необхідно заповнити, якщо ви здійснюєте міжнародну доставку, яка потребує митного оформлення: з країни поза зоною ЄС – у країну ЄС, з країни ЄС – за межі ЄС.
* **IOSS**: Ідентифікаційний номер юридичної особи, яка зареєстрована платником ПДВ у системі Import One-Stop Shop. Необхідний для спрощеного митного оформлення у країні доставки. Дозволяє стягувати ПДВ з покупця для товарів до €150 під час оплати замовлення.
Приклад заповнення розділу Sender Information
#### Місце відправки
Виберіть спосіб відправки та вкажіть необхідні дані відповідно до нього:
* **Adress**: Для відправки замовлень кур'єром з офісу або складу магазину.
* **Branch**: Ви самі привозите замовлення у вибране відділення Nova Post або партнерське.
| **Приклад заповнення для відправки кур'єром з адреси** | **Приклад заповнення для відправки з відділення** |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| | |
### Інформація про товари та пакування за замовчуванням
Якщо в картці товару відсутні вага та габарити, модуль використає значення за замовчуванням з цього розділу. Дані у цьому розділі впливають на розрахунок вартості доставки та доступні місця доставки.
#### Default Product Information
Розрахунок вартості доставки здійснюється на основі ваги, габаритів, ціни, пункту призначення та типу доставки. Якщо в картці товару відсутні вага та габарити, модуль використає значення за замовчуванням з цього розділу.
Приклад заповнення інформації про товар за замовчуванням
{% hint style="info" %}
Щоб встановити HS Code за замовчуванням, встановить [безплатний модуль HS Code](https://forum.prestashop.com/topic/1046735-free-modulehs-codes/).
{% endhint %}
#### Packaging Settings
Оберіть спосіб формування коробок:
* **Automatic**: Автоматично розраховує та підбирає оптимальні розміри коробок.
* **One box**: Використовуються фіксовані габарити пакування до всього замовлення.
Приклад заповнення інформації про пакування
### Післяплата
Щоб підключити послугу у своєму магазині:
* підпишіть додатковий договір з Nova Post.
* [встановіть безплатний модуль PrestaShop COD](https://addons.prestashop.com/en/omnichannel-payment-methods-pos/24637-cash-on-delivery-cod.html).
Для налаштування послуги перейдіть у **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`.
{% hint style="info" %}
Після видалення номера відстеження ви зможете внести зміни та згенерувати нову накладну.
{% endhint %}
**Документи відправлення**: Завантаження та друк документів доступні у розділі `Orders → Order → Nova Post Documentation`:
* Маркування (Nova Post Marking)
* Інвойс (Nova Post Invoice)
* Міжнародна накладна (Nova Post International)
### Шлях покупця на Checkout
Під час оформлення замовлення покупцю будуть доступні способи доставки Nova Post, які ви вибрали у налаштуваннях.
* **Адресна доставка Nova Post**: Введення точної адреси доставки.
* **Доставка у відділення Nova Post**: Вибір зручного відділення зі списку.
* **Доставка у поштомат Nova Post**: Вибір поштомата для отримання.
#### Мова модуля
Модуль підтримує англійську та українську мови на клієнтській стороні та перемикається автоматично залежно від обраної мови магазину.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://api-portal.novapost.com/gotovi-integraciyi/popular_integration/populyarni-integraciyi/prestashop.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
| 
|
### Інформація про товари та пакування за замовчуванням
Якщо в картці товару відсутні вага та габарити, модуль використає значення за замовчуванням з цього розділу. Дані у цьому розділі впливають на розрахунок вартості доставки та доступні місця доставки.
#### Default Product Information
Розрахунок вартості доставки здійснюється на основі ваги, габаритів, ціни, пункту призначення та типу доставки. Якщо в картці товару відсутні вага та габарити, модуль використає значення за замовчуванням з цього розділу.
