> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.weblium.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Підключення методу доставки "Нова Пошта" до інтернет-магазину

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

**Зміст**:
* [Отримання API-ключа в акаунті Нової Пошти](#1-otrimannya-api-klyucha-v-akaunti-novoyi-poshti)
* [Підключення інтеграції до сайту на Weblium](#1-pidklyuchennya-integraciyi-do-sajtu-na-weblium)
* [Налаштування інтеграції на Weblium](#1-nalashtuvannya-integraciyi-na-weblium)
* [Створення ТТН на основі замовлень](#1-stvorennya-ttn-na-osnovi-zamovlen)
* [Подовження терміну роботи АРІ-ключа](#1-podovzhennya-terminu-roboti-ari-klyucha)

${youtube}[Як підключити Нову Пошту до інтернет магазину](rpaet3ongOM)

# Отримання API-ключа в акаунті Нової Пошти

1. [Зареєструйте](https://new.novaposhta.ua/) особистий кабінет на сайті Нової Пошти або [увійдіть](https://new.novaposhta.ua/) у наявний.
2. Перейдіть до вкладки **Безпека** та натисніть на кнопку **Створити ключ**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/s-1_w7rzbh.png)
3. Підтвердіть створення API-ключа шляхом натиску на кнопку **Створити**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/s-2_dsbg09.png)
4. Скопіюйте ваш API-ключ у колонці **Ключ**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/s-3_15n3pt2.png)
|| ${color}[#FFA800](Примітка:) у колонці “Сервіс” має бути вказано саме “Бізнес-кабінет” (не “Мобільний додаток” абощо).
||| ${color}[#F97700](Важливо:) ключ API створюється терміном на 1 рік. Після настання кінцевої дати ключ перестає працювати і більше не може використовуватися на вашому сайті. Ви можете дізнатися, як подовжити термін дії АРІ-ключа в [останньому розділі цієї інструкції](#1-podovzhennya-terminu-roboti-ari-klyucha) (це можна зробити завчасно).

# Підключення інтеграції до сайту на Weblium

1. Відкрийте налаштування вашого сайту, перейдіть до розділу **Доставка** та натисніть на кнопку **Підключити** у секції **Нова Пошта**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ukr-1_8e7e3r.png)
2. Вставте ваш **API-ключ** у відповідне поле та натисніть на кнопку **Зберегти**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ukr-2_1816l1x.png)
# Налаштування інтеграції на Weblium

1. Як і в інших способах доставки, ви можете додати для ваших покупців **Примітку** та редагувати написи у полях, які заповнюють покупці вашого магазину, а саме змінювати назву та підказку всередині цих полів:
ㅤㅤㅤ① У полі **Назва способу доставки** можна, відповідно, вказати назву методу доставки, що ви обрали;
ㅤㅤㅤ② У полі **Примітки** ви можете вказати для ваших клієнтів додаткову інформацію, яка буде відображатися під назвою методу доставки;
ㅤㅤㅤ③ У полі з назвою **Поле назви міста** ви можете вказати той текст, який буде відображатися в кошику зверху та усередині поля, з якого ваші покупці обиратимуть місто для отримання посилки;
ㅤㅤㅤ④ Так саме ви можете змінити назву та текст-підказку всередині поля **Поле відділення пошти** (те, де покупець обирає конкретне відділення НП у своєму місті):
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/group-260_116h5kn.png)
|| ${color}[#FFA800](Примітка:) інформація із цих полів надходить від бази даних Нової Пошти напряму.

2. Наступна опція для налаштування — **Фільтр поштових відділень**.
Тут ви обираєте ті типи відділень, котрі з’являтимуться на боці покупця під час вибору відділення:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ukr-4_1228v99.png)
①  Поштове відділення — звичайне відділення Нової Пошти, яке приймає посилки вагою до 30 кг (деякі відділення мають меншу максимальну вагу посилки).
②  Вантажне відділення — здійснюють приймання/видачу відправлення з фактичною й об'ємною вагою до 1 000 кг на одне місце відправлення, максимальною довжиною до 300 см і висотою до 170 см.
③  Поштомат — це автоматичнй термінал для отримання і відправки посилок, щоб зробити це у будь-який час у досить зручний спосіб.

| ${color}[#1AA900](Підказка:) детальніше про роботу поштомату Нової Пошти можна [дізнатися тут](https://novaposhta.ua/poshtomat/).
|| ${color}[#FFA800](Примітка:) якщо у вас великогабаритні товари, вам може бути корисно вимкнути цей тип відділення (а також звичайні поштові відділення) і залишити лише вантажні.

④  Поштомат ПриватБанку — те ж саме, що описано у попередньому пункті. ПриватБанк співпрацює із Новою Поштою та надає свої поштомати для користування.
⑤ Parcel Shop передбачає розміщення пунктів прийому та видачі посилок вагою до 15 кг у торговельних центрах та супермаркетах на невеликій площі.

| ${color}[#1AA900](Підказка:) детальніше про цей тип відділення ви можете [дізнатися тут](https://novaposhta.ua/news/rubric/2/id/2183).
||| ${color}[#F97700](Важливо:) станом на сьогодні такі типи відділень як "Поштомат ПриватБанку" та "Parcel Shop" недоступні. Вони наразі присутні у нас, тому що Нова Пошта до сих пір технічно дозволяє обирати ці опції і ми, відповідно, теж їх залишили доступними. Можливо, ці 2 типи відділень стануть знову доступними у майбутньому, тому за бажанням ви можете залишити вищезгадані опції активованими.

3. Ви також маєте можливість налаштувати **Вартість доставки**.
Вона буває як фіксованою:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ukr-5_1a88w66.png)
||| ${color}[#F97700](Важливо:) фіксована вартість доставки буде додана до загальної суми замовлення.

…так й індивідуальною:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ukr-6_157ocr8.png)
4. І наостанок, ви маєте можливість обрати способи оплати, за вибору яких для ваших покупців буде доступна опція доставки від Нової Пошти:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ukr-7_ifuucf.png)
| ${color}[#1AA900](Підказка:) Нова Пошта стабільно працює з усіма цими платіжними системами, що вказані на скриншоті вище.

Не забудьте [опублікувати](https://help.weblium.com/uk/article/publikaciya-sajtu-16hom55/) сайт для внесення усіх останніх змін.

5. Після закінчення усіх налаштувань та їх збереження ви побачите Нову Пошту у кошику на вашому сайті:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ukr-8_8w0z04.png)

# Створення ТТН на основі замовлень

Якщо до вашого сайту підключено Нову пошту, ви можете генерувати ТТН (товаро-транспортну накладну) на боці Weblium для кожного окремого замовлення в вашому магазині. Для цього необхідно здійснити первинні налаштування інтеграції, після чого в кожному замовленні буде доступна кнопка **Створити ТТН**. 

### Первинне налаштування генерації ТТН
Для здійснення цих налаштувань до вашого інтернет-магазину вже має бути підключена інтеграція з Новою поштою відповідно до інструкцій у розділах вище. Перед тим, як для замовлень можна буде генерувати ТТН, необхідно вказати дані відправника (ваші реквізити) та параметри посилки, які будуть використовуватися за замовчуванням (габарити та вага). Для цього:

1. У налаштуваннях вашого сайту в розділі **Ваш магазин** перейдіть до підрозділу **Доставка**, в рядку навпроти Нової пошти праворуч натисніть на три прапки та виберіть пункт **Налаштувати**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ttn-ukr-1_vf1hpx.png)

2. Нижче у розділі **Автогенерація ТТН** вам необхідно заповнити дані відправника (продавця), які будуть використовуватися в усіх згенерованих ТТН у якості відправника:
![](https://storage.crisp.chat/users/helpdesk/website/-/f/a/8/4/fa84b4d83a50e800/ttn-ukr-2_dak5ok.png)
ㅤㅤㅤ① **Відправник** — виберіть з випадного списку прізвище, ім’я та по-батькові (ПІБ) необхідного вам відправника (контактної особи);
ㅤㅤㅤ② **Телефонний номер відправника** — номер телефону відправника;
ㅤㅤㅤ③ **Місто відправника** — виберіть місто, з якого буде надсилатися відправлення. Ви можете почати вводити назву міста, щоб вибрати його зі списку;
ㅤㅤㅤ④ **Відділення відправника** — виберіть відділення у вашому місті, з якого надсилатимете відправлення. Рекомендуємо вибирати таке відділення, у якому максимальна допустима вага посилки дозволяє надсилати всі ваші товари (тобто якщо у вас бувають великі або важкі товари, бажано не вибирати мінівідділення для відправки);
ㅤㅤㅤ⑤ **Платник за доставку** — виберіть, хто буде здійснювати оплату доставки: **відправник** (ви) чи **одержувач** (покупець);
ㅤㅤㅤ⑥ **Форма оплати** — виберіть, яким чином буде здійснюватися оплата: **готівкою** у відділенні (цей варіант у т.ч. відповідає за оплату банківською карткою) або ж це буде **безготівковий розрахунок** (оплата через банк від юридичної особи на банкіський рахунок Нової пошти)

|| ${color}[#ffa800](Примітка:) безготівковий розрахунок доступний лише тим клієнтам, які мають укладений з Новою поштою договір на організацію перевезень та не мають простроченої дебіторської заборгованості перед Новою поштою. При цьому в загальному випадку рекомендуємо вказувати безготівковий розрахунок, лише якщо платником є відправник (ви), адже не всі ваші покупці можуть мати укладений договір з Новою поштою.

ㅤㅤㅤ⑦ **Використовувати "Контроль оплати"** — при активації надає можливість при створенні ТТН обрати функцію "Контроль оплати", яка дозволить вашому клієнту оплатити замовлення на пошті при отриманні посилки. 

||| ${color}[#F97700](Важливо:) ця функція доступна лише за умови підписання договору з Новою Поштою для ФОПів та юр. осіб. 

ㅤㅤㅤ➇ **Опис посилки** (опис відправлення) — вказане в цьому полі значення відображатиметься в описі відправлення. Ви можете використовувати змінні для цього тексту, щоб туди автоматично підставлялася необхідна вам інформація, як-от номер замовлення, перелік товарів тощо.

3. Окремо варто виділити пункт під назвою **Додаткова інформація про відправлення**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/np-dop-ukr-3_2tsqi7.png)

Тут є змога вказати шаблон, по якому буде генеруватися додаткова корисна інформація під час створення ТТН. У разі натиску на кнопку **Показати змінні**, ви зможете переглянути, які змінні можна використовувати для свого шаблону:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/np-dop-ukr-4_11f2l1b.png)

4. Нижче в розділі **Параметри посилки за замовчуванням** вам необхідно заповнити ті параметри посилки, які будуть застосовуватися до всіх відправлень за замовчуванням. Ви можете вказати ті параметри, які найбільш притаманні вашим відправленням (більшості посилок, які ви відправляєте):
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ttn-ukr-3_vqxruv.png)

| ${color}[#1aa900](Підказка:) при цьому можна вказати як середні значення, так і навіть параметри тих ваших посилок, які розміром менші за інші — у разі якщо відправлення фактично буде більшого розміру, оператори Нової пошти мають вручну скорегувати габарити посилки і за потреби перерахувати його вартість. Якщо раптом посилка буде настільки більшою, що не проходитиме в вибране покупцем відділення за габаритами чи вагою, представник Нової пошти має з вами зв’язатися (як правило, зателефонувати) задля уточнення іншого відділення, куди відправляти посилку одержувачу (наприклад, на найближче вантажне відділення).

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

5. Збережіть зміни в налаштуваннях інтеграції, натиснувши **Зберегти** в правому верхньому куті:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ttn-ukr-4_7panci.png)

Готово! Тепер ви зможете генерувати ТТН усередині того чи іншого замовлення в налаштуваннях сайту. 

### Створення ТТН
Щоб згенерувати ТТН для замовлення, виконайте наступні кроки:

1. У налаштуваннях вашого сайту в розділі **Ваш магазин** перейдіть до підрозділу **Замовлення** та натисніть на необхідне вам замовлення:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ttn-ukr-5_1o4a978.png)

2. У правому меню знизу в секції **Доставка** натисність на кнопку **Створити ТТН**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ttn-ukr-6_db26qj.png)

||| ${color}[#F97700](Важливо:) у деталях замовлення (розділи `Контакт` та `Доставка`) текст повинен бути вказаний кирилицею.

3. У наступному вікні, що з'явиться, заповніть усі необхідні дані та натисність на кнопку **Створити**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/np-dop-ukr-1_138jzci.png)

4. Варто додатково звернути увагу на пункт під назвою **Параметри відправлення**:

ㅤㅤㅤ① **Загальні параметри**. Ви можете задавати параметри відправлення окремими місцями. Щоб задати загальні параметри, необхідно поставити галочку у цьому полі;
ㅤㅤㅤ② Кнопка для **копіювання місця відправлення**;
ㅤㅤㅤ③ Кнопка для **видалення місця відправлення**;
ㅤㅤㅤ④ Кнопка для активування опції **ручної обробки **(його необхідно відмічати, якщо відправлення не запаковане згідно правил Нової Пошти);
ㅤㅤㅤ⑤ Кнопка для **додавання місця відправлення**.
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/np-dop-ukr-6_yb6ebx.png)

5. У разі необхідності додаткового редагування вже створеної ТТН, у вас буде можливість її відредагувати:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/np-dop-ukr-2_1nq6xzj.png)

6. На боці Нової Пошти ТТН виглядатимуть наступним чином:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ttn-ukr-9_1dkwl24.png)

###### Копіювання чи Видалення ТТН
Якщо вам необхідно скопіювати чи видалити ТТН, ви можете це зробити в тому ж місці, де ви її створили, а саме в налаштуваннях замовлення за допомогою відповідних кнопок, котрі знаходиться праворуч від номеру ТТН:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/np-dop-ukr-7_1xf2w47.png)

# Подовження терміну роботи АРІ-ключа

Термін дії вашого АРІ-ключа можна подовжити. Це можна зробити, якщо зайти в особистий кабінет Нової Пошти, аналогічно до процесу підключення, у розділі **Налаштування** перейти до вкладки **Безпека** та натиснути на іконку у вигляді годинника біля потрібного ключа:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/s-4_d5zcah.png)
…та подовжити його натиском на кнопку **Підтвердити**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/s-5_15kf76d.png)
Однак є кілька ситуацій, які не дозволять продовжити термін дії ключа: якщо дата закінчення його роботи вже пройшла або якщо ключ був видалений. Тобто термін роботи ключа можна продовжити доки не настала його кінцева дата і він не вилучений.

||| ${color}[#F97700](Важливо:) якщо термін дії ключа завершився, вам необхідно повторити процес підключення з цієї інструкції (створити новий АРІ-ключ та повторно підключити його у налаштуваннях вашого сайту замість застарілого ключа).
| ${color}[#1AA900](Підказка:) ключ можна подовжити завчасно, навіть одразу після його створення.