# Shopify
### Основні функції застосунку Nova Post для Shopify
Інтеграція дозволить покупцям вибирати відділення до моменту оплати та автоматизує створення накладних, в тому числі для міжнародної доставки по всьому ЄС та в Україну.
* Вибір відділення Nova Post або адресної доставки покупцем під час замовлення.
* Оформлення доставки ваших замовлень клієнтам у вашій країні, по всій Європі та в Україну напряму в кабінеті Shopify.
* Автоматичне створення транспортних та експортних документів.
* Доступ до трекінга доставки та нотифікація покупців про зміну статусу доставки.
* Оформлення замовлень з оплатою при отриманні.
Що потрібно, щоб інтегрувати Nova Post у Shopify
1. 1Підписати договори з Nova Post на надання логістичних послуг. Якщо ви продаєте за кордон, вам знадобиться два договори: на внутрішню доставку по країні та на міжнародну – для доставки в інші країни. Для підписання договору зверніться до відділу продажів своєї країни.
2. Підписати додатковий договір для послуги [«Оплата при отриманні»](https://api-portal-stage.novapost.com/uk/api-methods/cod)\*
{% hint style="info" %}
\*Тільки для продавців з Польщі, Чехії, Німеччини
{% endhint %}
1. Зареєструватись в My Nova Post у вашій країні після підписання договорів з контактними даними, які ви вказали в договорі контактами довіреної особи-представника
2. Отримати API-ключ Nova Post. [Як створити ключ для європейського клієнта](https://api-portal-stage.novapost.com/uk/api-nova-post/start/api-keys)
### Як встановити та налаштувати застосунок Nova Post на Shopify
* [Відеоінструкція](https://www.youtube.com/watch?v=jBClvR-F6pU\&t=3s).
**Що підготувати перед налаштуванням:**
1. 1API-ключ
2. 2Номери локального та міжнародного договорів\
\
Після підписання договорів наш менеджер надішле вам номери на електрону пошту, а також їх можна знайти [в кабінеті My Nova Post](https://my.novapost.com/#).
#### Базові налаштування
1. **Встановіть застосунок.** Увійдіть у свій магазин Shopify >> Перейдіть до Shopify App Store >> Знайдіть Nova Post >> Натисніть "Install" >> Натисніть "Install" або перейдіть [за прямим посиланням](https://apps.shopify.com/nova-post-1?search_id=7bc00069-e4d9-4fb6-8e9e-6b17223ad373\&surface_detail=Nova+post\&surface_inter_position=1\&surface_intra_position=5\&surface_type=search).
2. **Налаштуйте обліковий запис Nova Post:**
* Вкажіть API-ключ
* Вкажіть номери локального та міжнародного договорів
* За потреби змініть мову застосунку. Доступні: англійська та українська
* Вкажіть країни, в які будете здійснювати доставку
* Вкажіть адресу відправника:
* для відправки кур'єром: адресу вашого магазину або складу
* для відправки з відділення: адресу відділення Nova Post
3. **Налаштуйте розрахунок вартості доставки (CCS):** необов'язково\
\
Функція дозволить вашим покупцям бачити розрахунок вартості доставки під час оформлення замовлення. Застосунок може працювати без цього налаштування.\
\
CCS (Carrier-Calculated Shipping) включено у вартість для тарифних планів Shopify Plus, Shopify Advanced та Shopify Grow з річним планом. Також можна активувати для Shopify Grow з помісячною оплатою за $20/місяць.\
\
Якщо CSS доступний, ви зможете налаштувати наступні опції:
1. **Типи доставки,** які будуть доступні для розрахунку вартості доставки. В цьому ж розділі ви можете вказати мінімальну суму замовлення для безплатної доставки.
2. **Вимога номера телефону**\
\
Номер телефону обов'язковий для оформлення відправки Nova Post. Якщо ви увімкнете цю опцію, користувач не зможе оформити замовлення, поки не введе номер телефону, навіть якщо у попередніх кроках він вже вводив номер телефону
3. **Додаткова плата за пакування**
4. **Вкажіть типи доставки, які будуть доступні покупцям:**
* У відділення
* На адресу
* У поштомат
* У пункт видачі
5. **Вкажіть параметри пакування:**
* Якщо ви пакуєте всі замовлення в однакові коробки, вкажіть її параметри
* Якщо габарити пакування залежать від продукту, виберіть розрахунок за параметрами товару
* Параметри відправлення, які будуть застосовуватись до замовлення, якщо у картці товару не вказані габарити
6. **Вкажіть дані для активації післяплати:** необов'язково\
\
Якщо хочете надати можливість покупцям сплачувати замовлення при отриманні, в цьому розділі вкажіть:
* Номер договору
* Дані про рахунок для зарахування коштів
{% hint style="info" %}
**Як увімкнути післяплату?**
 тільки для Польщі, Чехії та Німеччини
У Shopify admin перейдіть до Settings > Payments > Create custom payment method. Назвіть метод "Cash on Delivery (COD)" і вкажіть номер договору з Nova Post на надання послуг піспляплати. У застосунку Nova Post ви маєте ввести точну назву цього способу оплати, щоб він коректно працював.
{% endhint %}
7. **Вкажіть дефолний HS-код**: необов'язково
1. Вкажіть код, який буде автоматично використовуватись для всіх товарів, для яких не буде вказаний цей параметр у картці.\
Варто налаштувати цей параметр, якщо відправляєте товари за кордон.
8. **Вкажіть правила друку етикеток**
1. Ви можете налаштувати автоматичний друк етикеток. Маркування надрукується одразу після оформлення накладної.
#### Увімкніть віджет, який бачитимуть покупці
{% hint style="info" %}
На тарифах Basic та Grow необхідно використовувати віджет, для тарифів Advance та Plus вибір відділення буде інтегровано у чекаут автоматично.
{% endhint %}
* **Як увімкнути віджет Nova Post на сторінці кошика**
Щоб увімкнути віджет Nova Post на сторінці кошика, потрібно додати його до вашої теми. Ви можете додати його, перейшовши в Shopify admin > Online Store > Themes > Customize > Cart.
* **Як увімкнути віджет Nova Post на сторінці оформлення замовлення \*тільки для Shopify Plus**
Ви можете додати віджет Nova Post на сторінку оформлення замовлення за допомогою редактора оформлення замовлення. Зайдіть у Shopify admin > Settings > Checkout > Customize.
Віджет буде автоматично підтягувати відділення з API Nova Post (GET /divisions). Якщо покупець вкаже країну доставки, в яку ви не відправляєте, віджет все одно з’явиться, але покупець не зможе вибрати відділення.
### Як оформити відправку замовлення
Тестове відправлення
Щоб перевірити роботу інтеграції, ви можете створити тестове відправлення:
1. Додайте тестовий товар у кошик.
2. Перевірте:
* Чи працює вибір країни
* Чи підтягнулись відділення
* Чи записується обраний пункт у order note або cart attributes
3. Перейдіть у Shopify Admin → Orders → перевірте, чи відображається обране відділення
4. Згенеруйте тестову ТТН. Перевірте, чи підставились:
* ПІБ одержувача
* Контакти
* Відділення
* Інформація про товари (HS-код, вага, вартість, габарити)
1. Створіть накладну
1. Зайдіть у потрібне замовлення.
2. У блоці Nova Post ви побачите активну кнопку Create Shipment. Натисніть її.
3. Перевірте деталі та натисніть Create. Після створення відправлення ви можете роздрукувати накладну та інші необхідні документи.
2. Роздрукуйте документи: маркування, інвойс (для міжнародних відправлень)\
\
Зайдіть у потрібне замовлення в Shopify admin > натисніть "Print" > виберіть "Nova Post" > виберіть потрібний документ.
1. Запакуйте відправлення згідно зі стандартами пакування Nova Post та відправте замовлення.
{% hint style="info" %}
 Коли ви відправите замовлення, клієнт отримає номер накладної для відстеження на електрону пошту, вказану під час оформлення замовлення.
{% endhint %}
---
# Agent Instructions: 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:
```
GET https://api-portal.novapost.com/gotovi-integraciyi/gotovi-integraciyi/populyarni-integraciyi/shopify.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.